Nowledge 记忆层 nowledge-co/nowledge-mem-deepseek-harness

Nowledge Mem for DeepSeek Harness

Awesome DSH Plugin

一套记忆层，服务所有 AI 工具与智能体，打包成 DeepSeek Harness（dsh）插件包。Nowledge Mem 把 DSH 接入与其他智能体相同的持久记忆系统，提供启动上下文、提示词时召回、MCP 记忆工具，以及回合结束时的对话线程捕获。

本仓库是标准的独立插件包，在 nowledge-co/community 中同步镜像，用于 Nowledge Mem 连接器索引。

安装

dsh plugin --profile web add github:nowledge-co/nowledge-mem-deepseek-harness
dsh web

如果要在本地检出 nowledge-co/community，请在仓库根目录运行：

dsh plugin --profile web add ./nowledge-mem-deepseek-harness-plugin
dsh web

确认 nmem 命令行在 PATH 中，然后验证：

nmem status
nmem config mcp show --host deepseek-harness

适配器支持 DSH 0.1.5-rc.2、0.1.7-rc.1、0.2.1-alpha.1 和 0.2.1-rc.2。在当前宿主上使用
shell.execute(...).result()，同时保留旧版
shell.run() 回退。注入的消息使用 source.kind: "plugin:nowledge-mem"，
与 DSH 的 v3 到 v4 迁移保持一致；已有的旧版快照仍可识别。
替换已安装的插件版本后，请重启 DSH。

插件包默认连接本地 Mem MCP 端点：

http://127.0.0.1:14242/mcp

如果使用 Nowledge Cloud 或其他远程 Mem，请设置：

export NMEM_MCP_URL="https://<workspace>/mcp"
export NMEM_API_KEY="<mem-api-key>"

功能

- 每个 DSH 会话通过 agent/pre-step 注入一次 Nowledge Mem Context Bundle。
- 针对续写、发布、回归、连接器、插件等召回类提示词，在提示词阶段执行记忆召回。
- 通过 DSH 可重连的 @deepseek-ai/dsh-mcp-client 添加 Mem MCP 服务器，工具以 mcp__nowledge_mem__... 形式出现。
- 回合完成后，用 nmem t import --source deepseek-harness 导入真实的 DSH 界面转录。
- 为命令行导入打上 NMEM_IMPORT_ORIGIN=deepseek-harness 标记。

配置

插件包接受以下行配置字段，可在后续的 cordis.patch.yml 覆盖中设置：

- id: nowledge-mem
config:
cliPath: nmem
sourceApp: deepseek-harness
importOrigin: deepseek-harness
contextOnSessionStart: true
recallOnPrompt: true
syncOnTurnEnd: true
allowDangerFullAccessRetry: false
recallLimit: 8
spaceId: my-space-id
agentId: deepseek-harness

环境变量同样生效：

- NMEM_SPACE
- NMEM_AGENT_ID
- NMEM_HOST_AGENT_ID
- NMEM_MCP_URL 或 NOWLEDGE_MEM_MCP_URL
- NMEM_API_KEY

模型体验

启动上下文

模型会看到一条由插件提供的用户消息，其中包含当前的 Nowledge Mem Context Bundle。这条消息标记为 form: "snapshot"，并提醒模型：这是跨工具的上下文，不是覆盖指令的指令。

提示词时召回

当用户要求继续、记住、回顾之前的工作、发布版本、调试回归，或讨论连接器/插件时，插件会调用：

nmem --json m search "<prompt>" -n 8

模型会看到一条有长度上限的召回消息，包含记忆标题、来源提示、分数和内容。

MCP 工具

Mem MCP 工具通过 DSH 的 MCP 桥接注册在 nowledge_mem 命名空间下。DSH 目前只桥接 MCP 工具；Harness 客户端不会呈现 MCP 资源和提示词。

会话捕获

每完成一轮 DSH 对话，插件会把人类输入和助手回复文本导入 Mem，标记为 source=deepseek-harness。DSH 用 source.kind: "user" 标记真实的用户输入；来自其他生产者（运行时、时钟、技能、Mem 或其他插件）的用户角色上下文不算人类提示词。包含工具调用的助手步骤，连同其中的中间叙述、工具结果、推理块和执行元数据，都不属于对话文本，不会存为会话消息。图像块保留附件占位符，不保留图像字节。可见文本在配置的大小上限内原样保留；插件不会总结或改写回答。

更新插件只影响之后的捕获；它不会删除或改写之前导入的噪声消息。稳定身份仍能防止未变更的对话消息产生新副本。重新打开一个较早的受污染会话时，如果已有同身份消息包含执行文本，可能报告导入冲突：不要删除会话或更改其身份来强行重试。请先与支持团队一起审查限定范围的清理/导出方案。可以用新会话验证更新后的捕获，而不触碰旧数据。

沙箱兼容重试

默认情况下，插件不会用 danger-full-access 重试因沙箱不可用而失败的 nmem 命令。明确接受更宽访问权限的操作者，可以在 nowledge-mem 插件配置中设置 allowDangerFullAccessRetry: true。即使开启该选项，也只有当 DSH 主机提供 ctx.sandboxPolicy 并解析出所请求的策略时，重试才会执行；否则会失败关闭，并记录跳过重试的原因。

已知限制

- DeepSeek Harness 处于开发者预览阶段，公开包 API 可能变化。
- 本包尚未回填历史 DSH 会话；插件处于活动状态时，它会捕获新会话。
- DSH MCP 桥接只暴露工具，所以 Nowledge Mem 的资源/提示词目前不会通过 MCP 显示。
- 会话捕获依赖 DSH 进程环境中可用的本地 nmem 命令行。

社区定位

公开的标准仓库是 nowledge-co/nowledge-mem-deepseek-harness，打了 dsh-plugin 标签，方便在 DeepSeek Harness 生态里被发现。community 仓库为 Nowledge Mem 的各个入口维护一份注册表/索引镜像。

开发

跑回归测试套件之前，先安装开发依赖：

npm ci
npm run lint
npm test

插件测试用 DSH 0.2.1-alpha.1 真实的 message 和 Session 实现来跑入口点，并用官方 v4 准入校验器，在持久化 user-message 行和 inbox-splice 行两种场景下验证上下文与召回。CLI 响应和 shell 执行都是确定性的测试替身；要验证已安装的发布版本，仍需跑一次真实的 DSH 与 Mem 冒烟测试。

GitHub Actions 在每次 pull request 和推送到 main 时运行 ESLint 和测试。测试矩阵覆盖 Ubuntu 和 Windows，搭配 Node.js 24 与 DSH 0.1.7-rc.1、0.2.1-alpha.1、0.2.1-rc.2。它还会用 npm pack --dry-run 检查 npm 包内容。