gordan-code/dsh-search-ledger ↗★ 1

dsh-search-ledger

Provider-aware web search and fetch routing, key rotation, failover, and cost tracking for DSH 适合需要对DSH联网搜索和网页抓取进行多渠道管理、自动容灾与计费的用户。

パッケージ
dsh-search-ledger
互換性
未検証
Harness ピア範囲
0.2.1-rc.2
Cordis ピア範囲
^4.0.1
バージョン
0.5.1
ライセンス
MIT
最終更新
2026/10/20

インストール

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:gordan-code/dsh-search-ledger

ドキュメント

README 全文を読む ↗

配置

重启 DSH 后,在设置侧边栏打开 DSH 搜索账本,按下面的顺序配置:

  1. 在 渠道管理 添加渠道,填写名称、地址和费率,保存渠道配置。新建渠道默认停用,不会自动发送请求。
  2. 展开渠道,在 API Key 区域每行输入一个 Key,保存 Key 池。之后再次保存会替换整个池,不是追加。已经保存的 Key 不会显示出来。
  3. 在 渠道地址、费率与高级配置 勾选“启用”,再保存渠道配置。保存 Key 和启用渠道是两件事。
  4. 到 Provider 与覆盖,为实际的模型 Provider ID 分别选择 Search、Fetch 渠道并保存。覆盖顺序是:会话覆盖 → 全局覆盖 → Provider 绑定。
  5. 确认宿主 Web 工具使用 web-search-metered / web-fetch-metered 后端,发起一次原生调用,再去 用量与费用 看最近记录。

安装 patch 会选择这两个后端,但其他更高优先级的配置可能覆盖它。插件不默认绑定模型 Provider,也不会在没有绑定时自行选择收费渠道。

需要自动切换时,在对应操作下打开“有序切换”,调整渠道顺序和超时预算。配置示例在 provider-routing.patch.yml,其中的 Provider ID、地址和价格都需要按实际情况修改。

测试 Key

选择 Search 或 Fetch,再点击“测试 Key”。输入框有内容时测本次输入,为空时测已保存池或兼容凭证引用。测试后输入会保留,需要自己点保存。

每个 Key 只试一次,单 Key 最多 10 秒,整批最多 60 秒。测试不切换渠道,但可能收费,也会写入账本。Fetch 的测试目标固定为 https://example.com/。超时、限流和网络错误不一定是 Key 无效,也不能说明服务商没有扣费。

Key 池最多支持 32 个 Key。正常请求的轮换游标在当前进程内共享,重启后重置。