VioletScar-Hui/trcost-plugin

trcost — 轨迹省钱优化器 (Trajectory Cost Optimizer)

DSH 插件：实时分析 DeepSeek Harness 会话轨迹中的 token 浪费点（重复调用 / 失败重试 / 大结果 / 死胡同 / 重复读文件），
并用 执行层强制 的方式直接减少浪费——不是靠模型自觉，而是在工具调用前后拦截/截断。

纯确定性规则，零 LLM 成本，不消耗额外 token。

为什么做这个

LLM 会话中大量 token 被浪费在模型"重复做事"上：同一个文件读 3 遍、失败后盲目重试同一命令、一次拿到 40KB 的工具输出全文回流上下文。
之前靠系统提示词提醒（建议层）效果有限——模型不一定遵守。本插件新增 执行层：在 harness 的 waterfall 钩子上强制处理。

功能

建议层（分析 + 注入）

- 实时捕获全部会话轨迹（session/event），每会话有界环形缓冲。
- 5 条确定性诊断规则：
- R1 重复调用：同工具 + 同参数重复执行
- R2 失败重试：失败后盲目重试同一工具
- R3 大结果：单次工具输出 > 30KB 回流上下文
- R4 死胡同：连续失败/空结果探索
- R5 重复读文件：同一文件多次整读
- 有发现时生成省钱规则注入系统提示词（systemPrompt.section，order 150，每轮动态求值，无发现不出文本）。

执行层（强制，waterfall 钩子）

| 类别 | 钩子 | 行为 |
|---|---|---|
| 拦截重复调用 | tools/pre-execute | 窗口内（60s）同工具+同参数已成功调用 → deny，引导复用上次结果 |
| 拦截失败重试 | tools/pre-execute | 相同参数上次失败 → deny，引导先读错误 |
| 拦截重复读文件 | tools/pre-execute | 窗口内已读的文件 → deny |
| 截断大结果 | tools/post-execute | >30KB 的成功结果进上下文前截断（保留头 6KB + 尾 2KB + 截断说明） |

- 每个类别独立开关；同一调用窗口内只 deny 一次（防死循环）；所有拦截均有日志与统计。
- 不影响失败结果（错误完整保留），不拦截时走原生 next 链。

交互

- 悬浮球（可拖拽、位置记忆）：点击开/关报告面板。
- 面板：分析统计（会话/事件/估算 token/可省）、执行层统计（拦截 N / 截断 N / 省 tokens）、
每类开关、findings 列表、当前注入规则预览、一键复制规则。

安装

从 npm（市场收录后）

dsh plugin --profile web add trcost-plugin

从 GitHub

dsh plugin --profile web add github:VioletScar-Hui/trcost-plugin

安装后重启 DSH 宿主（或让 supervisor 自动拉起），侧栏即出现悬浮球。

使用

1. 正常使用 DSH（任意会话）。
2. 点悬浮球（💰）打开面板。
3. 「分析实时」看当前会话发现；「全量分析」扫历史（上限 15 会话）。
4. 执行层默认开启：重复调用/失败重试/重复读文件会被直接拦截，大结果自动截断。
5. 按需关掉某些类别（比如频繁改文件内容时可关「拦截重复读文件」）。

架构

- src/host/index.ts：TrcostService（TypertRemoteService）+ 捕获/分析/执行层 + RPC。
- src/client/index.tsx：悬浮球 + 面板（shell.overlay）。
- RPC：trcost/analyze | state | toggle | diag（SRC 模式）。
- 零运行时依赖：所有规则确定性实现，不调用任何 LLM。

开发

bun run build          # 全量构建（host ESM + client bundle）
bun run build:host     # 仅 host
bun run build:client   # 仅 client（浏览器刷新即生效）
bun run deploy:host    # 构建 host 并受控重启（走 dsh-ops/dsh-plugin-dev.sh）

License

MIT