dsh-better-tool-ui

Readme

# dsh-better-tool-ui

DeepSeek Harness（DSH）web 插件：把模型输出的**工具调用卡片**、**MCP 调用**和 **thinking 行**渲染成紧凑的时间线——左侧贯通色轨、行内图标 + 工具名 + 中文描述 + 参数摘要、GitHub PR 风格的代码变更视图，goal 工具渲染成 callout 色块。

> 本包早期叫 `dsh-hebbian-rows`，v2 起更名为 `dsh-better-tool-ui`（渲染范围已经不止最初那套行样式）。

## 安装

```bash
curl -fsSL https://raw.githubusercontent.com/GeekRicardo/dsh-better-tool-ui/main/install.sh | bash
```

装完**重启 dsh web 并硬刷新**（Cmd/Ctrl+Shift+R）生效。

先看效果再决定（不写任何文件）：

```bash
curl -fsSL https://raw.githubusercontent.com/GeekRicardo/dsh-better-tool-ui/main/install.sh | bash -s -- --dry-run
```

## 渲染覆盖

**内置工具行**（`tool.call.toolview` 按名接管，28 个 key）：

| 工具 | 行摘要 | 展开详情 |
| --- | --- | --- |
| bash / pwsh | 命令全文 | 深色终端块（`$ 命令` + 尾部输出 + 退出码/信号条），图标沿用 DSH 自带的那枚（`IconApiOutline14`） |
| read | 相对路径 `:#起-止` | 行号代码块 |
| write / edit | 文件名 | GitHub 风 diff（文件名头 + 徽标 + +N−M + 行号 + 整行红绿底色） |
| grep / glob | pattern | 按文件分组的匹配 / 路径列表 |
| web_search / web_fetch | query / url | 引用列表 / 正文回放 |
| todo_write | `N 项 · X 完成 · Y 进行中` | 勾选清单 |
| job_output 等 job 系列 | job_id | 终端块 + `[status:]` 彩色状态条 |
| subagent / send_message 等 | description / 目标 id | 输入输出回放 |
| str_replace_editor | 路径（+view_range） | view→内容回放；create/insert→纯新增视图；str_replace→diff 视图 |
| skill | 技能名 | 内容回放 |
| workflow / subagent 系列 | description | 输入输出回放 |
| ask_user_question | 首个问题的 header/正文（多问题时 `N 问`） | 分页问题面板：每页一个问题，选项列表按 DSH composer 同款标注选择（单选数字序号 / 多选 checkbox 勾选），自定义文本单独成行；多个问题在同一面板翻页 |

**MCP 工具行**（`mcp__<server>__<tool>`）：

- 行首是 MCP 官方标志（simple-icons 的 `modelcontextprotocol` 路径），标题是去掉服务器前缀的工具名（`mcp__dsh__dsh_status` → `status`），紧跟一枚服务器 chip（`dsh`），摘要按 `url / query / path / name …` 的顺序取第一个命中的主参数，都没有就退回 `第一个标量参数=值`。
- 展开后分「参数 / 结果」两段：参数排成 key/value 网格（对象与数组折进 pretty JSON 小块），结果按内容分流——合法 JSON 走轻着色（键/字符串/数字/字面量分色），host 端丢弃字节后留下的 `[image: …]` `[audio: …]` `[resource: …]` 占位行收成 chip，其余按纯文本回放。
- 调用失败时结果段让位给统一的红色错误块（错误名 · code + 正文），不重复渲染同一段文字。

> MCP 的公开名由用户装了哪些服务器决定，插件里无从枚举，而 keyed 槽位按精确 key 派发。所以插件订阅 `ctx.sessions` 的会话快照，扫出出现过的调用名后即时补注册，并把认领过的名字存进 `localStorage`，下次启动先行注册——首次遇到某个工具时可能闪一帧出厂卡片，之后不会。

**subagent / workflow 内部的工具**：DSH 的 `ToolCallTree` 会把一次调用的 `subCalls` 递归展开成同级兄弟节点，每个子调用**单独**过一次 `tool.call.toolview` 派发——所以子调用本来就会落到本插件的行上。麻烦在于名字：子调用带的是**驱动那一侧**的工具名，例如 `claude-in-dsh` 驱动时是 `Bash` / `Read` / `TodoWrite` / `Task` 这种大驼峰，而 keyed 槽位按精确 key 派发，这些名字过去全部落到出厂通用卡片。现在两头都补上了：

- **名字归一**：渲染分派统一先过 `canonicalName()`——大驼峰拆成蛇形小写，再走一张别名表（`Task`/`Agent` → `subagent`，`MultiEdit` → `edit`，`BashOutput` → `job_output`，`SlashCommand` → `skill` …）。同一个工具无论出现在哪一层，都落到同一套图标 / 描述 / 摘要 / 详情渲染。
- **补位认领**：会话快照里出现过的**所有**工具名都会被认领（不再只认 `mcp__` 开头的），但注册用的是**正的 priority**，只补位、不抢占。DSH 出厂的通用卡片是槽位的 fallback、不占 key，所以无主的名字归本插件；而 DSH 的专用视图、以及别的插件（例如 `claude-in-dsh` 给 `Task` / `Agent` / `Workflow` 注册的行）都在 priority 0，照旧胜出。

