博客 · 指南
DeepSeek Harness 模型接入
2026 年 8 月 20 日 · dshbase · 增补视觉 API 现状
DeepSeek Harness 不绑定模型——指向任意 OpenAI 兼容 API 都能跑。这里是社区实际在用的三种接入方式，从官方 API 到免费档。另外：请勿默认「官方 DeepSeek 今天就能识图」——见下方视觉 API 现状。
1. 官方 DeepSeek API
最简单、默认。到 platform.deepseek.com 注册、创建 API key，然后配到 dsh：
DEEPSEEK_API_KEY: sk-你的key
# base URL：https://api.deepseek.com写进 ~/.dsh/.credentials.yaml，或在设置 → 模型里填。官方没有邀请返佣计划——直接注册、按量付费。这条路径对应文本（以及当前 catalog 里已上架的模型）——不能当成「官方视觉端点已就绪」。
2. OpenCode Go — 5 刀换 60 刀额度
OpenCode Go 是个 token 套餐：首月 5 刀给 60 刀额度，按模型计费。上面最好用的是 DeepSeek 和 MiMo 两个模型。跟 dsh 配合很顺——给 dsh 派个任务，用 OpenCode 的模型额度跑。
# 在 dsh 里把 OpenCode Go 加为自定义 provider
# base URL + 你的 OpenCode Go key + 模型（deepseek / mimo）邀请链接：opencode.ai/go?ref=S7Y0RD7RBS
3. Agnes — 免费、不限量多模态 API
Agnes（Sapiens AI 出品）提供永久免费的多模态 API——agnes-2.5-flash 编码模型免费且不限量，覆盖代码、图像等。也有国内 API 节点。这是第三方供应商，不是 DeepSeek 官方视觉 catalog。
# 在 dsh 里把 Agnes 加为自定义 OpenAI 兼容 provider
# base URL（agnes 节点）+ 你的 Agnes key + 模型：agnes-2.5-flash到 agnes-ai.com 注册，然后在 dsh 的设置 → 模型里加为自定义 provider（小写 Provider ID + base URL + key + 模型）。
视觉 API 现状（rc.8）
rc.8 的营销会谈多模态 Agent。官方树里能看到实验名如 deepseek-v4-flash-vision-exp，并注明端点就绪前不进正式 catalog。接入时的实操结论：
- 不要宣称官方 DeepSeek 识图今天已经开箱可用。
- 过渡期：用已验证 vision 场景包——/packs/#vision 或艺术家包——以及
modlens/dsh-vision-toolkit等插件。 - 完整对照（叙事 vs catalog vs packs）：见视觉指南。
如何在 dsh 里加自定义 provider
- 打开 web UI 的设置 → 模型。
- 添加 provider：小写 ID、base URL、协议、你的 key、至少一个模型。
- 用获取可用模型验证端点。
完整模型配置见教程。
选哪个？
- 官方 DeepSeek——最简单，按量付费（文本 / 当前 catalog）。
- OpenCode Go——早期最划算（5 刀换 60 刀额度）。
- Agnes——免费第三方多模态，适合测试或轻量使用。
- 今天就要看截图——走 vision pack，而不是「等官方视觉」。