前言¶
在 DeepSeek Harness（DSH）裏做智能體或日常開發，模型往往來自不同渠道：IDE 配套來源、Claude / Codex 訂閱，各自登錄方式和配置分散。若還要對接 OpenAI 兼容端點、控制模型列表長度、查看請求統計，通常要在多個工具之間切換。
dsh-cpamc 是面向 DSH 的模型提供方插件：裝好後由插件準備模型服務、來源組件與完整管理界面，登錄並通過檢查的來源會自動進入 DSH 模型選擇器；輕量設置留在 DSH「設置 → dsh-cpamc」，登錄來源、改路由、看詳細日誌則一鍵打開原版完整 CPAMC 管理界面。下面介紹它做什麼、如何在 DSH 裏用，以及安裝與命令上的注意點。
這是什麼¶
- 名稱：dsh-cpamc（社區目錄：AIcivilization/dsh-cpamc）
- 維護者：AIcivilization
- 分類：客戶端（DSH 設置頁 Web 面板 + 本機服務）
- 代碼與許可：GitHub，MIT
- 狀態（README）：早期版本 0.1.x，已發佈到 npm；標爲「已實現」的部分在 macOS（Apple 芯片）上用過真實組件與真實 DSH 驗證，其他平臺與服務器仍在驗證中
- 關係：在 dsh-model 基礎上開發；可與 dsh-model 並存，但 DSH 會出現兩組模型，README 建議
migrate後卸載 dsh-model
一句話：爲 DSH 提供多來源模型，並在 DSH 內打開完整 CPAMC 管理界面，管理的就是爲 DSH 供模的同一套服務，在完整界面裏改的設置不會被 dsh-cpamc 覆蓋。
核心功能¶
模型與來源¶
- 爲 DSH 提供模型：已登錄且檢查通過的來源，其模型自動出現在 DSH 模型選擇器。
- 默認六個來源：WorkBuddy、Trae、Qoder、ZCode，以及 Claude 訂閱、Codex 訂閱；賬號由使用者自行登錄。
- 列表可控：每個來源可在 DSH 裏顯示或隱藏；默認只顯示免費來源中、已在當前賬號實測調通的模型，最多 2 個，其餘需再勾選。
- 開箱組件：模型服務、四個 IDE 來源的組件、完整管理界面、配置與 API Key 由插件準備，版本鎖定並校驗 sha256。
在 DSH 裏管理：設置 → dsh-cpamc¶
界面語言跟隨 DSH。README 中各區塊狀態如下（均爲「已實現」，「部署到服務器」另注待真實服務器驗證）：
| 位置 | 內容 |
|---|---|
| 頁面頂部 | 插件名與當前版本；有新版本時纔出現「更新」；「卸載」 |
| 模型管理 | 最近使用的模型；六個來源的狀態、賬號、顯示/隱藏；近 24 小時真實請求數、成功率、延遲與速度（無數據時顯示「暫無請求數據」）；選擇在 DSH 裏展示哪些模型 |
| API Key | 本機地址與外部地址；每臺設備一把 key，新增、複製、輪換、吊銷 |
| 服務 | 模型服務、渠道組件、完整管理界面的版本與運行狀態；重新檢查、重啓、修復 |
| 部署到服務器 | 在本機 DSH 中填寫服務器地址與 SSH 賬號，一鍵把 dsh-cpamc 裝到已有 DSH 的服務器；密碼僅本次使用、不保存 |
| 全部功能 | 確認服務運行後打開原版完整管理界面；複製登錄密鑰（不顯示，約 30 秒後從剪貼板清除）。遠程瀏覽器經 DSH 自身網址打開，需先登錄 DSH |
安全與卸載¶
- 服務只監聽本機；調用模型始終需要 API Key；DSH 設置頁拿不到守護進程和服務的密鑰。
- 卸載按順序撤下對外訪問、還原 DSH 配置、停止並移除服務、確認端口釋放，最後才從 DSH 移除插件；任一步失敗會停下並可重試，不會誤報「已卸載」。
安裝與啓用¶
通過 DSH 插件管理安裝¶
在 DSH 的插件管理裏安裝 dsh-cpamc（包名 dsh-cpamc，npm 已發佈）。若出現 ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION，是 DSH 包管理器限制「發佈不足一天」的包（報錯點名的可能是本插件或其他已裝插件）；過一段時間在界面點「重試」即可。
安裝完成後，可重複執行 setup 完成或修復全部組件（見下節命令）。之後在 設置 → dsh-cpamc 中通過「全部功能」登錄各來源。
setup 與開發構建（README 快速開始）¶
若需要從源碼構建或使用 CLI 修復環境，README 給出的開發版步驟爲：
cd dsh-cpamc && npm ci && npm run build
node bin/dsh-cpamc.js setup
setup 可重複執行。若插件管理安裝受阻，README 也提到可改用 dsh-cpamc setup 安裝明確指定版本（需本機已有 dsh-cpamc 可執行入口，通常來自上述構建或 npm 全局/項目依賴）。
運行環境：package.json 要求 Node >=20。
典型用法¶
1、在設置頁完成日常管理¶
進入 DSH 設置 → dsh-cpamc：查看來源與 24 小時統計、切換顯示/隱藏、管理 API Key、檢查或重啓服務；需要完整配置、路由與詳細日誌時，使用「全部功能」打開 CPAMC 完整管理界面。
2、命令行（dsh-cpamc）¶
安裝或構建後，可在終端使用 README 中的常用命令：
| 命令 | 作用 |
|---|---|
setup |
安裝 / 修復全部（可重複） |
sources |
六個來源：登錄狀態、在 DSH 顯示或隱藏、賬號、模型數 |
source show\|hide <來源> |
在 DSH 顯示 / 隱藏該來源模型 |
panel [--show-key] |
打印完整管理界面地址 |
key list\|add\|revoke\|rotate <名稱> |
訪問 key（每臺設備一把） |
stats |
按 key、來源、模型的成功率、延遲和速度 |
status / doctor |
總覽 / 逐項自檢 |
migrate |
從 dsh-model 遷移 Claude / Codex 登錄與訪問 key（只複製，不刪除） |
update / uninstall |
更新 / 乾淨卸載 |
3、從 dsh-model 遷移¶
若此前使用 dsh-model，可先執行：
dsh-cpamc migrate
再按 README 建議卸載 dsh-model，避免 DSH 裏重複兩套模型入口。
平臺與適用場景¶
平臺（README）¶
| 平臺 | 狀態 |
|---|---|
| macOS Apple 芯片 | 已用真實組件測試 |
| macOS Intel、Linux x64 / arm64、Windows x64 | 組件已齊，待逐個實測 |
| Windows arm64 | 渠道組件暫無該平臺版本，驗證中 |
| 服務器（VPS） | 完整管理界面經 DSH 自身網址、先過 DSH 登錄，已實測；不需另裝其他產品 |
適合誰¶
- 已在 DSH 生態內開發，希望 一個 OpenAI 兼容端點 聚合 WorkBuddy、Trae、Qoder、ZCode 與 Claude / Codex 訂閱，並在 DSH 模型選擇器裏可控展示。
- 需要 設置頁輕量運維 + 一鍵進完整 CPAMC 控制台 做登錄、路由與日誌排查的用戶。
- 計劃把同一套 dsh-cpamc 部署到已有 DSH 的遠程服務器（功能已實現，README 註明仍待更多真實服務器驗證）。
務必知曉的注意¶
- 條款與賬號風險：來源賬號憑據在官方客戶端之外使用，可能不符合服務商條款，賬號存在風險，需自行判斷。
- 額度：dsh-cpamc 只負責轉接，不提供任何額度。
- 插件權限：插件以當前 dsh 進程權限運行；安裝前請自行查看 源碼 與 MIT 許可證，確認符合你的安全與合規要求。
- 社區目錄：SkillHub 等目錄爲社區站點，與 DeepSeek / 幻方無官方從屬關係；DSH 本身遵循「一切皆插件」的擴展方式，本插件是其中一類模型提供方。
結尾¶
dsh-cpamc 把「多來源模型進 DSH」和「完整 CPAMC 管理界面」綁在同一套服務上：設置頁管日常，全部功能進控制台做深度配置，卸載路徑也按步驟可重試。當前爲 0.1.x 早期版本，除 Apple 芯片 macOS 外請按 README 平臺表預期驗證情況。
- 目錄頁：https://www.skillhub.cn/plugins/AIcivilization/dsh-cpamc
- GitHub：https://github.com/AIcivilization/dsh-cpamc
- 設計說明：倉庫內
docs/DESIGN.md、docs/M0-findings.md
