dsh-zterm 0.1.16 → 0.1.18

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.
@@ -98,12 +98,23 @@ DSH 会话标题栏的「zTerm」打开右侧大框。左侧保留 DSH 对话,
98
98
 
99
99
  ## 手工操作与停止
100
100
 
101
- 空闲时可以直接使用终端,复制、粘贴、搜索与常用终端快捷键沿用 xterm。手工输入撤销该目标的读写,并暂停 AI 的后续操作;退出交互程序、确认没有半行命令后,点击「确认空闲 Shell」。该确认不会自动恢复读写。
101
+ 空闲时可以直接使用终端,复制、粘贴与常用终端快捷键沿用 xterm。终端内搜索在 macOS 上用 Cmd+F,Windows/Linux 上用 Ctrl+Shift+F;Ctrl+F 照常发给终端程序(如 less/vim 翻页)。手工输入撤销该目标的读写,并暂停 AI 的后续操作;退出交互程序、确认没有半行命令后,点击「确认空闲 Shell」。该确认不会自动恢复读写。
102
102
 
103
- AI 正在占用终端时,不把手工输入混入它的协议。点击「停止」发出取消并切回读模式;停止不证明远端进程已经结束。如果业务已下发但没有可信完成回执,显示「结果不明」,保留手工终端供核实,禁止继续自动下发。核实远端状态后重新连接,再绑定并保持只读开始。
103
+ AI 正在占用终端时,不把手工输入混入它的协议。点击「停止」发出取消并切回读模式;停止不证明远端进程已经结束。如果业务已下发但没有可信完成回执,显示「结果不明」,保留手工终端供核实,禁止继续自动下发。核实远端状态后在提示条点「重建连接」并确认(或断开后重连),再绑定并保持只读开始。重建会断开当前 Shell,仍在前台运行的命令可能随之终止。
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
+ 停止只中断尚未完成的等待,不证明远端进程已经结束,已经下发的命令可能已产生副作用。停止后如果无法确认远端结果,该终端进入「结果不明」隔离态:AI 不再自动下发,人工核实后通过提示条的「重建连接」恢复(需确认,重新绑定仍默认只读),不要自动重试。
117
+
107
118
  ## 记录、导出和恢复
108
119
 
109
120
  点击「记录」查看实际目标、状态、退出码、完成语义、错误和有限输出;可导出 JSON。底部「导出终端」仅导出有界终端缓冲。AI 使用 `zterm_results` 取最近最多 200 条记录,交给其它归档工具。