dsh-tianshu-tui

把 DeepSeek Harness 变成完整、流畅的终端编程工作区。

中文 · English

dsh-tianshu-tui 是官方 DeepSeek Harness 的交互式终端 UI 插件。自研轻量 ANSI 渲染引擎，提供流式 Markdown、工具卡、会话恢复与回退、图片与视觉桥、LSP 诊断、16 个主题，以及完整的 slash 命令和快捷键体系。

它是一个纯展示层插件：agent 状态来自会话事件流，不另建一套 agent 循环，也不向模型偷偷注入 prompt 或工具。

核心体验

快速开始

环境要求

请显式使用宿主 @next。 不要用宿主 @latest 代替（当前为 0.2.1-rc.2，低于要求）；@alpha 的 0.2.2-alpha.2 存在已知 API 不兼容，暂不支持。本包也不是可独立运行的 CLI。

一键安装（推荐）

脚本会检查 Node/pnpm、安装官方 CLI、装配插件并启动：

# macOS / Linux
bash <(curl -fsSL https://raw.githubusercontent.com/huiliyi37/dsh-tianshu-tui/main/scripts/install-tui.sh)

# Windows PowerShell
powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/huiliyi37/dsh-tianshu-tui/main/scripts/install-tui.ps1 | iex"

只安装、不启动：macOS/Linux 在命令末尾加 --no-launch；Windows 克隆仓库后运行 powershell -ExecutionPolicy Bypass -File scripts\install-tui.ps1 -NoLaunch。

手动安装

# 1. 将插件装入独立的 tui profile
pnpm dlx @deepseek-ai/dsh@next plugin --profile tui add @huiliyi37/dsh-tianshu-tui

# 2. 启动
pnpm dlx @deepseek-ai/dsh@next --profile tui

首次启动后按引导配置 API Key，或输入 /key。看到 dsh-tianshu-tui 欢迎页即安装成功；按 Ctrl+Q 或输入 /exit 退出。

如果旧全局 dsh 导致 ERR_FS_EISDIR，或 npm 11 安装大型依赖树时发生 OOM，请改用上面的 pnpm dlx 命令。更多安装与排障方式见快速开始文档。

常用操作

常用命令

快捷键

完整命令、审批操作、Vim 键位和终端协议说明见交互手册。

更新

从 npm 安装的插件会在启动时检查更新；也可以在 TUI 中输入 /update 手动检查。设置 DSH_TUI_SKIP_UPDATE=1 可关闭启动检查。

pnpm dlx @deepseek-ai/dsh@next plugin --profile tui add @huiliyi37/dsh-tianshu-tui

当前版本：1.0.0-rc.4，适配宿主 0.2.1-rc.4。本版修复 #61：WSL/原生粘贴 API Key、供应商目录与账号入口，并新增自定义 pi-ai 端点、模型发现和已有路由编辑。版本历史见 CHANGELOG.md，TUI 内可输入 /changelog 查看。

文档

设计原则

• 事件驱动：所有渲染状态派生自会话事件流，恢复与实时显示走同一套转录桥。
• 不越过展示层边界：不注册自有 prompt、工具或上下文面，不直接改写 agent 请求体。
• 明确降级：宿主可选服务缺失时，对应面板会说明原因，不静默空白，也不阻塞启动。
• 终端友好：支持窄屏、16 色与 NO_COLOR，并针对中文宽字符、长输出和流式刷新优化。

实现细节与边界约束见架构文档和 ADAPTER.md。

已知限制

• ask_image 图片再询问需要同仓伴生插件 vision-ask；基础图片提交与视觉桥不依赖它。
• LSP server 采用懒启动；大型仓库可能常驻较多内存，切换会话时 rootUri 仍沿用首个会话目录。
• 上游 schedule 依赖 Web sessionController，当前 TUI 未挂载该工具面。
• 0.2.2-alpha.2 的模型选择与预设 API 已发生变化，完成专项适配前请停留在宿主 0.2.1-rc.4。

参与贡献

欢迎提交 Issue 和 PR。开始前请阅读贡献指南，改动后运行：

npm run typecheck
npm test
npm run build

官网与社区

社区生态

许可与来源

基于 Apache-2.0 开源。终端渲染引擎从作者的天枢 Tianshu-harness 演进而来；逐文件来源与修改声明见 SOURCE-MAP.md 和 NOTICE。