rocklau/dsh-ui-tool-graph

dsh-ui-tool-graph

为 DeepSeek Harness（dsh）Web UI 提供的工具调用价值图谱标签页插件。

English

智能体的轨迹会把自己的"经济学"埋掉：哪个工具吃掉了墙钟时间、哪里在失败、每轮烧了多少 token、哪些调用一字不差地重复。这个插件在会话视图环中新增 工具图谱（Tool Graph） 标签页，把会话日志折叠成一张带权重的关系图：

- 节点是工具，大小随你选的指标变化（总耗时 / 调用次数 / 错误数），外环 ∝ 失败率；
- 连线是转移，同一轮内相邻的调用组合，粗细 ∝ 转移次数；
- 优化洞察点名首要瓶颈、高失败率工具、完全相同的重复调用、值得批处理的连续自转移、最长的调用间隔等待、输出 token 大户步骤；
- 下一轮引导把这些指标渲染成一份自包含的分析提示词，一键复制，或二次确认后直接作为你的下一条消息排入队列。

全部数据在客户端从持久化会话日志增量折叠——确定性、重放安全、零额外模型调用、零 token 成本。

真实会话中的工具图谱

功能

- 加权径向图 — 节点权重随时切换：总耗时 / 调用次数 / 错误数；连线粗细 ∝ 转移次数。
- 优化洞察 — 规则派生、带严重度的发现：瓶颈占比、高失败率工具、逐字重复（缓存/去重候选）、连续同工具链、模型生成等待、token 大户步骤。
- 工具排名表 — 总耗时 / 平均 / 次数 / 错误；点行或点节点下钻到每次调用的耗时与参数摘要。
- 会话总计条 — 调用、进行中、失败、工具总耗时、最长平均间隔、输出 token。
- 一键引导下一轮 — 复制提示词，或显式二次点击后作为下一条排队消息发送。

安装

从 Release 下载 tarball（无需构建放行）：

dsh plugin --profile web add https://github.com/rocklau/dsh-ui-tool-graph/releases/download/v0.1.2/dsh-ui-tool-graph-0.1.2.tgz

或直接从 git 安装：

dsh plugin --profile web add github:rocklau/dsh-ui-tool-graph

git 安装拉取的是源码，首次 add 时 pnpm 会运行本包的 prepare 构建脚本；按 CLI 提示在 profile 的 pnpm-workspace.yaml 中放行该构建后重跑命令。之后重启 dsh web，每个会话头部都会出现 工具图谱 标签页。

卸载：dsh plugin --profile web remove dsh-ui-tool-graph。

指标口径

| 指标 | 定义 |
| --- | --- |
| 调用时长 | tool/result 时间 − 配对 tool/call 时间（墙钟） |
| 工具总耗时 | 当前窗口内已完成调用时长之和 |
| 失败率 | 该工具错误结果数 ÷ 已完成调用数 |
| 转移边 | 同一 turn 内按日志顺序相邻的调用组合 |
| 平均间隔 | 边上「上次结果 → 下次发起」的均值（主要包含模型生成等待） |
| Token | 最终 assistant/message 携带的 provider 用量，按 step 去重累计 |

视图目标随事件窗口增量折叠（replace/apply），统计范围即历史窗口范围；在轨迹页加载更早的回合即可扩大覆盖。

已知限制

- 嵌套子调用（委派/子代理）只按父结果折叠。
- LLM 与工具的墙钟拆分用调用间隔近似，尚未展示单请求级计时归因。
- 单工具会话只有一个节点、没有连线——这是定义使然。

开发

pnpm install
pnpm typecheck   # tsc --noEmit（strict）
pnpm test        # vitest：折叠一致性、布局纯度、提示词模板、组件行为
pnpm build       # lib/index.js（node 半）+ lib/client.js（浏览器 bundle）
pnpm pack        # 可安装 tarball

本包是 bundle + client 双身份：dsh.bundle 提供 patch 层，dsh.client 声明 web 插件。运行时值导入仅限宿主共享模块表（react/cordis/client-runtime），其余全部打包进产物。

License

MIT