@wendongfly/myhi weekly downloads statistics

myhi

基于 Web 的终端共享工具 —— 通过局域网或 Tailscale 在手机、平板等设备上安全访问和控制你的终端，无需中继服务器。

<p align="center"> <img src="public/icon.svg" width="120" alt="myhi logo"> </p>

特性

• 双前端界面 —— 聊天对话式 UI（适合手机触屏）和 xterm.js 全功能终端
• 设备控制权切换 —— 多设备同时观看，单设备独占输入，支持接管与释放
• AI Agent 集成 —— 内置 Claude Code CLI，Web 界面中直接与 AI 对话编程、审批文件变更
• 🛡 隐私护栏（去标识化） —— 提交给模型的敏感实体（主体名、证件/卡号/手机等）自动假名化，模型/第三方网关只看到占位符，答案里再还原成真名，映射表只留本机 + 审计留痕可导出
• 角色权限管理 —— admin / operator / viewer 三级角色，多种认证模式
• 多用户隔离 —— 独立用户目录、独立 Git 配置，支持独占模式
• SSH 开发账号 —— 为每个用户创建独立的 SSH 账号，VS Code Remote-SSH 远程开发
• Git 一键提交 —— 内置 Git 提交推送功能，支持每个项目独立的 GitLab 账号
• 自动更新 —— Web 界面检测新版本，一键更新服务器
• 会话持久化 —— 会话断线重连、服务重启自动恢复
• 零配置启动 —— 一条命令启动，自动创建会话并附加终端
• 局域网 / Tailscale —— 自动检测网络，点对点直连，QR 码快速连接
• PWA 支持 —— 可添加到手机主屏幕，原生应用体验

---

安装

npm install -g @wendongfly/myhi

需要 Node.js >= 18。

新版 npm 注意：若看到 npm warn allow-scripts（新版 npm 默认拦包的安装脚本），说明 node-pty 的原生模块脚本被跳过、终端可能受影响。加参数放行即可：

npm install -g @wendongfly/myhi --allow-scripts=@wendongfly/myhi,node-pty

或本机一次性放行：npm config set allow-scripts=@wendongfly/myhi,node-pty --location=user。用下面的 Windows 安装器则已自动处理，无需手动加。

Windows 傻瓜安装（给普通员工，免命令行）

不想让员工碰终端？用 installer/ 里的一键安装：右键 Install-myhi.bat → 以管理员身份运行，它会自动装 Node（缺则 winget 装）、装/更新 myhi、注册计划任务实现开机登录自启（脱离会话、无黑窗、普通权限）、放行防火墙、建桌面「myhi 控制台」快捷方式。装完开机登录即自动后台运行，员工只管点桌面图标用。详见 installer/README.md。

快速开始

# 前台启动（自动创建会话并附加终端）
myhi

# 后台守护进程模式
myhi -d

# 指定端口
myhi -p 8080

启动后，终端会输出访问地址和 QR 码。在同一局域网内的手机浏览器扫码或输入 http://<你的IP>:12300 即可访问。

首次启动会在 ~/.myhi/password 生成一个 4 位数默认密码，终端中会显示。

---

CLI 命令

服务器管理

myhi                     # 前台启动服务器
myhi -d / --daemon       # 后台守护进程启动
myhi -p 8080             # 指定端口
myhi stop                # 停止后台进程
myhi restart             # 重启后台进程
myhi status              # 查看运行状态
myhi log [N]             # 查看最近 N 行日志（默认 50）

会话操作

myhi attach              # 交互式选择会话并附加
myhi attach <id>         # 附加到指定会话
myhi attach --new        # 创建新会话并附加
myhi kick                # 交互式踢出用户

附加会话后按 Ctrl+] 可安全断开。

用户管理

myhi user list                   # 列出所有用户
myhi user add <密码> <名称> <目录>  # 添加用户
myhi user remove <密码>           # 删除用户
myhi exclusive on|off            # 开启/关闭独占模式

SSH 开发账号

为 myhi 用户创建系统 SSH 账号，员工可通过 VS Code Remote-SSH 远程开发，每人只能访问自己的项目目录（支持 Windows 和 Ubuntu）。

myhi ssh add <用户名> [密码]      # 创建 SSH 账号（绑定到 myhi 用户的项目目录）
myhi ssh list                    # 列出所有 SSH 账号
myhi ssh remove <用户名>          # 删除 SSH 账号（保留项目目录）

示例：

# 1. 先添加 myhi 用户
myhi user add 1234 张三 /data/projects/zhangsan

# 2. 为他创建 SSH 账号
myhi ssh add 张三 sshpass123
# 输出:
#   ✓ SSH 账号创建成功！
#   │ SSH 用户名: myhi-zhangsan
#   │ SSH 密码:   sshpass123
#   │ 项目目录:   /data/projects/zhangsan

目录隔离：

平台	隔离方式
Windows	NTFS 权限：上级目录仅允许穿越，子目录完全控制
Ubuntu	chmod 711 上级目录 + chmod 700 用户目录 + chown

员工在 VS Code 中连接后打开 ~/project 即可开发，无法查看其他用户的文件。

远程附加

# 连接到远程服务器的会话
MYHI_SERVER=http://192.168.1.100:12300 myhi attach

