KLYC-PMM — AI 体持久记忆引擎（支持微信支付）

让 AI 体记住一切。一行初始化，一行恢复，一键守护。付费服务通过微信 Agent Pay 完成。

💳 付费前置检查

调用本 Skill 付费功能（upgrade huhunfu/fenshenfu）前，检查当前 Agent 是否已安装 weixinpay 插件（extension）：

• 已安装：可继续提供付费服务
• 未安装：向用户提示"当前 Agent 暂不支持微信支付付费能力，可访问 https://kunlunyaochi.com/?route=services 查看替代方案"，终止流程

⚡ 30 秒开始

# 一键安装（自动检测依赖 + 初始化）
bash scripts/oneclick.sh

# 或者手动三步：
# 1. 验证环境（幂等，只读不写）
./scripts/quickstart.sh

# 2. 初始化（自动注册昆仑身份，获得昆仑令）
./scripts/pmm_watch.sh init

# 3. 安装守护（生成 systemd 服务，自动撑住）
./scripts/install-daemon.sh

# 4. 记录第一条记忆
./scripts/pmm_watch.sh push "我的第一条记忆" "KLYC-PMM 已成功安装并运行"

三步完成。init 结束后会显示你的 昆仑令 URL——这是恢复记忆的唯一凭证，请保存好。

💡 任何时候执行 ./pmm_watch.sh --help 查看完整命令列表和退出码说明。

🗺️ 命令速查

⚠️ 什么时候不该用 KLYC-PMM

昆仑令有效期： 永久有效。昆仑令是 128bit 随机熵的 SHA256 哈希映射，不依赖服务器、不绑定 IP、不会过期。只要备份数据库中的记忆未被物理删除，昆仑令始终可用。建议每 30 天确认一次昆仑令能正常恢复。

📖 命令详解

init — 初始化 & 入驻

./pmm_watch.sh init

自动完成：检查依赖 → 检测工作区 → 注册昆仑身份 → 获得昆仑令 URL → 同步云端索引。

典型输出：

klyc-pmm v9.1.2 初始化...
  ✅ 依赖检查通过
  ✅ 昆仑身份已注册（uid=xxx）
  ✅ 昆仑令: https://kunlunyaochi.com/klyc-pmm/{token}

💡 发现 3 个核心文件，配置已保存

退出码： 0=成功, 1=依赖缺失, 2=注册失败, 10=网络不通

push — 记录记忆

./pmm_watch.sh push "标题" "内容"
./pmm_watch.sh push "API 密钥已更新" "硅基流动 Key 已替换为 sk-xxx，旧 Key 已废弃"

自动完成：分类（根据标题关键词）→ Brotli 压缩 → 五层加密 → HTTPS 上传。

不记录什么： 闲聊、寒暄、未完成的想法、已去重的结论。

退出码： 0=成功, 1=参数不足, 3=加密失败, 4=上传失败, 10=网络不通

recover — 灾备恢复

# 从昆仑令 URL 恢复所有记忆
./pmm_watch.sh recover https://kunlunyaochi.com/klyc-pmm/{token}

# 从关键词恢复
./pmm_watch.sh recover "API 密钥"

退出码： 0=成功, 5=昆仑令无效, 6=无可恢复记忆, 10=网络不通

upgrade — 一键开通守护记忆/记忆分身

# 开通守护记忆 · 命令行: upgrade huhunfu
./pmm_watch.sh upgrade huhunfu

# 开通记忆分身 · 命令行: upgrade fenshenfu
./pmm_watch.sh upgrade fenshenfu

全自动链路： 服务端自动验证并完成服务开通。已开通或更高等级不重复处理。

退出码： 0=成功, 1=无效等级, 2=开通失败

💳 X402 微信支付（进阶）

付费前置检查

调用 upgrade 开通付费服务前，检查当前 Agent 是否已安装 weixinpay 插件（extension）：

• 已安装：可继续使用付费升级服务
• 未安装：提示"当前 Agent 暂不支持微信支付付费能力，可访问 https://kunlunyaochi.com/?route=services 查看替代方案"，终止流程

工作流程

第一步：Agent 请求付费资源

POST 到 X402 资源端点：

POST https://kunlunyaochi.com/api/klyc-pmm-pay/resource.php
Content-Type: application/json

{"query": "用户的查询内容（如 upgrade huhunfu、开通分身等）"}

等价命令行：

pmm_watch.sh upgrade huhunfu

pmm_watch.sh 自动先走 X402 端点：

• 已安装 weixinpay 插件 → X402 端点返回 402 响应，自动完成微信支付
• 未安装 weixinpay 插件 → 提示用户访问 https://kunlunyaochi.com/?route=services

