dsh-tool-cost-hint

Tool Cost Hint

不告诉你花了多少钱，只告诉你每个工具往你的上下文里塞了多少东西。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:qiyuexue-xiyu/dsh-tool-cost-hint#3fc67cbc66260801136ea38bc10be36072dc1c6e

兼容性与来源证明

Tool Cost Hint 以 dsh-tool-cost-hint 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: github
Registry 更新时间: 2026/10/18

版本

0.2.0stable

2026/10/18

DeepSeek Harness Plugin Hub

← Plugins

dsh-tool-cost-hint

Tool Cost Hint

不告诉你花了多少钱，只告诉你每个工具往你的上下文里塞了多少东西。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:qiyuexue-xiyu/dsh-tool-cost-hint#3fc67cbc66260801136ea38bc10be36072dc1c6e

README

dsh-tool-cost-hint

不告诉你花了多少钱，只告诉你每个工具往你的上下文里塞了多少东西。

纯被动观察插件：不注册工具、不往模型上下文写任何东西、不 append 任何 session 事件。它只监听 session/event，在每轮结束时整理出"这一轮谁调了哪些工具、各几次、各自注入多少 token"。

当前范围：host 面（记账）+ client 面（对话流内一行可折叠提示，conversation.chat.turnTail）。 host 面归因口径与第一轮完全一致，第二轮只新增了"把已有折叠结果送到浏览器"的通道和渲染层，没有改动任何计数逻辑。

⚠️ 安装前必读（桌面版用户）

DSH 桌面版（Electron）的 desktop profile 被主进程独占，dsh plugin 命令对它是只读的：

$ dsh plugin --profile desktop add file:.../dsh-tool-cost-hint-0.2.0.tgz
error: profile "desktop" is managed exclusively by the Electron application

这不是权限问题、也不是命令写错，而是设计如此——桌面端的 profile 由 Electron 应用自己管理。 所以如果你的 DSH 是桌面版，安装本插件的唯一方法就是手动改配置文件，dsh plugin add 永远会失败。

桌面版手动安装（三步）

设你的用户目录为 %USERPROFILE%（即 C:\Users\<你的用户名>），插件包放在任意位置，例如 C:\Users\you\Downloads\dsh-tool-cost-hint-0.2.0.tgz。

第 1 步：把包装进 profile。 打开命令行，在 %USERPROFILE%\.dsh\profiles\desktop\ 里执行（这一步只是解包，不会触发 Electron 限制）：

npm install "C:\Users\you\Downloads\dsh-tool-cost-hint-0.2.0.tgz"
# 或者用 pnpm（DSH 自带）：pnpm add "C:\Users\you\Downloads\dsh-tool-cost-hint-0.2.0.tgz"

装完应该出现 %USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-tool-cost-hint\dist\index.js。（如果想直接链接源码目录调试，改用 npm install "file:C:/path/to/dsh-tool-cost-hint"，或在 node_modules 里建一个指向源码目录的 Junction。）

第 2 步：改 %USERPROFILE%\.dsh\profiles\desktop\package.json。 用记事本打开，改两处：

{
  "dependencies": {
    // ……原有的依赖都保留，只追加下面这一行……
    "dsh-tool-cost-hint": "file:C:/Users/you/Downloads/dsh-tool-cost-hint-0.2.0.tgz"
  },
  "dsh": {
    "profile": {
      "bundles": [
        // ……原有的 bundle 都保留，数组末尾追加下面这一项……
        "dsh-tool-cost-hint"
      ]
    }
  }
}

两处都要改，缺一不可：

dependencies 让它能被 require 解析到（路径写成 file: + 正斜杠，或 link: 指向源码目录）；
dsh.profile.bundles 数组末尾的 "dsh-tool-cost-hint" 才是真正让它被加载的开关。写进 bundles 后，loader 会自动套用它自带的 cordis.patch.yml 把 tool-cost-hint 这行插进组合。

改之前建议先备份 package.json。注意 JSON 不允许注释，上面代码块里的 // 只是说明，别抄进文件。

第 3 步：完全退出 DSH 进程再重开（不是关窗口；插件在启动时组合，托盘退出或任务管理器结束进程都行）。

验证装好了没有

重开后随便发一轮用到工具的消息（比如让它读个文件），回复底部操作栏上方会出现一行：

🛠 read ×1 · pwsh ×2 · ≈3.4K tok

点它展开：逐行的 工具名 / ×次数 / 输入 / 输出，末行 注入量 ≈Z tok。没有这一行就是没装上，按顺序查：

%USERPROFILE%\.dsh\profiles\desktop\package.json 里两处都改了吗？（最常见的原因就是只改了 dependencies 忘了 dependencies 之外的 bundles）
node_modules\dsh-tool-cost-hint\dist\index.js 存在吗？
重启时是不是只关了窗口、进程还活着？

非桌面版（dsh web / dsh tui 命令行启动）不受影响，可以直接 dsh plugin --profile <profile> add file:<tgz 路径>，无需手改 JSON。

0. 怎么把插件发给别人

最简单的办法：直接发这个固定下载链接。

https://github.com/qiyuexue-xiyu/dsh-tool-cost-hint/releases/latest/download/dsh-tool-cost-hint-0.2.0.tgz

这个链接指向带着预构建 dist/ 的 tarball，永远指向最新 Release，不会失效。对方下载后一条命令装好（命令行版）：

dsh plugin --profile web add ./dsh-tool-cost-hint-0.2.0.tgz

桌面版看本文件开头的「⚠️ 安装前必读」——dsh plugin 对 desktop profile 一定会失败，必须手改 package.json。

当前 Release：https://github.com/qiyuexue-xiyu/dsh-tool-cost-hint/releases/tag/v0.2.0

注意：本仓库的网页地址本身不是一个可以直接安装的地址。

# ❌ 这些都不行（网页地址不是安装源）
dsh plugin add https://github.com/qiyuexue-xiyu/dsh-tool-cost-hint

DSH 的安装来源只有三种（官方文档）：

来源	命令形态	能不能用在本插件
npm 包名	`dsh plugin --profile web add <包名>`	暂不可用——还没发布到 npm registry
GitHub 源码	`dsh plugin --profile web add github:qiyuexue-xiyu/dsh-tool-cost-hint`	可用，但拉的是源码，对方要能连 GitHub 且本机得有构建工具链
Release / 本地 tarball	`dsh plugin --profile web add ./x.tgz`	可用且最省事，`dist/` 已经打包在里面

注意：github: 源拉的是源码而不是构建产物（dist/ 不进 git）。对方装完如果没有构建产物，插件加载会失败。想省掉这一步就用 Release 里的 tarball（路线 A）。

路线 A：发 tarball 文件（现在就能用，推荐）

