dsh-zterm 0.1.17 → 0.1.19

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
@@ -74,21 +74,6 @@ npm pack --ignore-scripts --pack-destination "out"
74
74
 
75
75
  `verify` 包含 TypeScript、Vitest、宿主与客户端构建。测试只使用虚构数据、独立临时目录以及测试拥有的回环 HTTP/SSH/PTY,不连接真实机器。SDK 检查使用已安装包创建临时 Cordis 上下文,不启动真实 DSH。
76
76
 
77
- ## 发布
78
-
79
- [deploy.sh](deploy.sh) 沿用 dsh-grafana 的维护者手动发布流程:
80
-
81
- ```sh
82
- ./deploy.sh release # 输入版本号,验证后提交、打标签并推送
83
- ./deploy.sh build # 安装开发依赖、准备原生依赖、验证和编译,打包到 dist/
84
- ./deploy.sh publish # 校验当前版本安装包,发布到 npm 与 GitHub Release
85
- ./deploy.sh all # 依次执行上述三步
86
- ```
87
-
88
- 发布链路默认限 main 分支,凭证和确认提示与来源项目一致。构建保留已有版本产物;分发只使用当前包名与版本对应的归档,并核对包内版本、宿主及客户端 bundle。脚本可从任意目录调用,不安装到 DSH profile,也不重启 Web 或桌面服务。
89
-
90
- `release` 和 `all` 包含 Git 写操作,`publish` 会上传安装包,由维护者本人执行;AI 在本项目的 Git 写禁令仍然有效。
91
-
92
77
  ## 执行和数据边界
93
78
 
94
79
  AI 执行要求空闲 POSIX Shell。每次调用使用独立子 Shell,`cd`/`export` 不改变后续调用的环境。结果不明的操作不会自动重试;核实远端后重建连接。
@@ -45,13 +45,19 @@ DSH 会话标题栏的「zTerm」打开右侧大框。左侧保留 DSH 对话,
45
45
 
46
46
  右侧主机行的「⋯」可编辑,「×」可移除配置;移除配置不改变已经建立的连接。文件夹支持嵌套、新建、改名和调整父节点;移除文件夹前先移出主机和子文件夹。SSH 配置导出不包含秘密。
47
47
 
48
+ 主机直接显示在所属目录下。点击目录名称或箭头可展开、折叠,折叠时一起隐藏子目录与机器;根目录只直接显示未分组主机。可以同时展开多个目录,每个目录独立翻页,每页最多 200 台。新增主机或文件夹默认放入当前选中的目录。搜索覆盖全部已配置主机,在同一滚动区显示匹配结果;清空搜索恢复目录展开状态和原滚动位置。切换来源、刷新列表或暂时收起侧栏,会保留当前工作台中的展开状态。
49
+
50
+ 再次打开同一工作台时,先从浏览器本地快照恢复目录、已浏览的机器分页、来源、实例、展开状态和滚动位置,同时在后台更新可见分支。正常网络下以 3~5 秒内更新为目标;慢请求和更新失败会继续显示原内容,失败时可就地重试。更新过程不清空列表,折叠分支不预取机器。首次使用或缓存不可用时按需加载。
51
+
52
+ 快照按浏览器来源和工作台隔离,最多保留最近三个工作台,每份最多 64 个分页、约 60 万字符,超过 24 小时的快照不恢复。只缓存目录、名称、地址等展示字段,不缓存搜索结果、凭据、连接账号授权或终端内容;编辑前重新读取完整配置,连接仍实时核验。浏览器禁用存储或空间不足时继续使用内存缓存。
53
+
48
54
  点击主机建立连接。首次连接显示 SSH 算法和 SHA256 指纹,需要通过管理员或其它可信渠道核实后选择「仅信任此次连接」或「信任并保存」。已保存指纹变化时连接会被拒绝;核实变更后可清除旧记录,再重新连接并确认。无法核实时取消连接。
49
55
 
50
56
  ## 配置 JumpServer
51
57
 
52
58
  切换到「JumpServer」,点击「+ 实例」。填写服务地址,选择 Access Key、Token 或账号密码。Access Key 的 ID 与 Secret 都进入 DSH 凭据库。
53
59
 
