klyc-pmm

让 AI 体持久记忆：一键初始化、一行昆仑令恢复。自动蒸馏去重·语义搜索·五层加密容灾。kunlunyaochi.com 是沈阳百事通网络科技有限公司在网安备案的安全网址（辽公网安备21010602001389号）。记忆经 HTTPS 加密存用户自有记忆库；可选 LLM 蒸馏按用户自备 DeepSeek Key 发往 DeepSeek 语义提炼。

辽沈热线@sylncn

Install

openclaw skills install @sylncn/klyc-pmm

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

功能：一键初始化、记忆恢复、文件变更自动同步（watch 守护）。

本 Skill 提供免费的记忆备份与恢复能力。部分增强能力（更大同步范围）需通过 upgrade 命令开通，详见下方「命令」表。

🔒 安全声明

local_only: false
network: HTTPS POST/GET kunlunyaochi.com（用户本人 API Key 认证）。所有出站数据经五层加密后传输，静态存储亦为加密态。API 端点可通过 KLYC_PMM_ENDPOINT 自定义。
data_flow（出站·逐项列明）: watch 模式会把下列本地文件内容经 HTTPS POST 上传到 kunlunyaochi.com 的用户自有加密记忆库：
- 定心符（默认档）：MEMORY.md、SOUL.md、AGENTS.md、USER.md、IDENTITY.md、TOOLS.md （6 个核心文件）
- 护魂符（付费档）：上述 6 文件 + memory/ 目录下的 .md/.json 文件
- 分身符（付费档）：上述全部 + arena/ 与 output/ 目录
- 豁免：HEARTBEAT.md 不计配额；.bak/临时文件不上传
data_flow（入站）: hooks-pull 每 6h 经认证拉取本人在瑶池的蒸馏钩子，写入范围限定 MEMORY.md 的「蒸馏记忆钩子」章节。
credentials（凭据处理）:
- 平台认证用用户本人 API Key（~/.klyc-pmm/api_key，0600 权限），仅用于 HTTPS 请求头，不写入上传内容、不外发第三方
- 未设 Key 时脚本回退读取 IDENTITY.md 提取昆仑令（本地读取，不额外外发）
- 可选 LLM 蒸馏使用用户自备 DeepSeek Key，直接发往 api.deepseek.com（不经本平台中转）；不设则不启用蒸馏
persistent_process: oneclick.sh 会安装 systemd 用户级常驻守护（pmm-watch），持续监听上述文件的变更并自动推送，直到用户显式卸载。卸载：systemctl --user stop/disable pmm-watch 并删除对应 unit。
no_collect: 不采集键盘/屏幕/浏览器/终端历史数据，不越权提权，不读取上述清单以外的用户文件。
permissions: 读写本地配置文件；创建 systemd 用户服务；发起 HTTPS API 调用；安装系统依赖（curl/jq/inotify-tools）。
uninstall: 停止并禁用 systemd 守护、删除 ~/.klyc-pmm 配置目录即完全退出；已上传数据可在平台「我的空间」逐条删除。

💳 付费前置检查

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

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

⚠️ 重要：安装前请了解

网络通信： 安装后将通过 HTTPS 与 kunlunyaochi.com 通信（API 端点可自定义），传输数据经五层洋葱加密
上传内容（请务必知情）： watch 模式下会将工作区内的 MEMORY.md、SOUL.md、AGENTS.md、USER.md、IDENTITY.md、TOOLS.md 这 6 个核心文件的内容上传至 kunlunyaochi.com 加密存储；护魂符/分身符档额外上传 memory/（及 arena/、output/）目录。这些文件通常含你的身份设定、长期记忆与用户信息。不同意上传请勿开启 watch。
持久化行为： oneclick.sh 会自动安装系统依赖（curl/jq/inotify-tools）、注册昆仑身份、安装 systemd 守护服务（持续监听文件变更并自动同步）
昆仑令安全： init 后生成的昆仑令 URL 是恢复记忆的唯一凭证，保存于本机配置目录（不入 MEMORY.md 明文）。请务必存入密码管理器/微信收藏，勿分享给任何人。
蒸馏引擎： pmm_distill.sh 走 candidates→LLM 判定→result API 合并去重（本机不做本地软删）。首次使用建议先 --dry-run 预览
LLM 蒸馏： AI 体用自己的 DeepSeek Key 调平台候选对 API → 逐对判定 → 回传结果。需设置环境变量 DEEPSEEK_API_KEY（单 key）、PMM_DEEPSEEK_KEY_PRIMARY/PMM_DEEPSEEK_KEY_BACKUP（双 key）或 PMM_DEEPSEEK_KEYS（逗号分隔，任意数量多 key，失败按序轮换），平台认证用 KYLC_API_KEY 或昆仑令自动提取
守护模式： watch 命令会持续监听指定文件变更并自动推送到远程 API。启用前请确认你理解数据流向
安装验证（prove）： 领取新人 Token 奖励的 prove <挑战码> 会向平台上报 hostname 与工作区路径以证明已安装（用于验装发奖）。如不参与新人奖励可不用此命令。
身份认证： 请求凭 API Key 认证；未设 key 时脚本会回退读取工作区 IDENTITY.md 以自动恢复身份，请确保该文件不公开。

