dsh-search-ledger
在终端中运行以下命令:
dsh plugin install gordan-code/dsh-search-ledger
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install gordan-code/dsh-search-ledger,或按仓库 https://github.com/gordan-code/dsh-search-ledger 说明安装(需 Node.js ≥22.19 与 DSH 0.2.1-rc.2)。
插件介绍
在 DSH 里同时接 DeepSeek 官方 API、中转和第三方搜索时,Search 和 Fetch 该走哪条渠道、失败后换谁、各自用了多少次,往往要分散在多处配置里,事后也很难对齐「一次工具调用到底试了几次、花了多少钱」。DSH Search Ledger 把渠道路由和本地费用记录放在同一套界面里:按模型 Provider 绑定 Search/Fetch 渠道,管理每个渠道的地址、费率与 Key 池,并用账本记录每一次实际 API 尝试。
核心能力围绕「可配置的路由」和「可审计的用量」展开。Search 与 Fetch 可以选不同渠道,也支持会话、全局或 Provider 级覆盖;官方与中转的单价、币种和计费口径可以分开设置。一个渠道可保存多个 Key 并轮换使用,失败时可按顺序切换渠道或同渠道的其他 Key;每次尝试单独入账,同一轮切换用 operationId 关联,历史记录沿用请求当时的价格,不会因后来改配置而重算。
插件统计的是经其后端的 web_search / web_fetch 请求,不是模型 Token;界面上的费用是本地估算,不能代替服务商账单。失败、超时或无法确认是否计费的情况也会如实保留,避免「看起来只请求了一次」或「算不出来就当免费」的错觉。
适合需要在多个 Provider 与搜索服务之间分配流量、想看清一次调用走了哪里、以及希望按渠道和会话复盘用量的用户。它不做全账户账单同步,也不会自动挑选最便宜的服务;若你主要需要单一搜索 API 接入而不关心路由与账本,可能不是首要选择。
使用场景
- 官方 API 与中转分别走不同 Search 渠道,并想按 Provider 统一绑定
- 一次工具调用发生渠道切换,需要看清每次尝试与本地估算费用
- 按日期、渠道或会话筛用量,排查某段对话搜索成本为何上升
适合人员
- 在 DSH 中同时使用多种搜索/抓取后端的深度用户
- 需要把 Search 与 Fetch 分开配置并做失败切换的运维或开发者
- 关心请求可追溯、费用可复盘而非只看 Token 用量的团队