DeepSeek Harness 接入指南
DeepSeek Harness(deepseek-harness / dsh)是社区流行的 Agent 编排 CLI,原生为 DeepSeek 模型设计。通过 宁享Token 接入后,除了 DeepSeek 全系,还能用 GLM / Kimi / Claude / Gemini 等全部模型驱动同一套工作流。
前置条件
- 已安装 deepseek-harness(
npm i -g deepseek-harness或对应发行版) - 宁享Token API Key
配置
1. 指向 宁享Token 网关
Harness 走 OpenAI 兼容协议,改两个环境变量即可:
bash
export DEEPSEEK_BASE_URL="https://api.nxtoken.cn/v1"
export DEEPSEEK_API_KEY="sk-你的宁享Token密钥"2. 模型选择
bash
# 官方同款
dsh run --model deepseek-v4-pro "分析这个仓库的架构"
# 错峰半价(详见计费说明)
dsh run --model deepseek-v4-flash "给这个模块写单测"
# 换脑:用 Kimi 处理超长上下文
dsh run --model kimi-k3 "总结整个 monorepo 的依赖关系"3. 配置文件持久化
~/.dsh/config.yaml:
yaml
provider: nxtoken
base_url: https://api.nxtoken.cn/v1
api_key_env: NXTOKEN_API_KEY
default_model: deepseek-v4-flash峰谷计费技巧(DeepSeek 专属)
DeepSeek 系实行峰谷定价:
| 时段 | 价格 |
|---|---|
| 工作日 09:00-12:00 / 14:00-18:00(高峰) | flash 输入 ¥2/M · 输出 ¥8/M |
| 高峰时段之外,以及周六/周日全天(谷时) | 半价(flash 输入 ¥1/M · 输出 ¥4/M) |
日期类型按星期判定:法定节假日不再自动按空闲(谷)计费 —— 未在后台为该日期显式配置节假日时段时,按该日所在星期计价(落在周一至周五的法定假日,09:00-12:00 / 14:00-18:00 按高峰价计费)。
夜间跑批量任务(单测生成、文档总结、代码迁移)成本直接减半。缓存命中的输入部分按缓存价计费;缓存命中价因模型而异,以平台定价页为准。
典型工作流
bash
# 1. 白天用 pro 做架构级改动
dsh run --model deepseek-v4-pro --auto "把回调风格改成 async/await"
# 2. 夜间用 flash 跑批量机械任务(半价)
dsh batch --model deepseek-v4-flash tasks/*.md
# 3. 输出对账:控制台「使用日志」逐条核对每个任务的花费常见问题
Q: Harness 报 401? 确认 DEEPSEEK_API_KEY 已生效(echo $DEEPSEEK_API_KEY),且 Key 未在控制台被禁用。
Q: 速率限制? 平台按 Key 实行梯度限流,高并发批量任务可在控制台「流量管控」查看实时配额;Agent 死循环类失控流量有专门闸门保护,不会误伤其他任务。
Q: 想要 Claude 的规划能力 + DeepSeek 的执行性价比? 规划阶段 --model claude-sonnet-5,执行阶段 --model deepseek-v4-flash——同一网关随意切换。
