dsh-ima-copilot：将 IMA 知识库问答注册为 ima_ask 工具的 DeepSeek Harness 插件

DSH 采用插件化架构。对于需要接入腾讯 IMA Copilot 知识库的场景，直接调用外部服务或常驻进程会增加运维复杂度。dsh-ima-copilot 是一个原生插件，它将 IMA 的知识库问答能力封装为 ima_ask 工具，允许 Agent 直接通过语义检索获取答案。

插件定位¶

这是一个由 onclaw-dev 维护的社区插件，属于联网工具分类。它属于 DeepSeek Harness 生态，与腾讯 IMA 或 DeepSeek 官方均无隶属或背书关系。

核心功能¶

• 原生工具集成：使用原生 ima_ask 工具查询一个或多个 IMA 知识库。
• 引用信息返回：返回回答正文以及资料 ID、标题和知识库名称等引用信息。
• Web 配置管理：通过 Web 设置页维护认证信息和知识库 ID，更新后无需重启 DSH。
• 请求控制：提供超时、并发限制、瞬时失败重试和请求取消处理。
• 安全凭证处理：凭证仅通过 DSH Credentials API 读写，不在 Web 页面回显。

安装与启用¶

在终端运行以下命令安装插件并启动 Web profile：

dsh plugin --profile web add dsh-ima-copilot
dsh web

安装完成后，重启 Web profile。可以通过以下命令确认插件已加载：

dsh --profile web --dump-config

典型用法¶

安装并配置完成后，Agent 可以直接调用 ima_ask 工具。

参数说明¶

返回结果¶

返回结果包含回答正文和引用资料列表：

{
  "answer": "回答正文",
  "references": [
    {
      "id": "资料 ID",
      "title": "资料标题",
      "knowledgeBase": "知识库名称"
    }
  ]
}

注意事项¶

• API 稳定性：IMA Web API 并非公开稳定 API，上游字段、鉴权或响应格式变化时，插件可能需要同步更新。
• 凭证验证：真实凭证在线验证未执行。
• 无对话历史：每次调用都会读取最新凭证、创建一次性 IMA 会话并在结束后释放资源，因此不保留跨调用的对话历史。
• 默认策略：默认请求超时为 300 秒，瞬时失败最多重试 3 次，并发上限为 1。
• 合规性：使用者应自行确保账号、知识库内容和认证信息的使用符合相关服务条款。

总结¶

通过 dsh-ima-copilot，可以在不引入额外依赖或运行子进程的情况下，让 DSH 代理直接利用 IMA 的知识库能力。项目托管在 GitHub，可查看版本兼容矩阵与源码。