推荐直接发 Release 链接，不用自己打包：

https://github.com/qiyuexue-xiyu/dsh-tool-cost-hint/releases/latest/download/dsh-tool-cost-hint-0.2.0.tgz

也可以自己打包后发文件（dist/ 必须先构建好，见第 8 节）：

npm run build
pnpm pack        # 或 npm pack，产出 dsh-tool-cost-hint-0.2.0.tgz

把 dsh-tool-cost-hint-0.2.0.tgz（约 32 KB）通过微信 / 网盘 / 邮件发给对方，对方执行：

# 非桌面版
dsh plugin --profile web add ./dsh-tool-cost-hint-0.2.0.tgz

桌面版按本文件开头的「⚠️ 安装前必读」手改 package.json（dsh plugin 对 desktop profile 永远会失败）。

安全提示：对方用非官方渠道拿到的文件时，先核对 sha256 再装（Windows）：

certutil -hashfile dsh-tool-cost-hint-0.2.0.tgz SHA256

v0.2.0 的期望值：73190410b86206af6e4b5785dec006f2ca59a7c6ce8c97b637607285fb19cba6

路线 B：发布到 npm registry（之后就能"一个包名直接装"）

发布后对方只需要：

dsh plugin --profile web add dsh-tool-cost-hint

需要的东西：

一个 npm 账号（https://www.npmjs.com/signup），本机 npm login；
npm publish（包名 dsh-tool-cost-hint 目前未被占用，已确认 registry 返回 404）；
之后每次更新 npm version patch && npm publish。

这是唯一能做到"我发个名字，对方一条命令装好"的路线。注意 dist/ 必须在发布前构建好——包里的 files 白名单要求 dist/ 存在（见第 8 节）。

路线 C：进 DSH Plugin Hub 插件市场（覆盖面最大）

DSH Plugin Hub（dsh-plugin 包，装完在「设置 → 插件市场」）靠爬虫自动收录，收录条件写得很明确：

GitHub 公开仓库 + 仓库 Topics 加 dsh-plugin（爬虫只认 GitHub）；
README 含可复制的安装命令（本文件已有）；
导出 apply(ctx)（本插件已导出）。

仓库已经是 GitHub 公开仓库，剩下的就是给仓库加 dsh-plugin topic，然后到 https://dsh-plugin.org/zh/submit 提交。

三条路怎么选

只想给一两个朋友试：路线 A，一分钟搞定；
想让人一条命令装、且能持续更新：路线 B（需要 npm 账号）；
想被更多人搜到：路线 C（仓库已满足条件，去提交即可）。

补充：部分 DSH 版本的客户端界面上有「添加插件」输入框，可以填包名 / GitHub 仓库地址 / 本地目录路径。填 GitHub 地址时拉的是源码（可能需要本机构建）；填本地 .tgz 的完整路径最稳，因为 dist/ 已经打包好了。

1. 文件清单

dsh-tool-cost-hint/
├─ package.json          # dsh.bundle + dsh.client 声明 + 依赖
├─ cordis.patch.yml      # 组合插入行（同时可用作 --patch 覆盖）
├─ tsconfig.json         # 只做类型检查（noEmit），产物交给 tsdown
├─ tsdown.config.ts      # 构建 host 入口 → dist/index.js
├─ tsdown.client.config.ts # 构建 client 入口 → dist/client.js（包 __ModuleLoader__ 壳）
├─ README.md
└─ src/
   ├─ index.ts           # apply()：监听、记账、轮末折叠、emit
   ├─ events.ts          # 纯函数：事件读取/校验 + token 定价
   ├─ types.ts           # host 对外契约：ToolUsage / TurnToolUsageSummary / Config
   ├─ contract.ts        # host↔client 共享的形状：投影 key + ToolCostHintView
   ├─ wire.ts            # 投影定义：同一套折叠逻辑 + wire.view（浏览器数据通道）
   └─ client/
      ├─ index.tsx       # 折叠条组件 + slot 注册 + 惰性降级
      ├─ style.ts        # 内联 CSS 字符串（client 产物必须自包含）
      └─ types.ts        # client 侧结构类型（不依赖 Harness Client 包）

2. 归因口径（本插件唯一的"技术核心"）

字段	含义	来源
`inputTokens`	该工具调用侧注入量：本轮 tool/call 事件里 tool-call 块的（工具名 + 参数 JSON）token	`estimate`（官方公式）
`outputTokens`	该工具结果侧注入量：tool/result 追加进模型可见 surface 的那条 tool 消息的 token	`meter` 优先，`estimate` 回退
`injectedTokens`	前两者之和，UI 上展示的就是这个数，标签为"注入量"	派生

为什么叫"注入量"而不是"花费量"：

provider 只报整轮的 usage（uncachedInput / cacheRead / output …），没有任何 per-tool 计费数据；
命中缓存后，"注入 3000 token"和"花了 3000 token 的钱"是两件事。
因此本插件不引入任何价格换算、不显示金额；计价留给 dsh-bill 这类插件，两边口径不重叠。

为什么 inputTokens 只能是估算：

tool/call 不是 surface 事件（模型可见 surface 只有 system/developer/user/assistant 消息和 tool/result），它在 ctx.tokenMeter.measure() 里没有独立节点，拿不到官方数字；
但 tool-call 块确实会进入下一次请求，必须算进去；
于是用 token meter 自己的定价公式（estimate.js 的 tool-call 分支）： ceil(name.length/4) + ceil(arguments.length/4) + 4，并不计 block.id（上游也不计，计了就对不上）。

结论：这不是"重算一个已有的数"，而是"补一个框架没有单独露出来的数"，且公式与框架逐字一致。数据结构里用 inputTokensSource / outputTokensSource 显式标出来源，UI 上可以区分"计量"与"估算"。

3. 事件时机（为什么等 `turn/end`）

事件	到达时做什么	为什么
`turn/start`	建本轮累加器	拿到 `startedSeq` / `startedAt`，用于时长与定位
`tool/call`	`calls += 1`，累加 `inputTokens`，登记待配对调用	O(1)，参数已在事件里，不需要任何服务
`tool/result`	配对 `callId`，累加 `errors`，只记 seq + 一个估算数字	不缓存结果正文：工具结果动辄几十 KB，长会话里留在插件内存里既浪费又长期驻留
`turn/end`	调一次 `ctx.tokenMeter.measure()`，用节点 tokens 覆盖估算值，折叠成摘要，emit	`measure()` 是 O(surface) 的整表快照，只能一轮一次；此时本轮所有结果都已落地，数据到了终态

未配对情况都显式记录，不静默吞掉：

