intelligence-transfer

智能迁移

通过 IPFS 跨项目共享模式。让其他项目或其他机器获取并应用本项目已学习的模式。

为什么需要它

大多数学习都是项目本地的。hooks_transfer 是一种变通方式：将模式发布到 IPFS，分享 CID，任何对等方都可以导入这些模式。这相当于“为 Agent 学到的内容生成部署制品”。

前置条件

# Required env var (or equivalent endpoint config)
echo $PINATA_API_JWT

如果未设置，hooks_transfer 会返回结构化结果 success: false，并附带 error: "PINATA_API_JWT not configured"。请在运行此技能前完成配置。

工作流

发布当前项目的模式

# Inspect what's stored locally first
mcp tool call neural_patterns --json -- '{"list": true}'

# Publish to IPFS — returns a CID
mcp tool call hooks_transfer --json -- '{"action": "store"}'

响应中包含 IPFS CID。请保存并分享给需要这些模式的对等方。

获取并应用对等方的模式

# Pull a CID and apply locally
mcp tool call hooks_transfer --json -- '{"action": "load", "cid": "QmXyz..."}'

# Verify they landed
mcp tool call hooks_intelligence_pattern-search --json -- '{"query": "<test>", "limit": 5}'

模式会与本地状态合并，而不会替换本地状态。冲突按新近程度解决（较新的优先）。

镜像整个项目的模式

# Read patterns from a sibling project on disk and republish under a new CID
mcp tool call hooks_transfer --json -- '{"action": "from-project", "source": "/path/to/peer-project"}'

适用于整合单体仓库或一组相关项目中的学习成果。

何时使用此技能

• 新项目启动前 — 从父项目获取相关模式，让新项目的 Agent 带着已有知识开始，而不是从零起步。
• 取得重要学习成果后 — 发布模式，让其他项目也能受益。
• 调试回归问题时 — 获取已知正常的模式集，以便进行比较。

何时不使用

• 每天使用 — 这是重量级操作。agentdb_consolidate 可在本地完成同类操作。
• 用于敏感模式 — IPFS 默认公开。Pinata 固定内容并不会让模式变成私有。发布前请移除个人身份信息（先使用 aidefence_has_pii）。

注意事项

• IPFS CID 基于内容寻址；重新发布相同的模式集会得到相同的 CID。
• 模式以 JSON 格式存储；其中仅包含嵌入哈希和元数据，不包含原始文本。解码需要使用生成这些模式时相同版本的 SONA / MicroLoRA 适配器。
• 此技能不会发布 AgentDB 行，只发布智能侧的模式。如需导出完整记忆，请使用 agentdb_* 导出工具（不在此处讨论）。

相关内容

• ruflo-agentdb ADR-0001 §“命名空间约定”——定义了此迁移所读取的 pattern 命名空间
• neural-train 技能——生成此技能要迁移的模式