DASH — DeepSeek Awesome Harness

DASH 是 DeepSeek Harness 的终端原生前端：同一套「一切皆插件」的 agent 内核与多模型切换能力，跑在你的 shell 里。

dash 是一个挂载在官方 dsh-base 之上的 Cordis 插件（bundle），通过 dsh plugin add 一键安装。DASH = DeepSeek AweSome Harness。

英文版请见 README_EN.md。

为什么是终端？

• 从命令行到编码 agent，只差一次回车。
• 多模型同一会话 —— /model 无需离开 TUI 即可切换 provider。
• 可脚本化、可管道、SSH 下照常可用。

特性

• 全屏 TUI：ANSI Shadow 的 DASH logo、滚动回看（banner、提示、正文、输入框作为同一条内容流滚动）、底部信息栏（cwd (branch) + 累计 token + session id）。
• 多行编辑器：历史、撤销、kill-ring —— Enter 发送，Shift+Enter 换行。
• Markdown 渲染：代码块、列表、行内代码、表格。
• 思考折叠：推理默认隐藏，Ctrl+O 展开为暗色块。
• 工具输出折叠：每个工具结果折叠为一行 ↳ N lines 摘要，Ctrl+T 展开为代码块；错误保持内联。
• 斜杠命令：带搜索框菜单 + accent 高亮。
• 多模型：/model 选择器（共享 llm 目录）。
• API key：/login 通过凭证 seam 存储并激活 provider 路由。
• 工具卡片：参数摘要；输出折叠，展开才显示。
• 会话恢复：/resume 在输入区打开选择器；dsh tui --resume <id> 直接恢复。
• 回滚（时间旅行分叉）：双击 Esc 在输入区打开行为账本——每条用户消息、工具调用、助手回复各一行，带 [user]/[tool]/[assistant] 标识 + turn 号 + 实测时长。选中一行即分叉回该 turn 边界——非破坏性分支，不是 undo 栈。
• 实时工作状态 footer：累计 token · 流式 TPS（64t/s）· 上下文占用预警（≥80% 黄、≥95% 红）· 运行中工具（⚙ 工具名）。
• @ 文件补全：输入 @ + 路径前缀，用 fd/fdfind 模糊补全文件路径。
• 鼠标选择即复制：拖拽选择文本，松开自动复制到剪贴板（OSC 52），双击选词、三击选行、滚轮滚动。

从 dsh 继承了什么

dash 完整复用 dsh-base 插件树——agent 相关的任何东西都没有重写：

• 一切皆插件的内核 —— Cordis 运行时、agent loop、工具注册表、会话日志，全部来自上游。
• 多 provider 的 llm —— /model 在共享 ctx.llm 目录上切换。
• 技能系统 —— skill-filesystem 扫描 ~/.agents/skills 与 <project>/.agents/skills，与 Claude Code / Codex / Grok 共享的技能，dash 的模型经 skill 工具直接可用。
• 工具 —— bash、fs、web、subagent、todo 等原样经 ctx.tools 注册。
• 会话持久化与恢复 —— --resume <id> 与 /resume 恢复持久化会话。
• plan 模式、命令、凭证、设置 —— 宿主 seam 及其 handler。

我们的理解

dash 增加的不是新能力，而是一个新 surface——以及几个我们觉得终端比浏览器表达得更好的想法：

• 终端是 agent 的汇编语言。 dsh 的「一切皆插件」是把 Unix 哲学用在 agent 上；dash 想让组装一个 agent 的感觉，像组装一个 shell 环境。
• 回滚是分叉，不是撤销栈。 双击 Esc 打开行为账本——每条用户消息、工具调用、助手回复各一行。选中一行分叉回该 turn 边界，旧分支（fork 谱系）被保留而非销毁。只有 append-only 的行为日志能表达这一点；纯聊天的 harness 只能回滚消息。
• 行为账本，而不是消息列表。 对齐 web 版 Trajectory 视图：[user] / [tool] / [assistant] 行带 turn 号与实测时长，让插件/工具活动可见。
• 输入框跟随内容流。 没有 dock 固定的输入框——编辑器随历史一起滚走，Claude Code 式。
• 同一色系。 所有品牌相关元素都落在 DeepSeek 靛蓝→天蓝渐变（#4D6BFE → #3982FF → #2498FF）上。

安装

dash 以 dsh bundle 插件的形式安装到官方 dsh CLI 上：

# 1. 安装官方 dsh CLI（已装可跳过）
npm install -g @deepseek-ai/dsh

# 2. 把 dash 插件装入 tui profile（`dsh plugin add` 会自动识别
#    package.json 里的 `dsh.bundle.patch` 并挂进 bundle 层）
dsh plugin --profile tui add @realchenwenqiao/dash

# 3. 启动
dsh --profile tui

npm 发布前，也可从源码运行：

git clone https://github.com/realchenwenqiao/dash.git
cd dash
pnpm install
pnpm run build
pnpm dash tui

需要 Node.js 与 pnpm。退出时用 dash tui --resume <session-id> 恢复（id 会在退出时打印），或在 TUI 内用 /resume。

用法

输入提示词，回车。会话流式输出回复与工具活动，底部信息栏显示累计 ↑ in ↓ out R reasoning、缓存命中率、上下文占用与当前 session id（供 --resume 使用）。

斜杠命令

命令	作用
/model	切换模型——遍历 llm 注册表里每个 provider 的选择器。
/login	为某 provider 添加 API key，激活其路由。
/logout	清除当前 provider 存储的凭证。
/resume	选择已保存会话，在其 workspace 中恢复。
/new	开始全新会话。
/clear	清空正文。
/export	把会话日志导出为 markdown 文件。
/status	显示会话状态（session / cwd / model / plan / token / 账本行数）。
/cost · /tokens	显示 token 用量与缓存命中。
/thinking	切换思考展开/折叠。
/help	显示快捷键与命令清单。
/audit /bug /review /practice /pr_comments /release-notes /vuln-check	技能命令——向模型发送激活提示（随包内置对应 SKILL.md）。
/exit · /quit	退出。
/compact /plan /goal /feedback /permission	宿主命令，与 web UI 共享同一注册表。

快捷键

键	动作
Enter	发送
Shift+Enter / Ctrl+J	换行
↑ / ↓	输入历史
Ctrl+O	展开 / 折叠思考
Ctrl+T	展开 / 折叠工具输出
Shift+Tab	切换 plan 模式
Esc Esc	打开回滚账本（分叉回之前的 turn）
Ctrl+C	取消打开的浮层；无浮层时退出

鼠标：拖拽选择即复制 · 双击选词 · 三击选行 · 滚轮滚动。

色卡

一套靛蓝→天蓝品牌族、一组中性色、三种常规状态色：

角色	出现位置
logo · brand · accent · code	DASH logo、标题、斜杠命令、选中项、行内代码
dim	工具正文、footer、推理
bgQuote	用户消息块（深靛蓝底）
success · warning · error	diff 新增 · 待处理 · diff 删除

生态

dash 是 DeepSeek Harness 插件生态的一员——在 dsh-plugin topic 下浏览所有社区插件，或查看精选清单 awesome-dsh-plugin。

架构

dash 是一个 Cordis bundle——@realchenwenqiao/dash——通过 tui profile 挂载在 dsh-base 之上，与 web、headless bundle 同构。TUI 驱动稳定表面（agents.create / agent.followup / agent.whenIdle / session/event），用 pi-tui 组件渲染。上游保持原样，TUI 只是多了一个 surface。

开发

从 docs/development.md 与 AGENTS.md 开始。

License

MIT。第三方声明：THIRD_PARTY_NOTICES.md。