unattributedCalls：发了 tool/call 但没等到 tool/result（中断/仍在跑）→ outputTokens 记 0，calls 与 inputTokens 照算；
orphanResults：收到 tool/result 但没有配对调用（插件中途加载、框架补写恢复结果）→ 归到合成桶 (unattributed)，结果 token 照算。

4. 推送接口设计（三层，第三层第二轮已落地）

三层，边界很清楚：

内存态（host 内部）：WeakMap<Session, SessionBook>，SessionBook.turns: Map<turn, TurnAccumulator> 就是需求里的 Map<turnId, ToolUsage[]> 进行中形态；轮次结束后折叠成 SessionBook.summaries: TurnToolUsageSummary[]（按 config.keepTurns 环形裁剪）。
进程内事件总线（本轮交付）： ctx.emit('tool-cost-hint/summary', summary)，payload 类型 TurnToolUsageSummary。 host 侧任何插件可 ctx.on('tool-cost-hint/summary', ...) 消费。
到浏览器的通道（第二轮已实现第 1 条）：
- host 投影 + wire.view：src/wire.ts 把同一套折叠逻辑注册成 toolCostHint 投影，在 definition 上声明 wire.view，值算好后框架直接送到 client 尾页，client 不自己折事件（官方推荐路线，见 §6）；
- 自注册 HTTP 路由 + client 侧 fetch：billion-context 就是这么做的（/bili/origin）。本插件不需要—— 投影已经能自动复用尾页携带、checkpoint 和重连重建。

明确不能用的路径：自定义 session 事件。会话日志的读者只容忍信封带 ignorable: true 的未知类型，而 live append() 无法设置该标记 —— 一旦往日志里塞自定义 type，这个会话之后就打不开了。同理，普通插件也无法把自定义 Cordis 事件加进 API gateway 的转发白名单，所以第 2 层到不了浏览器。

摘要 JSON 形状（`TurnToolUsageSummary`）

{
  "version": 1,
  "sessionId": "session-3",
  "turn": 7,
  "startedSeq": 120,
  "endedSeq": 148,
  "durationMs": 41230,
  "reason": "completed",
  "tools": [
    { "name": "read", "calls": 4, "errors": 0, "inputTokens": 96,
      "outputTokens": 8120, "injectedTokens": 8216,
      "inputTokensSource": "estimate", "outputTokensSource": "meter" }
  ],
  "totalCalls": 4,
  "totalErrors": 0,
  "totalInputTokens": 96,
  "totalOutputTokens": 8120,
  "totalInjectedTokens": 8216,
  "unattributedCalls": 0,
  "orphanResults": 0
}

排序固定：injectedTokens 降序 → calls 降序 → name 升序（同一轮数据永远同样顺序，UI 与日志可复现）。

5. Host 侧验证步骤

5.0 构建

cd <repo>\dsh-tool-cost-hint
pnpm install     # devDependencies 里的 @deepseek-ai/* 是"仅类型"依赖，只用于 tsc
pnpm typecheck   # 可选：tsc --noEmit
pnpm build       # 产物 dist/index.js + dist/index.d.ts

@deepseek-ai/cordis、@deepseek-ai/dsh-session 只用于类型检查，运行时不 import 它们（它们躺在 DSH 的 app.asar 里，从 profile 目录根本解析不到）。运行时唯一依赖是 @deepseek-ai/schemastery（Config schema）。

5.1 让 `name` 可解析

loader 是按 profile 的 node_modules 解析 cordis.patch.yml 里的 name 的。所以先把包挂进 profile：

# 把 <你的 profile 名> 换成实际名字；desktop 见文首「安装前必读」
dsh plugin --profile <你的 profile 名> add file:<本插件目录的绝对路径>

（dsh plugin --profile <name> <pnpm-args...> 会把参数转给 pnpm。也可以自己 pnpm add file:...。）

5.2 先看组合结果（不启动，最快的排错手段）

dsh --profile <你的 profile 名> --dump-config --patch <本插件目录>/cordis.patch.yml

输出里应当出现一行 id: tool-cost-hint / name: dsh-tool-cost-hint，并带上 config。 没有这一行 = patch 没被读到，此时不要继续往下试。

5.3 启动并观察

--patch <path> 是 launcher 级参数，语义是"在 profile 层之后再叠一层 patch"，可重复，且是单值收集器（不是变长参数，别把 app 参数紧跟在它后面）：

dsh --profile <你的 profile 名> --patch <本插件目录>/cordis.patch.yml

验证时把 patch 里的 logToConsole 改成 true（或临时用一个只覆盖 config 的 patch 文件）。

启动成功的标志（stderr）：

[tool-cost-hint] armed (attribution v1, keepTurns=20, emitEvent=true)

然后在会话里跑几个会用工具的任务，每轮结束后 stderr 会出现：

[tool-cost-hint] {"version":1,"sessionId":"...","turn":1,...,"tools":[...]}

没有 armed 行 → patch 没生效，回到 5.2；
有 armed 但没有摘要行 → 那一轮没有工具调用（纯对话轮次不产出摘要），或 tool/call / tool/result 没走到本插件（检查是否有别的插件把行 disabled 了）。

5.4 验证计数与 token 是否可信

调用次数：摘要里某工具的 calls 应等于该轮 assistant 实际发出的工具调用数（含被中断的那些）。
结果侧 token：totalOutputTokens 应能与上下文面板 / ctx.tokenMeter.measure() 的对应 tool/result 节点 tokens 对上（因为就是同一来源）。任何 outputTokensSource: "estimate" 的工具说明该轮 meter 不可用或节点缺失，这种数字只能当量级参考。
失败/中断：故意中断一轮（工具还在跑就结束），检查 unattributedCalls > 0 且该轮仍有摘要产出。
中途加载：在已有会话里热重载插件，检查 orphanResults 是否正确反映了"只看得到结果"的情况。

5.5 验证"零侵入"

session 日志里不应出现任何新的事件 type（grep tool-cost-hint <session.jsonl> 应为空）；
系统提示、工具列表、模型可见消息不应有任何变化；
关掉 emitEvent 后，插件仍然算数，只是不通知任何人。

5.6 client 联调（浏览器侧）

产物存在：dist/client.js 开头必须是 window.__ModuleLoader__.load({ id: "dsh-tool-cost-hint", factory: … })。如果不是这个形状，说明 tsdown.client.config.ts 里的包装插件没生效，浏览器会直接报加载失败。
投影注册上了：host stderr 不应出现 sessionProjections is unavailable；在 devtools 里 useProjection("toolCostHint") 的返回值形如 { v: 1, turns: [{ turn, tools: [...] }] }。
条目挂上了：在一轮的 turn-tail 节点（[data-turn-tail]）内部应当能看到一行 🛠 …；没有的话先看 console 有没有 [tool-cost-hint] 开头的警告——所有失败路径都只警告、不抛错。
点开对比：展开态里各工具的 输入/输出 与 host stderr 里同一轮的 inputTokens/outputTokens 必须逐字一致（同一套 estimate 函数算出来的，差一位就说明两边取的不是同一批事件）。

