dsh-trustedrouter: DeepSeek Harness 的 TrustedRouter 插件

前言¶

DeepSeek Harness (dsh) 的插件化架構允許用戶在不修改核心代碼的情況下擴展行爲。TrustedRouter 是一個提供隱私保護和智能路由的服務，它要求將策略配置放入請求體中，例如 {"provider": {"min_privacy": "confidential"}}。dsh 的模型提供者通常只能通過 Header 傳遞信息，無法寫入 Body 字段。在沒有此插件的情況下，無法直接將 TrustedRouter 的策略注入到請求中。

dsh-trustedrouter 插件解決了這個問題。它通過包裝 dsh 服務器的 fetch 方法，在發送到 TrustedRouter 網關的請求體中注入 provider 對象，從而允許在 dsh 中配置 per-model 的隱私和路由策略。

插件簡介¶

功能：爲 DeepSeek Harness 的每個模型添加 TrustedRouter provider 對象。
維護者：AmmarByFar
許可證：MIT
依賴：需要 pnpm 在 PATH 中，並依賴 @deepseek-ai/schemastery。

安裝¶

安裝此插件需要先確保 pnpm 已安裝並可在終端調用。安裝後需要重啓 dsh web。

命令行安裝（針對 web profile）：

dsh plugin --profile web add github:AmmarByFar/dsh-trustedrouter#v0.1.0

安裝後重啓 dsh web 即可生效。該插件沒有構建步驟。

配置與使用¶

1. 在 Web 界面配置（Per Model）¶

安裝後，進入 dsh 的 Settings → Models 頁面。在已配置的 TrustedRouter 提供者卡片中，點擊 Privacy & routing。

對於該提供者下的每個模型，你可以配置以下策略：

Privacy floor (min_privacy)：設置爲 no_store、zdr 或 confidential。TrustedRouter 會拒絕低於該級別的請求。
Prefer (sort)：選擇優化目標，如 price、latency 或 throughput。
Only these providers (only)：限制僅允許哪些提供商。
Never these providers (ignore)：排除某些提供商。
Billing (usage)：設置爲 credits 或 byok（Bring Your Own Key）。
US-headquartered providers only (jurisdiction: “us”)：僅使用美國總部的提供商。

配置生效：點擊 Apply 保存。下一次請求會自動應用該策略。

2. 全局與高級設置¶

在側邊欄 Plugins 中，進入 TrustedRouter privacy（在 Installed 下）。

這裏可以配置全局默認值和高級選項：

Gateways：配置應用策略的網關基礎 URL（默認爲 https://api.trustedrouter.com/v1）。
Defaults：適用於所有模型的默認設置。
Advanced defaults：
- order：首選提供商順序。
- allow_fallbacks：是否允許回退到其他提供商。
- max_price：最大提示詞和補全價格（USD/百萬 tokens）。
Per-model overrides (JSON)：JSON 格式的模型覆蓋配置。
Raw body rules (JSON)：深度合併到所有 POST 請求體的字段（除了 provider）。

3. 配置文件¶

插件會將配置寫入 web profile 的 cordis.patch.yml 文件中（路徑通常爲 ~/.dsh/profiles/web/cordis.patch.yml）。

你可以直接編輯該文件：

- id: trustedrouter
  config:
    gateways: [https://api.trustedrouter.com/v1]   # 網關地址
    defaults: { min_privacy: zdr }                 # 默認隱私等級
    models:                                        # 模型特定配置
      z-ai/glm-5.3: { min_privacy: confidential, only: [tinfoil, privatemode] }
    rules: []                                      # 可選的原始規則
    log: false                                     # 是否在終端記錄變更

限制與注意事項¶

桌面應用不支持：該插件僅支持 dsh web，不支持桌面客戶端。
自動更新：dsh 目前不會自動更新已安裝的插件。升級插件需要手動卸載後重新安裝，設置保存在 profile 中，不會丟失。
配置權限：設置只能在運行 dsh web 的同一臺機器上的瀏覽器中修改。
初始狀態：安裝後若未設置策略，請求不會發生改變。
安全機制：如果請求需要策略但無法讀取 Body，插件會拒絕請求（fail closed）並打印到終端，而不是發送不完整的請求。
依賴檢查：pnpm 會報出 @deepseek-ai/schemastery 的 peer dependency 警告，這是正常的，因爲該包由 dsh 本身提供。

驗證¶

在 Plugins 頁面開啓 Log changes to the terminal，然後發送一條包含 TrustedRouter 模型的聊天。終端會輸出類似日誌：

[trustedrouter] added provider to POST https://api.trustedrouter.com/v1/chat/completions for z-ai/glm-5.3: {"min_privacy":"confidential"}