workbuddy迁移

认知前提：哪些东西不随账户走

服务端只保存一份「画像式」的长期记忆（笼统的用户画像），以下均为纯本地文件，换机后不会自动出现：

技能本身有同步通道（客户端内置 skillCloudSync，账本在云端），但只认得出市场来源的技能——本地自建的、以及对市场技能做过的二次修改，都救不回来。

三步流程

1. 盘点

python scripts/migrate.py inventory

列出所有本地资产、体积、来源（市场可重装 / 仅本地），并标出备份覆盖范围之外的项（如外部大模型仓库），提醒人工处理。

2. 备份

python scripts/migrate.py backup                       # 输出到脚本同级的 _backups/
python scripts/migrate.py backup --out "D:/网盘目录"    # 推荐直接输出到会被带走的介质

产物是一个 zip，内含：技能本体、*-personal/ 人格记忆文件、models.json、workspace-display-names.json、
settings.json 快照、_tools 自建脚本、历史任务记忆、定时任务清单 JSON、requirements.txt、manifest.json。

凭据一律不打包：keyblob、connectors/ 内含授权令牌，默认跳过（备份包可能存网盘）。确要带走用 --include-secrets，并自行承担风险。

3. 还原

python scripts/migrate.py restore <zip路径>            # 已有同名文件自动改名留备份
python scripts/migrate.py verify                       # 核对还原完整性

restore 只恢复「可直接搬运」的部分，其余生成待办清单打印出来（迁移后立即做）：

• [ ] pip 依赖重装：python -m pip install -r requirements.txt
• [ ] 定时任务对照 automations.json 在客户端重建
• [ ] settings.json 的 sandbox 白名单 / 插件开关按需合并
• [ ] 连接器在新机重新授权
• [ ] MCP 服务重配（若新 ~/.workbuddy/mcp.json 为空）
• [ ] 外部模型仓库（如 LM Studio 模型目录）另行拷贝

付费改造（支付宝 AI 按量付费 / A2M 402 Payment Required）

本 Skill 已接入支付宝 AI 付，作为付费 Skill 对外分发。未付费访问时返回 402 状态码与 Payment-Needed 账单头（含 RSA2 商家签名）；买家付款后携带 Payment-Proof 头重试，服务端验付（alipay.aipay.agent.payment.verify）并发送履约回执（alipay.aipay.agent.fulfillment.confirm）后，返回可安装的 Skill 包。

买家侧四步流程：probe（探测 402 账单）→ pay（调起支付宝付款）→ complete（携带 Payment-Proof 领取资源）→ ack（安装到 Skills 目录）。核心实现见 pay/ 目录，支付依赖包（flask / alipay-sdk-python / pycryptodome / requests）声明在 pay/requirements.txt。

• pay/a2m_merchant.py — 402 账单下发、携带凭证重试、验付调用、履约确认
• pay/a2m_client.py — 买家侧 probe / pay / complete / ack
• pay/order_repository.py — 订单持久化与幂等（SQLite，禁止内存订单兜底）
• pay/README.md — 商户部署与买家安装说明

目录

• scripts/migrate.py — 盘点 / 备份 / 还原 / 校验
• pay/ — 支付宝 AI 按量付费（A2M）支付改造模块（402 / Payment-Needed / Payment-Proof / probe / pay / complete / ack）
• references/checklist.md — 完整资产清单与逐项说明，做迁移前扫一眼