6. client 面：挂哪里、怎么拿到数据、怎么降级

6.1 为什么挂在 `conversation.chat.turnTail`

DSH 的"轮末"是两个 slot，都在 turn-tail 节点里、渲染在自底向上那一行操作区：

slot	谁声明的	条目拿到的 props	适不适合
`conversation.chat.turnTail`	ui-chat 的 `conversation.chat.node`（`key: "turn-tail"` 的 children）	`{ turn, seq, openFile }`	用了这个：能拿到 `turn`，可按轮取值；位置就在操作栏那一行
`conversation.chat.assistant-actions`	同上（children）	`{ messageId }`	不合适：在 hover 才显现的图标条里，塞不进多行折叠内容，也拿不到 turn

turn-tail 的渲染顺序是 [turnTail, MessageIconActions(extraActions=assistantActions, usageAction=…)]，我们把一行折叠条注册进 turnTail，视觉上就贴在原生底部操作栏的位置，不用自己写定位。

没有用 data-* 钩子去定位官方 DOM：读别的插件的 DOM/样式是官方明令禁止的，而且官方结构一变就碎； slot 本来就是"已经留好空位"的正规接入点（turn-tail 节点上的 data-turn-tail="<turn>" 只用于你在 devtools 里核对）。

6.2 数据怎么来：投影 `wire.view`，不是事件

client 侧的 useProjection("toolCostHint") 读的是 host 注册的 session 投影（src/wire.ts）：

不能用自定义 Cordis 事件：API gateway 的转发白名单是构建期写死的，第三方插件加不进去；
更不能往 session 里 append 自定义事件：未知 type 没有 ignorable 标记，会让会话之后打不开；
投影的 wire.view 是唯一"算好再送到浏览器"的正规通道，还顺带白拿尾页携带、checkpoint 和重连重建。

src/wire.ts 的 fold() 刻意不用 ctx.tokenMeter.measure()：投影必须能从日志纯折叠重建，不能依赖某个服务在某一刻的整表快照。对 append 型的 tool/result，meter 节点的定价函数就是 estimateMessage，和我们这里调的是同一个函数、同一个数（第二轮已用断言脚本核对过）。

6.3 惰性降级（探测不到就什么都不做）

情况	行为
`ctx.slots` 服务不存在	`apply` 直接 return，只在 stderr 打一行 `[tool-cost-hint] slots service is unavailable`
slot 名不存在（ui-chat 没装/改名）	`slots.inject(name, …)` 的回调永远不会被调用；不报错、不重试、不查询 DOM
投影没注册成功（`sessionProjections` 缺失）	host 侧打一行警告并跳过注册；client 的 `useProjection` 拿到 `undefined/{}`
该轮没有数据（纯对话轮、或插件是中途加进来的历史轮）	`pickTurn()` 返回 `undefined` → 组件 `return null`，不占位、不留空行
视图形状不对（版本不匹配/字段缺失）	同上，形状校验不过就当没有数据，绝不抛错把会话渲染带崩

所有注册都走 ctx.effect() / slots.inject()，卸载即清理：<style> 标签会被移除，slot 条目会被摘掉。

6.4 视觉

折叠态一行：🛠 read ×2 · edit ×1 · ≈1.2K tok
展开态逐行：工具名 / ×N（失败时带 !N）/ 输入 X / 输出 Y，末行 注入量 ≈Z
全部颜色继承 currentColor + opacity，字号 var(--dsh-font-size-1, 12px)，数字 tabular-nums；没有硬编码颜色，所以亮/暗主题自动跟随，不写主题分支。
合计文案走 locale 字典（zh/en），用的是**"注入量"**，不是"花费"或"金额"。

7. 与需求的两处偏差（都是有意为之）

dsh.client 在第二轮才声明。 宿主会按 dsh.client 去扫描并物化客户端产物，产物缺失会明确导致激活失败（不是静默跳过），所以第一轮（只有 host 面）声明它就是主动制造启动故障。第二轮既然真的产出了 dist/client.js，就一并声明了："client": { "platform": "web", "immediately": true }。 immediately: true 的含义是"应用启动即加载"，而不是等某个 slot 被渲染才惰性加载—— 因为我们的条目要挂到每轮的 turn-tail 上，越早注册越不会漏掉首轮。
cordis.patch.yml 的双重身份。 它既是 dsh.bundle.patch 指向的 bundle 补丁文件（被列进 profile 的 dsh.profile.bundles 后自动生效），也可以直接作为 --patch 的覆盖文件（同一份 YAML 数组格式）。两种用法语义完全一致，所以不需要两份文件。

8. 分发（打包给另一台机器）

# 在本插件目录里（先确认 dist/ 是新的：npm run build）
npm install          # 首次、或换了机器之后
npm run build        # 产出 dist/index.js + dist/client.js
npm pack             # 产出 dsh-tool-cost-hint-0.2.0.tgz

files 白名单只放 8 个文件：package.json、README.md、cordis.patch.yml、 dist/index.js、dist/index.d.ts、dist/client.js、locale/zh.json、locale/en.json。 node_modules/、src/、test/、各种 ts 配置、lockfile 都不会进包（.gitignore 只影响 git，files 才决定包里有什么）。 dist/index.js.map 也不再进包（tsdown.config.ts 里 sourcemap: false，那个 map 有 70 KB，比 host 产物本身还大）。

另一台机器上（目标 profile 不是 desktop 时）：

dsh plugin --profile <profile> add file:C:/path/to/dsh-tool-cost-hint-0.2.0.tgz

装完确认两件事：package.json 的 dsh.profile.bundles 里出现了 dsh-tool-cost-hint； dsh --profile <profile> --dump-config 里有 - id: tool-cost-hint。然后重启 DSH。

desktop profile 见本文开头的「安装前必读」——dsh plugin add 会直接被拒，只能手改配置文件。

9. 下一轮（不在本轮范围）

客户端 bundle 的构建目前依赖 tsdown 的 outExtensions + 一个内联 renderChunk 包装插件；若你的 tsdown 版本不吃这两个选项，退回"手写 dist/client.js"（官方 decoration 模板就是手写的， window.__ModuleLoader__.load({ id, factory }) 的壳见 tsdown.client.config.ts 顶部注释）。
回看更早的轮次：投影已经按 keepTurns 保留了最近 N 轮，若要"整段会话汇总"，扩视图即可，不用改折叠。
跨会话持久化（如果需要）：投影缓存 + checkpoint，而不是自己写盘。

