- Home
- Plugins
- Security & Permissions
- dsh-aiterm
dsh-aiterm
rj-yejianping/dsh-aiterm
SSH and Telnet terminals for DeepSeek Harness (DSH). Multi-session tabs where a human and an AI share the same real terminal: per-session AI permissions (read-only / write-only / read-write), control handoff, delta reads, searchable history, batch scripts, audit trail.
Install
dsh plugin --profile web add github:rj-yejianping/dsh-aitermREADME
dsh-aiterm · SSH / Telnet 终端(人与 AI 协同)
DeepSeek Harness(DSH)插件:把 SSH 和 Telnet 会话放进 Harness 右侧栏的终端面板,人和 AI 共用同一个真实终端,并按会话控制 AI 能做什么。
Give your agent hands on real servers. aiterm puts SSH and Telnet sessions in DSH's right sidebar — one real terminal shared by you and the AI, not an AI-only pipe: per-session AI permissions (read-only / write-only / read-write), a single control token, token-cheap delta reads, searchable history, batch scripts and a full audit trail.
改名说明(0.5.0 起):包名由
@dsh/dsh-ssh-telnet→@dsh/aiterm→ 公开发布名dsh-aiterm,整套标识一起改到位:模型工具名aiterm_*、HTTP 路由/aiterm、数据目录~/.dsh/aiterm、凭据作用域aiterm/、前端存储键dsh.aiterm.*、面板标签类型aiterm。0.4.0 只改了包名,0.5.0 是破坏性改名,从 0.3.x/0.4.0 升级要迁移数据与提示词,见下方「从 ssh-telnet 升级」。
- 多会话:同时打开多台主机,标签页切换;终端输出实时滚动,支持重连回放。
- 省 token 的读取:默认 增量读(只回上次之后的新输出),另有「只看变化行」的屏幕读、带时间戳的历史搜索、以及"等到有输出/提示符/退出"的等待读,不再反复重传整屏。
- 历史可查:输出按会话落盘(默认 24 小时),会话关闭、甚至重启后仍可按时间范围或关键字检索。
- 批量与脚本:一次调用跑多步(发送 → 等待 → 只读新输出),支持多会话扇出;可保存脚本并在面板里一键运行。
- SSH + Telnet:SSH 走
ssh2(密码 / 私钥 / agent),Telnet 为原生实现(完整 IAC 协商、TERMINAL-TYPE、NAWS 窗口尺寸)。 - AI 权限按会话设置:
只读(ro):AI 能看屏幕/输出,不能输入;只写(wo):AI 能输入,不能看输出;读写(rw):两者都可。
- AI 操作时屏蔽人工写:AI 一开始输入就持有「控制权」,人工键盘输入被拒绝并显示提示;AI 空闲超时自动释放,或人工点「接管」立即夺回控制。
- 双向互斥:人工「接管」后,AI 的写入被拒绝,直到人工「交还 AI」。
- 审计:每次读、写、拒绝、控制权变更都记录来源(human / ai),面板内可查,AI 也能用工具查。
- 凭据隔离:保存的密码/私钥存在 Host 侧(优先 DSH 加密凭据库),不会进入模型上下文、工具结果或日志。
这是权限与协作层面的护栏,不是远程主机的安全沙箱。对敏感环境请给 AI 设
只读,或让 AI 仅通过保存的 profile 连接。
安装
公开发布后(npm):
dsh plugin --profile web add dsh-aiterm
# 重启 DSH Web
本地开发:先打包再装真实包,不要用 link: / 软链——宿主在 profile 目录下按 importer
路径做包解析,软链会让内核包解析到 profile 之外而启动失败(ERR_MODULE_NOT_FOUND)。
npm install && npm run build # 需要 esbuild / xterm 才能重建 lib/client.js
npm pack # → dsh-aiterm-0.5.0.tgz
# 然后 plugin_manager(action:"install_bundle", target:"<tgz 绝对路径>")
装好后浏览器 Ctrl+F5 硬刷新一次:客户端半边由宿主重打包,SPA 内切页不够。
不会触发 pnpm 的构建脚本门禁。
ssh2本身是纯 JS,但它的两个可选原生加速件 (cpu-features与内建的sshcrypto绑定)带install/node-gyp rebuild脚本, pnpm 10+ 会因此挂起安装等人工批准。本包已把 ssh2 打成vendor/ssh2.cjs随包发布, 依赖图里没有任何安装脚本;缺少原生件时 ssh2 自动回落纯 JS,功能不受影响。
从 ssh-telnet 升级(破坏性)
0.5.0 把工具名、路由、数据目录、凭据作用域和存储键全部从 ssh-telnet 改成 aiterm,不保留旧别名。
从 0.3.x / 0.4.0 升级时按序执行:
# 1) 停掉 DSH Web(改名期间旧进程还在往旧目录写)
# 2) 迁移数据目录(历史、脚本、导出的日志、已知主机、回退密钥都在里面)
mv ~/.dsh/ssh-telnet ~/.dsh/aiterm
# 3) 凭据库记录改作用域(先备份;这个文件写坏会让 DSH 下次起不来)
cp ~/.dsh/.credentials.yaml ~/.dsh/.credentials.yaml.bak
sed -i 's#^ ssh-telnet/# aiterm/#' ~/.dsh/.credentials.yaml
# 4) 若用的是文件回退(没有 credentials 服务),同步 secrets.json 的键前缀
sed -i 's#"ssh-telnet/#"aiterm/#' ~/.dsh/aiterm/secrets.json
然后卸载旧包、安装 dsh-aiterm@0.5.0 并重启 DSH Web,浏览器 Ctrl+F5。不要新旧并存——两者注册同名工具会冲突。
升级后需要自己改的地方:
- 提示词 / 脚本 / 外部调用里写死的
ssh_telnet_*改成aiterm_*(模型工具名变了)。 - 反向代理 / 书签里的
/dsh-ssh-telnet路由改成/aiterm。 - 前端本地偏好(脚本面板的排序、方言选择、快捷条分组可见性)用的是新键
dsh.aiterm.*,旧值不迁移,重新设置一次即可。
使用
- 右侧栏打开 aiterm 面板 → 新建连接,或先保存一个主机档案(profile)。
- 选择连接方式:SSH(密码 / 私钥 / ssh-agent)或 Telnet。
- 连接成功后即可直接输入;顶部工具条可随时调整 AI 权限。
- 让 AI 操作:在对话里让它「读一下 st-1 的屏幕」「在 st-2 上执行
df -h」。AI 开始操作时,面板顶部出现 AI 正在操作 · 人工输入已屏蔽 提示;点 接管 立刻拿回键盘,AI 的后续写入会被拒绝。
AI 权限模型
每个会话独立维护两件事:
| 维度 | 取值 | 含义 |
|---|---|---|
aiAccess | ro / wo / rw | AI 的读/写能力(只有人能改) |
lockOwner | null / ai / human | 当前控制权归属 |
规则(Host 侧统一执行,AI 工具与浏览器按键走同一入口):
- AI 读:
ro、rw允许;wo拒绝 →AI_READ_DENIED。 - AI 写:
wo、rw允许;ro拒绝;lockOwner === 'human'也拒绝 →AI_WRITE_DENIED。 - 人工读:永远允许。
- 人工写:
lockOwner === 'ai'且blockHumanWhileAi: true时拒绝 →HUMAN_WRITE_BLOCKED。 - AI 一次成功写入即取得控制权;
aiLockIdleMs(默认 30s)无 AI 写入后自动释放;人工点「接管」立即改为human,AI 调用aiterm_release_control只能交还自己持有的控制权。
只有人能做:修改 AI 权限、接管、交还控制、保存/删除档案。这些操作不提供模型工具。
模型工具
| 工具 | 作用 |
|---|---|
aiterm_list | 列出会话、状态、AI 权限、控制权 |
aiterm_connect | 通过保存的 profile(推荐)或 ad-hoc agent/none 建立连接 |
aiterm_status | 查看某会话的权限与控制权 |
aiterm_read | 默认增量读(mode:"delta",只回新输出);也可 screen / history / tail |
aiterm_screen | 可见屏幕文本;changedOnly:true 只回变化行(带行号) |
aiterm_screenshot | aiterm_screen 的兼容别名(已精简载荷,不再重复整屏) |
aiterm_wait | 等到「输出停顿 / 出现匹配 / 会话退出」,只回这期间的新输出 |
aiterm_history | 按时间范围/正则检索历史(含已关闭会话与重启后的历史) |
aiterm_send | 发送文本/按键(\u0003 = Ctrl-C),可选等待并在审计中记录一次 read:tail 回读 |
aiterm_batch | 一次调用执行多步(send → waitFor → 只读新输出),可多会话扇出 |
aiterm_script_list | 列出保存的脚本(按分组) |
aiterm_script_run | 运行脚本(支持延迟/变量/if/循环/断言,{{参数}} 替换) |
aiterm_script_save | 保存/覆盖脚本(删除仍仅限人在面板操作) |
aiterm_resize | 调整远端子终端尺寸 |
aiterm_release_control | 主动交还控制权给人工 |
aiterm_audit | 读权限审计记录 |
aiterm_disconnect | 断开但保留会话(可重连) |
aiterm_reconnect | 重连该会话(同一 id,历史保留) |
aiterm_close | 关闭会话(终止并从列表移除) |
AI 不能提供密码或私钥:需要密码/私钥的连接必须使用保存的 profile,由 Host 侧解析。
配置
在 ~/.dsh/profiles/<profile>/cordis.patch.yml 覆盖本插件行(合并语义:给整段 config):
- id: aiterm
name: 'dsh-aiterm'
config:
aiAccessDefault: ro # 新会话默认 AI 权限:ro | wo | rw
aiAutoLock: true # AI 写入时是否自动取得控制权
aiLockIdleMs: 30000 # AI 控制权空闲自动释放时间
blockHumanWhileAi: true # 核心行为:AI 操作时屏蔽人工写
humanCanPreempt: true # 是否允许人工随时接管
maxSessions: 16
scrollback: 4000
replayBufferBytes: 262144 # 重连回放保留的原始输出字节数
aiReadMaxBytes: 65536
connectTimeoutMs: 20000
keepaliveMs: 15000
routePath: /aiterm
knownHostsPolicy: accept-new # accept-new | strict | insecure
terminalType: xterm-256color
# v2 读取 / 历史 / 脚本
promptPattern: '(?:^|[\s\])])[#$%>❯»]\s*
## 读取方式与 token 成本
| 场景 | 建议用法 | 典型开销 |
| --- | --- | --- |
| 追一条长时间命令的输出 | `aiterm_read`(默认 delta)+ 上次返回的 `cursor` | 只有新输出,几十到几百字符 |
| 判断命令是否跑完 | `aiterm_wait {until:"idle"}` 或 `{until:"pattern"}` | 一次调用 + 新输出 |
| 看 vim/top 之类全屏界面 | `aiterm_screen {changedOnly:true}` | 只回变化的行 |
| 排查"刚才发生了什么" | `aiterm_history {since:"10m", search:"ERROR"}` | 命中行 + 时间戳 |
| 一组固定操作 | `aiterm_batch` 或保存脚本 | 一次调用,逐步只回新输出 |
## 首次打开
没有会话时,面板**默认打开配置管理**(连接库),可在其中选择已有配置连接,或点「新建连接」。
不会再一进来就是一张空表单。
## 界面导航
所有非终端页面(新建/编辑连接、配置管理、历史、脚本)共用同一个页头:**← 返回 · 标题 · × 关闭**。
- **返回回到来处**:面板内部维护一个视图栈。配置管理 → 编辑某条配置 → 返回,回到配置管理;
终端 → 历史 → 返回,回到终端。根视图是终端(或没有会话时的配置管理),不会被弹空。
- **Esc = 一次退一层**:整个面板只有一个 Esc 处理者;行内编辑/行内确认条会先吃掉 Esc(取消自己),
不会一次退两层。
- **终端视图有常显入口**:标签行右侧的「配置管理」按钮带文字,不再只是一个图标。
- **按钮尺寸**:文本按钮高 32px、图标按钮 30px(会话标签行的关闭按钮 26px)、控件字号 12–13px,
命中区域按触摸场景放宽。
### 增删改的确认方式
- **删除配置**、**关闭会话**、**删除脚本**都改成**行内确认条**(`确认删除 xxx?[确认][取消]`),
不再用「3 秒内点两次」的定时器:既不会误触,也不会因为犹豫几秒就得重来。
- 删除配置后会清掉对应的密码/私钥/口令;关闭会话会断开连接并从列表移除(不可恢复)。
- 保存配置后自动回到列表,并**高亮刚保存的那一行**。
- 配置行操作常显:`连接`(主)/ `编辑` / `重命名` / `移动文件夹` / `删除`,不靠 hover 才出现。
## 会话中断与重连
- **中断**(`sessions.disconnect` / 工具 `aiterm_disconnect`):断开传输但**保留会话**——同一 `id`、标题、
AI 权限、输出历史、审计都还在,列表里标记为 `disconnected`。
- **重连**(`sessions.reconnect` / 工具 `aiterm_reconnect`):复用同一 `id` 重新连接,`generation` +1,
AI 权限与历史延续;远端是新的 shell,所以**屏幕会重置**(客户端清屏并提示),但历史检索仍覆盖断开前的内容。
- **掉线不再丢会话**:远端主动断开或网络中断时,会话进入 `disconnected`(记录 `closeReason`),点一下即可恢复;
只有显式「关闭」才会移除。
- 重连的认证材料:有配置走配置(会重新读取,密码轮换也能生效);ad-hoc 会话的凭据只留在 Host 进程内存,
从不落盘/回传;两者都没有时返回 `RECONNECT_NO_CREDENTIALS`,请用配置重连。
- 保留上限:同时最多保留 `maxDetachedSessions`(默认 20)个断开会话,超出按最早断开修剪。
## 配置管理
面板里的 **配置管理** 支持按文件夹分组维护连接配置:
- 新建 / 编辑 / 重命名 / 删除配置;删除会同时清掉该配置的密码、私钥与口令。
- 移动到分组、取消分组;新建分组;连接表单保存时可直接选分组。
- 重命名只改显示名,**id 不变**(id 是凭据键的一部分,改了会丢密码)。
- 编辑时密码/私钥留空表示"保持原值",只有显式清空才会删除。
- 所有配置写操作仅限人工(AI 无法读写你的凭据)。
## 终端与 AI 会话的归属
**每个 DSH(AI)会话单独维护自己的 SSH/Telnet 终端**:在对话 A 里打开的终端,切到对话 B 就看不到,
也不会被 B 的 AI 读到或操作。
- 客户端把当前 DSH 会话 id 作为 `owner` 带在每次会话相关调用上,SSE 流也按 `?owner=` 过滤
- 宿主侧按 `owner` 隔离:`sessions.list`、读写、断线重连、权限、审计、历史查询、日志导出**全部按 owner 过滤**;
用别的对话的 id 去访问一律 404,且文案与「id 不存在」完全一致(不泄露存在性)
- `maxSessions` / `maxDetachedSessions` **按每个 AI 会话分别计数**,一个对话开满不会影响另一个
- AI 通过工具创建的终端,归属**调用它的那个 AI 会话**(工具 schema 里没有 owner 参数,模型无需关心)
- 身份取自 DSH 的 `agent.id`(兼容 `agent.session.id`);**子代理**开的终端归到它所属的那个对话,
**fork** 出来的新对话则各管各的
- 万一宿主读不出调用方身份,工具会直接报 `OWNER_UNKNOWN` 而不是造一个谁都看不见的终端
- 哪些是宿主级、不按会话隔离:连接配置(`profiles`)、保存的脚本(`scripts`)、自动写日志开关、
`导出全部`(显式跨会话操作)
> 切换 DSH 会话时面板会清空并重新拉取,这是设计行为——不会把上一个对话的终端带过来。
> 已关闭终端的归属在宿主进程内记忆;**DSH 重启后**磁盘上的旧历史按「无归属」处理(只有不带 owner 的调用可见)。
## 会话与协议
- 会话标签上是**带颜色的协议徽标**:`SSH` 用强调色、`TELNET` 用告警色;徽标同样出现在侧栏 tab 标题里,
同一条 rail 上同时挂 SSH 和 Telnet 会话时一眼可分。
- 每个会话独立:各自的标题/主机/端口、断线重连、AI 权限、审计、输出历史互不影响。
## 日志导出与自动写文件
**导出**(历史面板底部):
| 按钮 | 作用 |
|---|---|
| 导出当前 | 把当前选中会话的输出写成一个文本文件 |
| 导出全部 | 每个会话各写一个文件(含已关闭的) |
- 输出目录:`~/.dsh/aiterm/exports/`,文件名 `<会话id>-<标题>-<时间戳>.log`
- 内容:头注释(协议 / `user@host:port` / 标题 / 开始时间)+ 每行 `<ISO 时间戳> <输出行>`
- 文件写在**宿主机**上(不是浏览器下载),用 DSH 的文件面板取走即可;导出结果面板会列出路径、大小、行数
- 导出失败会显示原因;若提示「重启 DSH 后可用」,说明宿主代码还是旧代际
**自动写日志文件**(默认关闭):
- 历史面板里的「自动把每个会话写进日志文件」开关,打开后每个会话实时追加写入
`~/.dsh/aiterm/logs/`(可在 Host 侧改目录)
- 开关状态存在 `~/.dsh/aiterm/settings.json`,重启后保持;写失败只会告警一次并自动停写,
不影响会话本身
- AI 也可以用工具 `aiterm_export` / `aiterm_autolog` 触发同样的能力
## 脚本
脚本是**纯数据**(不执行任意代码),支持多脚本、分组与参数:
| 能力 | 写法 |
|---|---|
| 发送命令 / 等待 / 回读 | `{ send, enter, waitFor:{pattern,idleMs,timeoutMs}, read:'delta'\|'screen'\|'none' }` |
| 延迟 | `{ delay: 500 }`(毫秒) |
| 变量 | `{ set: "name", value: "{{param}}-x" }`,所有字符串支持 `{{name}}` |
| 条件分支 | `{ if: {match:"ok"\|contains:"x"\|variable:"v",equals:"y"}, then:[...], else:[...] }` |
| 循环 | `{ loop: { count: 3 }\|{ while: Cond }\|{ until: Cond, maxIterations: 20 }, steps:[...] }` |
| 断言 | `{ expect: Cond, onFail: 'stop'\|'continue' }` |
| 日志 | `{ log: "..." }` |
- 条件看的是"自上次条件判断以来的输出",所以 `发送 → 立刻 if/expect` 能看到刚产生的输出。
- **步骤之间是严格顺序执行的,但 `send` 默认不等待**:写完就进入下一步,不会自动等远端输出。
想"等命令跑完再发下一条",二选一:
- 在该步骤里写 `waitFor`:`{ send:"ls", enter:true, waitFor:{ idleMs:250, timeoutMs:5000 } }`(等输出停顿)
或 `waitFor:{ pattern:"\\$\\s*$", timeoutMs:5000 }`(等提示符回来);
- 或在两条命令之间插 `{ delay: 500 }` 固定间隔。
`delay` 会真的睡满;`expect` / `if` / `loop.while` / `loop.until` 会读取输出(有读窗口)。
多目标时每个目标各自顺序执行;`parallel: true` 才是目标之间并发。
- 面板进度里的 `#0`、`#1` 是**步骤序号**(嵌套步骤显示成 `3.2` 这样的路径,并标注 send/delay/if/loop 类型)。
如果进度里出现"未知",那是事件来自 AI 工具(`aiterm_batch`)而非面板运行——工具事件只带序号,
不带步骤类型,面板就回退显示 `#n · 未知`。
- 上限:500 步、嵌套 5 层、单循环 1000 次(默认 100)、50 个变量、单变量 8 KiB、整脚本 10 分钟。
- 每次 `send` 仍走权限闸口:AI 只读会失败,人工接管会中止。
- 其他工具:`aiterm_script_list` / `_run` / `_save`(删除仅限人在面板操作)。
## 快捷脚本条
终端底部有一条**快捷脚本**条(点「⚡ 快捷脚本」展开):脚本按文件夹分组,点一下就用在当前会话上,
参数取脚本里声明的默认值。日常「查个负载/看个磁盘」不用再开面板。脚本在「脚本」面板里维护,
保存后展开快捷条即可看到。
## 脚本编写:逐行命令(推荐)
新建脚本默认是**逐行命令**:一行一条,直接发送;`@` 开头是控制行。
```text
# 注释
uname -a
@wait 300
df -h
@expect continue Filesystem
@python
print('hello from the remote host')
@end
| 写法 | 含义 |
|---|---|
| 普通行 | 发送该命令(带回车) |
@raw 文本 | 发送但不带回车 |
@wait 500 / @wait 2s | 暂停 |
@set name = value | 定义变量({{name}} 可在任意字符串里用) |
@log 文本 | 写进运行日志 |
@expect 文本 / @expect continue 文本 | 断言输出匹配,失败时停止 / 继续 |
@python … @end | 把代码发到远端 python3 执行 |
- 命令按行原样发送,不会自动等待:想等命令跑完再发下一条,就在中间写
@wait(或在该行之后加@expect断言);@wait 500/@wait 2s都可以。 - 需要
if/loop等结构时改用 高级脚本(新建时选择类型);两种类型各自独立,不互相转换。 - 编译在浏览器侧完成,存进 Host 的仍是同一份步骤数组,安全与权限规则完全不变。
- 为什么不用真正的 Python 写脚本:那等于在 Harness 进程里执行任意代码(安全退步),
且本镜像没有
python3。要用 Python,就写@python … @end,让远端服务器的 python3 跑。
脚本分组与两种编写方式
两种写法各自独立,互不转换(按脚本创建时选择):
| 类型 | 适合 | 编辑器 |
|---|---|---|
| 逐行命令 | 一串要按顺序发的命令 | 一行一条,@ 开头是控制行 |
| 高级脚本 | 需要 if / loop 结构 | JSON 步骤数组 |
- 新建时选类型(新建 · 逐行命令 / 新建 · 高级脚本);列表里每行带方言小标签。
- 编辑器顶部显示当前脚本的方言,不再提供互相切换的开关。
- 分组管理:编辑器里有「名称 / 分组」(分组可内联新建);列表的分组表头可以重命名分组、 删除分组(删除时组内脚本移到未分组)。
- 快捷脚本条的分组可见性:快捷条头部的「分组显示」勾选清单决定哪些分组出现在快捷条上, 选择会记住。
脚本面板(主从管理)
- 顶部
分组:下拉 + [添加分组][重命名分组][删除分组] - 左栏底部「+ 新建」——点了才弹出类型菜单(
逐行命令/JSON(高级)),选哪个就按哪种类型创建; 已打开脚本的类型显示在右栏的只读标签里(不做互转) - 左栏:当前分组的脚本列表;下方 [+新建][−删除][▲上移][▼下移][复制]
- 右栏:名称 / 分组 / 类型(只读)/ 模板 / 内容 + [保存][取消];内容框会撑满剩余高度,不再固定 120px
- 运行区在下方:运行目标(当前 / 选定 / 全部)+ 参数 + 运行
模板下拉随类型变化:逐行命令只列宏模板(发送命令 / @wait / @set / @log / @expect / Python), 高级脚本只列 JSON 骨架(send / delay / set / log / expect / if / loop)。 ▲▼ 的排序是本机显示顺序(存在浏览器 localStorage),不影响脚本执行;换浏览器会回到默认顺序。
运行结果
运行只占一行摘要(运行完成 · N 步 · 共 X 个会话,Y 个成功)。点 [查看结果] 弹出独立窗口看完整
步骤明细:运行中会自动打开,Esc 或 × 只关这个窗口(不会把脚本面板一起关掉)。
数据与安全
凭据文档是共享的。 本插件只通过 records(
aiterm/<id>)写自己的条目,并在写入后回读校验; 同时把每个密钥镜像到~/.dsh/aiterm/secrets.json(0600)。若凭据库无记录,读取会回落到镜像, 因此"保存了却显示没有密码"不会静默发生。其他插件若把 API key 填进apiKeyEnv之类的 "环境变量名"字段,会写坏整个文档(详见 VERIFICATION §12),那不是本插件能控制的。
- 主机档案(非机密字段):
~/.dsh/aiterm/profiles.json(0600)。 - SSH 主机指纹:
~/.dsh/aiterm/known_hosts,不写入用户自己的~/.ssh/known_hosts。 - 密码 / 私钥 / 私钥口令:走 Host
credentials服务的 records 通道,键形如aiterm/<profile>(私钥-key、口令-pass)。DSH 的records:只接受<scope>/<id>且每段匹配/^[a-z][a-z0-9-]*$/,本插件只通过credentialKeyFor()生成键并在写入前校验;不可用时回退到~/.dsh/aiterm/secrets.json(0600)并打印告警。 - ⚠️ 不要改回
credentials.set('aiterm/…'):refs:段只接受 POSIX 标识符 (/^[A-Za-z_][A-Za-z0-9_]*$/),写入当时不报错,但会让凭据文档在下次启动时 无法解析,导致 DSH 起不来(本项目曾因此事故)。test/secrets.test.mjs会拦截这种回退。 - RPC 与 SSE 路由经
connection.admit()认证(可信来源 + 签名 Cookie),非授权请求返回 401/403。 - 审计只记录输入预览(控制字符剔除、≤200 字符),不记录机密内容。
已知限制
- AI 截屏基于 headless 终端模拟,全屏 TUI 的鼠标/图片类内容无法表达。
- Telnet 协议本身明文传输(建议只在可信网络使用)。
- 浏览器端把 RPC 前缀硬编码为默认的
/aiterm;若改了routePath,需要同步修改client/api.js并npm run build。 - 历史检索对已关闭/重启前的会话不做权限判定(其权限状态已随会话消失);活跃会话的读取(含历史检索)仍严格受 AI 权限约束。
- 提示符识别是正则启发式,非标准 shell 集成;可通过
promptPattern按需调整。 - 面板视觉验证需要浏览器环境;本项目环境无浏览器控制能力,界面仅做了构建与注册级验证。
开发
npm install # 运行时依赖 ssh2 / @xterm/headless / @xterm/addon-serialize,
# 以及构建用 devDeps:esbuild、@xterm/xterm、@xterm/addon-fit
npm run build # 从 client/**.jsx 重新生成 lib/client.js(模块 id 取自 package.json 的 name)
npm run build:vendor # 重新打包 vendor/ssh2.cjs(需要 devDependency ssh2 + esbuild)
npm run lint # node --check 全部 Host 端源码
npm test # 客户端冒烟:槽位注册、locale 键、RPC 方法覆盖
改了 client/ 一定要重新 build 并提交 lib/client.js:lib/ 是仓库的一部分,
用户装包时不跑构建。
接口契约见 CONTRACTS.md。
License
MIT © yejianping