前言¶
在 DeepSeek Harness（DSH）裏做智能體開發，模型通常走各家 API Key 或內置 provider。如果你已經在用美團妙手（CatPaw / catpaw-moon）桌面客戶端，賬戶裏帶着 passport 登錄態和積分套餐，卻想在 DSH 的對話界面裏直接選同一套模型，就需要一個能把妙手上游「翻譯」成 OpenAI 兼容流式接口的插件。
下面介紹社區插件 dsh-connect-miaoshou（維護者 Wahwayhale）：在 DSH 中註冊 provider miaoshou，複用妙手登錄態，經 nocode.cn 的 chat → agent-stream → SSE 鏈路返回文本；設置頁附帶只讀的積分、套餐與模型清單卡片。分類上屬於「模型推理」類 DSH 插件；目錄見 SkillHub，源碼見 GitHub。
這是什麼¶
dsh-connect-miaoshou 是妙手桌面客戶端（或獨立掃碼）與 DeepSeek Harness 之間的 model provider 橋接層。它不執行妙手遠端的工具調用，isAgent 固定爲 false，拿回的是純文本流；瀏覽器側路由只返回數字視圖，不暴露令牌。
核心能力¶
模型 provider miaoshou¶
插件提供 12 個模型，與妙手 App 模型選擇器逐條對齊，展示名與 App 一致，調用名按廠商口徑轉換（README 寫明 12 條均已實測可調通）：
- Auto
- LongCat-2.5 / LongCat-2.0
- GLM-5.3-FlashX / GLM-5.3-Flash / GLM-5.3
- DeepSeek-V4.1-Flash / DeepSeek-V4-Pro
- MiniMax-M3.1-Flash / MiniMax-M3
- Kimi-K3.1-Pro / Kimi-K3
模型目錄只讀 catpaw-agent.meituan.com/api/agent/maas/model-types（帶積分倍率 extendedInfo.rateMultiplier），不與 catx.nocode.cn 那套另一命名混用。
設置頁「妙手」卡片¶
可用積分、套餐到期與下次發放倒計時、賬號狀態；可勾選哪些模型出現在 DSH 模型選擇器；可覆蓋上游地址。另有診斷：目錄條數與來源、當前上游、憑據讀取狀態。
思考檔位映射¶
DSH 的思考檔位會轉成 agent-stream 請求裏的 modelParams.declarativeParams。不同模型對上思考 / effort 的支持不一致（例如部分 GLM、MiniMax 不發 thinking），非法 effort 會導致整輪無輸出，故未支持的檔位不會出現在選擇器裏；Auto 僅暴露 Off。
用量與計費字段¶
妙手按積分計費，不返回 token 用量（表現爲用量恆爲 0）。每輪積分消耗出現在 OpenAI 兼容響應的自定義字段 miaoshou.creditCost 中。
憑據與登錄¶
憑據按優先級有三種來源：
-
掃碼登錄（推薦，不依賴妙手客戶端）
在設置卡「賬號狀態」點「掃碼登錄」，瀏覽器掃碼確認後令牌寫入~/.dsh/dsh-connect-miaoshou.token.json（權限 0600）。Passport 沒有 refresh_token，過期需重新掃碼。 -
妙手客戶端登錄態（兜底）
默認讀取~/.meituan-catpaw/auth.json中的auth.accessToken；可用環境變量MIAOSHOU_HOME指向其他目錄。 -
epCLI（僅企業版）
與個人 CatPaw 賬號不是同一套；個人版請用掃碼或客戶端文件。README 說明卡片上不再把 ep 作爲主路徑。
對話鏈路與賬號積分鏈路使用不同鑑權頭，混用會 401；域名與頭字段見倉庫 README 表格（nocode.cn、catx.nocode.cn、catpaw-agent.meituan.com）。
安裝與啓用¶
插件以本地目錄方式安裝。README 給出的命令爲：
dsh plugin install <本目錄絕對路徑>
將 <本目錄絕對路徑> 換成本地已構建或克隆後的插件根目錄（含 package.json 與構建產物 lib/）。package.json 聲明版本 0.1.1，許可證 MIT，Node 引擎爲 ^22.19.0 || >=24.0.0，並依賴 Cordis / dsh-host-webserver / dsh-llm 等 peer 包（版本範圍見倉庫）。
安裝前建議自行閱讀源碼與許可證：插件在當前 dsh 進程權限下運行，會讀取本機 auth 文件或寫入 token 文件。
典型用法¶
完成安裝並在設置卡完成登錄或確認客戶端已登錄後：
- 在 DSH 模型選擇器中選擇 provider miaoshou，勾選卡片裏啓用的具體模型。
- 按平常方式發起對話；響應爲 OpenAI 兼容流式文本。
- 需要覈對賬戶時打開設置頁妙手卡片查看積分與套餐，或用診斷項確認上游與憑據狀態。
開發構建（維護者自用）：
npm run build # 產出 lib/index.js (ESM) + lib/client.js (CJS)
npm run typecheck
已知限制與適用場景¶
適合誰：已在妙手/CatPaw 有個人賬號或積分套餐，希望在 DSH 統一界面調用與 App 一致的 12 個模型，且能接受文本-only、非官方 API 橋接的方式。
不適合或需有預期：
- 只支持文本：圖片
images鏈路未打通，所有模型僅聲明text模態。 - 首字延遲約 8～12 秒：上游一次性發出整段文本，表現爲等待後整段彈出。
- 上游可能注入 agent 口癖：部分請求帶固定開場，
isAgent:false也不能完全消除。 - 不替你在妙手遠端跑工具；僅作模型文本輸出橋接。
DSH 生態強調「一切皆插件」；SkillHub 等爲社區目錄，與 DeepSeek / 幻方無官方從屬關係，本文介紹的是第三方維護的橋接插件。
