yeeap-cli

YEEAP 支付 Skill 命令行工具：pay / 授权 / 订单文件，以及 Agent 宿主上下文采集。

支付 Skill（Phase 2）

npx --yes yeeap-cli@wallet-stable pay-context -o <order_no> -a <app_id>

• 自动读取 ~/.yeeap/orders/<app_id>/<order_no>.json
• 无本地授权 token 时输出 授权链接:（需先 H5 授权 + check-auth）
• pay/pay-context 成功后将 payCredential 写回订单文件；pay-query 只查询状态，不写凭证。
• 推荐使用 *-context 命令，由 CLI 内部准备支付上下文，避免同机多 Agent 窗口串用 agentId。

命令

| 命令 | 说明 | |------|------| | pay -o <order_no> -a <app_id> | 提交支付（调 Open API） | | pay-context -o <order_no> -a <app_id> | 支付上下文模式，推荐给 Agent skill 使用 | | pay-query -o <order_no> -a <app_id> | 查询订单状态；SUCCESS 仅表示订单已成功，不返回也不写入 payCredential | | auth-init [-a <app_id>] | 发起 Agent 支付授权 | | auth-init-context [-a <app_id>] | 支付上下文模式发起授权 | | check-auth -i <auth_id> [-a <app_id>] | 查询授权；SUCCESS 写入 ~/.yeeap/<MD5(login)>/<agentId>/<tokenId> | | check-auth-context -i <auth_id> [-a <app_id>] | 支付上下文模式查询授权 | | read-order -o ... -a ... | 调试：订单摘要（不含 encrypted_data / payCredential 全文） | | get-env --strict | 采集 agentSessionId / loginAccount / deviceFp | | setup-hooks | 可选配置 Agent 上下文采集 Hook（改善 loginAccount） |

订单文件格式

CLI 依赖 ~/.yeeap/orders/<app_id>/<order_no>.json，最小字段：

{
  "order_no": "订单号",
  "amount": 1,
  "app_id": "应用标识",
  "skill_id": "SKL_xxx（平台登记后下发）",
  "question": "用户查询内容",
  "encrypted_data": "SM4 加密后的订单 JSON"
}

skill_id 由 YEEAP 平台在 Skill 登记后下发，必须由服务端创建订单时返回，禁止脚本本地伪造。支付时 CLI 会将 skill_id 一并提交至 Open API，后端校验其是否属于对应 app_id。

环境变量

| 变量 | 说明 | |------|------| | YEEAP_API_BASE | 默认 https://ap.yeepay.com/yeeap | | YEEAP_PAY_STUB=1 | 桩模式，无需后端（本地联调） | | YEEAP_STATE_DIR | 默认 ~/.yeeap | | YEEAP_AGENT_ID / YEEAP_LOGIN_ACCOUNT / YEEAP_DEVICE_FP | 覆盖 get-env（测试用） |

本地状态目录与权限

CLI 会在 YEEAP_STATE_DIR 下写入订单文件、待授权上下文与本地授权 token。默认目录为 ~/.yeeap。

在 WorkBuddy 等 Agent 新窗口中，首次写入 ~/.yeeap/pending-auth 或 token 目录时，宿主沙箱可能短暂返回 EPERM / EACCES / EBUSY / ENOENT。CLI 会对这些本地状态读写做短暂重试；若重试后仍失败，请确认当前 Agent/Node 允许写入 ~/.yeeap，或将 YEEAP_STATE_DIR 设置到可写目录后重试。

本地桩联调

export YEEAP_PAY_STUB=1
export YEEAP_AGENT_ID=agent-dev
export [email protected]
export YEEAP_DEVICE_FP=fp-dev
mkdir -p ~/.yeeap/orders/app_demo
# 写入订单 JSON 后：
yeeap-cli check-auth -i auth_stub_x
yeeap-cli pay -o <order_no> -a app_demo

安装

npm install -g [email protected]

发布：npm publish --access public（在 doc/cli 目录，prepublishOnly 会跑测试）。发布成功后，将支付稳定版标签指向新版本：npm dist-tag add [email protected] wallet-stable。

与 yeeap-wallet

安装技能：

npx -y skills add "https://github.com/Yeepay-Open-Platform/yeeap-wallet" --agent '*' -g -y

技能固定使用 yeeap-cli@wallet-stable，Agent 只传 order_no + app_id，由 CLI 读订单文件（对标 jd-clawtip-payment-skill）。wallet-stable 由 YEEAP 官方通过 npm dist-tag 指向当前支付稳定版 CLI。