前言¶
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
