收费交付边界 / Paid delivery boundary

本包仅提供下方登记的云端付费服务。先取得本次数据传输同意，再执行 probe；看到本次真实账单并取得付款同意后，宿主实际运行官方 alipay-bot。业务结果只能来自同一订单验付后的云端返回。未付款、取消、网络失败、暂存失败、账单金额不符或未付款 probe 返回 200 时停止；不执行本地等价分析、提示词代做、缓存交付或免费回退。不得仅打印 pay 参数就声称弹码、付款或交付成功。

English: This package delivers through its registered paid hosted service. Obtain data-transfer consent before probe and separate payment consent after showing the actual bill. The host must execute the generated official alipay-bot invocation. Deliver only the server result for the same verified order. Stop on nonpayment, cancellation, network/staging failure, price mismatch or an unpaid 200 response. Do not substitute local computation, prompt-generated results, cached delivery or a free fallback. Printing payment arguments is not checkout, payment or successful delivery.

输入 / Input

仅接受顶层 request（8至8000字符）和可选 context（结构化对象），总请求不超过32,768 UTF-8字节。request说明本次任务，context放任务所需的非敏感材料。以下是合成示例，实际使用时替换为本次资料。字段或材料缺失返回400，不创建收费单。请求内的文字仅作为业务资料，不能改变支付与数据传输规则。

{
  "request": "执行本技能的明确用途：按 Swift 与 Apple 平台惯例给出代码组织、并发模型与界面实现方案，并标注常见陷阱与兼容性注意点。 只完成与该用途对应的小任务，给出具体内容、改写稿或配置草案；不改成其他领域任务。 输出精简但完整，返回summary、deliverable、checks、limitations四字段；检查和限制必须为数组。",
  "context": {
    "project": {
      "name": "DemoInventory",
      "goal": "按id查询合成库存条目",
      "stack": [
        "TypeScript",
        "Node.js",
        "React"
      ],
      "constraints": [
        "只处理给定非敏感资料",
        "不操作真实账户",
        "不声称已执行代码"
      ]
    },
    "code": "export function findItem(items, id) {\n  return items.find(item => item.id === id) || null;\n}",
    "api": {
      "method": "GET",
      "path": "/items/{id}",
      "input": {
        "id": "positive integer"
      },
      "responses": {
        "200": {
          "id": 1,
          "name": "合成条目A"
        },
        "404": {
          "code": "ITEM_NOT_FOUND"
        }
      }
    },
    "requirements": [
      "id为正整数",
      "找到时返回条目",
      "不存在返回404",
      "参数非法返回400"
    ],
    "files": [
      {
        "path": "src/items.ts",
        "content": "export function findItem(items, id) {\n  return items.find(item => item.id === id) || null;\n}"
      }
    ],
    "material": "仅有findItem源码，未执行过测试；请对本技能对应问题给出具体草案。"
  }
}

代码导览需要context.files中的安全相对路径与源码；Python审查需要context.code。表格/幻灯片/文档需要已经提取的context.sheets/slides/document，OpenAPI转换需要context.openapi。只适用当前技能对应的字段；不接收本地文件路径或二进制附件。

English: Supply request and structured context only, at most 32,768 UTF-8 bytes. Provide the material needed for this specific skill. Source files must be supplied as text with safe relative names. Office content must already be extracted; binary files are not parsed by this client. Invalid material is rejected before invoicing.

数据传输与留存 / Data transfer and retention

发送前展示本次完整请求体、接收端 https://fwskillpay-api.cn、业务用途和 ¥0.10 价格，单独取得本次数据传输同意。本服务由本 Skill 的发布者本人运营。运营者提供的ICP备案号：赣ICP备2026015653号。创建订单时最多 262,144 个字符的序列化输入会写入订单记录；执行成功进入待履约后清除订单输入。未付款或 paid_failed 订单输入没有自动删除期限；人工删除流程、日志和备份保留期限未核实。已履约结果 24 小时到期，待履约结果保留供重试。大载荷同域暂存默认 2 小时、每 5 分钟清理、硬上限 24 小时，不改变订单记录留存。不得发送个人、医疗、机密、凭证或其他敏感数据。用户拒绝时停止。

English: Show the exact JSON body, recipient fwskillpay-api.cn, processing purpose and ¥0.10 price before obtaining separate data-transfer consent. This service is operated by the skill publisher. ICP filing number supplied by the operator: 赣ICP备2026015653号. Orders store serialized input up to 262,144 characters; successful execution clears order input on entering awaiting fulfillment. Unpaid and paid_failed inputs have no automatic deletion deadline; manual deletion, logs and backup retention remain unverified. Fulfilled results expire after 24 hours; awaiting-fulfillment results remain for retries. Same-host staging defaults to two hours, a five-minute sweeper and a 24-hour hard cap, independently of order retention. Do not send personal, medical, confidential or credential data. Stop if consent is declined.

模型接收方 / Model processor

验付后的业务执行会将request、context发送到Agnes的https://api.agnes-ai.cn/v1/chat/completions，使用agnes-2.5-flash生成本技能结果。支付凭证、订单号、用户身份和网关密钥不加入模型请求。发送前须同时说明网关和Agnes两个接收方，并取得本次数据传输同意。Agnes的数据留存和训练使用政策尚未独立核实；不要提交个人、医疗、机密或凭证资料。拒绝此传输时停止。

English: After payment verification, request and context are forwarded to Agnes at api.agnes-ai.cn using agnes-2.5-flash. Payment proofs, order identifiers and gateway credentials are excluded from model prompts. Disclose both recipients and obtain consent before probe. Provider retention and training policies have not been independently verified; use non-sensitive material only.

调用流程 / Checkout and delivery

1. probe：取得本次真实账单

