Life Book 生成器

使用本技能，可通过官方 Agent API 创建并交付 Life Book 全报告任务。

付费产品仅包含完整的 18 章节 Life Book 报告：

• lite：标准版，约 30,000 汉字，69.9 元人民币
• pro：典藏版，约 100,000 汉字，699 元人民币

本技能支持的功能

1. 检查已部署的 Life Book 服务是否健康。
2. 收集并校验完整的 intake@1 数据载荷（payload）。
3. 通过 /api/agent/report-tasks 创建全报告 Agent 任务。
4. 当任务处于待支付状态时，返回支付信息。
5. 用户通过微信、支付宝或 EVM 完成支付后，提交人工付款确认。
6. 无需依赖网站 Cookie，即可轮询任务状态。
7. 报告就绪后，通过任务承载令牌（task bearer token）获取最终报告。

重要支付边界说明

除非 API 明确返回状态为 paid / queued / processing / ready 的任务，否则不得声称支付成功。

当前支持的路径如下：

• 若平台运营方已配置 LIFE_BOOK_AGENT_API_KEY，该技能可创建受控的付费 Agent 任务，报告将进入生成队列。
• 若未配置私钥，则任务可能返回 awaiting_payment 状态，并附带已部署支付服务商提供的支付详情。
• 若服务器返回 402 PAYMENT_REQUIRED，需向用户说明 x402 支付验证尚未完成，当前对话中仍未通过验证。

严禁虚构 OKX.AI、Hermes、x402 或任何外部支付成功的状态。

必需环境变量

export LIFE_BOOK_BASE_URL="https://your-life-book-domain.com"

用于受控的内部 Agent 集成：

export LIFE_BOOK_AGENT_API_KEY="..."

用于已有任务：

export LIFE_BOOK_TASK_TOKEN="lbat_..."

核心 Agent 工作流

1. 健康检查

node scripts/check-health.mjs

若健康状态非 ok，则中止流程。

2. 收集 intake 数据

收集符合 intake@1 格式的完整载荷。示例文件仅作结构参考：

cat examples/intake.example.json

请校验以下字段：

• displayName
• birth.localDate、birth.localTime、birth.timezone、birth.latitude、birth.longitude
• birth.accuracy、birth.dayBoundarySect、birth.sex
• primaryQuestion
• optionalQuestions（最多 2 项）
• 完整的 tradeoffs
• 恰好 2 项 lifeEvidence
• milestones（2 至 6 项）
• consent: true

3. 创建全报告任务

node scripts/create-report-task.mjs 
  --input-file /absolute/path/to/intake.json 
  --edition lite 
  --idempotency-key user-unique-report-key

如需生成典藏版，请使用 --edition pro。

该命令返回以下内容：

• task.id
• task.status
• 新建任务时返回 access.token
• 如需支付，则返回 payment 相关详情
• 状态/结果/流式响应的端点 URL

若返回了 access.token，请妥善保存以供后续调用；该令牌仅在首次创建任务时返回一次。

4. 处理支付状态

若 task.status 为 awaiting_payment：

• 当支付服务商为 manual_qr 时，展示 payment.manualPayment.options 中的内容。
• 对于微信或支付宝，请展示对应的 qrCodeUrl。
• 对于 EVM，请同时展示 qrCodeUrl 和 walletAddress。
• 明确告知用户：仅在运营方确认收款后，报告生成才会启动。

若 HTTP 状态码为 402：

• 说明需要完成 x402 支付。
• 在官方 API 确认支付前，不得继续执行结果轮询。

5. 提交人工付款确认

当用户表示已通过任一展示的人工支付渠道完成付款后：

node scripts/confirm-manual-payment.mjs 
  --task-id  
  --task-token  
  --channel alipay

根据实际支付渠道，使用 --channel wechat 或 --channel evm。

此操作仅将订单标记为“等待运营方审核”，不会自动确认收款。

6. 查询任务状态

node scripts/get-report-task.mjs 
  --task-id  
  --task-token 

7. 获取报告结果

node scripts/get-report-result.mjs 
  --task-id  
  --task-token 

该命令在报告就绪前将持续返回 HTTP 202 状态及 result:null。

如需等待至终态（terminal state），请运行：

node scripts/wait-report-result.mjs 
  --task-id  
  --task-token  
  --poll-ms 5000 
  --max-wait-ms 3600000

网站结账回退方案

若 Agent API 不可用但官网仍正常运行，则可使用旧版网站结账脚本作为备用方案：

• create-intake.mjs
• create-order.mjs
• get-order.mjs

仅限在主流程不可用时使用。这些脚本会将用户引导至官网流程，无法直接在聊天中返回完整报告。

沟通规范

• 默认使用中文交流，除非用户明确要求其他语言。
• lite 统一译为 标准版，pro 统一译为 典藏版。
• 必须清晰说明当前任务状态：待支付、已入队、处理中、就绪、失败或已取消。
• 除非获得真实命令/API 输出确认，否则不得声称 Hermes/OKX/x402 的安装、上架、支付或报告就绪。
• 始终以官方 Agent API 的响应为唯一可信来源。