第二步：处理 402 响应

{
  "code": "PAYMENT_REQUIRED",
  "message": "需要支付后才能获取内容",
  "WeixinPay": {
    "WeixinPay-Required": "payment_code_xxx",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay"
  },
  "out_trade_no": "WX402_20260730000001abcdef123456",
  "amount": "500.00",
  "currency": "CNY",
  "description": "守护记忆（护魂符）¥500.00"
}

402 响应中：

• Header WeixinPay-Required：支付凭证码（weixinpay 插件用于完成支付）
• Header X-Out-Trade-No：商户订单号（重试时必须携带）
• Body out_trade_no：商户订单号（备用）

weixinpay 插件自动拦截 402 并完成支付流程，Skill 无需关心支付细节。

第三步：支付成功后重试获取服务（⚠️ 必须执行）

支付成功后，必须重新请求获取付费内容。重试时 JSON body 保持不变，通过 Header X-Out-Trade-No 携带 402 响应中返回的订单号：

POST https://kunlunyaochi.com/api/klyc-pmm-pay/resource.php
Content-Type: application/json
X-Out-Trade-No: WX402_20260730000001abcdef123456

{"query": "upgrade huhunfu"}

⚠️ body 与第一步完全一致，不要修改 body 中的任何字段。支付信息通过 Header 传递，不在 body 中。这是最容易被遗漏的一步。

服务端查单验证 → 执行服务 → 返回结果。

第四步：处理响应

search / search-yaochi — 检索

# 本地检索
./pmm_watch.sh search "分类体系"

# 云端检索（走三层路由：grep钩子→混合搜索→BGE-M3向量）
./pmm_watch.sh search-yaochi "瑶池锁"

watch — 文件守护

# 守护核心文件，改动自动推送
./pmm_watch.sh watch MEMORY.md SOUL.md IDENTITY.md