兼容性与来源证明

Tool Cost Hint 以 dsh-tool-cost-hint 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: github
Registry 更新时间: 2026/10/18

版本

0.2.0stable

2026/10/18

README

dsh-tool-cost-hint

不告诉你花了多少钱，只告诉你每个工具往你的上下文里塞了多少东西。

⚠️ 安装前必读（桌面版用户）

DSH 桌面版（Electron）的 desktop profile 被主进程独占，dsh plugin 命令对它是只读的：

$ dsh plugin --profile desktop add file:.../dsh-tool-cost-hint-0.2.0.tgz
error: profile "desktop" is managed exclusively by the Electron application

桌面版手动安装（三步）

设你的用户目录为 %USERPROFILE%（即 C:\Users\<你的用户名>），插件包放在任意位置，例如 C:\Users\you\Downloads\dsh-tool-cost-hint-0.2.0.tgz。

第 1 步：把包装进 profile。 打开命令行，在 %USERPROFILE%\.dsh\profiles\desktop\ 里执行（这一步只是解包，不会触发 Electron 限制）：

npm install "C:\Users\you\Downloads\dsh-tool-cost-hint-0.2.0.tgz"
# 或者用 pnpm（DSH 自带）：pnpm add "C:\Users\you\Downloads\dsh-tool-cost-hint-0.2.0.tgz"

第 2 步：改 %USERPROFILE%\.dsh\profiles\desktop\package.json。 用记事本打开，改两处：

{
  "dependencies": {
    // ……原有的依赖都保留，只追加下面这一行……
    "dsh-tool-cost-hint": "file:C:/Users/you/Downloads/dsh-tool-cost-hint-0.2.0.tgz"
  },
  "dsh": {
    "profile": {
      "bundles": [
        // ……原有的 bundle 都保留，数组末尾追加下面这一项……
        "dsh-tool-cost-hint"
      ]
    }
  }
}

两处都要改，缺一不可：

dependencies 让它能被 require 解析到（路径写成 file: + 正斜杠，或 link: 指向源码目录）；
dsh.profile.bundles 数组末尾的 "dsh-tool-cost-hint" 才是真正让它被加载的开关。写进 bundles 后，loader 会自动套用它自带的 cordis.patch.yml 把 tool-cost-hint 这行插进组合。

改之前建议先备份 package.json。注意 JSON 不允许注释，上面代码块里的 // 只是说明，别抄进文件。

第 3 步：完全退出 DSH 进程再重开（不是关窗口；插件在启动时组合，托盘退出或任务管理器结束进程都行）。

验证装好了没有

重开后随便发一轮用到工具的消息（比如让它读个文件），回复底部操作栏上方会出现一行：

🛠 read ×1 · pwsh ×2 · ≈3.4K tok

点它展开：逐行的 工具名 / ×次数 / 输入 / 输出，末行 注入量 ≈Z tok。没有这一行就是没装上，按顺序查：

%USERPROFILE%\.dsh\profiles\desktop\package.json 里两处都改了吗？（最常见的原因就是只改了 dependencies 忘了 dependencies 之外的 bundles）
node_modules\dsh-tool-cost-hint\dist\index.js 存在吗？
重启时是不是只关了窗口、进程还活着？

非桌面版（dsh web / dsh tui 命令行启动）不受影响，可以直接 dsh plugin --profile <profile> add file:<tgz 路径>，无需手改 JSON。

0. 怎么把插件发给别人

最简单的办法：直接发这个固定下载链接。

https://github.com/qiyuexue-xiyu/dsh-tool-cost-hint/releases/latest/download/dsh-tool-cost-hint-0.2.0.tgz

这个链接指向带着预构建 dist/ 的 tarball，永远指向最新 Release，不会失效。对方下载后一条命令装好（命令行版）：

dsh plugin --profile web add ./dsh-tool-cost-hint-0.2.0.tgz

桌面版看本文件开头的「⚠️ 安装前必读」——dsh plugin 对 desktop profile 一定会失败，必须手改 package.json。

当前 Release：https://github.com/qiyuexue-xiyu/dsh-tool-cost-hint/releases/tag/v0.2.0

注意：本仓库的网页地址本身不是一个可以直接安装的地址。

# ❌ 这些都不行（网页地址不是安装源）
dsh plugin add https://github.com/qiyuexue-xiyu/dsh-tool-cost-hint

DSH 的安装来源只有三种（官方文档）：

来源	命令形态	能不能用在本插件
npm 包名	`dsh plugin --profile web add <包名>`	暂不可用——还没发布到 npm registry
GitHub 源码	`dsh plugin --profile web add github:qiyuexue-xiyu/dsh-tool-cost-hint`	可用，但拉的是源码，对方要能连 GitHub 且本机得有构建工具链
Release / 本地 tarball	`dsh plugin --profile web add ./x.tgz`	可用且最省事，`dist/` 已经打包在里面

注意：github: 源拉的是源码而不是构建产物（dist/ 不进 git）。对方装完如果没有构建产物，插件加载会失败。想省掉这一步就用 Release 里的 tarball（路线 A）。

路线 A：发 tarball 文件（现在就能用，推荐）

推荐直接发 Release 链接，不用自己打包：

https://github.com/qiyuexue-xiyu/dsh-tool-cost-hint/releases/latest/download/dsh-tool-cost-hint-0.2.0.tgz

也可以自己打包后发文件（dist/ 必须先构建好，见第 8 节）：

npm run build
pnpm pack        # 或 npm pack，产出 dsh-tool-cost-hint-0.2.0.tgz

把 dsh-tool-cost-hint-0.2.0.tgz（约 32 KB）通过微信 / 网盘 / 邮件发给对方，对方执行：

# 非桌面版
dsh plugin --profile web add ./dsh-tool-cost-hint-0.2.0.tgz

桌面版按本文件开头的「⚠️ 安装前必读」手改 package.json（dsh plugin 对 desktop profile 永远会失败）。

安全提示：对方用非官方渠道拿到的文件时，先核对 sha256 再装（Windows）：

certutil -hashfile dsh-tool-cost-hint-0.2.0.tgz SHA256

v0.2.0 的期望值：73190410b86206af6e4b5785dec006f2ca59a7c6ce8c97b637607285fb19cba6

路线 B：发布到 npm registry（之后就能"一个包名直接装"）

发布后对方只需要：

dsh plugin --profile web add dsh-tool-cost-hint

需要的东西：

一个 npm 账号（https://www.npmjs.com/signup），本机 npm login；
npm publish（包名 dsh-tool-cost-hint 目前未被占用，已确认 registry 返回 404）；
之后每次更新 npm version patch && npm publish。