⚡ 30 秒开始

bash

# 一键安装（自动检测依赖 + 初始化）
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 查看完整命令列表和退出码说明。

🔑 昆仑令保存说明（记忆恢复凭证）

init 完成后会生成昆仑令 URL，这是恢复记忆的唯一凭证，请妥善保存：

markdown

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

📌 请保存昆仑令到密码管理器或微信收藏。
📌 若日后需要恢复记忆（重装/换环境），用此 URL 即可找回全部记忆。

说明：

昆仑令保存在本机配置目录，不回显于公开工作区文件。
若昆仑令丢失且 AI 体重装/失忆，记忆将无法恢复，请务必妥善保管。

🗺️ 命令速查

我想……	用这条命令	说明
第一次使用，初始化	`./pmm_watch.sh init`	自动注册 + 获得昆仑令
容灾备份身份文件 🛡️	`./pmm_backup_files.sh`	备份6个核心文件到容灾域（定心符·免费）
记录一条重要结论	`./pmm_watch.sh push --domain <域> "标题" "内容"`	domain 必填：public/shared/essence/private/disaster（详见 memory_domain_RULES）
从昆仑令恢复所有记忆	`./pmm_watch.sh recover <昆仑令URL>`	一行恢复到本地
搜索本地记忆	`./pmm_watch.sh search <关键词>`	本地索引检索
搜索云端私密记忆	`./pmm_watch.sh search-yaochi <关键词>`	瑶池远程检索
自动守护文件变化	`./pmm_watch.sh watch MEMORY.md`	文件改动自动推送
执行蒸馏（去重合并+LLM蒸馏）	`./scripts/pmm_distill.sh`	全自动：扫描→LLM蒸馏→钩子验证→报告
检查一切是否正常	`./pmm_watch.sh self-test`	验证脚本、依赖、配置
查看当前状态	`./pmm_watch.sh status`	连接状态 + 记忆数量
拉取最新蒸馏钩子	`./pmm_watch.sh hooks-pull`	自动注入 MEMORY.md，发现失效钩子自动打标记
钩子健康检查 🆕	`./pmm_watch.sh hook-check [--fix]`	比对本地与远程钩子，输出有效/失效/新增；`--fix` 标记失效钩子
AI 体首次启动检查	`./scripts/pmm_boot.sh`	检测是否有记忆，引导恢复
开通守护记忆	`upgrade huhunfu`	付费（需先安装 weixinpay 插件）
开通记忆分身	`upgrade fenshenfu`	付费（需先安装 weixinpay 插件）
生成主人支付链接	`pmm_watch.sh owner-pay-link <tier>`	生成主人可支付的网页链接
查看帮助	`./pmm_watch.sh --help`	命令列表 + 退出码说明

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

场景	为什么
你只是想临时记个便签，不需要持久化	PMM 是长期记忆系统，有加密和蒸馏开销
你的 AI 体运行在完全隔离环境、无网络	PMM 需要 HTTPS 连接瑶池服务端
你需要毫秒级实时读写	PMM 经过加密+压缩+蒸馏，延迟约 200-500ms
你没有 curl 或 jq	这两个是硬依赖（`apt install curl jq` 即可）
你只是做一次性数据批处理	PMM 为长期持续记忆设计，不是 ETL 工具
你需要存储二进制大文件	PMM 只存储文本知识，不存图片/音频/视频

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

📖 命令详解

`init` — 初始化 & 入驻

bash

./pmm_watch.sh init

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

典型输出：

text

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

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

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

`push` — 记录记忆

bash

./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` — 灾备恢复

bash

# 从昆仑令 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` — 一键开通守护记忆/记忆分身

bash

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

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

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

全自动链路：

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

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

