dsh-deepbrain: 为 DeepSeek Harness 带来 DeepBrain 记忆插件

前言¶

DeepSeek Harness (DSH) 采用插件化架构，允许开发者为智能体扩展能力。在构建智能体时，记忆的可靠性是核心难点。传统的记忆方式往往依赖存储原始文档，这不仅占用大量上下文，还容易导致检索到的信息缺乏上下文关联或存在偏差。

DeepBrain 不同于文档存储，它存储的是判断——即从会议、访谈和讲座中提炼出的结论。每个判断都附带证据链，能够回溯到原始录音，并在不同场合进行交叉验证。dsh-deepbrain 插件将 DeepBrain 的这套“组织第二大脑”能力引入 DSH，让智能体能够读取这些判断、引用经过逐字验证的引语、查询人员的履历，并借用 DeepBrain 的分析方法。

插件定位¶

dsh-deepbrain 是 DeepSeek Harness 的记忆插件，由 qiuyiwu1989-star 维护，采用 MIT 许可证。它的核心价值在于为 DSH 智能体提供经过结构化处理的记忆层：判断、证据链和逐字验证的引用。

该插件不存储原始文档，仅存储经过处理的判断；所有调用均为实时调用，不进行缓存。

安装与启用¶

安装前请确保已安装 DeepSeek Harness。

安装插件：
使用以下命令将插件安装到指定 profile（默认为 web）：

    npx -p @deepseek-ai/dsh dsh plugin --profile web add github:qiuyiwu1989-star/dsh-deepbrain

安装完成后请重启 profile。

配置环境变量：
DeepBrain 需要账号和 API Key。建议优先通过环境变量设置，而非写入配置文件（防止密钥泄露到日志或截图）：

    export DEEPBRAIN_API_KEY=lj_live_xxx

核心功能¶

该插件向 DSH 注册了 6 个 MCP 工具。智能体不需要调用服务端提供的 27 个原始工具，插件负责将它们裁剪为适合 LLM 使用的形状，避免模型因工具过多而胡乱选择导致上下文爆炸。

deepbrain_brief
- 用途：当你不确定该问什么时，先描述当前情况，让 DeepBrain 决定你需要了解哪些关键信息。
deepbrain_topics
- 用途：浏览索引或拉取某个主题的摘要。这是大多数写作和分析工作的终点。
deepbrain_quotes
- 用途：获取可归因的引用，每一条都经过与录音的逐字验证。
deepbrain_person
- 用途：查询人员名单或某人的历史立场，建议在谈判或会议前使用。
deepbrain_ask
- 用途：提出具体问题并获取带来源的回答。慢速问题会自动等待结果。
deepbrain_call
- 用途：逃生通道。当上述五个工具无法覆盖需求时，直接调用任何 DeepBrain MCP 工具。
- 注意：如果 tool 参数为空，会列出当前 API Key 允许调用的所有工具。

配置示例¶

在 DSH 的 profile 配置中添加如下内容：

- insert:
    - id: deepbrain
      name: 'dsh-deepbrain'
      config:
        endpoint: 'https://shennao.zaowuyun.com/api/mcp'
        apiKey: ''              # 留空表示读取 DEEPBRAIN_API_KEY 环境变量
        timeoutMs: 120000       # 多步骤检索可能耗时较长，建议设置超时
        passthrough: true       # 设为 false 则不注册 deepbrain_call

API 权限与调用限制¶

DeepBrain API Key 是有作用域的，服务器会根据 Key 的权限修剪可用的工具集。

brain.ask：读取判断、引用、人物信息、方法库。这是大多数使用场景所需的基础权限。
transcript.read / transcript.write：读取或写入原始录音文本。
brain.propose：写入判断（这些判断会进入收件箱，需人工审核）。

只有在明确通过 deepbrain_call 请求写入操作，且 Key 拥有 brain.propose 权限时，才会执行写入。

重要限制：
* 无缓存：所有调用均为实时请求。判断可能会被覆盖或失效，缓存会导致模型获取过时结论。
* 无写入权限：除非使用 deepbrain_call 并具备 brain.propose 权限，否则插件不会向 DeepBrain 写入任何数据。
* 无客户端 UI：这是一个仅提供工具注册的 Host-only 插件，不包含前端界面。

已知问题¶

在干净的 profile 环境中（未启用 auto-install-peers），可能会遇到 Cannot find package '@deepseek-ai/cordis' 的错误。

这是因为该插件依赖 @deepseek-ai/dsh-tools，而后者将 @deepseek-ai/cordis 声明为 peer dependency。DSH 本身通常提供 cordis，但在特定环境下可能未自动安装。解决方法是启用自动安装 peer 依赖：

pnpm config set auto-install-peers true

该插件有意不依赖自己的 cordis 副本，以避免 DI 容器上下文/服务身份分裂。

总结¶

dsh-deepbrain 解决了智能体记忆缺乏结构化验证的问题。它将 DeepBrain 的“判断”能力转化为 DSH 可用的工具，使智能体能够基于经过验证的证据进行推理和引用。对于需要处理大量会议记录、访谈内容，并希望智能体具备可靠记忆能力的开发者，这是一个实用的工具。