前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构。当主 Web 界面因插件冲突、客户端补丁损坏而无法打开时，需要一个隔离的环境进行系统修复或基础操作。dsh-safe-tui 旨在提供这样一个环境。
插件定位¶
这是一个 DeepSeek Harness 安全模式 / 修复模式 TUI，也可在 DSH Web 中作为“控制台”Tab 使用。
核心特性包括：
* 环境隔离：不加载任何用户插件，不加载 Web UI。
* 受限交互：交互上只允许官方系统预设：minimal / standard / code / cordis。不发现用户自建预设。
* 历史继承：继承 ~/.dsh/sessions 里的历史会话。
* 文件修复：从内置 pristine 副本自动修复已损坏的官方客户端文件。
定位说明：dsh-safe-tui 是安全模式/修复专用 TUI，不加载用户插件、不加载 Web、只允许官方系统预设，用于主界面打不开时修复系统。它不是日常体验增强型 TUI（例如社区里的 ccch1mneyyy/dsh-TUI），二者定位不同、可以互补。
安装与启用¶
插件本身是自包含的 DSH bundle，包含 agent-presets + safe-tui，无需手动建 profile。
# 从 GitHub 安装并初始化 safe profile
dsh plugin --profile safe add github:aorucshiea/dsh-safe-tui#v0.4.16
之后可以直接运行：
dsh --profile safe
核心功能¶
安全模式 TUI¶
桌面通常会创建两个入口：“DeepSeek Harness Safe Mode”（进入安全终端）和“DeepSeek Harness Repair”（只运行修复脚本，不需要 DSH 启动）。
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.6.0 起，控制台默认继续当前 Web 会话。
* 打开右侧“控制台”面板时会自动附上当前 sessionId，后端以 dsh --profile safe --resume <sessionId> 启动 Safe TUI。
* Web 服务重启后，Safe TUI 由独立的 console-bridge 进程托管，不会跟着 Web 进程一起退出。
* AI 可以通过工具自助穿梭/配置：
* console_status — 查看当前 session / model / preset / cwd。
* console_set_model — 切换当前对话模型。
* console_set_preset — 切换当前对话预设。
* console_handoff — 把当前 Web 会话移交给右侧“控制台”面板。
* console_return — 从 Safe TUI 请求关闭控制台并回到 Web 对话。
常用命令¶
终端命令¶
dsh --profile safe "你的问题" # 一次性问答
dsh --profile safe --list # 列出会话
dsh --profile safe --resume <id> # 恢复指定会话
dsh --profile safe --check # 检查客户端状态
dsh --profile safe --repair # 修复损坏文件
TUI 内部命令¶
/help
/sessions
/sessions all
/new
/preset [minimal|standard|code|cordis]
/models
/models <provider/model>
/providers
/add-provider
/status
/repair
/clean
/check
/quit
注意：
* /clean 会删除所有没有 AI 生成内容的空会话。
* 模型思考与工具调用默认折叠为一行，按 Ctrl+O 可展开/收起全部详情。
* 可以在已有会话中切换 preset（会提示旧工具调用可能不兼容）。
注意事项¶
- 开发阶段：插件仍处于开发阶段，存在 bug，下载后请自行承担风险。
- 权限：插件本身以当前 dsh 进程权限运行。
- 生态背景：DSH 理念是「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
生态与链接¶
- GitHub: https://github.com/aorucshiea/dsh-safe-tui
- 目录: https://www.skillhub.cn/plugins/aorucshiea/dsh-safe-tui