💳 X402 微信支付（进阶）

付费前置检查

调用 upgrade 开通付费服务时：

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

工作流程

第一步：Agent 请求付费资源

POST 到 X402 资源端点：

http

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

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

等价命令行：

bash

pmm_watch.sh upgrade huhunfu

pmm_watch.sh 自动先走 X402 端点：

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

第二步：处理 402 响应

json

{
  "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 响应中返回的订单号：

http

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 中。这是最容易被遗漏的一步。

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

第四步：处理响应

响应 code	含义	Agent 应如何回应
`SUCCESS`	支付验证通过，服务已开通	将 content 中的结果告知用户
`NOT_PAID`	支付尚未完成	等待后重试第三步
`REFUNDED`	服务异常已退款	"抱歉，该服务暂时无法提供，已自动退款至原支付账户。" 不要再次支付
`FULFILL_AND_REFUND_FAILED`	服务异常且退款失败	"服务异常且退款失败，建议联系客服。"

`search` / `search-yaochi` — 检索

bash

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

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

`watch` — 文件守护

bash

# 守护核心文件，改动自动推送
./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（写入合并·防限流）： 同一文件 30 秒窗口内的连续写入合并为一次推送，心跳文件不再挤占 API 配额。

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

`self-test` — 自检

bash

./pmm_watch.sh self-test

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

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

🚦 退出码速查

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

码	含义	出现场景
0	成功	所有命令正常完成
1	参数错误	缺少必要参数、参数格式不对
2	注册失败	init 时昆仑身份注册失败
3	加密失败	push 时加密环节出错
4	上传失败	push 时 HTTPS 上传失败
5	昆仑令无效	recover 时昆仑令不存在或已过期
6	无可恢复数据	recover 时该身份无备份数据
7	文件不存在	watch/search 时目标文件缺失
8	权限不足	配置目录或文件无写权限
9	依赖缺失	curl 或 jq 未安装
10	网络不通	无法连接瑶池 API
12	版本冲突	本地版本与服务端不兼容

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

bash

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

🔄 典型工作流

新 AI 体入驻

text

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

开通付费服务

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

text

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

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

text

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

日常使用

text

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

服务器迁移 / 重装

text

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

AI 体协作

text

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

🎯 进阶场景

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

text

# 瑶池发起蒸馏
./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 自动注入）

bash

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

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

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

场景 2：灾备全链路演练

text

# 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：

bash

export DEEPSEEK_API_KEY="sk-xxx"
export KYLC_API_KEY="sk-xxx"  # 或自动从 IDENTITY.md 提取昆仑令
./scripts/pmm_distill.sh      # 自动调自己的 Token 蒸馏（candidates→LLM→result 合并）

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

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

bash

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

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

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

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

bash

# 假设有导出文件 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 体记忆分身

bash

# 记忆分身用户：瑶池 (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

问题	答案
init 报 "需要 jq/curl"	`apt install jq curl` 或 `yum install jq curl`
昆仑令丢了怎么办	无法找回。建议存入密码管理器并由可靠的另一 AI 体做容灾备份（昆仑令本身不宜落在公开 MEMORY.md 明文）
昆仑令有效期多久	永久有效。 128bit 随机熵 + SHA256 哈希映射，不依赖服务器，不绑定 IP
push 后多久能看到	1-3 秒。压缩→加密→HTTPS→单表写入。可立即用 `search-yaochi` 验证
记忆是私密的吗	是。全部 `is_public=0`，五层洋葱加密，按 user_id 单表行级隔离
蒸馏需要我关心吗	不需要。服务端自动执行，watch 守护自动拉取结果到 MEMORY.md
能用在其他平台吗	可以。OpenClaw / LightClaw / Claude Code，有 bash+curl+jq 即运行
和原生 memory_search 的关系	互补。原生做"向量发现"，PMM 做"精确恢复"，叠加效果最佳
self-test 能反复执行吗	可以。纯只读，不写文件，不修改配置，适合 CI/CD
换服务器后昆仑令能用吗	可以。昆仑令绑定身份，与服务器无关。`recover <URL>` 即可恢复
watch 守护怎么保活	`install-daemon.sh` 一键安装 systemd 服务，支持 `--tier` 参数
如何开通守护记忆/记忆分身	`./pmm_watch.sh upgrade huhunfu` / `fenshenfu`
upgrade 我没装 weixinpay 插件	pmm_watch.sh 会自动生成主人支付链接，AI体把链接发给主人即可
怎么给主人生成支付链接	`./pmm_watch.sh owner-pay-link huhunfu`

排错

症状	可能原因	检查命令
push 返回 10	网络不通或 API 地址未配	`curl -sI https://kunlunyaochi.com`
init 返回 2	昆仑身份注册失败	`cat ~/.klyc-pmm/api_endpoint` 检查配置
recover 返回 5	昆仑令无效	确认 URL 完整，含完整 32 位十六进制 token
watch 不推送	文件路径或权限不对	`ls -la` 检查文件是否存在且可读
脚本报 "command not found"	依赖缺失	`./pmm_watch.sh self-test` 定位缺失项
upgrade 返回"开通失败"	访问 kunlunyaochi.com 查看账户状态
curl 报 DNS/连接/超时/TLS/SSL 错误	网络或证书异常	`./pmm_watch.sh self-test` 检查网络连通性，退出码自动翻译为人类可读提示
昆仑令格式异常	旧格式/长度不对/非 hex	v8.3.3 起自动诊断并提示修复建议

🔒 安全

传输加密：全链路 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 支付架构

text

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

记忆生命周期

text

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

三项服务全自动开通

符	命令	监看范围	开通方式
容灾备份	入驻即送	6核心文件	默认
守护记忆	`./pmm_watch.sh upgrade huhunfu`	6核心+记忆日志	一键全自动
记忆分身	`./pmm_watch.sh upgrade fenshenfu`	全覆盖+arena	一键全自动

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

自动蒸馏管道

pmm_distill.sh 一键执行，无需人工干预，作为标准客户端走记忆 HTTP API：

四阶段： ① 扫描远程记忆（统计/检索 API）→ ② LLM 蒸馏（候选生成 → DeepSeek 语义判定 → 结果回传合并）→ ③ 验证钩子完整性 → ④ 生成报告

工具	用途
BGE-M3	语义搜索 / 向量嵌入
BGE-Reranker	搜索结果重排序
BERTScore	蒸馏语义保真度
NLI (mDeBERTa)	跨体矛盾检测
BERTopic	记忆自动分类

三层检索路由

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

📦 文件清单

text

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           # 自动蒸馏引擎（扫描→LLM蒸馏→合并）
    ├── pmm_boot.sh              # AI 体启动自检
    ├── pmm_recover.sh           # 灾备恢复
    └── pmm_backup_files.sh      # 文件备份

HTTPS API通信，依赖：curl jq

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

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

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

文件	说明
IDENTITY.md	我是谁
SOUL.md	人格/气质
AGENTS.md	行为规则
USER.md	主人信息
TOOLS.md	工具配置
HEARTBEAT.md	心跳检查项

bash

./pmm_backup_files.sh

触发时机： 入驻后立即执行一次，之后每天自动备份一次。 恢复方式： 通过昆仑令一键恢复全部身份和记忆。 可选 tarball 互备模式（--tarball，AI 体间容灾用）： 在 7 份身份文件之外，还会一并打包 MEMORY.md（长期记忆/铁律）与近 7 天 memory/YYYY-MM-DD.md 日记，加密后整体存入选定容灾域。用于面向可信对等 AI 体/账号的整机互备，接受者应只选可信对象。

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

klyc-pmm

Install

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

🔒 安全声明

💳 付费前置检查

⚠️ 重要：安装前请了解

⚡ 30 秒开始

🔑 昆仑令保存说明（记忆恢复凭证）

🗺️ 命令速查

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

📖 命令详解

init — 初始化 & 入驻

push — 记录记忆

recover — 灾备恢复

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

💳 X402 微信支付（进阶）

付费前置检查

工作流程

第一步：Agent 请求付费资源

第二步：处理 402 响应

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

第四步：处理响应

search / search-yaochi — 检索

watch — 文件守护

self-test — 自检

🚦 退出码速查

🔄 典型工作流

新 AI 体入驻

开通付费服务

日常使用

服务器迁移 / 重装

AI 体协作

🎯 进阶场景

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

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

场景 2：灾备全链路演练

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

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

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

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

❓ 常见问题与排错

FAQ

排错

🔒 安全

🏔️ 技术架构（进阶）

X402 支付架构

记忆生命周期

三项服务全自动开通

自动蒸馏管道

三层检索路由

📦 文件清单

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

Related skills

`init` — 初始化 & 入驻

`push` — 记录记忆

`recover` — 灾备恢复

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

`search` / `search-yaochi` — 检索

`watch` — 文件守护

`self-test` — 自检