dsh-zterm 0.1.14 → 0.1.16

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
 
@@ -28,6 +28,8 @@ DSH 会话标题栏的「zTerm」打开右侧大框。左侧保留 DSH 对话,
28
28
  - 私钥内容:粘贴私钥,也可以点击「选择私钥文件」直接导入文件,不需要记路径。文件上传到运行 DSH 的机器,私钥内容存入 DSH 凭据库;加密私钥需填写口令。
29
29
  - 私钥文件:填写运行 DSH 的机器上的绝对路径或 `~/` 路径,一次保存后按名称复用。DSH 在远端运行时,这里使用远端文件路径;浏览器的本地文件可通过「私钥内容」导入。
30
30
 
31
+ 私钥内容及宿主文件支持 OpenSSH 私钥、传统 RSA/EC PEM,以及 PKCS#8(`BEGIN PRIVATE KEY`/`BEGIN ENCRYPTED PRIVATE KEY`,支持 RSA、ECDSA P-256/P-384/P-521、Ed25519)。加密密钥填写正确口令;导入完整的单个私钥,公钥、截断或拼接的内容不能使用。PKCS#8 仅在宿主内存中转换为 SSH 可读格式,不改写原文件或凭据。
32
+
31
33
  编辑可以修改名称、类型或内容;密码和私钥内容不会回显,留空保留原值,切换类型时须填写新的内容。口令可明确清除。更新后的凭证在下次连接或重连时生效,已有连接继续运行。保存凭证会刷新列表,并保留其它尚未保存的设置。
32
34
 
33
35
  ## 配置 SSH
@@ -70,6 +72,12 @@ DSH 会话标题栏的「zTerm」打开右侧大框。左侧保留 DSH 对话,
70
72
 
71
73
  读工具由宿主生成固定查询,不接受任意 Shell 命令。它们仍使用登录账号的权限;这不是操作系统级只读沙箱。文件路径不展开 `~`、变量或通配符,拒绝设备、管道和常见凭据文件,能力缺失或读取范围越界会返回失败。
72
74
 
75
+ 凭据保护同时检查目录位置、文件名称/后缀和有界样本中的常见内容类型。私钥即使改成普通文件名,样本中的 PEM/OpenSSH/PGP/PuTTY 私钥格式仍会被拒绝;AWS 凭据赋值、带认证值的 Docker 配置、kubeconfig 结构及含秘密字段的 Google 凭据结构也会被识别。检查在远端同一采样缓冲区输出正文之前完成,拒绝时只返回固定文字,不先把样本送进终端流或操作记录。
76
+
77
+ 文件从末尾读取时,除末尾最多 64 KiB 的返回窗口及边界字节外,还会额外检查前 64 KiB 的凭据类型;前缀只用于检查、不返回。单文件搜索识别到凭据内容时失败;目录搜索跳过已识别文件并报告数量,这些样本仍占最多 100 个文件的检查预算。普通公钥、公开证书和非凭据结构的日志/配置仍可读取。
78
+
79
+ 这是常见类型的有界识别,不是通用秘密扫描器:未采样的中段、自定义或编码后的格式不能保证识别,头尾检查也不是文件快照。人工终端与人类授权的通用执行不属于这层文件读取过滤范围;不要用改名、转码或其它工具绕过凭据拒绝。修复不回溯清洗既有历史或外部日志,若此前实际暴露过真实密钥,应由人类按凭据管理流程轮换。
80
+
73
81
  `zterm_read_context` 是有限终端历史和最近已验证结果,不能冒充实时机器信息。
74
82
 
75
83
  ## 人类开启读写
@@ -119,6 +127,8 @@ AI 正在占用终端时,不把手工输入混入它的协议。点击「停
119
127
 
120
128
  DSH 设置里的「zTerm」可管理命名凭证、选择默认 SSH 私钥凭证,调整本地终端、默认登录账号、宿主默认私钥文件、面板默认宽度、终端数量、写命令预算和超时。本地终端默认关闭,自动目标查找不需要额外开启地址开关。
121
129
 
130
+ 设置页最上方有「临时禁用 zTerm」开关。打开后插件仍保持启用,但 AI 侧不再收到 zTerm 系统提示,模型工具表里也不会出现 `zterm_*` 工具;工作台、手工终端、已有连接和主机/凭据管理不受影响。点击即时生效,无需保存设置,刷新或重启 DSH 后保持,直到手动关闭。它用于让 AI 暂时改用 bash、SSH、JumpServer 等其它方式操作服务器,不再被 zTerm 的提示和工具引导;关闭后工具与提示原样恢复。禁用期间聊天入口显示「AI禁用」,工作台顶部也会提示。
131
+
122
132
  使用本地终端时,勾选「允许打开运行 DSH 的机器上的终端」并保存设置,然后打开 zTerm,点击面板右上方的「打开本机终端」。每次点击都会新建独立终端并切换到对应标签,可重复打开多个,数量受「每会话终端上限」控制。未启用时按钮置灰并提示去设置开启。「本机」指运行 DSH 的机器。
123
133
 
124
134
  升级前由维护者备份 DSH 设置、凭据库和 `$DSH_HOME/zterm/`,安装新的本地包并通过现有方式重载插件。现有连接会释放;模式保持默认读。回退时装回原包并核对数据格式,不自动回滚机器上的实际操作。