sync-memory

/digital-marketing-pro:sync-memory

脚本位置。 如果宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 并列。请使用 Python 3.10 或更高版本运行：python；如果找不到 python（macOS 和许多 Linux 系统），则使用 python3。

用途

批量将当前会话中的经验、insights.json 条目和营销活动历史同步到持久化记忆层。确保保留本次会话中有价值的知识，供后续会话使用，而无需用户通过 /digital-marketing-pro:save-knowledge 手动保存每一项。采用增量同步——仅同步上次检查点之后新增的内容——因此重复同步速度快、具备幂等性且安全。处理从差异检测到存储，再到更新检查点的完整流程，并详细报告已同步、已跳过或失败的内容。在富有成效的会话结束前运行此命令，以保存所有值得记住的内容。

所需输入

用户必须提供（或系统会提示用户提供）：

• 同步范围：要同步的内容——all（经验 + 营销活动 + 会话学习）、insights-only（仅同步 insights.json 条目——绩效数据、指标快照和自动生成的经验）或 campaigns-only（仅同步营销活动数据、复盘经验和策略决策）。默认值为 all
• 强制完整同步（可选）：设为 true 可忽略上次同步检查点，无论之前的同步状态如何都重新同步所有内容。适用于数据损坏、向量数据库迁移、索引重建，或本地索引与持久化存储可能不一致的情况。默认值为 false（从上次检查点开始增量同步）
• 内容类型覆盖（可选）：强制为所有同步项目指定特定的 content_type 分类，覆盖自动检测结果。很少需要，但在迁移知识分类体系时，适用于批量重新分类
• 试运行（可选）：设为 true 可预览将要同步的内容，但不实际存储任何内容。显示完整差异、负载预览和预计存储影响，供提交前审核。适用于审查上次同步后累积的内容
• 要应用的标签（可选）：为本次同步批次中的所有项目添加其他标签，例如“q1-2026-review”“pre-rebrand”“campaign-retrospective”。这些标签会与自动检测的标签一同添加，而非替换它们
• 排除模式（可选）：指定本次同步要跳过的内容模式或类型，例如排除草稿经验、不完整的营销活动数据或特定内容类型。避免同步不完整或仍在处理中的知识

流程

1. 加载品牌背景：读取 ~/.claude-marketing/brands/_active-brand.json，获取当前激活的 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语调、目标市场合规规则（skills/context-engine/compliance-rules.md）和行业背景。另检查 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json 中是否有指南；如果存在，加载其中的限制。检查 ~/.claude-marketing/sops/ 中是否有代理机构 SOP。如果不存在品牌，请询问：“要先设置品牌吗（/digital-marketing-pro:brand-setup）？”——或者使用默认设置继续。
2. 加载同步状态：运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/memory-manager.py" --brand {slug} --action sync-insights，从 ~/.claude-marketing/brands/{slug}/memory/_last_sync.json 加载上次同步检查点。识别上次同步时间戳、此前已同步的条目（按内容哈希）以及需要从失败处恢复的部分同步任务。如果请求强制同步，则将检查点重置为 epoch 零。
3. 收集可同步条目：加载 insights.json 条目、campaigns/ 中的活动数据，以及当前工作上下文中累积的会话经验。应用同步范围筛选器（all、insights-only、campaigns-only）和排除模式，构建候选集。
4. 识别新增和修改的条目：将候选集与同步检查点进行比较。为每个候选条目生成内容哈希（SHA-256），并与本地内容哈希注册表进行比较。将条目分为：新增（此前未同步）、已修改（自上次同步以来内容已更改——哈希不匹配）和未更改（已同步——跳过）。继续之前先报告差异摘要。
5. 准备存储负载：对每个新增或已修改条目，运行 memory-manager.py --action prepare-store，构建元数据负载——根据来源自动检测 content_type（insight 条目设为 performance-insight，活动复盘设为 campaign-learning，策略决策设为 campaign-learning，指南设为 guideline），应用自动检测的标签及用户指定的批次标签，并将 source 设为 sync。
6. 检查已配置的记忆服务：运行 python "${CLAUDE_PLUGIN_ROOT}/scripts/memory-manager.py" --brand {slug} --action get-memory-status。这只检查环境变量——它会报告已配置的后端，而不会报告后端是否可访问，也不会报告远程剩余容量（无法测量远程提供商的用量）。如果未设置向量数据库环境变量，则在本地存储，并建议连接向量数据库。
7. 执行批量存储：如果已连接向量数据库 MCP（例如 Pinecone），则通过它存储每个已准备的条目；否则将条目保存到本地索引。按顺序处理条目，以便妥善处理故障——如果某个条目存储失败，则记录包含错误详情的故障，并继续处理其余条目。每次成功存储后，立即更新本地内容哈希注册表，避免同步中断时丢失进度。
8. 更新同步状态：处理完所有条目后，使用新的检查点时间戳、累计已同步条目数、跳过条目数、失败条目数（附带用于重试的内容哈希）以及各层存储状态更新 _last_sync.json。如果有条目失败，其哈希将排入队列，在下次同步运行时自动重试。
9. 报告同步摘要：提供完整的同步报告及可执行的详情——同步了哪些内容、跳过了哪些内容及原因、哪些内容失败以及如何修复、存储利用率状态，以及此品牌持久化记忆的当前状态。

输出

一份结构化的同步报告，包含：

• 同步摘要：已处理的总项目数及明细——新增同步的项目、已更新的修改项目、已跳过的重复项（按原因统计：哈希匹配、排除模式），以及失败项目的具体错误原因和相应补救步骤
• 已同步项目详情：列出每个已同步项目的内容摘要（前 100 个字符）、分配的 content_type、应用的标签（自动检测 + 批次标签），以及用于参考的向量数据库存储 ID
• 已跳过项目：按原因列出重复项和排除项——内容哈希匹配（已存在于持久化存储中）、命中排除模式，或自上次同步以来未发生变化——以便用户确认没有遗漏任何重要内容
• 失败项目：列出无法存储的所有项目——包含完整错误消息、失败原因（API 超时、验证错误、容量限制、格式错误的负载）、用于重试识别的内容哈希，以及具体补救步骤
• 同步状态更新：新的检查点时间戳、持久化记忆中的累计项目数（所有同步总计）、自上次同步以来的增量（净新增项目数），以及根据当前会话活动速率估算的下次同步规模
• 各层状态：哪些记忆层接收了数据——已存储的向量 DB 项目（含命名空间）、已创建的知识图谱实体（如果已连接图谱服务）、已更新的跨会话条目（如果已连接跨会话存储），以及已注册的本地索引条目
• 本地索引大小：本次运行从本地索引同步的项目总数，以及累计本地项目数。（DMP 无法读取远程向量 DB 的套餐用量——请在服务提供商自己的仪表板中查看剩余容量。）
• 下次同步建议：根据会话活动量和存储容量建议下次同步时间——并提醒用户，在结束会话前运行 /digital-marketing-pro:sync-memory，可确保不会丢失任何经验

使用的 Agent

• memory-manager — 加载同步检查点，并根据内容哈希注册表计算增量差异；为新增和修改项目生成 SHA-256 哈希；准备负载，并自动分类内容类型、根据来源添加标签；通过向量数据库 MCP 批量执行存储，逐项处理错误并持久化进度；每次成功存储后更新本地索引和内容哈希注册表；管理同步状态检查点，并为中断的同步恢复部分进度；监控存储容量并在用量过高时发出提醒；生成全面的同步报告并管理重试队列