dsh-zterm 0.1.15 → 0.1.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -19,6 +19,7 @@ DSH 对话中指定主机,结合 Grafana / OpenSearch 等证据
19
19
  - 可选 DSH 宿主本地 PTY;多终端、尺寸同步、手工输入、终端搜索、断开和重连。
20
20
  - 终端默认 12px;设置中可调 8–32px,即时应用并保存在当前浏览器。
21
21
  - 14 个 `zterm_*` 工具;默认读模式,人类在已绑定终端工具栏开启读写。
22
+ - 设置页顶部的「临时禁用 zTerm」:插件保持启用,仅撤下 AI 侧工具与系统提示,让 AI 可改用其它方式操作服务器;人类工作台不受影响。
22
23
  - 真正的退出码和完成边界;终端串行锁、取消、发送前授权复核、结果不明隔离、重复 callId 防重放。
23
24
  - DSH 设置及凭据库、操作记录与导出、恢复上次目标列表。
24
25
 
@@ -104,6 +104,17 @@ AI 正在占用终端时,不把手工输入混入它的协议。点击「停
104
104
 
105
105
  本地 Windows cmd/PowerShell 可以作为人工终端,AI 完成协议会拒绝这类目标。当前交付的原生 PTY 验证在 macOS arm64/Node 24 完成,其它平台需各自安装与运行验收。
106
106
 
107
+ ## 进度与取消
108
+
109
+ AI 调用 zTerm 工具期间,DSH 对话、会话切换和其它面板应保持可用;zTerm 工作台在终端工具栏显示「AI 执行中」,连接过程显示「连接中」。进行中的操作超过 2 秒时会追加已用时,例如「AI 执行中 · 已 5 秒」、「连接中 · 已 12 秒」,随每秒刷新。「记录」面板同时保留一条「执行中」记录,结束后更新为最终状态。
110
+
111
+ 等待期间可以取消:
112
+
113
+ - 工作台:点击工具栏「停止」,中断当前操作并把该目标切回读模式。
114
+ - 对话中:使用 DSH 输入框的停止按钮取消本次工具调用,效果相同。
115
+
116
+ 停止只中断尚未完成的等待,不证明远端进程已经结束,已经下发的命令可能已产生副作用。停止后如果无法确认远端结果,按「手工操作与停止」的「结果不明」流程核实并重建连接,不要自动重试。
117
+
107
118
  ## 记录、导出和恢复
108
119
 
109
120
  点击「记录」查看实际目标、状态、退出码、完成语义、错误和有限输出;可导出 JSON。底部「导出终端」仅导出有界终端缓冲。AI 使用 `zterm_results` 取最近最多 200 条记录,交给其它归档工具。
@@ -127,6 +138,8 @@ AI 正在占用终端时,不把手工输入混入它的协议。点击「停
127
138
 
128
139
  DSH 设置里的「zTerm」可管理命名凭证、选择默认 SSH 私钥凭证,调整本地终端、默认登录账号、宿主默认私钥文件、面板默认宽度、终端数量、写命令预算和超时。本地终端默认关闭,自动目标查找不需要额外开启地址开关。
129
140
 
141
+ 设置页最上方有「临时禁用 zTerm」开关。打开后插件仍保持启用,但 AI 侧不再收到 zTerm 系统提示,模型工具表里也不会出现 `zterm_*` 工具;工作台、手工终端、已有连接和主机/凭据管理不受影响。点击即时生效,无需保存设置,刷新或重启 DSH 后保持,直到手动关闭。它用于让 AI 暂时改用 bash、SSH、JumpServer 等其它方式操作服务器,不再被 zTerm 的提示和工具引导;关闭后工具与提示原样恢复。禁用期间聊天入口显示「AI禁用」,工作台顶部也会提示。
142
+
130
143
  使用本地终端时,勾选「允许打开运行 DSH 的机器上的终端」并保存设置,然后打开 zTerm,点击面板右上方的「打开本机终端」。每次点击都会新建独立终端并切换到对应标签,可重复打开多个,数量受「每会话终端上限」控制。未启用时按钮置灰并提示去设置开启。「本机」指运行 DSH 的机器。
131
144
 
132
145
  升级前由维护者备份 DSH 设置、凭据库和 `$DSH_HOME/zterm/`,安装新的本地包并通过现有方式重载插件。现有连接会释放;模式保持默认读。回退时装回原包并核对数据格式,不自动回滚机器上的实际操作。