安装
在 DeepSeek Harness 里通过 dsh-market 安装
dsh plugin --profile web add dshmarket
或使用命令行
dsh plugin --profile web add dsh-plugin-dit
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码,并尽量锁定 commit(github:owner/repo#sha)。
README
在 DeepSeek Harness 中使用 DIT.ai 的对话模型目录。这个 profile bundle 会把 DIT 添加为原生模型提供方,不改变 Harness 自带的工具与运行时。
安装
DeepSeek Harness 需要 Node.js 22.19 或更新版本,以及 pnpm。
npx @deepseek-ai/dsh plugin --profile web add dsh-plugin-dit
启动 Harness:
npx @deepseek-ai/dsh web
Web profile 首次启动时会显示一次 DIT 引导。你可以从弹窗注册 DIT、打开 API Key 管理页,并将密钥直接保存到 Harness 的凭据服务。插件无法读取已保存密钥的明文,也不会把密钥发送到 DIT API 之外的任何地址。
版本确认、重新显示引导、国内网络访问与兼容范围见安装与故障排查。
也可以跳过引导,使用环境变量:
export DIT_API_KEY="你的-DIT-API-Key"
打开 Settings → Models,选择模型和协议:
DIT.ai:推荐默认,使用 OpenAI Chat Completions(/v1/chat/completions)DIT.ai Messages:使用 Anthropic Messages(/v1/messages)
DIT.ai 提供 DIT 当前所有支持 OpenAI Chat Completions 的模型;DIT.ai Messages 提供当前所有支持 Anthropic Messages 的模型。两个提供方共享同一个 DIT_API_KEY。
Headless 模式:
npx @deepseek-ai/dsh plugin --profile headless add dsh-plugin-dit
export DIT_API_KEY="你的-DIT-API-Key"
npx @deepseek-ai/dsh --profile headless "解释这个仓库"
在 Harness 内发现插件
该插件已进入 dsh-market 使用的社区目录,也可以通过 dsh-find-plugin 搜索。
npx @deepseek-ai/dsh plugin --profile web add dshmarket
打开 Market 标签页,搜索 DIT 或 dsh-plugin-dit。
协议支持
| Provider | Harness API | DIT endpoint | Thinking |
|---|---|---|---|
dit |
openai-completions |
/v1/chat/completions |
按模型能力 |
dit-messages |
anthropic-messages |
/v1/messages |
Anthropic Messages 原生 thinking |
DIT.ai 适合 OpenAI-compatible 客户端;DIT.ai Messages 适合需要 Anthropic 消息块、tool use、原生 Messages 流事件和 thinking budget 的工作流。
插件配置内容
- Provider routes:
dit、dit-messages - OpenAI Chat base URL:
https://api.dit.ai/v1 - Anthropic Messages base URL:
https://api.dit.ai(Harness 会自动追加/v1/messages) - 凭据引用:
DIT_API_KEY - 归因请求头:
X-DIT-Integration: deepseek-harness - Chat 模型:
/v1/models当前声明支持openai_chat_completions的全部 29 个模型,覆盖 Claude、DeepSeek V4、Gemini、GLM、GPT、Grok、Kimi、MiniMax 系列 - Messages 模型:当前声明支持
anthropic_messages的全部 10 个 Claude 模型 - Messages 原生 thinking,支持 Off、High、Max
- Web 首次启动引导:注册 DIT、创建密钥、通过 Harness Credentials 安全保存
API Key 由 Harness 在请求时解析,不会写进插件。
DIT 鉴权后的 /v1/models 是协议支持范围的权威来源。图像、音频和视频模型不在列表中,因为 Harness 使用的是对话模型接口。
安全
插件包不包含 API Key。弹窗使用 Harness 官方 credentials.set 接口写入凭据;插件只能查询“是否已配置”和“是否可写”,无法读回已保存的明文。需要注意:Harness 默认会把凭据以明文保存在 $DSH_HOME/.credentials.yaml,文件权限为 0600,这不是静态加密。插件没有遥测,也不会把密钥写入浏览器存储或插件日志。完整边界和报告方式见 安全策略。
本地开发
在本目录执行:
pnpm test
pnpm smoke:harness
DIT_API_KEY="你的-DIT-API-Key" node scripts/check-catalog.mjs
npx @deepseek-ai/dsh plugin --profile web add .
npx @deepseek-ai/dsh --profile web --dump-config
pnpm smoke:harness 会让官方 Harness headless agent 分别请求本地 mock 的 /v1/chat/completions 和 /v1/messages;scripts/check-catalog.mjs 会把插件模型 ID 与 DIT 实时声明的协议范围进行对比,不发起模型推理请求。
卸载
npx @deepseek-ai/dsh plugin --profile web remove dsh-plugin-dit
License
MIT