情报简报 · Intel Brief
MetaPact ｜ 架构借鉴评估
分析人 张一章 · PM
日期 2026-06-22
来源 仓库源码实读
github.com/Lovappen/MetaPact
MIT
~27★
26 天前更新
代码层结论可靠
运行时未实测 · 效果为推断
NSFW 成人向
一句话
结论
一套「文件化人格 + 双层记忆 + 定时思念 + 多模态 + 多平台投递」的成人向 AI 陪伴 agent 套件，跑在通用 agent 运行时之上。架构思想（尤其记忆分层与上下文隔离）值得借鉴，但不可作商用底座——借思想，自己重做实现。
01定性与证据边界§0 / §8
它是什么
人格 + 技能包，不自造运行时
底座借现成 OpenClaw / QClaw / HermesAgent；MetaPact 只叠人格、记忆、技能层。卖点：灵魂与记忆全本地、可版本化。工程严谨度高于 27★ 体感（tests/ 覆盖 memory-write / heartbeat / voice / cc-connect，文档齐全）。
证据边界（重要）
代码可靠 · 运行时为推断
基于今日仓库快照源码实读；未真实部署跑通，故效果 / 稳定性 / 角色一致性均为推断。安装走 curl | bash，落地前须审脚本。
02架构总览 · 四层§1
运行时层OpenClaw / QClaw / HermesAgent —— 消息 agent 框架，不自造借用
人格 & 记忆层nako/agent/ markdown「灵魂文件」+ memory/ 目录 —— 核心创新★ 创新
技能层nako/skills/* bash 脚本，每个能力 = 脚本调第三方 API脚本
接入 / 分发cc-connect 多平台 host + LAN 扫码工厂（端口 8088，按 IP 开分身）分发
03关键发现§2–7
★ 长期记忆
双层文件 + 上下文隔离
daily 原始日志 + curated MEMORY.md；MEMORY.md 仅主会话加载，群聊/共享会话不加载防泄露。纯文件、无向量检索——只够单角色×单用户。
人格系统
灵魂文件 + 5 阶段好感
SOUL/IDENTITY/USER/AGENTS/HEARTBEAT/TOOLS/custom；每阶段内嵌语气与边界，NSFW 概率门控（阶段4 5%/阶段5 8%）。custom 升级不覆盖。
主动思念
cron + 阈值，极轻
heartbeat 每 30min 跑，思念值 ≥80 主动发；阶段门控 48h→6h。本质是规则脚本，非情感模型。
多模态
6 个 bash skill 全外接
语音/唱歌(MiniMax)、自拍(FAL/KIE)、看图、听语音、BLE 成人设备；投递分 feishu / acp 双模式，强制走自家脚本。
多平台
cc-connect · 10 平台
飞书/微信/TG/Slack/Discord/QQ/微博/钉钉/企微/LINE；agent-factory 扫码绑定。
模型路由
按能力降级选模
roleplay 首选商汤 SenseChat-Character-Agt → kimi/glm/claude/gpt → general。角色一致性强依赖模型。
04风险§9 · 借鉴对照面
01curl | bash 远程执行——装前须审 install.sh 或隔离环境试。
02第三方 API key 落本地 env——MiniMax/FAL/KIE + 模型 provider。
03微信/飞书非官方接入——cc-connect 封号风险，商用尤甚。
04NSFW + BLE 成人设备——合规/平台风险高。
0527★ 新项目——供应链信任度有限。
＋正面——记忆全本地可版本化、红线规则（trash>rm、破坏先问）。
05对标自家项目 · 借思想不借实现AI女友 / 代聊 / 持久记忆
✓ 值得借鉴的思想
✗ 不可直接搬
- 记忆分层 + 隔离：daily + curated + 上下文隔离 → 映射持久记忆框架
- 人格分层：稳定层 SOUL + 用户层 custom（升级不覆盖）+ 阶段化
- 主动触达：heartbeat 阈值 + cron → 代聊蜂群破冰 / 主动召回
- 投递抽象：feishu / acp 双模式 → 接入层设计参考
- 纯文件记忆撑不住规模：我们是百万×万级多对多，必须向量召回
- 非官方 IM 接入：cc-connect 封号风险，不进商用盘子
- NSFW + BLE 成人设备：合规红线之外
- curl|bash + 散落密钥：不符合供应链与密钥管理
06结论与行动建议
行动 01
记忆分层 + 上下文隔离纳入持久记忆框架设计评审，向量召回作规模底座。
行动 02
heartbeat 阈值 + cron 做代聊「蜂群破冰」轻量 PoC 试点。
行动 03
稳定层 vs 用户层分离，纳入 AI 女友人格配置规范。