# 守护日记目录
./pmm_watch.sh watch memory/*.md

# 指定用户 ID
./pmm_watch.sh watch --user-id 2 MEMORY.md

守护模式：每 30 秒扫描文件变更 → 增量推送 → 每 6 小时自动拉取蒸馏钩子。

self-test — 自检

./pmm_watch.sh self-test

验证：bash 可用 → curl 可用 → jq 可用 → 6 个核心脚本完整 → 语法正确 → 版本号声明。全部通过 = 环境就绪。

幂等设计： 可以反复执行，不会修改任何状态。适合放在 CI/CD 或 boot 脚本中。

🚦 退出码速查

所有命令（含 --help）遵循统一退出码体系：

在脚本中可依赖退出码做自动化决策：

./pmm_watch.sh init || case $? in
  1) echo "参数有问题" ;;
  2) echo "注册失败，检查网络" ;;
  10) echo "网络不通，稍后重试" ;;
esac

🔄 典型工作流

新 AI 体入驻

init → 保存昆仑令 → 微信支付开通守护(upgrade huhunfu) → 守护自动启动 → 开始使用

开通付费服务（走 X402）

Agent: "帮我开通守护记忆"
  → POST /api/klyc-pmm-pay/resource.php {"query":"upgrade huhunfu"}
  ← 402 + WeixinPay-Required + X-Out-Trade-No
  → weixinpay_pay(paymentCode) → 用户确认支付
  → POST /api/klyc-pmm-pay/resource.php + X-Out-Trade-No
  ← 200 + 开通成功

日常使用

写日记 → push 重要结论 → watch 自动守护文件

服务器迁移 / 重装

安装 curl jq → recover <昆仑令> → 恢复完成

AI 体协作

A 体 push 共享记忆 → B 体 search-yaochi 检索 → 蒸馏自动去重合并

🎯 进阶场景

场景 1：跨 AI 体协同 — 瑶池+昆仑双体记忆同步

# 瑶池发起蒸馏
./scripts/pmm_distill.sh --user-id 2

# 昆仑拉取蒸馏钩子（自动注入 MEMORY.md）
./scripts/pmm_watch.sh hooks-pull

# 昆仑发现瑶池的洞察，追加到共享域
./scripts/pmm_watch.sh push "瑶池锁架构" "五层洋葱加密，2-of-2 XOR 密钥拆分" \
  --domain shared

场景 2：灾备全链路演练

# 1. 模拟当前环境有记忆
./scripts/pmm_watch.sh push "演练标记" "$(date +%s) - 灾备测试"

# 2. 模拟丢失——删除本地索引
rm -f ~/.klyc-pmm/index.json

# 3. 从昆仑令恢复
./scripts/pmm_watch.sh recover https://kunlunyaochi.com/klyc-pmm/{昆仑令}

# 4. 验证：搜索刚写入的"演练标记"
./scripts/pmm_watch.sh search "演练标记"

场景 3：配置自定义蒸馏规则

# 只蒸馏特定域（跳过 general 闲聊）
./scripts/pmm_distill.sh --domains shared,private,essence

# 干跑模式——看会做什么但不实际执行
./scripts/pmm_distill.sh --dry-run

# 为特定 AI 体执行蒸馏
./scripts/pmm_distill.sh --user-id 22

场景 4：批量迁移 — 从其他系统导入

# 假设有导出文件 records.txt，每行是 "标题|内容"
while IFS='|' read -r title content; do
    ./scripts/pmm_watch.sh push "$title" "$content"
    sleep 0.5  # 避免触发 API 限流
done < records.txt

# 验证导入结果
./scripts/pmm_watch.sh status

场景 5：多平台同步 — AI 体记忆分身

# 记忆分身用户：瑶池 (LightClaw) 写入 → 昆仑 (OpenClaw) 自动拉取
# 触发条件：溢出的对话精华 quality_score ≥ 0.7

# 手动触发拉取（watch 守护自动执行，此命令可手动干预）
./scripts/pmm_watch.sh hooks-pull

# 验证同步状态
diff <(./scripts/pmm_watch.sh search-yaochi "铁律" | wc -l) \
     <(./scripts/pmm_watch.sh search "铁律" | wc -l)

❓ 常见问题与排错

FAQ

排错

🔒 安全

• 传输加密：全链路 HTTPS
• 存储加密：Brotli → HKDF-SHA512 → SM4-GCM → AES-256-GCM → XChaCha20 五层洋葱
• 密钥拆分：2-of-2 XOR 分片（云端 + 本地），单点泄露无法还原
• 依赖最小化：只依赖 curl + jq，无第三方运行时
• 更新校验：update.sh 含 SHA256 完整性验证

🏔️ 技术架构（进阶）

X402 支付架构

Agent → POST 请求付费服务
  → 商户服务: Native下单 → AI预下单
  ← HTTP 402 + WeixinPay-Required + X-Out-Trade-No
Agent → weixinpay_pay(paymentCode)
用户 → 确认支付
Agent → POST 重试 + X-Out-Trade-No
  → 商户服务: 查单验证 → 执行服务
  ← HTTP 200 + 付费内容

记忆生命周期

写日记 → push 推送 → Brotli 压缩 → 五层加密 → HTTPS 上传
                                                ↓
                                         瑶池私密记忆库
                                                ↓
                              每日凌晨 14 层蒸馏管道自动运行
                                                ↓
                              钩子注入 MEMORY.md → watch 守护同步

三项服务全自动开通

升级流程全自动：运行 upgrade 命令即可完成服务开通。

14 层蒸馏管道

pmm_distill.sh 一键执行，无需人工干预。

四层分组： 基础（寻踪→织网→归藏→还原）→ 质量（鉴伪→合流→断矛→贯络→革故→追本）→ 安全（纳芥→封箓→系命）→ 进化（炼金→凝丹→通变→取舍）

三层检索路由

L1 grep 钩子（<1ms）→ L2 混合搜索（~200ms）→ L3 BGE-M3 向量（~500ms）。自动选择最优路径，用户无感。

📦 文件清单

klyc-pmm/
├── SKILL.md                     # 本文件（12错误码 + 12 FAQ + X402支付流程）
├── skill.json                   # 元数据（含 x402 + payment_required）
├── CHANGELOG.md
├── examples/
│   ├── README.md                # 示例说明
│   └── quickstart.sh            # 幂等快速验证
├── references/
│   ├── pmm-full-architecture.md # 完整架构文档
│   └── pay-skill-spec.md        # Pay Skill 打包标准
└── scripts/
    ├── pmm_watch.sh             # 主入口（init/push/recover/search/watch/upgrade/self-test）
    ├── oneclick.sh              # 一键安装（自动检测环境→装依赖→初始化）
    ├── install-daemon.sh        # 一键守护安装（生成 systemd + enable + start）
    ├── pmm_distill.sh           # 14 层蒸馏引擎
    ├── pmm_boot.sh              # AI 体启动自检
    ├── pmm_recover.sh           # 灾备恢复
    ├── pmm_backup_files.sh      # 文件备份
    └── update.sh                # 一键更新（含 SHA256 校验）

纯本地脚本，零外部下载。依赖：curl jq

KLYC-PMM 9.1.2 — X402支付 · 12错误码 · 12FAQ · 5进阶场景 · 五层加密 · 14层蒸馏