---

环境变量

变量	默认值	说明
PORT	12300	监听端口
HOST	0.0.0.0	监听地址
MYHI_AUTO_ATTACH	1	启动时自动打开本地终端窗口并附加会话
MYHI_CWD	当前目录	新建会话的工作目录
MYHI_SERVER	http://localhost:PORT	attach 客户端连接的服务器地址

---

界面说明

仪表盘（/）

会话列表页面，显示所有终端和 Agent 会话：

• 实时状态（运行中 / 已退出 / 模式）
• 在线观看人数
• 控制权状态指示
• 快捷操作：打开、删除、重命名、踢出用户
• 新建 PTY 会话或 AI Agent 会话（支持文件夹选择器）
• 用量统计（7 天活动数据）
• 版本更新提示 —— 检测到新版本时显示更新横幅，一键更新

聊天模式（/terminal/:id）

对话式界面，主要为手机优化：

• 用户消息 vs AI 回复的对话气泡
• ANSI 48 色彩色终端输出渲染
• Markdown 渲染（加粗、代码块、列表）
• 工具调用可视化（可折叠分组，支持一键展开/收起全部）
• AI 思考过程（可展开查看）
• 文件差异查看器
• 权限请求卡片（允许 / 拒绝按钮）
• 图片上传（粘贴或选择，最大 20MB）
• 实时消息流式显示
• ESC 取消 —— Agent 处理中按 ESC 或点击停止按钮中断操作
• Git 提交 —— 快捷按钮一键提交代码到 GitLab，每个项目独立凭据

终端模式（/terminal-raw/:id）

完整的 xterm.js 终端：

• 全键盘操作支持
• 自动适配窗口大小
• 可点击的 URL 链接
• 完整的终端色彩和格式

登录页（/login）

• 密码输入认证
• 登录失败计数与锁定倒计时
• 独占模式下显示占用状态

---

认证系统

myhi 支持三种认证模式，按优先级依次检查：

1. 用户模式（users.json）

每个用户拥有独立密码、名称和工作目录：

// ~/.myhi/users.json
{
  "users": {
    "alice123": { "name": "Alice", "dir": "/home/alice/projects" },
    "bob456":   { "name": "Bob",   "dir": "/home/bob/work" }
  },
  "exclusive": false
}

通过 CLI 管理：myhi user add <密码> <名称> <目录>

独占模式（exclusive: true）：同一时间只允许一个用户登录，其他用户需等待当前用户退出（2 分钟无连接自动释放）。

2. 角色模式（roles.json）

不同密码映射到不同角色：

// ~/.myhi/roles.json
{
  "passwords": {
    "1234": { "name": "管理员", "role": "admin" },
    "5678": { "name": "开发者", "role": "operator" },
    "0000": { "name": "观察者", "role": "viewer" }
  }
}

3. 默认密码模式

无配置文件时，使用 ~/.myhi/password 中的 4 位数密码，所有登录用户获得 admin 角色。

认证流程

1. 浏览器访问 → 重定向到 /login
2. 输入密码 → 服务器验证（5 次失败锁定 IP 5 分钟）
3. 验证通过 → 设置 HttpOnly Cookie（myhi_sid，SameSite=Strict）
4. 后续请求自动携带 Cookie，7 天无活动自动过期

---

设备控制模型

每个会话同一时间只允许一个设备进行输入操作，其余设备为只读观察模式。

操作	说明
获取控制权	点击按钮或发送消息时自动获取
释放控制权	主动释放或 5 分钟无输入自动释放
强制接管	admin 角色可强制从其他设备接管
断线释放	控制者断开连接后立即释放

权限等级：admin(3) > operator(2) > viewer(1)

• admin：创建/删除会话、强制接管、浏览目录、踢出用户
• operator：获取控制权、输入命令
• viewer：只读观看

---

AI Agent 会话

myhi 集成了 Claude Code CLI，可以在 Web 界面中直接与 AI 进行编程协作。

工作方式

1. 在仪表盘点击"新建 Agent 会话"
2. 选择工作目录，创建 Agent 会话
3. 在聊天界面中输入自然语言指令
4. AI 以流式方式返回回复，包括：
   • 文本回复 —— Markdown 格式
   • 工具调用 —— 文件读写、命令执行等（可折叠查看，支持一键展开全部）
   • 思考过程 —— AI 的推理过程（可展开）
   • 权限请求 —— 需要你批准的操作（允许/拒绝按钮）
   • 文件差异 —— 代码变更的 diff 视图

权限模式

Agent 会话支持三种权限模式，可在界面中切换：

模式	说明
acceptEdits	默认，自动批准文件编辑，其他操作需确认
plan	规划模式，AI 只分析不执行
bypassPermissions	信任模式，自动批准所有操作

中断与取消

• ESC 键 —— 在 Agent 处理中按 ESC 中断当前操作
• 停止按钮 —— Agent 忙时发送按钮自动变为红色停止按钮，点击取消

会话恢复

Agent 会话支持断线重连，重新打开时自动加载最近的对话历史（最多 500 条消息）。

---

Git 提交推送

聊天界面的快捷键栏提供**"提交"**按钮，一键将代码提交并推送到 GitLab/GitHub。…