Skip to main content
R

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-aiterm

README

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.*,旧值不迁移,重新设置一次即可。

使用

  1. 右侧栏打开 aiterm 面板 → 新建连接,或先保存一个主机档案(profile)。
  2. 选择连接方式:SSH(密码 / 私钥 / ssh-agent)或 Telnet。
  3. 连接成功后即可直接输入;顶部工具条可随时调整 AI 权限。
  4. 让 AI 操作:在对话里让它「读一下 st-1 的屏幕」「在 st-2 上执行 df -h」。AI 开始操作时,面板顶部出现 AI 正在操作 · 人工输入已屏蔽 提示;点 接管 立刻拿回键盘,AI 的后续写入会被拒绝。

AI 权限模型

每个会话独立维护两件事:

维度取值含义
aiAccessro / wo / rwAI 的读/写能力(只有人能改)
lockOwnernull / 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_screenshotaiterm_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

Related plugins