agent-memory-sync
/agent-memory-sync
把分散在多个智能体(Claude Code、Codex、DeepSeek Harness、Qoder、WorkBuddy、ZCode、Trae、Cursor 等)里的会话记录统一采集、去重、归一化,汇总进 Obsidian 知识库,并让各智能体共享同一份记忆。当用户提到"把不同智能体的记录打通""统一记忆""同步各个 AI 的聊天记录""之前那个任务做到哪了""跨智能体时间线""记忆库"或要求执行任务后同步记忆时使用。
- Author
- haow9508-ctrl ↗
- Repository
- agent-memory-sync ↗
- Licence
- MIT
- Last repository change
- 01.11.2026
Assessment and security
- Files in this package
- 6
- Scripts
- 0
- HTML comments
- 2
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 01.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.
What it does and when to use it
把分散在多个智能体(Claude Code、Codex、DeepSeek Harness、Qoder、WorkBuddy、ZCode、Trae、Cursor 等)里的会话记录统一采集、去重、归一化,汇总进 Obsidian 知识库,并让各智能体共享同一份记忆。当用户提到"把不同智能体的记录打通""统一记忆""同步各个 AI 的聊天记录""之前那个任务做到哪了""跨智能体时间线""记忆库"或要求执行任务后同步记忆时使用。
Triggers from the description
Original author description
把分散在多个智能体(Claude Code、Codex、DeepSeek Harness、Qoder、WorkBuddy、ZCode、Trae、Cursor 等)里的会话记录统一采集、去重、归一化,汇总进 Obsidian 知识库,并让各智能体共享同一份记忆。当用户提到"把不同智能体的记录打通""统一记忆""同步各个 AI 的聊天记录""之前那个任务做到哪了""跨智能体时间线""记忆库"或要求执行任务后同步记忆时使用。
How it works
- 已接入的智能体
- 记忆桥接写到哪里
- 产出什么
- 命令
- 工作流:每次干完活要同步
- 关键实现细节(改代码时必须知道)
- 安全边界
- 用户的偏好(写死在这里,不要违反)
SKILL.md preview
---
name: agent-memory-sync
description: 把分散在多个智能体(Claude Code、Codex、DeepSeek Harness、Qoder、WorkBuddy、ZCode、Trae、Cursor 等)里的会话记录统一采集、去重、归一化,汇总进 Obsidian 知识库,并让各智能体共享同一份记忆。当用户提到"把不同智能体的记录打通""统一记忆""同步各个 AI 的聊天记录""之前那个任务做到哪了""跨智能体时间线""记忆库"或要求执行任务后同步记忆时使用。
---
# 跨智能体统一记忆
用户在多个智能体上并行干活,各家的会话互不相通——换个工具,之前的上下文就断了。
这套机制把所有智能体的本地会话读出来,归一化后写进 Obsidian 知识库,
并在各家智能体的全局记忆文件里放一个指针,让它们共享同一份记忆。
## 已接入的智能体
| 智能体 | 数据源 | 格式 |
| --- | --- | --- |
| Claude Code | `~/.claude/projects` | JSONL |
| Codex | `~/.codex/sessions` | JSONL + zstd |
| DeepSeek Harness | `~/.dsh/sessions` | JSONL + **多帧** zstd |
| Qoder / Qoder 国内版 | `~/.qoder{,-cn}/projects` | JSONL(Anthropic 风格) |
| WorkBuddy / WorkBuddy AI | `~/.workbuddy{,-ai}/projects` | JSONL |
| ZCode | `~/.zcode/v2/agent-config` | Claude Code 格式 |
| Trae / Trae 国内版 | `~/.trae{,-cn}/memory` | 结构化摘要 JSONL |
| Cursor | `~/.cursor/projects` | JSONL |
新增一家智能体:在 `scripts/lib/sources.cjs` 加一条源,在 `scripts/lib/adapters.cjs` 加一个解析器即可。
## 记忆桥接写到哪里
每家读取的入口文件不同,这里按**实测**配置(不是猜的):
| 智能体 | 入口文件 |
| --- | --- |
| Codex | `~/.codex/AGENTS.md` |
| WorkBuddy | `~/.workbuddy/MEMORY.md` |
| ZCode | `~/.zcode/workspace/default/AGENTS.md` |
| Qoder | `~/.qoder/memory/MEMORY.md`(它有自己的 memory 约定,不读 AGENTS.md) |
| Trae / Trae CN | `~/.trae{,-cn}/user_rules/agent-memory-sync.md`(**独占文件**,撤销时直接删除) |
| 通用 | `<Vault>/wiki/AGENT-README.md` |
Trae 的规则机制是从安装包里确认的:`firstRuleDir=".trae"`、`legacyUserRuleFilePath="user_rules.md"`、
`userRulesDirPath="user_rules"`,根目录是 `productDataFolderPath`(即 `~/.trae-cn`)。
所以用户级规则放 `~/.trae-cn/user_rules/`,项目级是 `<项目>/.trae/rules/*.md`。
## 产出什么
全部写在知识库的 `AI记忆/` 目录下(默认 `~/Documents/Obsidian Vault/AI记忆/`):
```
AI记忆/
├── AI记忆索引.md ← 总入口:智能体分布 + 项目列表
├── 最近7天.md ← 一周概览
├── 会话/YYYY-MM/ ← 每个会话一篇,含完整对话折叠区
├── 项目/ ← 跨智能体项目时间线(核心)
├── 每日回顾/ ← 按天汇总
└── .state/ ← 增量游标 + 检索索引(不用管)
```
**项目时间线是这套东西真正的价值**:同一件事在 Claude Code 起头、Qoder 改、Codex 收尾,
单看哪一家都是残片,时间线把各家按日期串起来,并标出哪几天发生了"接力"(🔀)。
## 命令
脚本目录:`~/.agents/skills/agent-memory-sync/scripts/`
```powershell
# 环境自检(换机器 / 首次使用先跑这个)
node doctor.cjs
# 日常:一条命令搞定(采集 + 校验桥接)
node sync.cjs
# 全量重建(首次、或改了归一化规则之后)
node sync.cjs --full
# 采集(增量)
node collect.cjs
node collect.cjs --only dsh,qoder # 只采某几家
# 检索
node search.cjs 部署 # 全文搜索所有会话正文
node search.cjs 华为云 --limit 10
node search.cjs 登录 --agent claude
node search.cjs --projects # 列出所有项目
node search.cjs --recent 7 # 最近 7 天
node search.cjs --stats # 索引概况
# 记忆桥接:让各智能体读到统一记忆
node bridge.cjs --dry # 先看会改哪些文件
node bridge.cjs # 注入指针块(幂等)
node bridge.cjs --status # 查看注入状态
node bridge.cjs --undo # 一键撤销(精确还原,不碰别的)
```
## 工作流:每次干完活要同步
这是用户明确要求的——**每次执行完任务都要同步进知识库**,这样其他智能体才能看到。
在任务收尾时:
1. 跑 `node collect.cjs`(增量,通常几秒到几十秒)
2. 确认输出里的"新增"数字合理,且没有失败项
3. 如果有失败,看错误信息定位是哪家的格式变了
会话文件是各智能体自己写的,本工具只读不写,所以同步是安全的、可重复执行的。
## 关键实现细节(改代码时必须知道)
这几条都是踩过坑得出的,改之前先读:
1. **DSH 的 zstd 是多帧追加格式**。Node 的 `zstdDecompressSync` 只解第一帧——
实测 943KB 的文件只解出 175 字节。必须先按魔数 `28 B5 2F FD` 切帧再逐帧解压。
见 `adapters.cjs` 的 `readMaybeZstd()`。
2. **中文检索必须用 FTS5 的 trigram 分词器**。`unicode61` 不切中文(整段当一个词),
实测中文查询命中 0。见 `index.cjs`。
3. **FTS5 不能用 contentless 表**。contentless 不支持 DELETE,增量更新时会报
`cannot DELETE from contentless fts5 table`。用普通表。
4. **跨智能体存在镜像重复**。实测 ZCode 完整镜像了 Claude Code 的会话、
Qoder 与 Qoder 国内版共享同一批工作区(323 条重复)。
`dedupe.cjs` 用「项目 + 起始分钟 + 首条诉求」的指纹合并,保留信息最全的一份。
5. **项目名必须归一化**。原始 cwd 有 431 个不同值,大量是
`automation-2026-09-15-14-45-54`、`ff7daa900efa` 这类时间戳/哈希目录。
直接取末级目录名会得到几百个无意义"项目"。见 `project.cjs`。
6. **自动化模板会污染标题**。WorkBuddy 的定时任务把同一段提示词写进每个会话,
直接取首条用户消息当标题,时间线全是重复废话。
`isTemplatePrompt()` 识别后回落到助手结论并标 `⚙️ 自动任务`。
7. **清空笔记只在 `--full` 时发生**。早期版本在每次运行时都清空 `会话/`,
而增量运行时 `kept` 只含本次变动的会话——结果就是跑一次增量把历史笔记全删光。
这是实测发生的真实事故,`clearDir` 现在只由 `opts.full` 触发。
8. **时间线/每日回顾从磁盘全量重建**,不用本次的子集,否则增量运行时聚合视图会缺历史。
9. **文件名撞车要加尾号**。同一天同一智能体可能有多条标题相同的会话
(比如反复跑同一个自动化),直接用标题当文件名会互相覆盖——实测 868 条只落盘 794 个文件。
10. **桥接要幂等且可精确还原**。首次注入时把原文另存为 `.amsx-orig`,
`--undo` 据此做字节级还原;否则反复注入/撤销会让文件尾部逐渐漂移。
11. **全量重建后要 VACUUM**。反复重建会留下大量未回收页,实测索引从 47MB 虚胖到 136MB。
## 安全边界
- **只读源数据**:绝不修改任何智能体的原始会话文件。
- **桥接只动标记块**:写入内容是 `<!-- agent-memory-sync:begin -->` 到
`<!-- agent-memory-sync:end -->` 之间,你手写的其他内容不会被碰;
首次注入前把原文存为 `.bak` 和 `.amsx-orig`,`--undo` 做字节级精确还原(已实测验证)。
- **不删用户文件**:采集器只清理自己生成的 `AI记忆/会话/` 下的 `.md`,
且只在 `--full` 时清理;目录里其他任何文件都不动。
## 用户的偏好(写死在这里,不要违反)
- 回复用中文。
- **不要替用户做任何决策**(编辑器、文件夹、终端、底层行为改动都要先问)。
- **知识库是用户的第二大脑**:写入要克制、要有结构,不要制造噪声。
- **绝不批量删除用户文件**;Vault 批量改动前先备份。
- 用户的记忆入口是 `wiki/_ai-entry.md`,本工具产出放在 `AI记忆/`,两者是补充关系,
不要去改写 `_ai-entry.md`。
Files in this package (6)
- .gitattributes 1 KB
- .gitignore 1 KB
- LICENSE 1 KB
- README.md 13 KB
- SKILL.md 8 KB
- package.json 1 KB
Versions
The database has no other skills named agent-memory-sync.
Database snapshot: 13.11.2026 · package version cb45bd93dbd5 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100session-vault
Back up and restore native local sessions for Codex, Claude Code, Hermes, Pi and CodeBuddy CLI, plus CodeBuddy CN IDE conversations exported as JSON/ZIP. Back up non-sensitive ZCode profile files only. Use for local session migration and verified recovery; Qoder, WorkBuddy, TRAE… - 91agent-office
Open a live office view of every coding agent on this machine — Claude Code, Codex, Copilot CLI, Kimi Code, Grok Build, DeepSeek Harness, Gemini CLI, Qwen Code, Pi, omp, Qoder, WorkBuddy and CodeBuddy — and show who is thinking, running a tool, waiting for you, done or stuck.… - 100zcode-sub
用 zcode-sub CLI 把任务派给本机 ZCode 桌面版当子代理跑:并行派发、运行中补充或打断、收事件与结果。当用户要把工作交给 ZCode、让 ZCode 并行跑多个对话、提到 zcode-sub、或说 delegate to ZCode / ZCode subagent 时使用。要求与 ZCode 桌面版同一台机器。不用于 ZCode 本身的开发与配置、读取 ZCode 历史会话,也不用于跨座位子代理(dwc-sub)或宿主内置的 Agent/Task 子代理。 - 100cleanup
This skill should be used when the user asks to \"clean up memory\", \"sync ctx and memory\", \"review memory\", \"deduplicate nodes\", \"fix memory conflicts\", \"ctx cleanup\", \"memory maintenance\", \"reconcile memory systems\", or mentions stale nodes, memory bloat, or… - 89trae-orchestrator
Orchestrates TRAE IDE for automated software development with multi-agent collaboration. Invoke when user wants to develop software using TRAE or needs automated project management. - 100self-evolve
扫描本机 Claude Code、Codex、WorkBuddy、CodeBuddy、ZCode 等 Agent 会话,保留初始化和增量处理记录,低成本初筛后由当前 Agent 提炼经验、迭代与 Skill 沉淀建议,生成可独立打开的 HTML 报告。也用于复盘当前对话、接续每周沉淀或检查扫描覆盖。无需单独配置模型 API Key;不自动应用建议或安装 Skill。