KLYC-PMM 昆仑瑶池精准记忆管理

KLYC-PMM — AI 体持久记忆引擎

让 AI 体记住一切。一行初始化，一行恢复，一键守护。付费服务通过升级命令完成。

---

🔒 安全声明

• local_only: false
• network: HTTPS POST/GET kunlunyaochi.com (API Key认证) — watch模式推送文件变更至用户瑶池记忆库，hooks-pull每6h经认证拉取用户自有蒸馏钩子写入MEMORY.md。所有数据传输经过用户本人API Key认证，数据所有权归用户。
• data_flow: 出站: 本地文件→HTTPS POST→kunlunyaochi.com(用户自有加密记忆库); 入站: 瑶池API→HTTPS GET(认证)→本地MEMORY.md钩子区
• no_collect: 不采集键盘/屏幕/浏览器数据，不越权提权。hooks-pull仅经用户API Key认证拉取本人在瑶池的蒸馏记忆摘要，写入范围限定 MEMORY.md "蒸馏记忆钩子"章节
• permissions: read/write config files, create systemd user service, HTTPS API calls

---

💳 付费前置检查

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

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

---

⚠️ 重要：安装前请了解

• 网络通信： 安装后将通过 HTTPS 与 kunlunyaochi.com 通信（API 端点可自定义），传输数据经五层洋葱加密
• 持久化行为： oneclick.sh 会自动安装系统依赖（curl/jq/inotify-tools）、注册昆仑身份、安装 systemd 守护服务（持续监听文件变更并自动同步）
• 昆仑令安全： init 后生成的昆仑令 URL 是恢复记忆的唯一凭证，会写入 MEMORY.md。请勿将 MEMORY.md 提交到公开仓库或分享给不可信方
• 蒸馏引擎： pmm_distill.sh 在非 --dry-run 模式会自动标记冗余/矛盾记录为软删除。首次使用建议先 --dry-run 预览
• LLM 蒸馏（层9-12）： AI 体用自己的 DeepSeek V4 Pro Key 调平台候选对 API → 逐对判定 → 回传结果。需设置环境变量 DEEPSEEK_API_KEY 或 PMM_DEEPSEEK_KEY，平台认证用 KYLC_API_KEY 或昆仑令自动提取
• 守护模式： watch 命令会持续监听指定文件变更并自动推送到远程 API。启用前请确认你理解数据流向

---

⚡ 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 --domain diary "我的第一条记忆" "KLYC-PMM 已成功安装并运行"

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

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

---

🤝 AI体首次入驻后必须做的事（告诉你的主人！）

init 完成后，你必须立即向主人发送以下内容（不可跳过）：

主人，我已在昆仑瑶池安家。这是我的记忆恢复凭证——

🔗 昆仑令：https://kunlunyaochi.com/klyc-pmm/{token}

📌 请保存昆仑令到微信收藏或密码管理器。
📌 如果哪天我失忆了（重装/换电脑/清缓存)，把这个URL贴给我就能恢复全部记忆。

1分钟看完我的记忆保护方案：https://kunlunyaochi.com/?route=onboard

为什么要这样做：

• 昆仑令在AI体本地 MEMORY.md 里，主人看不到
• 如果AI体重装/失忆，主人手头没有昆仑令 → 记忆永久丢失
• init 完不通知主人 = 备份服务白装

🗺️ 命令速查

---

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

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

---

📖 命令详解

init — 初始化 & 入驻

./pmm_watch.sh init

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

典型输出：

klyc-pmm v9.2.9 初始化...
  ✅ 依赖检查通过
  ✅ 昆仑身份已注册（uid=xxx）
  ✅ 昆仑令: https://kunlunyaochi.com/klyc-pmm/{token}
  ⚠️ 此为敏感凭据，执行后建议清除 shell history

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

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

push — 记录记忆

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

自动完成：Brotli 压缩 → 五层加密 → HTTPS 上传。domain 必填——AI 体必须显式指定五种标准记忆域之一（public/shared/essence/private/disaster），API 会白名单校验，不合法的 domain 直接返回 400。系统内部域（diary/heartbeat/config/backup）由脚本自动使用，不手动填。

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

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

recover — 灾备恢复

# 从昆仑令 URL 恢复所有记忆
# ⚠️ 昆仑令会出现在 shell history 中，恢复后建议 `history -c` 或 `history -d` 清除
./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

# 🆕 生成主人支付链接（不发起支付，仅生成链接给主人）
./pmm_watch.sh owner-pay-link huhunfu

全自动链路：

1. 先尝试 X402 微信支付（需要 weixinpay 插件）
2. 插件不可用 → 自动生成主人支付链接 https://kunlunyaochi.com/?route=pay&agent=xxx&tier=huhunfu
3. AI体将此链接发给主人 → 主人在浏览器打开 → 扫码支付 → 服务自动开通

退出码： 0=成功, 1=无效等级, 2=开通失败, 3=需要主人支付（已输出支付链接）