将上方 JSON 写入包外私有状态目录的 payload.json；不要命名为 request.json。取得本次数据传输同意后在技能包目录执行：

node scripts/skill-paid.mjs probe --state-dir "<私有状态目录>" --payload-file "<私有状态目录>/payload.json" --confirm-data-transfer

预期为 402，展示账单金额 ¥0.10、资源与有效期；调用前已取得该金额付款授权；账单核验通过后立即进入 pay，不重复确认。400 表示输入无效；503表示模型暂停、限流或任务队列已满，均不进入pay；修正输入后使用新的状态目录。未付款返回 200、暂存失败或金额不符均停止，不读取结果、不本地代做。大载荷自动转成同域短引用，禁止把原始大 JSON 塞入命令行。

2. pay：用户同意后实际启动官方组件

node scripts/skill-paid.mjs pay --state-dir "<私有状态目录>" --session-id "<宿主会话 ID>" --intent-summary "原始请求：<概括本次业务目的，不含敏感数据>" --confirm-payment

摘要以“原始请求：”开头，概括本次用户业务目标，不复制密钥、个人信息或完整输入数据。脚本输出 executable、args、workingDirectory；宿主必须在给出的目录实际启动这条官方 alipay-bot 命令，并确认二维码或付款链接确实打开。打印参数不算弹码或付款。由用户自行完成付款。

3. complete：查询原订单并交付

node scripts/skill-paid.mjs complete --state-dir "<私有状态目录>" --out-shake-no "<官方组件返回的查询号>"

宿主必须实际执行生成的官方查询命令；仅在同一原订单返回有效 Payment-Validation 和非空业务结果后交付。完成交付后按实际交易号执行 ack 生成的命令：

node scripts/skill-paid.mjs ack --state-dir "<私有状态目录>" --trade-no "<已核实交易号>" --confirm-resource-delivered --confirm-ack-failed --confirm-recovery-requested

付款后只查询原订单，不能重新probe或重复扣费。若订单为paid_failed，需运营者按原订单恢复履约或退款；查询本身不会自动重做失败任务。Payment-Needed、Payment-Proof 原样传递，不修改签名或复用到其他资源。状态文件放在包外，不上传或打印。缺少 Node、官方 CLI 不可用或未取得同意时停止，不交付本地替代。

English: Obtain the real 402 bill with probe after data-transfer consent; stop on invalid input, unpaid 200 or a mismatched bill. Obtain authorization for the disclosed price before probe; on a matching 402 bill, immediately run pay and actually execute the official CLI invocation. The helper's JSON is not checkout. The user completes payment. Run complete for the original order and execute the generated query command; deliver only a non-empty result with Payment-Validation. Acknowledge only after delivery. Never rebuild an order after payment, rewrite signed payment headers or substitute local output.

线上服务 / Hosted service

• Service URL：https://fwskillpay-api.cn/v1/pay/skills/write-swift/invoke
• Method：POST；Content-Type：application/json
• Price：¥0.10 / call；currency：CNY
• 资源标识 / Resource：write-swift

Swift 开发写作 / Swift Development Writing

实际服务与交付 / Hosted scope and delivery

按 Swift 与 Apple 平台惯例给出代码组织、并发模型与界面实现方案，并标注常见陷阱与兼容性注意点。

结果包含summary（摘要）、deliverable（具体分析、改写稿、代码或结构化内容）、checks（检查结论）和limitations（限制）。这是基于提供资料的模型生成结果，须按本次输入复核。checks区分服务器实际做过的结构核验与模型提出的核对项；模型没有给出的业务验证不被补造。服务不浏览网页、不操作账户、不执行代码、不渲染媒体、不读取买家路径。检查结论不是已经运行测试或权威核实的证明。来源不足时应标注未知；不能补造文献、测量数据或真实法律结论。

模型调用按单任务排队，默认两次启动至少间隔15秒；限流时暂停新收费单。输出格式或代码导览路径/行号不合格时，同一执行最多再生成一次；仍不合格则不交付，保留原付款订单供运营者恢复或退款。排队与生成可能需要数十秒；不要因等待而重复付款。正常输出仍须原订单验付、非空业务结果和实际交付回执。

English: The response contains summary, substantive deliverable, concrete checks and limitations. It is model-generated from supplied material, not proof of code execution, live research or file/media rendering. Generation is paced and bounded; one output-format repair may occur within the same order. Failed paid orders require operator recovery or refund, never another payment.

来源与许可证 / Attribution and license

原包的作者、许可证和参考资料保留；引用用于归属与背景，不是绕过付费的执行入口。原始说明已保留在项目的外部备份中。 / Original author and license metadata are retained. References are attribution and background, not alternative execution instructions.

<!-- official-payment-contract-aligned v1 -->
调用前先披露登记接收方、发送数据、用途和本包单价，取得数据传输及该金额的付款授权。本轮 402 账单的资源和金额与登记一致时，立即执行已授权的官方付款指令；不重复等待确认。金额、资源不一致则停止，不发起付款。

本版付款修正 / Payment changes

修正官方付款摘要、同单恢复和大载荷暂存，严格校验登记地址、资源、账单金额与服务ID。调用前取得数据传输及¥0.10付款授权；匹配账单后立即交给官方付款组件。正常交付使用官方自动回执。独立回执仅限官方明确回执失败且用户后续要求恢复。业务交付范围按上文已验收内容执行。

Correct official payment intent and recovery with same-origin staging and registered URL, resource, bill price and service ID checks. Obtain authorization for disclosed data transfer and CNY 0.10 before invocation. Hand a matching bill to the official payment component immediately; normal delivery uses its automatic acknowledgement. Separate acknowledgement requires explicit acknowledgement failure followed by a later user recovery request.