DeepSeek-TUI
UI & ExperienceTheMcSwift/DeepSeek-TUI
dsh --profile tui: terminal interactive client for DeepSeek Harness (out-of-tree profile bundle).
- deepseek
- deepseek-harness
- dsh
- dsh-plugin
- terminal
- tui
README
DeepSeek-TUI
dsh --profile tui：给 DeepSeek Harness（dsh）加上终端聊天界面。安装一个插件，在终端里与智能体持续对话——审查工具执行、随时插话、排队追问，交互体验与官方 web 客户端对齐，但不需要浏览器。
dsh 的 headless 形态适合一次性任务（提交即跑、结果进 stdout）；需要持续会话时，用 dsh --profile tui。
English version · 功能对照清单 FEATURE-CHECKLIST.md · 选择建议见 和其他 dsh 客户端怎么选
特色
与官方 web 同一套智能体：会话记录、设置、权限/计划/工作流插件全部共享——终端里聊的就是 web 里那个智能体，不经过 HTTP 中转，无功能降级。
交互与文案逐项对齐 web：以官方 web 客户端为功能基线，148 项功能逐项对照（覆盖率 ≈ 93%）；双语界面（zh/en）文案逐字复用、视觉配色取自 web 实现，状态区布局同源——终端体验向 web 看齐，而不是另造一套。
渲染与工具执行可视化：流式 Markdown、推理块分级着色、代码高亮、TeX 数学、Mermaid 图；工具执行卡片——终端卡（退出码）、Read 高亮卡、grep/glob 分组卡、web_search 引用卡、run_code 子调用树；产物文件 OSC 8 链接（Cmd 点击打开）。
安装即用，不碰 dsh 本身：以插件形式挂载到 tui profile，不改 dsh 源码、不打依赖补丁；渲染引擎 pi（earendil-works 开源终端 UI 库）以 vendor 快照形式内嵌，版本固定、升级可控。
键盘驱动：Tab 焦点环 + Enter 展开/收起（思考块/工具卡/长消息）；Ctrl+Enter 打断并发送、Shift+Tab 会话模式循环（默认/计划/完全访问）；三套键位预设——Claude Code / pi / OpenCode 风格（/keymap 切换）；/model、/permission 支持枚举选择，也可带参数直接切换；@ 文件引用补全（发送时自动附加内容）、$EDITOR 编辑配置与当前输入、命令别名、OSC 52 复制。
会话级面板：goal / todo / jobs / workflow 运行树（run→member 完整层级）；/status、/tokens、/cost 会话信息；/config 供应商管理（列表 / 添加向导 / $EDITOR 编辑 settings.yaml）。
安装
前置要求：可用的 dsh 环境（Node ≥ 22.19、pnpm）。
# 从 npm 安装（推荐）
dsh plugin --profile tui add @mcswift/dsh-tui
# 本地开发：挂载源码（lib/ 是 profile 的加载入口，改完 pnpm build 生效）
git clone https://github.com/TheMcSwift/DeepSeek-TUI.git
dsh plugin --profile tui add link:/path/to/DeepSeek-TUI
cd DeepSeek-TUI && pnpm install && pnpm build
安装即自带 /tui 操作手册技能（/ 菜单可入、/skills 可见）：由本 bundle 的
cordis.patch.yml 注册进 dsh 技能 registry（custom 源，任意 cwd 可用，随包版本同步）。
快速开始
$ dsh --profile tui # 新会话
$ dsh --profile tui --resume <id> # 恢复指定会话
$ dsh --profile tui -c # 恢复最近会话
$ dsh --profile tui # 默认 regular 渲染：主屏输出留在终端 scrollback（无应用内滚动/鼠标，`[` 导出转录）
$ dsh --profile tui --fullscreen # 切回 alt-screen 视口模式（旧的默认：应用内滚动/鼠标/搜索跳转）
dsh tui — DeepSeek Harness 终端客户端
Esc/Ctrl+C 中断（busy） · Ctrl+C 再按退出（idle） · Ctrl+Enter 打断并发送 · / 斜杠菜单 · Ctrl+/ 命令面板
Ctrl+R 会话 · Ctrl+G 模型 · Ctrl+P 权限预设 · Ctrl+F 搜索 · Ctrl+B 分支 · Ctrl+Y 评分
Ctrl+X 用 $EDITOR 编辑输入 · Ctrl+W 工作区 · Ctrl+T 思考 · Ctrl+K 折叠 · Ctrl+E 退出 plan
Ctrl+O jobs 折叠/展开 · Ctrl+L 轨迹 · Alt+Enter 插话 · Alt+Up 取回队列 · Tab 焦点环/follow-up · Enter 发送（busy=steer）/展开收起
使用
命令
| 命令 | 说明 |
|---|---|
/new /quit /clone /hotkeys(?) | 会话控制 |
/rename <标题> | 固定会话标题（替代自动生成） |
/queue | 查看排队消息：逐项取回或删除 |
/effort /lang /rate /export([md]) | 推理强度 / 语言 / 评分 / 导出会话日志（md=Markdown 分节文件） |
/model [provider/model] | 切换模型：不带参数打开枚举选择，带参数直接切换 |
/permission [预设] | 切换权限预设：不带参数打开枚举选择，带参数直接切换（full-access 有确认） |
/config | 供应商列表 / 添加供应商向导 / 预览与 $EDITOR 编辑 settings.yaml |
/status /tokens /cost /doctor /init /agents /skills | 状态与诊断（notice + Enter 展开全文） |
/mcp /permissions /login /logout /add-dir /hooks /vim /terminal-setup /connect | 策略/平台说明（DSH 能力说明或占位） |
/resume(/r) /rewind /trajectory /settings /plugins /workspace /theme /keymap /preset /compose | 更多 TUI 命令（Ctrl+/ 面板统一浏览；/rewind 回退到一条用户消息：fork 分支 + 原消息回填输入框，空输入双击 Esc 同入口） |
/goal /plan /compact … | profile 注册的命令 |
命令别名：exit→quit · clear→new · ?→hotkeys · r→resume · m→model · perm→permission · language→lang（在斜杠解析链生效，菜单仍显示主名）。
环境变量
| 变量 | 说明 |
|---|---|
DSH_TUI_DEBUG | 1 输出事件/渲染调试日志 |
DSH_TUI_ANIM | 0 冻结品牌 shimmer 与 spinner 动画 |
DSH_TUI_THEME | light/dark/auto（跟随终端背景色） |
DSH_TUI_THEME_PRESET | web/cc/pi/opencode 视觉主题预设（/theme 同功能） |
DSH_TUI_KEYMAP | cc/pi/opencode 键位预设（/keymap 同功能） |
DSH_TUI_LANG | zh/en（/lang 运行时可切换） |
DSH_TUI_ENTER | steer：busy 时按 Enter 直接插话；默认 queue（入队等待） |
DSH_TUI_MOUSE | 1 开启 TUI 内鼠标（选区复制/滚轮滚动消息列表）；默认关闭——右键/滚轮归宿主终端（Warp 原生菜单/scrollback），键盘 PgUp/PgDn 滚动照常 |
DSH_TUI_REGULAR | 1 显式开启 regular 渲染模式（默认即 regular）——主屏输出留在终端 scrollback，[ 可随时导出转录供 Cmd+F 搜索 |
DSH_TUI_FULLSCREEN | 1 切回 fullscreen 视口模式（同 --fullscreen，2026-08-20 前的默认）——应用内滚动/鼠标/搜索跳转 |
DSH_TUI_WARP_NOTIFY | off 关闭 Warp 通知（OSC 777） |
和其他 dsh 客户端怎么选
| 选择 | 适用场景 | 说明 |
|---|---|---|
| 官方 web 客户端 | 浏览器、富交互（图像/拖拽/表单） | 全功能基线 |
| 本 TUI（进程内） | 终端里与 web 同栈同数据 | 同一份会话/设置/插件；必须跑在 dsh 安装的机器上 |
| 远程 HTTP 系 TUI（dsh-tui/dsh-tui、MashedPotato817/dsh-tui 等） | 任意机器连远端 dsh host | 交互风格自成一派，与 web 不同栈；支持 Vim 模态编辑等 |
我们的取舍：本 TUI 只跑在 dsh 安装本机（无远程模式）；pi 版本固定（0.84.1 vendor 快照），上游修复需手动跟进；浏览器能力（图像/拖拽/设置表单）以终端形态降级——图片→占位行、设置页→/config；默认 regular 渲染（输出留在终端回滚），应用内搜索跳转/滚动不可用（可用终端原生 Cmd+F），--fullscreen 切回视口模式。
与 dsh-plugin 生态的 TUI 同行对比（2026-08-26 快照，逐仓库核对 README）
数据源：awesome-dsh-plugin（自动聚合目录）+ 各仓库 README 实测核对。 口径：终端第一形态的 dsh 客户端；Web UI 的内嵌终端面板（
dsh-plugin-terminal类）不在列。
| 项目 | 引擎/技术栈 | 安装方式 | ⭐ | 核心特性 |
|---|---|---|---|---|
| ccch1mneyyy/dsh-TUI | 自研（TS） | dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui（或 npm -g） | 2.5k | 像素鲸顶栏、双流光大字、实时状态行、思考流式展开、双击 Esc 时间回溯、蓝白上下文进度条 + TPS 仪表；官方公众号收录；本仓库差距清单的对标对象 |
| huiliyi37/dsh-tianshu-tui | 自研 ANSI 极简引擎（非 pi/ink） | dsh plugin --profile tui add @huiliyi37/dsh-tianshu-tui（或 github:） | 234 | 图像与视觉桥接、代码智能检索、记忆与跨会话召回、16 内置主题、VS Code 集成、/update 自更新；⚠️ 生态边界（勿与 oh-my-tianshu 生态混装） |
| openma-ai/Martty | Rust 核心（npm 包侧 Node/ACP） | npm i -g martty / npx martty；可选 dsh plugin --profile martty add martty@latest | 60 | DSH-first Agent TUI：Cordis 插件能力（与 DSH 同款）+ ACP（可连其他兼容 agent）；子代理、持久会话 |
| XMoon/dsh-pi-tui | Pi TUI fork（TS） | dsh plugin --profile pi-tui -- add @xmoon76/dsh-pi-tui（独立 bundle，含 fork） | 12 | 流式 Markdown、Thinking 折叠、Tool 卡片、Transcript 全文搜索、长会话历史折叠、Context/Token 显示、Approval/ask_user_question、Plan Review、Subagent、Shell、设置 |
| lk251066/dsh-tui-pro | 自研（TS） | dsh plugin --profile tui add @lk251066/dsh-tui（包拥有插件 + profile 层） | 3 | 多会话终端工作台：durable Assistant + 活跃项目会话切换、transcript-only 滚动、思考/工具/diff/plan/子代理结构化视图 |
| ipromise2021/dsh-omc-tui | 自研（JS/ANSI） | dsh plugin --profile tui add github:ipromise2021/dsh-omc-tui | 2 | 保留终端 Scrollback（不进备用屏幕）；图片无感直贴（Cmd/Ctrl+V 剪贴板、iTerm2 OSC 1337、Kitty 协议）+ 智能视觉子代理自主决策（无需手动切模型/技能）；行内审批、Plan/Jobs、上下文状态栏 |
| kouyichi/dsh-tui-app | Ink（React for CLI） | 手动组装 profile（bundles + patch + 沙箱 + 搜索索引） | 2 | Claude Code 形态 + 品牌鲸鱼；一个终端同时指挥 hermes/claude/codex/dsh 四个 Agent（多代理 hub）；jobs/全文搜索/轨迹回放 |
| xiaoshihou514/dsh-tui | 自研（TS） | dsh plugin --profile tui add "github:xiaoshihou514/dsh-tui#main" | 2 | 真·极简（README：A minimal TUI for DSH） |
| MashedPotato817/dsh-tui | Ink（JS，core 纯 Node 零依赖） | npm i -g dsh-tui（独立客户端，连本机 dsh web host 的 SSE） | 1 | Claude Code 功能 + Vim 三模态（normal/insert/command）+ PTC 模式（dsh code agent preset）+ HUD 状态栏；core/ui 分离（core 可复用） |
| Isanti2016/dsh-console | — | dsh plugin --profile web add dsh-console（web profile） | 1 | 斜杠命令控制台（/web /tunnel /ask）+ /console 控制台 TUI 入口（非终端客户端本体） |
| 本仓库（@mcswift/dsh-tui） | pi-tui vendor（TS） | dsh plugin --profile tui add @mcswift/dsh-tui | 1 | 见「我们 vs 同行」 |
我们 vs 同行：
- 三预设交互宽度（cc/pi/opencode 分别对齐 Claude Code / pi / OpenCode 的键位与语式）+ 五视觉主题预设（web/cc/pi/opencode/ansi）+ 自定义 JSON 主题覆盖——TUI 同行中独有；
- 契约驱动前端纪律：
SessionEvent → fold() → ViewDocument → render单向数据流、fold 纯函数、文档即真相源——417 项无终端单测，每批typecheck + 单测 + 完整 PTY E2E（10 场景）全绿才合入；配套docs/COMMUNITY-COMPARISON.md（功能差距审计）与docs/PLAN-ROADMAP.md（路线图）双文档基线； - 自描述随包：安装即带
/tui操作手册技能（bundle 注册进 dsh 技能 registry，任意 cwd 可用）——同行暂无； - 命令面对齐口径：cc 对齐落在「广义交互层」（键位/投递语义/菜单语式），未做像素级复刻（差距清单见 COMMUNITY-COMPARISON）；
- 已知边界：单机进程内（无远程模式，
dsh webhost 复用型与 MashedPotato817 形态相异）；pi-tui 0.84.1 固定（XMoon 亦 fork，上游修复需手动跟进）；default regular 模式下内容超屏后输入框经 split-footer 恒贴底（chrome 独立于内容流，滚动只携带内容、零重复行）——--fullscreen为 alt-screen 贴底模式（滚动隔离更彻底，可用[导出转录到 scrollback）。
给开发者
数据流：SessionEvent → fold() → ViewDocument → app.render() 单向流转；fold() 是纯函数（无 cordis/pi 依赖），每个新事件类型在 tests/projection.spec.ts 补回归。
out-of-tree 约束：cordis.patch.yml 是必填声明（缺失直接报错）；insert 行只能引用 dsh 安装已携带的插件。更多见 DESIGN.md §10 与 ARCHITECTURE.md。
pnpm typecheck # 严格类型检查
pnpm test # vitest 单测（395 项）
pnpm build # tsc 构建到 lib/
python3 scripts/e2e-pty.py # 9 场景 PTY 端到端（真实 dsh + mock LLM）
python3 scripts/e2e-pty.py --only-questions # 单场景
文档导航
| 文档 | 内容 |
|---|---|
| ARCHITECTURE.md | 总体结构：模块职责、边界与依赖方向 |
| DESIGN.md | 设计契约与实施修订史（§10 out-of-tree 约束） |
| FEATURE-CHECKLIST.md | dsh web 功能对齐基线（148 项逐包审计） |
| GAP-ANALYSIS.md · PI-GAP-ANALYSIS.md | 基线差距审计 |
| COMMUNITY-COMPARISON.md | 与社区 ccch1mneyyy/dsh-TUI 的完整功能对比报告（2026-08-20） |
| BACKLOG-FEATURE-GAP.md · BACKLOG-CC-PARITY.md · BACKLOG-CC-VISUAL-PARITY.md | 对比报告拆解的实现清单：功能差距（Part A）+ cc 预设交互对齐（Part B）+ cc 预设视觉对齐（Part C） |
| BOUNDARY-DESIGN.md | 能力边界判定：TUI 本分留内部 / 越权增强独立（含已完成功能回审） |
| PLAN-ROADMAP.md · PLAN-BUNDLED-SKILL.md · DESIGN-ATTACHMENTS.md | 未动工 backlog 全量实现规划（6 阶段）· tui 手册技能随插件注册专项 · B4 图片附件专项设计（实现押后） |
| INTERACTION-PLAN.md | 交互规划与批次 |
| CONTRIBUTING.md | 贡献指南（提交 trailer 约定） |
| LICENSE | MIT |
致谢
本项目完全由 dsh 与 DeepSeek 模型编写：规划、实现、评审与文档均由 dsh 驱动的 deepseek-v4-pro 会话完成（每笔提交带 Assisted-by: dsh trailer）。
灵感来源：官方 web 客户端（功能基线、文案与设计 token）、pi（渲染引擎）、Claude Code / pi 交互风格、社区 ccch1mneyyy/dsh-TUI（品牌区设计：像素鲸 + 渐变 DEEPSEEK 字标 + 探索未至之境！）。