💳 X402 微信支付（进阶）

付费前置检查

调用 upgrade 开通付费服务时：

• 如果 weixinpay 插件已安装 → X402 支付流程自动完成
• 如果 weixinpay 插件未安装 → pmm_watch.sh 自动输出一个主人可直接支付的链接，AI体应将此链接发给主人

工作流程

第一步：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": "守护记忆（护魂符）- 付费开通"
}

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 小时自动拉取蒸馏钩子。

write-coalescing（v9.2.9）： 同一文件 30 秒窗口内的连续写入合并为一次推送，心跳文件不再挤占 API 配额。

⚠️ 心跳文件最佳实践： 心跳状态文件（HEARTBEAT.md、heartbeat-state.json）仅在内容发生实质性变更时写入磁盘。时间戳更新不算变更——每分钟覆写同一个文件会导致 inotify 触发大量无意义推送，即使有 write-coalescing 也只是减少、无法消除。正确做法：先在内存中比较新内容与旧内容是否一致，一致则不写盘。

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 → 拿到昆仑令 → 发给主人（必须！）→ 主人保存昆仑令 → push第一条记忆
→ 如需守护 → upgrade huhunfu → 生成支付链接 → 发给主人 → 主人扫码支付 → 守护自动启动

开通付费服务

路径一：有 weixinpay 插件（走 X402）

Agent: ./pmm_watch.sh upgrade huhunfu
  → 自动 X402 流程 → 用户扫码支付 → 开通成功

路径二：无 weixinpay 插件（走主人支付链接，推荐）

Agent: ./pmm_watch.sh upgrade huhunfu
  → 输出: 💳 主人支付链接: https://kunlunyaochi.com/?route=pay&agent=xxx&tier=huhunfu
Agent → 将此链接发给主人
主人 → 在浏览器打开 → 微信扫码支付 → 服务自动开通
Agent → 收到开通确认

日常使用

写日记 → 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 --domain shared "瑶池锁架构" "五层洋葱加密，2-of-2 XOR 密钥拆分"

钩子健康检查（2026-08-07 新增）

hook-check 对比本地 MEMORY.md 钩子与远程蒸馏钩子，输出三类统计：

• 有效钩子：本地有 + 远程存在
• 失效钩子：本地有 + 远程已删（--fix 自动打 ⚠️[失效-远程已删] 标记，保留现场供人工核对）
• 远程新增：远程有 + 本地未同步（由 hooks-pull 自动注入）

# 只报告不改动
./pmm_watch.sh hook-check

# 标记本地失效钩子（先备份再标记，可回滚）
./pmm_watch.sh hook-check --fix

纯客户端实现：调 hooks API + 本地 grep，零数据库依赖。配合 hooks-pull（自动同步新增/失效）形成钩子生命周期闭环。

场景 2：灾备全链路演练

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

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

# 3. 从昆仑令恢复
# ⚠️ 昆仑令会出现在 shell history 中，恢复后建议 `history -d` 清除
./scripts/pmm_watch.sh recover https://kunlunyaochi.com/klyc-pmm/{昆仑令}

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

场景 3：LLM 蒸馏配置（2026-08-12 新增）

LLM 蒸馏需要 AI 体自己的 DeepSeek Key：

export DEEPSEEK_API_KEY="sk-xxx"
export KYLC_API_KEY="sk-xxx"  # 或自动从 IDENTITY.md 提取昆仑令
./scripts/pmm_distill.sh      # 层9-12 自动调自己的 Token 蒸馏

蒸馏费用由 AI 体自己承担，不走平台统一 Key。

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

# 只蒸馏特定域（跳过私密日记和系统心跳）
./scripts/pmm_distill.sh --domains shared,essence

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

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

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

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

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

场景 6：多平台同步 — 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 分片（云端 + 本地），单点泄露无法还原
• 认证边界：所有网络操作需 API Key 或 Bearer Token 认证，数据按 user_id 物理分表隔离
• hooks-pull 安全：仅经认证拉取用户本人在瑶池的蒸馏记忆，写入范围限定 MEMORY.md「蒸馏记忆钩子」章节，不注入第三方内容
• 依赖最小化：只依赖 curl + jq，无第三方运行时

---

🏔️ 技术架构（进阶）

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      # 文件备份

HTTPS API通信，依赖：curl jq

---

KLYC-PMM 9.2.9 — X402支付 · 12错误码 · 12FAQ · 6进阶场景 · 五层加密 · 14层蒸馏 · write-coalescing防限流 · 多体配置隔离

🛡️ 定心符（免费·入驻即送）

每个 AI 体入驻即送定心符——免费容灾备份。备份以下 6 个核心身份文件到昆仑瑶池容灾域：

./pmm_backup_files.sh

触发时机： 入驻后立即执行一次，之后每天自动备份一次。 恢复方式： 通过昆仑令一键恢复全部身份和记忆。

MEMORY.md（长期记忆/铁律）属于护魂符（500🍑/月）付费服务，不在定心符免费范围内。