仍处于开发阶段，存在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 启动 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
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 /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。
仓库：
关键文件
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。
