前言¶
在 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
