导入到 DeepSeek Harness
DeepSeek Harness（dsh）是 DeepSeek AI 开源的智能体框架。通过添加自定义 OpenAI 兼容 Provider，可以让 DeepSeek Harness 使用 sub2aigc 提供的模型。
⚠️ 注意 DeepSeek Harness 目前处于开发者预览阶段，配置入口和字段可能随版本更新而变化。
前置准备
| 项目 | 说明 |
|---|---|
| Node.js | 已安装可用版本 |
| API Key | 在 sub2aigc 控制台创建，建议命名为 deepseek-harness |
| Base URL | https://sub.any2aigc.com/v1 |
| API 协议 | openai-completions |
| Model | sub2aigc 控制台模型列表中的模型名称 |
启动 DeepSeek Harness
在要作为工作区的项目目录中运行：
npx @deepseek-ai/dsh web
启动成功后，浏览器访问：
http://127.0.0.1:3080
运行命令时所在的目录会作为默认工作区位置。
添加 sub2aigc Provider
- 打开 DeepSeek Harness Web UI。
- 进入 设置 → 模型。
- 点击「添加自定义提供方」。
- 按下表填写配置：
| 配置项 | 填写内容 |
|---|---|
| Provider ID | sub2aigc |
| 显示名称 | sub2aigc |
| API 地址 | https://sub.any2aigc.com/v1 |
| API 协议 | openai-completions |
| API 密钥 | sub2aigc 控制台创建的 API Key |
Provider ID 需要使用小写字母。创建后不建议修改，因为模型默认值、凭据引用和已有会话都会使用该 ID。
添加模型
在「模型目录」中点击「获取可用模型」，DeepSeek Harness 会请求 sub2aigc 的 /models 接口并展示可用模型。
选择需要的模型后保存。如果没有获取到列表，也可以点击「添加模型」，手动填写控制台展示的完整模型 ID。
模型名称需要保持完全一致，不要修改大小写、横线或版本后缀。
选择模型并验证
- 关闭设置窗口。
- 在模型选择器中选择
sub2aigcProvider 下的模型。 - 选择或添加一个工作区。
- 发送一条轻量测试消息：
请只回复一句话：DeepSeek Harness 已连接。
如果模型正常回复，再回到 sub2aigc 控制台查看使用记录。出现对应请求即表示配置生效。
手动配置
如果需要直接编辑 $DSH_HOME/settings.yaml，可以添加：
llm-pi-ai:
providers:
sub2aigc:
displayName: sub2aigc
apiKeyEnv: SUB2AIGC_API_KEY
api: openai-completions
baseURL: https://sub.any2aigc.com/v1
models:
- id: your-model-name
启动前设置 API Key：
export SUB2AIGC_API_KEY="sk-your-api-key"
npx @deepseek-ai/dsh web
把 your-model-name 替换为 sub2aigc 控制台中的完整模型名称。通过 Web UI 保存密钥时，DeepSeek Harness 会自行管理凭据，不需要再设置该环境变量。
常见问题
| 问题 | 处理方式 |
|---|---|
| 获取模型返回 401 | 重新复制 API Key，确认没有多余空格 |
| 获取不到模型列表 | 确认 API 地址填写到 /v1，或手动添加模型 ID |
提示 MISSING_CREDENTIAL |
在模型设置中保存 API Key，或确认 SUB2AIGC_API_KEY 已生效 |
提示 UNKNOWN_MODEL |
使用 sub2aigc 控制台展示的完整模型名称 |
| 请求未出现在使用记录 | 确认当前会话选择的是 sub2aigc Provider |