前言¶
DeepSeek Harness（DSH）采用插件化架构，允许用户通过插件扩展功能。在使用 PackyCode（PackyAPI）作为模型提供商时，通常需要额外配置 provider 或修改 YAML 文件。DSH PackyCode API 插件旨在解决这一痛点，它直接在 DSH 中集成了 PackyCode 的 Key 管理、模型路由与余额查询功能。
插件简介¶
这是一个由 BaronCyrus 维护的模型推理插件，开源协议为 MIT。
它的核心价值在于：利用 PackyCode 的 API Key，在 DSH 里选模型、轮换 Key、看余额。
核心功能¶
根据已核实的事实，该插件具备以下能力：
* 自带模型路由：安装后模型选择器会出现 PackyCode 分组，无需配置 provider 或修改 cordis.patch.yml。
* 多 Key 按顺序使用：额度用尽或 Key 被拒绝时自动切换到下一个可用 Key。
* 按分组选 Key：支持根据 Key 所在的 PackyCode 分组来选择模型。
* 余额一眼可见：设置页列出每个 Key 的剩余、已用、额度及合计。
* 本地凭据管理：Key 仅存储在 DSH 凭据文件里，浏览器无法获取明文。
* Claude 本地 CLI：特定 Claude 模型可通过本机官方 CLI 执行。
* 网页搜索集成：可选将 DSH 的 web_search 接管给 PackyCode。
* 图片生成与编辑：支持 GPT Image 系列模型的生成与编辑。
安装与启用¶
- 准备好 DeepSeek Harness 和 PackyCode 的 API Key。
- 打开桌面应用的插件页，点击添加插件。
- 在包名或地址中填入带版本号的包名：
dsh-packycode-api@1.2.9
- 在安装源中选择官方源，然后点击安装。
注意：一定要带版本号。只填
dsh-packycode-api时，DSH 默认 pnpm 可能安装旧版，且安装提示无法显示实际版本差异。安装后可在 设置 → PackyCode → 插件版本 核对。
日常使用¶
- 添加 Key：打开 设置 → PackyCode，在「添加 Key」里粘贴 API Key。点「添加」。
- 选择模型：在对话的模型选择器里选
PackyCode分组下的模型。 - 配置显示模型：在 设置 → PackyCode → 显示的模型 中勾选要显示的模型。
- 切换 Key：点「切到此 Key」指定优先使用的 Key。Key 按添加顺序使用。
- 查看余额：「账户与 Key」显示各 Key 的剩余与合计额度。「刷新」会跳过约 60 秒的缓存。
注意事项¶
- 本地开发：本地开发需加
link:前缀（如dsh plugin --profile <name> add link:/path/to/dsh-packycode-api），不要直接写路径或file:，否则会把整个仓库复制进 profile。 - 凭据安全：Key 只存在 DSH 凭据文件里，浏览器只能看到备注、状态和余额，插件不会读取环境变量
PACKY_CODE_API_KEY。 - 网络问题：旧默认值
https://www.packyapi.com在国内网络下 DNS 被污染，插件会自动尝试.ai后缀或提示配置接口地址。 - 隐私：不要把 Key 粘贴到公开 Issue、聊天记录或截图里。
结语¶
该插件简化了在 DSH 中使用 PackyCode 的流程，实现了从 Key 管理到模型路由的无缝集成。适合需要频繁切换不同模型提供商或管理多 Key 的开发者。更多细节可查阅 GitHub 仓库。