54
- 选择实例后,节点树按需获取。点节点名称筛选其资产,点箭头加载子节点;搜索和翻页只读取当前需要的资产。点资产后选择有连接权限的账号。连接和重连都会重新申请 fresh token,并经过 SSH 网关指纹确认。
60
+ 选择实例后,目录树按需获取。点节点名称或箭头展开后,子节点和机器直接显示在该节点下面;没有子节点的目录也能展开资产。每个目录独立翻页,每页最多 100 台;读取失败时可在对应目录重试。真实目录树排在前面,「全部资产」作为默认折叠的汇总入口放在目录树最后,展开后的机器与分页栏也在目录树下方。搜索覆盖当前实例的全部授权资产,清空后恢复目录视图。不同实例分别保留展开状态;同一资产在多个授权节点中出现时可分别展示,在单个节点内去重。点资产后选择有连接权限的账号。连接和重连都会重新申请 fresh token,并经过 SSH 网关指纹确认。
55
61
 
56
62
  节点路径 `key` 用于查子节点,`nodeId` 用于查节点资产;账号和资产使用稳定 ID。网关账号、密码和 fresh token 仅在宿主连接层处理,不作为模型工具参数。
57
63
 
@@ -98,9 +104,9 @@ DSH 会话标题栏的「zTerm」打开右侧大框。左侧保留 DSH 对话,
98
104
 
99
105
  ## 手工操作与停止
100
106
 
101
- 空闲时可以直接使用终端,复制、粘贴、搜索与常用终端快捷键沿用 xterm。手工输入撤销该目标的读写,并暂停 AI 的后续操作;退出交互程序、确认没有半行命令后,点击「确认空闲 Shell」。该确认不会自动恢复读写。
107
+ 空闲时可以直接使用终端,复制、粘贴与常用终端快捷键沿用 xterm。终端内搜索在 macOS 上用 Cmd+F,Windows/Linux 上用 Ctrl+Shift+F;Ctrl+F 照常发给终端程序(如 less/vim 翻页)。手工输入撤销该目标的读写,并暂停 AI 的后续操作;退出交互程序、确认没有半行命令后,点击「确认空闲 Shell」。该确认不会自动恢复读写。
102
108
 
103
- AI 正在占用终端时,不把手工输入混入它的协议。点击「停止」发出取消并切回读模式;停止不证明远端进程已经结束。如果业务已下发但没有可信完成回执,显示「结果不明」,保留手工终端供核实,禁止继续自动下发。核实远端状态后重新连接,再绑定并保持只读开始。
109
+ AI 正在占用终端时,不把手工输入混入它的协议。点击「停止」发出取消并切回读模式;停止不证明远端进程已经结束。如果业务已下发但没有可信完成回执,显示「结果不明」,保留手工终端供核实,禁止继续自动下发。核实远端状态后在提示条点「重建连接」并确认(或断开后重连),再绑定并保持只读开始。重建会断开当前 Shell,仍在前台运行的命令可能随之终止。
104
110
 
105
111
  本地 Windows cmd/PowerShell 可以作为人工终端,AI 完成协议会拒绝这类目标。当前交付的原生 PTY 验证在 macOS arm64/Node 24 完成,其它平台需各自安装与运行验收。
106
112
 
@@ -113,7 +119,7 @@ AI 调用 zTerm 工具期间,DSH 对话、会话切换和其它面板应保持
113
119
  - 工作台:点击工具栏「停止」,中断当前操作并把该目标切回读模式。
114
120
  - 对话中:使用 DSH 输入框的停止按钮取消本次工具调用,效果相同。
115
121
 
116
- 停止只中断尚未完成的等待,不证明远端进程已经结束,已经下发的命令可能已产生副作用。停止后如果无法确认远端结果,按「手工操作与停止」的「结果不明」流程核实并重建连接,不要自动重试。
122
+ 停止只中断尚未完成的等待,不证明远端进程已经结束,已经下发的命令可能已产生副作用。停止后如果无法确认远端结果,该终端进入「结果不明」隔离态:AI 不再自动下发,人工核实后通过提示条的「重建连接」恢复(需确认,重新绑定仍默认只读),不要自动重试。
117
123
 
118
124
  ## 记录、导出和恢复
119
125