这是唯一能做到"我发个名字，对方一条命令装好"的路线。注意 dist/ 必须在发布前构建好——包里的 files 白名单要求 dist/ 存在（见第 8 节）。

路线 C：进 DSH Plugin Hub 插件市场（覆盖面最大）

DSH Plugin Hub（dsh-plugin 包，装完在「设置 → 插件市场」）靠爬虫自动收录，收录条件写得很明确：

GitHub 公开仓库 + 仓库 Topics 加 dsh-plugin（爬虫只认 GitHub）；
README 含可复制的安装命令（本文件已有）；
导出 apply(ctx)（本插件已导出）。

仓库已经是 GitHub 公开仓库，剩下的就是给仓库加 dsh-plugin topic，然后到 https://dsh-plugin.org/zh/submit 提交。

三条路怎么选

只想给一两个朋友试：路线 A，一分钟搞定；
想让人一条命令装、且能持续更新：路线 B（需要 npm 账号）；
想被更多人搜到：路线 C（仓库已满足条件，去提交即可）。

补充：部分 DSH 版本的客户端界面上有「添加插件」输入框，可以填包名 / GitHub 仓库地址 / 本地目录路径。填 GitHub 地址时拉的是源码（可能需要本机构建）；填本地 .tgz 的完整路径最稳，因为 dist/ 已经打包好了。

1. 文件清单

dsh-tool-cost-hint/
├─ package.json          # dsh.bundle + dsh.client 声明 + 依赖
├─ cordis.patch.yml      # 组合插入行（同时可用作 --patch 覆盖）
├─ tsconfig.json         # 只做类型检查（noEmit），产物交给 tsdown
├─ tsdown.config.ts      # 构建 host 入口 → dist/index.js
├─ tsdown.client.config.ts # 构建 client 入口 → dist/client.js（包 __ModuleLoader__ 壳）
├─ README.md
└─ src/
   ├─ index.ts           # apply()：监听、记账、轮末折叠、emit
   ├─ events.ts          # 纯函数：事件读取/校验 + token 定价
   ├─ types.ts           # host 对外契约：ToolUsage / TurnToolUsageSummary / Config
   ├─ contract.ts        # host↔client 共享的形状：投影 key + ToolCostHintView
   ├─ wire.ts            # 投影定义：同一套折叠逻辑 + wire.view（浏览器数据通道）
   └─ client/
      ├─ index.tsx       # 折叠条组件 + slot 注册 + 惰性降级
      ├─ style.ts        # 内联 CSS 字符串（client 产物必须自包含）
      └─ types.ts        # client 侧结构类型（不依赖 Harness Client 包）

2. 归因口径（本插件唯一的"技术核心"）

字段	含义	来源
`inputTokens`	该工具调用侧注入量：本轮 tool/call 事件里 tool-call 块的（工具名 + 参数 JSON）token	`estimate`（官方公式）
`outputTokens`	该工具结果侧注入量：tool/result 追加进模型可见 surface 的那条 tool 消息的 token	`meter` 优先，`estimate` 回退
`injectedTokens`	前两者之和，UI 上展示的就是这个数，标签为"注入量"	派生

为什么叫"注入量"而不是"花费量"：

provider 只报整轮的 usage（uncachedInput / cacheRead / output …），没有任何 per-tool 计费数据；
命中缓存后，"注入 3000 token"和"花了 3000 token 的钱"是两件事。
因此本插件不引入任何价格换算、不显示金额；计价留给 dsh-bill 这类插件，两边口径不重叠。

为什么 inputTokens 只能是估算：

tool/call 不是 surface 事件（模型可见 surface 只有 system/developer/user/assistant 消息和 tool/result），它在 ctx.tokenMeter.measure() 里没有独立节点，拿不到官方数字；
但 tool-call 块确实会进入下一次请求，必须算进去；
于是用 token meter 自己的定价公式（estimate.js 的 tool-call 分支）： ceil(name.length/4) + ceil(arguments.length/4) + 4，并不计 block.id（上游也不计，计了就对不上）。

结论：这不是"重算一个已有的数"，而是"补一个框架没有单独露出来的数"，且公式与框架逐字一致。数据结构里用 inputTokensSource / outputTokensSource 显式标出来源，UI 上可以区分"计量"与"估算"。

3. 事件时机（为什么等 `turn/end`）

事件	到达时做什么	为什么
`turn/start`	建本轮累加器	拿到 `startedSeq` / `startedAt`，用于时长与定位
`tool/call`	`calls += 1`，累加 `inputTokens`，登记待配对调用	O(1)，参数已在事件里，不需要任何服务
`tool/result`	配对 `callId`，累加 `errors`，只记 seq + 一个估算数字	不缓存结果正文：工具结果动辄几十 KB，长会话里留在插件内存里既浪费又长期驻留
`turn/end`	调一次 `ctx.tokenMeter.measure()`，用节点 tokens 覆盖估算值，折叠成摘要，emit	`measure()` 是 O(surface) 的整表快照，只能一轮一次；此时本轮所有结果都已落地，数据到了终态

未配对情况都显式记录，不静默吞掉：

unattributedCalls：发了 tool/call 但没等到 tool/result（中断/仍在跑）→ outputTokens 记 0，calls 与 inputTokens 照算；
orphanResults：收到 tool/result 但没有配对调用（插件中途加载、框架补写恢复结果）→ 归到合成桶 (unattributed)，结果 token 照算。

4. 推送接口设计（三层，第三层第二轮已落地）

三层，边界很清楚：

内存态（host 内部）：WeakMap<Session, SessionBook>，SessionBook.turns: Map<turn, TurnAccumulator> 就是需求里的 Map<turnId, ToolUsage[]> 进行中形态；轮次结束后折叠成 SessionBook.summaries: TurnToolUsageSummary[]（按 config.keepTurns 环形裁剪）。
进程内事件总线（本轮交付）： ctx.emit('tool-cost-hint/summary', summary)，payload 类型 TurnToolUsageSummary。 host 侧任何插件可 ctx.on('tool-cost-hint/summary', ...) 消费。
到浏览器的通道（第二轮已实现第 1 条）：
- host 投影 + wire.view：src/wire.ts 把同一套折叠逻辑注册成 toolCostHint 投影，在 definition 上声明 wire.view，值算好后框架直接送到 client 尾页，client 不自己折事件（官方推荐路线，见 §6）；
- 自注册 HTTP 路由 + client 侧 fetch：billion-context 就是这么做的（/bili/origin）。本插件不需要—— 投影已经能自动复用尾页携带、checkpoint 和重连重建。

摘要 JSON 形状（`TurnToolUsageSummary`）

