Excel / WPS 公式设计 · Pay Skill
每次约定任务 ¥0.99(CNY)。执行前读取完整原业务规则,保留其触发条件、输入判断、输出格式及配套示例;其本地处理步骤作为服务端实现与结果验收依据,收费任务的结果取自接口,不能在未支付时本地代做并声称已交付。基础范围见业务合同,输入示例见example-request.json。
依赖与状态
需要 Node.js 20+、当前宿主可加载的官方 alipay-payment-skill 和 alipay-bot,以及发布者的公网 HTTPS 收费接口。先读取已安装官方 Skill 的 SKILL.md 和 references/402-payment.md;参数或行为与本包核对版本不同则停止适配,不猜命令。
payment-config.json 当前为 unconfigured。保持该状态直到发布者提供真实 URL、serviceId 并核对支付宝登记价、服务端账单价和展示价一致;缺配置时停止,不传输材料、不收费。服务端生产密钥、模型 API Key 不进入买家包。
请求与付款
- 根据原业务规则明确本次输入、输出要求和业务目的,说明商户、目的地和 ¥0.99;将材料保存在包外私有文件,JSON 为
{"input":"原始材料和业务要求"}。已获授权的范围不重复询问,未获资料传输授权时先确认。所有脚本路径相对本 Skill 根目录,执行时定位其绝对路径。 - 发起一次原始请求并保存状态;
--purpose用当前任务的业务目标,不能只写 URL、价格或 HTTP 方法:
node scripts/paid-client.mjs probe --state-dir /PRIVATE/TASK-DIR --payload-file /PRIVATE/request.json --purpose '本次具体业务目标' --confirm-data-transfer
- HTTP 402 中的
Payment-Needed原样写入私有文件,不解码、不改写;同时存在唯一非空amtPaymentLink时优先使用它。材料直接交官方工具核验,不能把本包配置价当作账单核验结论。非 402、缺支付头、空或冲突链接、超限或网络失败时停止,保留状态,不重新请求或生成替代结果。 - 生产调用加载官方支付 Skill 后按其规则推进。当前任务仅做本地预付款验证时,在此停止,不运行下面的 pay。真实付款必须取得针对本次商户、用途及金额的授权;
--confirm-payment表示宿主已取得授权,不能替代授权。
node scripts/paid-client.mjs pay --state-dir /PRIVATE/TASK-DIR --session-id CURRENT_HOST_SESSION --confirm-payment
会话标识按官方优先级取当前元数据 sessionId/session_id,其次 threadId/conversationId/agentContextId(Codex 使用 CODEX_THREAD_ID),最后才是 AIPAY_SESSION_ID;原样使用,全部缺失则停止。客户端仅调用官方 402-buyer-pay,保留原 URL、POST 正文、Content-Type 和业务目的,不实现付款或签名。支付材料有且仅有 --amt-payment-link 或 --file。
同单查询与展示
官方输出原样展示一次,待确认后停止,等待用户后续表示已支付或要求查询。脚本只从本次官方命令输出的对客标签提取查询号码:订单号/查询单号须为32位数字且第11–14位为8282,否则回退到合法交易号;没有有效号码时停止,不让用户猜号、不从日志或其他订单补齐。
node scripts/paid-client.mjs complete --state-dir /PRIVATE/TASK-DIR
查询保持同一订单、原 URL、正文和请求头,不再发起付款。明确“支付待确认”且有有效原单时,可在用户后续请求后继续查原单;其他结果(成功、业务失败、资源为空或未知输出)均停止,不重复请求资源。命令网络失败/超时仅按当前官方文档最多恢复一次,业务失败不重试。未知格式保留输出并停止,不能凭退出码宣称支付或交付成功。
官方非 JSON 对客输出逐字符展示一次;MEDIA 引用按官方文档转图片通道,不分析或复用其他订单图片。JSON 按当前官方流程处理,不能自行推断未定义状态。资源是后续原业务格式展示的依据,原始支付状态和错误不能被润色成成功。
非空资源交付后官方 CLI 已处理买家回执,成功路径不追加 ack。只有同次输出明确回执失败、有交易号且用户在后续消息要求恢复时,才直接按官方 Skill 的回执恢复分支操作,本包不自动恢复。
文件与发行边界
一个任务一个状态目录,位于包外,仅当前用户可访问。原请求、账单和官方输出可能包含敏感内容,不上传或提交。默认不跟随 HTTP 重定向;JSON 正文目前上限16KB,超限先明确说明,等待真实服务提供大输入暂存/短引用方案,不截断材料。
本包经官方买家 Skill 1.0.15 的传统 402 文档核对;安装器1.0.28、CLI0.4.8。模拟测试不调用真实钱包,不能替代公网接口及实付验收。安装、本地加载、测试、打包和缺失配置见发行目录 README;许可与改编来源见 LICENSE 和 NOTICE.md。