> 本插件不自绘子调用树——那是 DSH 已经在做的事，插件再画一遍就是同一棵树渲染两遍。样式表里只对 `[data-subcalls]` 容器做缩进对齐。

**goal 系列**：`create_goal` 蓝 / `get_goal` 灰 / `update_goal`（complete 绿、blocked 红、pause 黄）callout 色块，直接嵌入消息流。

**ask_user_question**：把 `questions[]`（`id` / `question` / `header` / `options` / `multi_select`）渲染成分页问题面板——每页一个问题，选项列表按答案 `answers[]`（按 `id` 对回，`selected` 是选中的 label 数组）标注用户的选择，视觉对齐 DSH 原生 composer：单选数字序号、多选 checkbox 勾选，选中的选项行以原生高亮（浅灰背景 + 描边），`(Recommended)` / `（推荐）` 后缀拆成 badge，`custom` 自由文本单独成行。多个问题在同一面板内翻页（`‹ 1 / N ›`），未回答显示「未回答」，等待回答期间显示「等待回答…」。

**thinking 行**：紫色轨（`#8c93f8`）+ 与工具行统一的 12px 网格、图标位对齐。

**流式工具行**（`conversation.chat.streamingCall` 按名接管，含已认领的 MCP 名）：write/edit 等大参数工具在参数流式生成期间，**消息流里**（正式卡片将要落地的位置）出现一行「生成中… + 目标 + 已生成字符数」，展开显示实时内容尾部；参数流完、正式卡片物化后自动让位。该座位由 DSH 原生提供，未被本插件接管的工具名走 DSH 自带的原生流式行。

> **旧版 DSH 兼容**：`conversation.chat.streamingCall` 是较新的 DSH 才声明的座位（0.1.0-rc.5 及更早没有）。没有它的版本上，同一行改从 `conversation.input.dock` 出场——渲染在输入框上方，内容与逻辑完全一致，只是位置不同。两种形态由座位是否声明仲裁：座位在，dock 行让位；座位不在，dock 行顶上，所以任何一个版本上都只会有一行预览。

**bash 展开的最短停留**：running 的 bash 行自动展开看实时输出，完成后自动收回。亚秒级命令会让这一展一收变成一次闪烁，所以自动展开至少停留 **2 秒**再收。这只推迟折叠——左侧色轨的蓝（运行中）→ 绿（完成）仍按真实完成时刻变色，两者互不影响。

**间距**：连续工具行 / think 步骤之间 2px 等距贴合（负 margin 抵消聊天列 16px gap），含正文段落的消息不受影响。

**色轨语义**：绿 `#34d59a` 完成 / 蓝 `#3dbbf5` 运行中（呼吸动画）/ 红 `#ee5858` 错误或非零退出码。

## 卸载

```bash
cd ~/.dsh/profiles/web
node -e '
const fs = require("fs");
const p = "package.json";
const j = JSON.parse(fs.readFileSync(p, "utf8"));
delete (j.dependencies || {})["dsh-better-tool-ui"];
const b = j.dsh?.profile?.bundles ?? [];
j.dsh.profile.bundles = b.filter((x) => x !== "dsh-better-tool-ui");
fs.writeFileSync(p, JSON.stringify(j, null, 2) + "\n");
'
pnpm install
```

重启 dsh web 后恢复出厂渲染。

## 工作原理

DSH web 的 profile（`~/.dsh/profiles/web`）在 boot 时按 `package.json` 的 `dsh.profile.bundles` 顺序加载 bundle 包；本包的 `cordis.patch.yml` 往 host composition 插入一行插件，web 端按 `package.json` 的 `dsh.client` 拉取 `lib/client.js` 执行。插件本体只做四件事：

1. 往 keyed 槽位 `tool.call.toolview` 注册同名 key，**遮蔽**出厂工具卡片（停止插件即恢复，不动出厂代码）；
2. 往 keyed 槽位 `conversation.chat.streamingCall` 注册同一套 key 接管流式预览行，并在没有该座位的旧版 DSH 上退回 `conversation.input.dock`；
3. 从会话快照里发现运行期才知道的工具名（MCP 名、子调用里的驱动侧名字）并**补位**注册上述槽位；
4. 注入一段样式表，把 DSH 原生 thinking 行（`[data-variant="think"]`）与节点间距调整到统一网格。

全部颜色走 DSH 主题 token（`--dsw-alias-*`），明暗主题自动跟随。

## 开发

```
lib/client.js     web 端全部渲染逻辑（ModuleLoader 工厂格式，无构建步骤）
lib/index.js      host 侧空挂载点（本插件无 host 能力）
cordis.patch.yml  bundle 挂载补丁（插入插件行）
dsh.plugin.json   插件清单
install.sh        curl|bash 安装器（幂等改写 profile package.json + pnpm install）
scripts/build-dynamic.mjs  由 lib/client.js 生成动态插件形态（沙盒里免装即改即试）
```

改动后：升 `package.json` 与 `dsh.plugin.json` 的 version → push → 使用侧 `cd ~/.dsh/profiles/web && pnpm up dsh-better-tool-ui` → 重启 dsh web。

## License

MIT