{
  "version": 1,
  "sessionId": "session-3",
  "turn": 7,
  "startedSeq": 120,
  "endedSeq": 148,
  "durationMs": 41230,
  "reason": "completed",
  "tools": [
    { "name": "read", "calls": 4, "errors": 0, "inputTokens": 96,
      "outputTokens": 8120, "injectedTokens": 8216,
      "inputTokensSource": "estimate", "outputTokensSource": "meter" }
  ],
  "totalCalls": 4,
  "totalErrors": 0,
  "totalInputTokens": 96,
  "totalOutputTokens": 8120,
  "totalInjectedTokens": 8216,
  "unattributedCalls": 0,
  "orphanResults": 0
}

排序固定：injectedTokens 降序 → calls 降序 → name 升序（同一轮数据永远同样顺序，UI 与日志可复现）。

5. Host 侧验证步骤

5.0 构建

cd <repo>\dsh-tool-cost-hint
pnpm install     # devDependencies 里的 @deepseek-ai/* 是"仅类型"依赖，只用于 tsc
pnpm typecheck   # 可选：tsc --noEmit
pnpm build       # 产物 dist/index.js + dist/index.d.ts

@deepseek-ai/cordis、@deepseek-ai/dsh-session 只用于类型检查，运行时不 import 它们（它们躺在 DSH 的 app.asar 里，从 profile 目录根本解析不到）。运行时唯一依赖是 @deepseek-ai/schemastery（Config schema）。

5.1 让 `name` 可解析

loader 是按 profile 的 node_modules 解析 cordis.patch.yml 里的 name 的。所以先把包挂进 profile：

# 把 <你的 profile 名> 换成实际名字；desktop 见文首「安装前必读」
dsh plugin --profile <你的 profile 名> add file:<本插件目录的绝对路径>

（dsh plugin --profile <name> <pnpm-args...> 会把参数转给 pnpm。也可以自己 pnpm add file:...。）

5.2 先看组合结果（不启动，最快的排错手段）

dsh --profile <你的 profile 名> --dump-config --patch <本插件目录>/cordis.patch.yml

输出里应当出现一行 id: tool-cost-hint / name: dsh-tool-cost-hint，并带上 config。 没有这一行 = patch 没被读到，此时不要继续往下试。

5.3 启动并观察

--patch <path> 是 launcher 级参数，语义是"在 profile 层之后再叠一层 patch"，可重复，且是单值收集器（不是变长参数，别把 app 参数紧跟在它后面）：

dsh --profile <你的 profile 名> --patch <本插件目录>/cordis.patch.yml

验证时把 patch 里的 logToConsole 改成 true（或临时用一个只覆盖 config 的 patch 文件）。

启动成功的标志（stderr）：

[tool-cost-hint] armed (attribution v1, keepTurns=20, emitEvent=true)

然后在会话里跑几个会用工具的任务，每轮结束后 stderr 会出现：

[tool-cost-hint] {"version":1,"sessionId":"...","turn":1,...,"tools":[...]}

没有 armed 行 → patch 没生效，回到 5.2；
有 armed 但没有摘要行 → 那一轮没有工具调用（纯对话轮次不产出摘要），或 tool/call / tool/result 没走到本插件（检查是否有别的插件把行 disabled 了）。

5.4 验证计数与 token 是否可信

调用次数：摘要里某工具的 calls 应等于该轮 assistant 实际发出的工具调用数（含被中断的那些）。
结果侧 token：totalOutputTokens 应能与上下文面板 / ctx.tokenMeter.measure() 的对应 tool/result 节点 tokens 对上（因为就是同一来源）。任何 outputTokensSource: "estimate" 的工具说明该轮 meter 不可用或节点缺失，这种数字只能当量级参考。
失败/中断：故意中断一轮（工具还在跑就结束），检查 unattributedCalls > 0 且该轮仍有摘要产出。
中途加载：在已有会话里热重载插件，检查 orphanResults 是否正确反映了"只看得到结果"的情况。

5.5 验证"零侵入"

session 日志里不应出现任何新的事件 type（grep tool-cost-hint <session.jsonl> 应为空）；
系统提示、工具列表、模型可见消息不应有任何变化；
关掉 emitEvent 后，插件仍然算数，只是不通知任何人。

5.6 client 联调（浏览器侧）

产物存在：dist/client.js 开头必须是 window.__ModuleLoader__.load({ id: "dsh-tool-cost-hint", factory: … })。如果不是这个形状，说明 tsdown.client.config.ts 里的包装插件没生效，浏览器会直接报加载失败。
投影注册上了：host stderr 不应出现 sessionProjections is unavailable；在 devtools 里 useProjection("toolCostHint") 的返回值形如 { v: 1, turns: [{ turn, tools: [...] }] }。
条目挂上了：在一轮的 turn-tail 节点（[data-turn-tail]）内部应当能看到一行 🛠 …；没有的话先看 console 有没有 [tool-cost-hint] 开头的警告——所有失败路径都只警告、不抛错。
点开对比：展开态里各工具的 输入/输出 与 host stderr 里同一轮的 inputTokens/outputTokens 必须逐字一致（同一套 estimate 函数算出来的，差一位就说明两边取的不是同一批事件）。

6. client 面：挂哪里、怎么拿到数据、怎么降级

6.1 为什么挂在 `conversation.chat.turnTail`

DSH 的"轮末"是两个 slot，都在 turn-tail 节点里、渲染在自底向上那一行操作区：

slot	谁声明的	条目拿到的 props	适不适合
`conversation.chat.turnTail`	ui-chat 的 `conversation.chat.node`（`key: "turn-tail"` 的 children）	`{ turn, seq, openFile }`	用了这个：能拿到 `turn`，可按轮取值；位置就在操作栏那一行
`conversation.chat.assistant-actions`	同上（children）	`{ messageId }`	不合适：在 hover 才显现的图标条里，塞不进多行折叠内容，也拿不到 turn

6.2 数据怎么来：投影 `wire.view`，不是事件

client 侧的 useProjection("toolCostHint") 读的是 host 注册的 session 投影（src/wire.ts）：

不能用自定义 Cordis 事件：API gateway 的转发白名单是构建期写死的，第三方插件加不进去；
更不能往 session 里 append 自定义事件：未知 type 没有 ignorable 标记，会让会话之后打不开；
投影的 wire.view 是唯一"算好再送到浏览器"的正规通道，还顺带白拿尾页携带、checkpoint 和重连重建。

6.3 惰性降级（探测不到就什么都不做）

情况	行为
`ctx.slots` 服务不存在	`apply` 直接 return，只在 stderr 打一行 `[tool-cost-hint] slots service is unavailable`
slot 名不存在（ui-chat 没装/改名）	`slots.inject(name, …)` 的回调永远不会被调用；不报错、不重试、不查询 DOM
投影没注册成功（`sessionProjections` 缺失）	host 侧打一行警告并跳过注册；client 的 `useProjection` 拿到 `undefined/{}`
该轮没有数据（纯对话轮、或插件是中途加进来的历史轮）	`pickTurn()` 返回 `undefined` → 组件 `return null`，不占位、不留空行
视图形状不对（版本不匹配/字段缺失）	同上，形状校验不过就当没有数据，绝不抛错把会话渲染带崩

