腾讯 IMA Copilot 的 DeepSeek Harness 原生插件。它将知识库问答注册为 ima_ask 工具，
让 Agent 可以按问题语义检索 IMA 知识库、归纳答案并返回引用资料，无需额外运行 MCP、
Python 服务或常驻子进程。
- 使用原生
ima_ask工具查询一个或多个 IMA 知识库。 - 返回回答正文以及资料 ID、标题和知识库名称等引用信息。
- 通过 Web 设置页维护认证信息和知识库 ID，更新后无需重启 DSH。
- 提供超时、并发限制、瞬时失败重试和请求取消处理。
- 凭证仅通过 DSH Credentials API 读写，不在 Web 页面回显。
运行环境：
- Node.js
^22.19.0或>=24.0.0 - 兼容的 DSH 版本见版本兼容验证矩阵
- Web 设置页需要
@deepseek-ai/dsh-client-ui-settings
从 npm 安装：
dsh plugin --profile web add dsh-ima-copilot
dsh web也可以从 GitHub 安装：
dsh plugin --profile web add https://github.com/onclaw-dev/dsh-ima-copilot.git
dsh web安装后重启 Web profile。以下命令的输出中应包含 ima-copilot：
dsh --profile web --dump-config打开“设置 → IMA Copilot”，填写：
| 字段 | DSH 凭证引用 | 说明 |
|---|---|---|
| X-Ima-Cookie | IMA_X_IMA_COOKIE |
IMA 请求的完整 Cookie |
| X-Ima-Bkn | IMA_X_IMA_BKN |
IMA 请求头中的业务密钥 |
| 知识库 ID | IMA_KNOWLEDGE_BASE_IDS |
每行一个 ID，也可使用逗号分隔 |
获取配置值：
- 登录 IMA Copilot。
- 打开浏览器开发者工具的 Network 面板，在 IMA 中发送一条消息。
- 找到
/cgi-bin/assistant/qa请求，从同一请求的原始请求头复制完整x-ima-cookie和x-ima-bkn。不要使用包含省略号的截断值。 - 在目标知识库页面找到
init_session请求，从请求体读取knowledge_base_id。
保存知识库 ID 时需要提交完整列表，新列表会替换旧列表。设置页只显示凭证是否已配置， 不会读取或展示已保存的明文。
| 参数 | 必填 | 说明 |
|---|---|---|
question |
是 | 要向 IMA 知识库提出的非空问题 |
knowledgeBaseId |
否 | 目标知识库 ID；配置多个知识库时必填 |
返回结果包含回答正文和引用资料：
{
"answer": "回答正文",
"references": [
{
"id": "资料 ID",
"title": "资料标题",
"knowledgeBase": "知识库名称"
}
]
}配置单个知识库时插件会自动选择；配置多个知识库时必须传入列表中的
knowledgeBaseId。配置缺失、列表为空或 ID 不在列表中时，请求会在访问 IMA 前失败并
返回配置提示。
每次调用都会读取最新凭证、创建一次性 IMA 会话并在结束后释放资源，因此不保留跨调用的 对话历史。默认请求超时为 300 秒，瞬时失败最多重试 3 次，并发上限为 1。
下表最后验证于 2026-11-11。“通过”表示同一个未改写插件 tarball 已在该范围内每个 DSH Release 的精确依赖环境中完成隔离安装、依赖身份检查、Client bundle smoke 和 Host 接口检查。
| DeepSeek Harness Release | 适配接口 | 结果 | 说明 |
|---|---|---|---|
dsh-v0.1.0-rc.7 ～ dsh-v0.1.1-rc.2 |
Static Config + connection.api.credentials + settings.section |
package/bundle smoke 4/4 | 使用 legacy envelope adapter |
dsh-v0.1.2-alpha.2 ～ dsh-v0.1.6-alpha.2 |
Static Config + remote.credentials + settings.section |
package/bundle smoke 13/14 | dsh-v0.1.3-alpha.1 的精确 npm 包未发布 |
dsh-v0.1.7-alpha.1 ～ dsh-v0.2.2-rc.1 |
Volatile Config + remote.credentials + settings.section |
package/bundle smoke 19/19 | 使用当前基线接口 |
开发基线仍为 dsh-v0.2.2-rc.1，运行时以能力探测选择 legacy 或 gateway 凭证协议；完整的
逐 tag commit、接口族、adapter 和验证状态见
docs/harness-interface-contract-audit.md。环境契约排除的
dsh-v0.1.2-alpha.1 不在适配范围内。
IMA Web API 并非公开稳定 API，上游字段、鉴权或响应格式变化时，插件可能需要同步更新。
IMA 请求与响应解析逻辑源自 highkay/tencent-ima-copilot-mcp， 本项目将其适配为 DSH 原生插件，并采用 MIT License。
DSH 是 DeepSeek Harness 的生态简称。本项目是社区插件，与腾讯 IMA 或 DeepSeek 官方均无 隶属或背书关系。使用者应自行确保账号、知识库内容和认证信息的使用符合相关服务条款。