Crowd Memory v0.1.1

Coding Agent群体记忆

把一个 coding Agent 在开发任务中验证过的经验，提供给处理相关问题的其他 Agent，并保留来源、适用条件和测试结果。

终端 · DSH 适配器
dsh plugin --profile web add @fuxi-ailabs/crowdmemory-dsh-adapter@0.1.1

先启动本机 Runtime；web 换成实际使用的 DSH Profile。其他 Agent 请按接入指南安装。 选择 Agent 接入方式 →

功能演示安装使用

DSH 0.1.6-alpha.2 或 ^0.2.0-rc.2 · adapter/runtime 0.1.1

本机 Runtime · Node.js ≥ 22.18 · Python ≥ 3.10 使用条件 ↓

三方库接入，把修法交给下一个 Agent

A 修好 PNG 信息读取工具并留下经验；B 在另一个工程核对来源，完成图片读写测试。

使用场景与适合人群

适合使用 coding Agent 的应用开发者

接入与维护三方库

“这个库的依赖、链接和版本问题，其他 Agent 是否处理过？”

查阅同类工程的构建修法，核对目标名、头文件与库版本，再在当前工程构建并运行功能测试。

适合开发 workflow 的集成与维护者

在开发 workflow 中传递经验

“上一次在构建或测试阶段遇到过什么问题？”

把构建、测试阶段留下的排查经验提供给同机后续运行的 Agent。需要按开发阶段采集时，使用 workflow-default。

适合维护构建与测试环境的开发者

复用构建排错方法

“相同的构建失败以前是怎么修好的？”

记录编译、依赖或配置问题的原因、实际命令和检查结果。后续 coding Agent 可核对记录，在当前项目重新验证修法。

libpng：从信息读取到图片读写

两个独立工程接入真实 libpng 1.6.59。A 先处理 PNG 信息读取工具的链接失败；B 接手另一个图片读写工程，核对 A 的经验后重新构建与测试。

  • 左侧 A：实际构建，复现 png_image_* 未定义符号，核对 CMake 链接配置。
  • A：修复链接与本机头文件版本混用，运行测试，再用 memory_note 记录原因、条件和命令。
  • 右侧 B：在新工作区复现另一个目标的失败，用 memory_search、memory_read 核对 A 的来源记录。
  • B：按当前目标调整配置，验证 PNG 解码、编码、重新读取后的像素一致性。

这是可复现的三方库接入示例，libpng 本身未修改。两个 Agent 在同一台机器的独立工作区依次运行，按阶段并排回看；不比较耗时。原始提示、人工恢复、测试和读取回执见运行依据。

两个 Agent，一份可核对的 libpng 构建经验

约 94 秒中文配音讲解：先看 DSH 适配器配置说明与实际加载状态，再看两个 Agent 复用 libpng 构建经验。默认 1080p，可切换 4K 查看代码细节；Runtime 与适配器均为 0.1.1。

在 DSH 中复现
发送给 DSH
在 libpng 接入示例的独立工作区中，先构建 info 目标并复现失败，核对 CMake 依赖、头文件与二进制版本，修复后运行 PNG 信息读取测试；用 memory_note 记录实际原因、修法、验证和适用条件，scope=global，topic_key=libpng/cmake-link-target。再让另一个独立 Agent 处理 roundtrip 目标，先复现失败，再搜索和读取记忆，核对当前目标名与环境，修复后验证 PNG 解码、编码、重新读取的像素一致性。不要修改三方库或用硬编码输出代替测试。

构建失败，到新工程验证通过

截图取自上面两个 Agent 的真实工具结果：A 首次构建遇到链接失败；B 读取经验、核对当前配置后，通过另一个目标的构建与图片读写测试。

A：首次接入，链接失败

CMake 找到了 libpng，但可执行目标未链接库，png_image_* 符号无法解析。

B：核对经验后，图片读写通过

按自己的目标配置链接与头文件路径后，PNG 解码、编码、重新读取的像素一致性测试通过。

记录有来源，Agent 可以核对当时的问题和实际修法。

后续 Agent 可读取来源记录，按当前工程调整配置，并运行构建与测试。

公开 E1 的 120 对受控合成任务：关记忆 45/120，开记忆 104/120。任务设置、数据和复算方法见评测页。

DSH 安装与验证

以下是视频中的 DSH 接入步骤。OpenClaude、opencode 和 Codex 的安装方式见 Agent 接入指南。

