前言¶
給 DeepSeek Harness（下文簡稱 DSH）開發智能體時，一個常見的麻煩是能力分散：聊天要接一個 provider，圖片生成、視頻生成、聯網搜索各自要配密鑰、寫適配。ClawRouters 把這些能力收斂到一個 OpenAI 兼容的 API 和一把密鑰之後，而 dsh-plugin-clawrouters 要做的，就是把這把密鑰和這組能力裝進一個 DSH 插件包——裝完、配好 key，就能在 DSH 裏直接選用。
下面介紹這個插件的定位、功能、安裝與配置方式。
這是什麼¶
dsh-plugin-clawrouters 是由 ropon 維護的 DSH 插件，一句話定位：爲 DeepSeek Harness 提供一鍵接入 ClawRouters 的能力，覆蓋聊天、圖片生成、視頻生成與網頁搜索。許可證爲 MIT。
它走的是 DSH「一切皆插件」的路子：不需要在 DSH 之外另起一個應用，安裝一個插件包、配置一把 API key，聊天路由和三個工具就都可用。
核心功能¶
插件提供四個入口：
clawrouters / auto：OpenAI 兼容聊天路由，支持圖片輸入；clawrouters_image_generate：生成圖片，並存爲持久化的 DSH 圖片附件；clawrouters_video_generate：提交併輪詢視頻任務，返回簽名結果 URL；clawrouters_web_search：返回結構化的標題、摘要與來源 URL，不替換 DSH 既有的通用web_searchprovider。
注意最後一點：搜索工具是新增能力，不會動你已有的 web_search provider 配置。
安裝與啓用¶
前置要求：DeepSeek Harness 0.1.0-rc.6 或更新版本，且 PATH 上需有 pnpm。
把 v0.1.1 標籤版本安裝到 Web profile 並啓動：
dsh plugin --profile web add github:ropon/dsh-plugin-clawrouters#v0.1.1
dsh web
倉庫提交了構建後的 lib/ 輸出，因此從 GitHub 安裝不需要 pnpm allowBuilds，也不會在安裝時執行構建腳本。
本地開發調試時，可以在插件倉庫目錄裏直接安裝當前檢出版本：
dsh plugin --profile web add .
dsh web
配置 API key¶
先在設置頁保存密鑰，再到會話裏選擇模型，步驟如下：
- 打開 DSH Web 或 Desktop；
- 進入 Settings → Models → ClawRouters；
- 粘貼你的 ClawRouters API key 並保存；
- 在會話模型選擇器中選擇
clawrouters / auto。
密鑰通過 DSH credential service 以 CLAWROUTERS_API_KEY 存儲，不會寫入 settings.yaml。聊天路由和三個工具在每次調用時解析同一份憑據，所以輪換密鑰不需要重建插件。
也可以不改設置頁，直接通過啓動環境提供密鑰：
export CLAWROUTERS_API_KEY='...'
dsh web
默認配置與覆蓋¶
默認 API base 爲 https://www.clawrouters.com/api/v1。工具部署默認值可以在後續 profile patch 中覆蓋，目標是 id: clawrouters-tools，可覆蓋項包括 apiKeyEnv、baseURL、imageModel、videoModel、imageTimeoutMs、videoTimeoutMs、searchTimeoutMs、videoPollIntervalMs。
README 給出的默認值示例如下：
- id: clawrouters-tools
config:
apiKeyEnv: CLAWROUTERS_API_KEY
baseURL: https://www.clawrouters.com/api/v1
imageModel: auto
videoModel: auto
imageTimeoutMs: 600000
videoTimeoutMs: 1800000
searchTimeoutMs: 30000
videoPollIntervalMs: 5000
需要調整超時、模型等部署參數時，把這段 patch 加在插件之後即可。
結果處理與能力邊界¶
對返回結果的校驗是有邊界的：圖片 URL 僅接受 HTTP(S)，需解碼、格式校驗，並經 DSH attachment policy 驗證後才持久化；視頻結果 URL 同樣限制爲 HTTP(S)。
目前暫不支持的能力有三類：
- embeddings / 向量搜索；
- 文本轉語音 / 語音轉文本；
- 持久化視頻（返回簽名 URL，而非複製視頻字節）。
如果需求落在這三類裏，這個插件目前覆蓋不到。
適用場景與注意¶
適合的對象很明確：想在 DSH 裏用一把密鑰同時獲得聊天（含圖片輸入）、圖片生成、視頻生成和結構化搜索的人，以及不想爲每類能力單獨維護 provider 與憑據的團隊。
安裝前有兩點務必留意：
1、插件以當前 dsh 進程的權限運行，安裝前應檢查插件源碼與許可證（本項目爲 MIT），確認可接受再裝；
2、確認本地 DSH 版本不低於 0.1.0-rc.6，且 PATH 上有 pnpm。
經過上面的步驟——安裝插件、保存密鑰、選擇 clawrouters / auto——四類能力就都可以在會話中使用了。開發參與者可以按 README 的流程跑 pnpm install && pnpm check 做本地檢查。
小結¶
dsh-plugin-clawrouters 的價值在於收斂：一個插件包、一把 API key，把聊天、圖片生成、視頻生成和網頁搜索接進 DSH，且密鑰輪換不需要重建插件。相關鏈接：
- GitHub 倉庫：https://github.com/ropon/dsh-plugin-clawrouters
- 社區插件目錄頁：https://www.skillhub.cn/plugins/ropon/dsh-plugin-clawrouters （該目錄爲社區獨立維護的站點，並非官方應用商店）