所有注册都走 ctx.effect() / slots.inject()，卸载即清理：<style> 标签会被移除，slot 条目会被摘掉。

6.4 视觉

折叠态一行：🛠 read ×2 · edit ×1 · ≈1.2K tok
展开态逐行：工具名 / ×N（失败时带 !N）/ 输入 X / 输出 Y，末行 注入量 ≈Z
全部颜色继承 currentColor + opacity，字号 var(--dsh-font-size-1, 12px)，数字 tabular-nums；没有硬编码颜色，所以亮/暗主题自动跟随，不写主题分支。
合计文案走 locale 字典（zh/en），用的是**"注入量"**，不是"花费"或"金额"。

7. 与需求的两处偏差（都是有意为之）

dsh.client 在第二轮才声明。 宿主会按 dsh.client 去扫描并物化客户端产物，产物缺失会明确导致激活失败（不是静默跳过），所以第一轮（只有 host 面）声明它就是主动制造启动故障。第二轮既然真的产出了 dist/client.js，就一并声明了："client": { "platform": "web", "immediately": true }。 immediately: true 的含义是"应用启动即加载"，而不是等某个 slot 被渲染才惰性加载—— 因为我们的条目要挂到每轮的 turn-tail 上，越早注册越不会漏掉首轮。
cordis.patch.yml 的双重身份。 它既是 dsh.bundle.patch 指向的 bundle 补丁文件（被列进 profile 的 dsh.profile.bundles 后自动生效），也可以直接作为 --patch 的覆盖文件（同一份 YAML 数组格式）。两种用法语义完全一致，所以不需要两份文件。

8. 分发（打包给另一台机器）

# 在本插件目录里（先确认 dist/ 是新的：npm run build）
npm install          # 首次、或换了机器之后
npm run build        # 产出 dist/index.js + dist/client.js
npm pack             # 产出 dsh-tool-cost-hint-0.2.0.tgz

另一台机器上（目标 profile 不是 desktop 时）：

dsh plugin --profile <profile> add file:C:/path/to/dsh-tool-cost-hint-0.2.0.tgz

装完确认两件事：package.json 的 dsh.profile.bundles 里出现了 dsh-tool-cost-hint； dsh --profile <profile> --dump-config 里有 - id: tool-cost-hint。然后重启 DSH。

desktop profile 见本文开头的「安装前必读」——dsh plugin add 会直接被拒，只能手改配置文件。

9. 下一轮（不在本轮范围）

客户端 bundle 的构建目前依赖 tsdown 的 outExtensions + 一个内联 renderChunk 包装插件；若你的 tsdown 版本不吃这两个选项，退回"手写 dist/client.js"（官方 decoration 模板就是手写的， window.__ModuleLoader__.load({ id, factory }) 的壳见 tsdown.client.config.ts 顶部注释）。
回看更早的轮次：投影已经按 keepTurns 保留了最近 N 轮，若要"整段会话汇总"，扩视图即可，不用改折叠。
跨会话持久化（如果需要）：投影缓存 + checkpoint，而不是自己写盘。

Tool Cost Hint

兼容性与来源证明

版本

相关插件

Tool Cost Hint

README

dsh-tool-cost-hint

⚠️ 安装前必读（桌面版用户）

桌面版手动安装（三步）

验证装好了没有

0. 怎么把插件发给别人

路线 A：发 tarball 文件（现在就能用，推荐）

路线 B：发布到 npm registry（之后就能"一个包名直接装"）

路线 C：进 DSH Plugin Hub 插件市场（覆盖面最大）

三条路怎么选

1. 文件清单

2. 归因口径（本插件唯一的"技术核心"）

3. 事件时机（为什么等 turn/end）

4. 推送接口设计（三层，第三层第二轮已落地）

摘要 JSON 形状（TurnToolUsageSummary）

5. Host 侧验证步骤

5.0 构建

5.1 让 name 可解析

5.2 先看组合结果（不启动，最快的排错手段）

5.3 启动并观察

5.4 验证计数与 token 是否可信

5.5 验证"零侵入"

5.6 client 联调（浏览器侧）

6. client 面：挂哪里、怎么拿到数据、怎么降级

6.1 为什么挂在 conversation.chat.turnTail

6.2 数据怎么来：投影 wire.view，不是事件

6.3 惰性降级（探测不到就什么都不做）

6.4 视觉

7. 与需求的两处偏差（都是有意为之）

8. 分发（打包给另一台机器）

9. 下一轮（不在本轮范围）

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

dsh-tool-cost-hint

⚠️ 安装前必读（桌面版用户）

桌面版手动安装（三步）

验证装好了没有

0. 怎么把插件发给别人

路线 A：发 tarball 文件（现在就能用，推荐）

路线 B：发布到 npm registry（之后就能"一个包名直接装"）

路线 C：进 DSH Plugin Hub 插件市场（覆盖面最大）

三条路怎么选

1. 文件清单

2. 归因口径（本插件唯一的"技术核心"）

3. 事件时机（为什么等 turn/end）

4. 推送接口设计（三层，第三层第二轮已落地）

摘要 JSON 形状（TurnToolUsageSummary）

5. Host 侧验证步骤

5.0 构建

5.1 让 name 可解析

5.2 先看组合结果（不启动，最快的排错手段）

5.3 启动并观察

5.4 验证计数与 token 是否可信

5.5 验证"零侵入"

5.6 client 联调（浏览器侧）

6. client 面：挂哪里、怎么拿到数据、怎么降级

6.1 为什么挂在 conversation.chat.turnTail

6.2 数据怎么来：投影 wire.view，不是事件

6.3 惰性降级（探测不到就什么都不做）

6.4 视觉

7. 与需求的两处偏差（都是有意为之）

8. 分发（打包给另一台机器）

9. 下一轮（不在本轮范围）

3. 事件时机（为什么等 `turn/end`）

摘要 JSON 形状（`TurnToolUsageSummary`）

5.1 让 `name` 可解析

6.1 为什么挂在 `conversation.chat.turnTail`

6.2 数据怎么来：投影 `wire.view`，不是事件

3. 事件时机（为什么等 `turn/end`）

摘要 JSON 形状（`TurnToolUsageSummary`）

5.1 让 `name` 可解析

6.1 为什么挂在 `conversation.chat.turnTail`

6.2 数据怎么来：投影 `wire.view`，不是事件