使用条件
运行平台
macOS 或 Linux；Python 需包含 venv。
宿主与插件
adapter/runtime 0.1.1；DSH 支持 0.1.6-alpha.2 或 ^0.2.0-rc.2，包含市场基准 0.2.1-rc.2。
独立安装
Runtime 本地 npm 安装，在指定目录建立独立 Python 环境；不需要全局安装 Runtime。
适用范围和限制
开发任务范围

面向 coding Agent 的代码修复、构建排错、接口测试和开发 workflow，支持本机 Agent 共享经验与 workflow 阶段间传递记录。跨机器开发协作为内部预览；跨项目复用按 project/global 范围配置。

在当前项目重新验证

代码、依赖和运行环境变化后，原来的修法可能不再适用。Agent 采用前应核对条件，采用后运行当前项目的测试。记忆服务不可用时，开发会话继续执行，但这一步不带记忆。

配置与验证

DSH Profile 决定插件装在哪个环境，Runtime 的 session-default/workflow-default 是采集模板。实际连接取决于启动 DSH 的进程收到的端点配置。

  1. 检查环境 确认 Node.js、Python 和 DSH 满足上面的条件。 终端

    node --version
python3 --version
dsh --version

  2. 本地安装 Runtime 在独立目录安装 npm 包，Runtime 在 prefix 下建立隔离环境。 终端 A

    mkdir -p CMLocal && cd CMLocal
npm install --save-exact @fuxi-ailabs/crowdmemory-runtime@0.1.1
npx --no-install crowdmemory-runtime install --prefix "$PWD/.runtime/crowdmemory"

  3. 启动记忆服务 保持前台终端运行；Ctrl-C 会停止服务。 终端 A · CMLocal

    npx --no-install crowdmemory-runtime start --prefix "$PWD/.runtime/crowdmemory"

  4. 安装并连接 DSH 另开终端进入同一 CMLocal 目录，将端点传给 DSH。web 换成自己的 Profile。 终端 B · CMLocal

    export CROWDMEMORY_ENDPOINT_FILE="$PWD/.runtime/crowdmemory/state/endpoint.json"
dsh plugin --profile web add @fuxi-ailabs/crowdmemory-dsh-adapter@0.1.1
dsh --profile web

  5. 检查状态并运行 coding 例子 另开终端检查状态。在 DSH 中运行上面的修复任务，写下经验后再启动独立 Agent，读取记录、修改代码并运行测试。 终端 C · CMLocal

    npx --no-install crowdmemory-runtime status --prefix "$PWD/.runtime/crowdmemory"
检查结果
  1. 检查环境

    Node.js ≥ 22.18，Python ≥ 3.10，DSH 位于支持范围。

  2. 本地安装 Runtime

    安装输出包含 Runtime 目录、Python 环境及 host-config.json。

  3. 启动记忆服务

    Runtime 启动，并生成 state/endpoint.json。

  4. 安装并连接 DSH

    插件出现在该 Profile 中，Agent 可调用 memory_note、memory_search、memory_read。

  5. 检查状态并运行 coding 例子

    状态显示 Runtime 运行中；第二个 Agent 能读取来源记录，并用测试验证修改。

安装与使用文档 ↗

常见问题

开发经验如何提供给其他 coding Agent？

修复并完成测试后，让 Agent 用 memory_note 记录现象、原因、实际修法、适用条件和检查结果。后续会话在相关开发任务或失败出现时可收到记录与命中理由，也可用 memory_search、memory_read 查找和核对来源；采用后仍需在当前代码上验证。

已经有 session-default，为什么还要 DSH Profile？

DSH Profile 决定插件安装在哪个环境，例如 web；session-default / workflow-default 是 Runtime 的采集模板，两者不同。

必须全局安装吗？Node.js 18 可以吗？

不需要全局安装 Runtime，按上面的独立目录步骤操作即可。npm 发布包需要 Node.js ≥ 22.18；Node.js 18 不满足要求。

为什么另一个 Agent 没有收到记录？

检查两边是否连接同一 Runtime、记录的 project/global 范围和端点配置。笔记从后续会话开始可见，不推给写入它的同一会话。从 Dock 启动的桌面程序不会自动继承终端环境变量，需按配置文档设置。

如何判断已有修法适用于当前代码？

核对问题现象、源码位置、依赖版本、运行环境和记录中的适用条件，查看实际 diff 与验证结果，再在当前工作区运行回归测试。libpng 接入录像与受控评测的任务设置、数据及原始依据见评测与运行依据链接。

运行截图