dsh-safe-tui

仍处于开发阶段，存在bug，下载后，请自行承担风险。

dsh-safe-tui

English

DeepSeek Harness 安全模式 / 修复模式，并可在 DSH Web 中作为“控制台”Tab 使用。

Demo

它是什么

当主 Web UI 因为插件/客户端补丁损坏而无法打开时，用这个独立的终端可以：

• 不加载任何用户插件、不加载 Web UI；
• 不发现用户自建预设（includeUserRoot: false），交互上只允许官方系统预设：minimal / standard / code / cordis；
• 继承 ~/.dsh/sessions 里的历史会话（/sessions）；
• 从内置 pristine 副本自动修复已损坏的官方客户端文件（/repair 或独立 Repair 快捷方式）。

定位区别：dsh-safe-tui 是安全模式/修复专用 TUI，不加载用户插件、不加载 Web、只允许官方系统预设（minimal/standard/code/cordis），用于主界面打不开时修复系统。它不是日常体验增强型 TUI（例如社区里的 ccch1mneyyy/dsh-TUI），二者定位不同、可以互补。

Web 控制台

自 v0.5.0 起，dsh-safe-tui 还提供一个 Web Console 模式：

• 在 DSH Web 的 “对话 | 轨迹 | 控制台” 保留“控制台”Tab；点击后从右侧滑出一个可滚动的控制台面板（类似左侧栏）。
• 面板内是一个真正的 xterm.js 终端，后端通过 node-pty 启动 dsh --profile safe。
• 效果和 PowerShell/终端一致，可以完整使用 Safe TUI 的 /sessions、/new、/preset、/repair 等命令。
• 当 Web 对话因插件错误无法加载时，左侧栏仍可用，可直接切到“控制台”继续操作 DSH。
• Safe TUI 会自动修复因强制中断产生的会话日志 seq 重复问题，恢复后可直接继续历史会话。

同会话穿梭（v0.7.0）

控制台默认继续当前 Web 会话：打开右侧“控制台”面板时会自动附上当前 sessionId，后端以 dsh --profile safe --resume <sessionId> 启动 Safe TUI，因此 Web 和 TUI 看到的是同一条对话。

• Web 服务重启后，Safe TUI 由独立的 console-bridge 进程托管，不会跟着 Web 进程一起退出；浏览器重连后会重放终端滚动缓冲，TUI 保持存活。
• AI 可以通过工具自助穿梭/配置：
  • console_status — 查看当前 session / model / preset / cwd；
  • console_set_model — 切换当前对话模型（Web 侧立即生效，Safe TUI 侧下一步生效并保存默认）；
  • console_set_preset — 切换当前对话预设（Web/TUI 均可带历史警告切换，并同步默认预设）；
  • console_handoff — 把当前 Web 会话移交给右侧“控制台”面板（自动打开面板并 resume 同一 session）；
  • console_return — 从 Safe TUI 请求关闭控制台并回到 Web 对话。
• 控制台面板可关闭；断线后会自动重连。
• 极简 preset 会额外加 agent 级工具掩码，只暴露 pwsh/bash 与 str_replace_editor，与官方极简模式一致。

会话独占锁

Web 与 Safe TUI 是不同进程，而 DSH 的持久化写锁只在单进程内生效。为避免同一会话被两边同时写入导致日志 seq 损坏，本插件在 ~/.dsh/safe-tui/leases/ 维护跨进程租约：

• Web agent 创建时自动持有 web 租约，agent 销毁或 handoff 时释放；
• Safe TUI resume / 发消息前持有 console 租约；Web 未释放时会显示等待提示；
• 进程崩溃后租约通过 PID 存活检查与 heartbeat 超时自动回收。

因此同一会话同一时间只有一个写入方。若控制台一直等待，请让 Web 侧执行 console_handoff 或关闭占用该会话的 Web agent。

使用

桌面已创建两个入口：

• DeepSeek Harness Safe Mode：进入安全终端（现代化全屏 TUI）。
• DeepSeek Harness Repair：只运行修复脚本，不需要 DSH 启动。

也可以手动运行：

deepseek                       :: 直接进入全屏 TUI
dsh --profile safe
dsh --profile safe "你的问题"   :: 一次性问答
dsh --profile safe --list
dsh --profile safe --resume <sessionId>
dsh --profile safe --check
dsh --profile safe --repair
node "%USERPROFILE%\dsh-safe-tui\lib\repair.js" --repair

安全终端内命令：

/help /sessions /sessions all /new /preset [minimal|standard|code|cordis] /models /models <provider/model> /providers /add-provider /status /repair /clean /check /quit

官方系统 preset 的含义：

• minimal — 极简模式：仅持久 bash + str_replace_editor 双工具编码 Agent。

• standard — 标准模式：完整编码 Agent，含文件编辑、Shell、检索、Skills、计划、目标、子代理、工作流。

• code — PTC 模式：标准全部能力 + Code Mode SDK，用 TypeScript 程序组合多步操作。

• cordis — 创造模式：标准全部能力 + 运行时检查、插件实验和 preset 创作指导（可修改/创建 preset）。

• /sessions 采用 OpenCode 风格的 Sessions 选择器：可直接输入过滤，按 Today/Yesterday/日期分组，行尾显示工作区目录，当前会话带 ● 标记；按 Ctrl+X 两次可删除选中会话。

• /clean 或 dsh --profile safe --clean 会删除所有没有 AI 生成内容的空会话。

• 对话生成中按 Ctrl+C 或 Esc 可强制取消当前回合，模型会停止并回到输入状态。

• 在 /preset 选择器中按 i 或 ? 可查看当前高亮预设的详细说明，再按一次收起。

• 输入框为空时，↑ / ↓ 或 PgUp / PgDn 可上下浏览会话历史；输入状态下 ↑ / ↓ 仍为命令历史。

• 模型思考与工具调用默认折叠为一行，按 Ctrl+O 可展开/收起全部详情；鼠标滚轮也可上下滚动历史。

• 可以在已有会话中切换 preset（会提示旧工具调用可能不兼容）。

从插件市场 / GitHub 安装

插件本身是自包含的 DSH bundle，包含 agent-presets + safe-tui，无需手动建 profile：

# 从 GitHub 安装并初始化 safe profile
dsh plugin --profile safe add github:aorucshiea/dsh-safe-tui#v0.7.0

之后可以直接运行：

dsh --profile safe

或者如果 deepseek 命令可用（npm 安装会自动提供，或把仓库里的 deepseek.cmd 复制到 PATH）：

deepseek

deepseek 会直接打开同一个全屏 TUI。

仓库：https://github.com/aorucshiea/dsh-safe-tui

关键文件

• cordis.patch.yml — bundle 补丁，挂载 safe-tui 插件。
• lib/index.js — 交互式/一次性安全终端插件。
• lib/repair.js — 无需 DSH 即可独立运行的修复脚本。
• pristine/ — 从官方 0.1.0-rc.6 提取的原始文件，用于恢复。
• ~/.dsh/profiles/safe/ — 安全 profile，只有 dsh-base + dsh-safe-tui。