@openguardrails/dsh-tui

English | 中文

DeepSeek Harness 智能体的交互式终端（TUI）入口——在终端里获得 Claude Code / Codex 同款的对话体验，以树外（out-of-tree）dsh 插件 bundle 的形式安装。基于 @earendil-works/pi-tui 构建。

它组合在官方 @deepseek-ai/dsh-base bundle 之上，与官方 web 界面共享同一套插件生态——shell 与文件系统工具、技能、子代理、工作流、沙箱审批——不 fork、不魔改。

功能

• 模型输出与思考过程的流式 Markdown 渲染
• 工具调用卡片（terminal / diff / generic 三种渲染意图）；Ctrl+O 三档切换：预览 → 展开 → 隐藏
• 工具审批与 ask_user_question 对话框，含 plan 模式评审
• @文件 路径自动补全与 @session 会话引用卡片
• 斜杠命令：/model（含推理力度选择）、/resume、/compact、/details、/help，以及其他插件注册的全部命令
• 常驻 todo 面板、token 用量与上下文压力状态栏、会话标题
• 可配置主题；从 COLORTERM 自动检测真彩色

安装

需要 Node ^22.19 || >=24 和 dsh CLI（npm i -g @deepseek-ai/dsh@next）。

dsh plugin --profile tui add @openguardrails/dsh-tui
dsh --profile tui                                      # 在当前目录开启会话
dsh --profile tui --resume                 # 恢复历史会话

想跟踪仓库最新代码而非 npm 发布版，用 add github:openguardrails/dsh-tui。git 安装的插件在安装时通过 prepare 脚本构建，pnpm 默认拦截构建脚本：若该 add 失败，按它打印的键名在 ~/.dsh/profiles/tui/pnpm-workspace.yaml 里追加 allowBuilds 后重跑——

allowBuilds:
  "@openguardrails/dsh-tui": true

在环境变量（或启动目录 / $DSH_HOME 下的 .env）里设置 DEEPSEEK_API_KEY。

本地 / 自部署 DeepSeek 端点

零代码配置，三选一：

1. 环境变量：DEEPSEEK_BASE_URL=http://localhost:8000/v1 搭配 DEEPSEEK_API_KEY。

2. 设置文件（热加载）：$DSH_HOME/settings.yaml

   llm-deepseek:
     baseURL: http://localhost:8000/v1
   

3. （vLLM、SGLang 等）：在 profile 补丁（）里声明一个 路由并把默认模型指过去——参见 dsh 的 providers 指南。