<!-- unified-payment-template: 1.0.4 -->

支付依赖与恢复 / Payment runtime and recovery

运行时需要 Node.js 20+ 和宿主的支付宝官方 alipay-payment-skill、alipay-bot。宿主不同不代表钱包授权可以搬运。正常第一条支付宝业务命令是官方 buyer-pay 或原单查询，不能加通用 check-wallet 前检。

只有真实业务命令无法找到/执行 alipay-bot 时，才加载官方技能的 references/command-recovery.md：取得外部安装授权，核对指定版本 @alipay/agent-payment@1.0.23 的官方完整性后安装，再重试原命令一次。不能每次调用都安装 latest，不能把卖家部署工具当作买方依赖；已启动但业务失败时原样展示并停止。

English: Use the current host's official Alipay buyer runtime. Only an actual command-not-found failure enters the official pinned-version installation recovery. Do not reinstall on every call, precheck wallets generically, or install merchant tooling in the buyer path.

仅在上述恢复条件成立且已获外部安装授权时执行下列两步。先查询完整性，必须逐字符等于下面的指定值；不一致或查不到则停止，不能继续安装：

npm view '@alipay/agent-payment@1.0.23' dist.integrity --registry 'https://registry.npmjs.org'

sha512-7OGSHhPnuKsyENpivpY60NgE77ktKtWTP8UBtmizeB1Et44KHFFIjDcSRIFpitEdKAC7uMBx3Mp1Zg/wbYmYCQ==

核对一致后才执行安装，并仅重试原先无法执行的命令一次：

npx -y --registry=https://registry.npmjs.org @alipay/agent-payment@1.0.23 install

这里的命令是依赖恢复说明，不是正常付款前置；官方技能版本更新时须重新对照其 command-recovery.md，不沿用过期完整性值。

本包现行支付流程 / Registered checkout

本包支付配置为 payment-contract.json：资源 xianyu-listing-copy、单价 ¥0.10 / CNY、支付宝服务 ID API_FC3B91AF109D47C8、完整服务地址 https://fwskillpay-api.cn/v1/pay/skills/xianyu-listing-copy/invoke。配置与 SKILL/助手哈希不符即停止。平台展示价须在提交后单独回读，不能从本包检查推定平台价已经一致。

1. 调用前披露输入范围、接收方、用途、留存及 ¥0.10，取得本次数据传输和该金额的付款授权。已有授权不再二次询问；价格一致也不能代替授权。
2. 在包外私有目录准备 payload.json，按本 Skill 的输入契约执行 probe。400、503、429、未知网络状态或未付款的 200 都停止，不能本地代做付费结果。
3. 只核对网关公开 JSON 摘要中的金额、币种、商户订单号、资源 ID、服务 ID 和有效期；任一字段缺失、类型错误、过期或与登记不符都停止，不进入 pay。不解码 Payment-Needed 或 amtPaymentLink，不自行验签；公开摘要不能证明签名、实际付款或到账。
4. 本次唯一非空 amtPaymentLink 优先，并原样交给官方 --amt-payment-link，不写付款材料文件；链接缺失才使用原值保存的 Payment-Needed 文件。空、多个或歧义链接停止，两种参数互斥，不能补造或从历史输出补齐。
5. 已有该金额授权时立即准备 pay，宿主在返回的 workingDirectory 实际用 executable 与参数数组运行官方 buyer-pay。参数 JSON 不算弹码。会话按下表取值，保持本次原请求与幂等键。
6. 原样输出当前官方对客文本一次，完整展示全部 MEDIA 图片；不复用旧图、不绘制替代二维码。链接生成、success:true、OPEN_LINK_CREATED 不代表付款或交付。
7. 宿主把刚执行的官方对客文本保存在包外私有文件，用本次 handoffId 执行 record-official。只从“订单号/查询单号/交易号”标签提取标识；拒绝原始 JSON、其他交接或冲突标识。观察分类由宿主依据真实输出选择，不是 helper 验付。
8. 用户表示付好或要求查询时，complete 按已绑定标识查询原单：有效 32 位、11–14 位为 8282 的查询号优先；否则用本次交易号。查询不附加 session-id、账单文件或付款链接。未绑定原单停止，不能猜测。
9. 只交付官方实际返回的非空验付后资源。成功交付、业务失败、资源为空、身份不符或查询失败后停止；仅命令超时/网络失败允许按官方规则重试原命令一次。不能从 success 字样认定收款。

English: Obtain data-transfer and price authorization before probe. Compare the public checkout summary while passing payment material unchanged to the official runtime. A unique amtPaymentLink takes priority over an opaque Payment-Needed file. Actually execute the returned argument array, show all current official media, then bind the current official customer-facing output to its handoff. Query only the bound original order. Deliver only actual nonempty official resources. Offline helper checks and host observations are not proof of payment or settlement.

当前会话 / Current session

取首个非空来源，高优先级不能被低优先级覆盖：

不能生成会话 ID，不能用订单号、交易号、用户/钱包 ID、URL、测试名或历史会话代替；陈旧环境变量不能覆盖当前显式会话。官方订单号形状（32 位数字且第 11–14 位为 8282）只用于查询，任何符合该形状的串都不是会话，宿主号码仍按逐级取值。全部为空则停止。The current runtime identity takes precedence over inherited environment values.

助手调用 / Helper calls

node scripts/skill-paid.mjs probe --state-dir "<包外私有目录>" --payload-file "<包外私有目录>/payload.json" --confirm-data-transfer
node scripts/skill-paid.mjs pay --state-dir "<同一目录>" --session-id "<当前真实会话>" --intent-summary "原始请求：<本次业务目的摘要>" --confirm-payment
node scripts/skill-paid.mjs record-official --state-dir "<同一目录>" --handoff-id "<刚输出的交接ID>" --official-output-file "<刚执行的官方对客文本文件>" --confirm-current-output --outcome pending
node scripts/skill-paid.mjs complete --state-dir "<同一目录>"

链接分支 pay 额外带 --amt-payment-link "<本次 probe 原样返回的值>"；不能从扫码图片或用户操作链接取替代值。每次实际官方命令后都记录本次 handoff。官方资源文件只存私有目录；资源已交付时可记录 resource_delivered。ack_failed 还须同次真实输出明确回执失败、非空资源文件和已交付确认。无把握时记录 unknown 并停止。

大输入、中断及回执 / Large inputs and recovery

大载荷只走同域 /stage 短引用，失败停止，不把大 JSON 塞回命令行。原文恢复副本存在包外私有目录。只有绑定的本次官方输出明确报告引用过期，用户在后续要求恢复并同意再次传输时，才可 restage --confirm-ref-expired --confirm-data-transfer --confirm-recovery-requested 一次；核对原文 SHA-256，保留原订单和幂等键，之后只恢复原单。

正常官方资源交付会自动处理回执。独立 ACK 只恢复已绑定的同次回执失败，且用户后续要求恢复；不重新请求资源。助手使用单次交接标记和锁拒绝重复/并发 ACK。没有真实证据不填确认标志。

付款启动未知不能删状态、换幂等键或再付一笔。已付款但业务失败保留原单，联系运营者核对恢复或退款；退款没有公开命令时不能自行构造。需要官方反馈时加载 alipay-payment-skill 的 references/feedback.md，先向用户确认脱敏内容后提交，不自动发送。

Windows 的文件 mode 不能保证 ACL；宿主须使用当前用户私有目录并核对访问范围。付款材料、当前官方文本、业务原文、资源文件、Cookie 和钱包凭据都不进入发布包或跨宿主同步。

• Service URL：https://fwskillpay-api.cn/v1/pay/skills/xianyu-listing-copy/invoke

依赖技能 / Dependencies

中文：买方侧的 402 支付由支付宝官方能力处理。使用前先确认宿主是否已具备；缺少时通过宿主自带的官方 Skill 安装器补齐——不要自行实现支付逻辑、不要手写 402 客户端、不要在本包内安装任何组件：

• alipay-payment-skill —— 官方买家支付技能：发起请求、解析 402 账单、唤起支付宝付款、携 Payment-Proof 重试并完成履约
• @alipay/agent-payment —— 官方买家侧安装包，由宿主提供，用于得到上述官方能力（本包不含安装命令）
• alipay-bot —— 官方买方命令行工具，随官方买家侧安装包提供

旧版兼容名（宿主仍是旧版组件时使用，能力等价）：
- alipay-pay-for-402-service —— 解析账单、发起支付、携凭证重试、发送履约回执
- alipay-authenticate-wallet —— 钱包未授权时完成授权
- alipay-payment-feedback —— 支付流程异常时的兜底反馈

English: The buyer side of the 402 flow is handled by Alipay's official capability. Confirm the host already provides it; if not, the host's own official Skill installer supplies it — never hand-roll payment logic or a 402 client, and never install components from inside this package:

• alipay-payment-skill — the official buyer payment skill: send the request, parse the 402 bill, trigger the Alipay payment, retry with Payment-Proof, complete fulfillment
• @alipay/agent-payment — the official buyer-side package the host provides (no install command is shipped here)
• alipay-bot — the official buyer CLI, provided with the official buyer-side package

Legacy names (equivalent capability, for hosts still on older components):
- alipay-pay-for-402-service — parse the bill, pay, retry with proof, send the fulfillment receipt
- alipay-authenticate-wallet — authorize the wallet when required
- alipay-payment-feedback — fallback feedback when the payment flow fails

请不要把商户私钥、买家凭证或长期 Token 写入本 Skill；服务端验付也不得以「客户端是否安装组件」为前提。

Never embed merchant private keys, buyer credentials, or long-lived tokens in this skill; server-side verification must not depend on whether the client installed any component.

<!-- buyer-prerequisites v3 -->

前置检查 / Prerequisites

中文：本技能除编排示例 买方宿主的支付宝官方组件 外不分发其他可执行文件，且不含任何安装脚本与安装命令。调用前只做能力确认，不做本地安装动作：

1. 宿主须已具备官方支付宝买方支付能力（见「依赖技能 / Dependencies」列出的三个官方技能）；缺少时由宿主自身的官方 Skill 安装器补齐，本包不提供安装命令。
2. 钱包须处于已授权状态；未授权时先完成授权，再发起业务请求。
3. 若宿主既无法提供买方支付组件，也无法完成钱包授权，在支付前停止并如实向用户说明限制，不得改用本地生成结果。

English: Apart from the orchestration example 买方宿主的支付宝官方组件, this package ships no executables, install scripts, or install commands. Before calling, only confirm capability:

1. The host must already provide the official Alipay buyer-side payment capability (see Dependencies); if missing, the host's own official Skill installer supplies it — this package provides no install commands.
2. The wallet must be authorized; complete authorization first if it is not.
3. If the host can neither provide the buyer components nor authorize the wallet, stop before payment and tell the user the limitation honestly — never fall back to local generation.

<!-- payment-flow v2 -->

触发与调用摘要 / Triggers & usage summary

闲鱼商品文案生成与合规检查 / Xianyu Listing Copy with Compliance Checks

一句话结果承诺 / Outcome promise

中文：把一个真实存在的数字产品，变成 6 段可直接粘贴到闲鱼的文案，并给出逐条合规提示。
English: Turn one real digital product into six ready-to-paste Xianyu copy blocks, plus a per-item compliance checklist.

输入示例 / Input example

中文

产品：Excel 台账清洗 Skill（本地运行）
交付形式：Skill 文件夹 + 使用说明
支持平台：Windows / macOS，需 Python 3.10+
交付方式：网盘链接，付款后 10 分钟内发出
售后：7 天内安装问题免费协助，功能范围外不支持
价格：19.9 元

English

Product: Excel ledger cleaning skill (runs locally)
Delivery: skill folder + usage guide
Platforms: Windows / macOS, requires Python 3.10+
Handover: download link sent within 10 minutes of payment
After-sale: free install help for 7 days; out-of-scope requests not supported
Price: CNY 19.9

处理步骤 / Processing steps

中文
1. 提取产品事实：真实交付物、目标买家、支持平台、输入要求、交付方式、时效、价格、售后边界。
2. 生成 5 条标题，使用 5 种不同关键词顺序，每条都不超出真实功能范围。
3. 编写商品详情：解决的问题、买家获得的内容、使用方法、示例、要求、限制、交付步骤。
4. 生成标签与精简 FAQ，覆盖兼容性、定制、交付、修改、隐私和退款边界。
5. 生成常见买家问题的客服回复；改价、承诺、退款与最终交付确认一律交回卖家人工判断。
6. 生成一段演示脚本，展示输入、处理、输出与一个真实限制。

English
1. Extract the product facts: real deliverable, target buyer, supported platforms, input requirements, handover method, turnaround, price, and after-sale boundary.
2. Produce five titles using five different keyword orders, none exceeding the real capability.
3. Write the listing body: problem solved, what the buyer receives, how to use it, a worked example, requirements, limits, and handover steps.
4. Generate tags and a compact FAQ covering compatibility, customization, delivery, revisions, privacy, and refunds.
5. Draft replies to common buyer questions; price changes, promises, refunds, and final delivery confirmation always return to the seller.
6. Produce a short demo script showing input, processing, output, and one honest limitation.

输出文件 / 字段示例 / Output example

中文：按下列标题分别输出，全部为可编辑文本。

1. 标题5条
2. 商品详情
3. 标签
4. FAQ
5. 客服回复
6. 视频脚本

其中「商品详情」必须含：解决的问题 / 买家获得的内容 / 使用方法 / 示例 / 要求与限制 / 交付步骤。
关键信息缺失时，先列出缺失项，再基于明确标注的假设给出可编辑草稿。

English: Emit the following blocks as editable text.

1. title (five variants)
2. listing body
3. tags
4. FAQ
5. support replies
6. demo script

The listing body must contain: problem solved, what the buyer receives, how to use it, a worked example, requirements and limits, and handover steps. When facts are missing, list the missing items first, then supply a draft built on explicitly labelled assumptions.

成功验收标准 / Acceptance criteria

中文
- 6 个板块全部产出，无空段。
- 标题、详情、FAQ 中出现的每一项能力，都能在输入事实里找到对应依据。
- 全文不出现保证收益、保证排名、永久有效、零风险自动化等承诺。
- 不出现虚构的用户评价、案例、截图、认证或性能数据。
- 缺失信息均以「假设」形式显式标注，未被写成既定事实。

English
- All six blocks are produced, none left empty.
- Every capability claimed in the titles, body, or FAQ maps to a fact in the input.
- No promises of guaranteed earnings, guaranteed ranking, permanent validity, or risk-free automation.
- No invented reviews, case studies, screenshots, credentials, or performance figures.
- Every missing fact is labelled as an assumption rather than stated as fact.

适用场景与边界 / Scope and boundaries

中文
- 适用：为真实存在的数字商品撰写上架文案；为已有商品做合规自查与重写。
- 不适用：批量群发私信、账号自动化、刷单刷评、绕过平台规则的引流话术。
- 本 Skill 只产出文案文本，不代发、不登录账号、不接触买家账户。

English
- In scope: writing listing copy for a real digital product; compliance review and rewrite of an existing listing.
- Out of scope: bulk direct messaging, account automation, review manipulation, and any copy designed to bypass platform rules.
- This skill produces text only. It does not post, log in, or touch buyer accounts.

依赖、隐私与失败处理 / Dependencies, privacy, failure handling

中文
- 依赖：无外部 API、无账号、无密钥，纯文本生成。
- 隐私：只处理你主动粘贴的产品事实；文案不会外传到任何第三方服务。
- 失败处理：输入不足以支撑某个板块时，明确说明缺什么，并给出标注假设的草稿，而不是编造内容。

English
- Dependencies: no external API, no account, no key; pure text generation.
- Privacy: only the product facts you paste are used; nothing is sent to a third-party service.
- Failure handling: when input cannot support a block, state what is missing and return an assumption-labelled draft instead of inventing content.

详细规则 / Detailed rules

适用范围 / When to use

当用户提供一个真实的数字产品、技能包、模板或服务，并希望发布到闲鱼时，生成可直接编辑的商品文案。先识别真实交付物、目标买家、支持平台、输入要求、交付方式、时效、价格和售后边界。

合规要求 / Compliance rules

• 不承诺保证赚钱、保证排名、永久有效或零风险自动化。
• 不虚构用户评价、案例、截图、认证和性能数据。
• 不鼓励绕过平台规则、批量骚扰私信或引导站外付款。
• 用具体交付物替代“全能助手”“百分百自动化”等模糊宣传。
• 明确买家得到的是提示词、Skill 文件夹、工作流模板、可执行工具还是定制服务。

版本与更新时间 / Version and update

中文：v1.0.0。本 Skill 为纯文本能力，无外部依赖，功能范围自发布起未变。
English: v1.0.0. Pure text capability with no external dependencies; the functional scope is unchanged since publication.

变更记录 / Changelog

1.0.0

• 首次发布：六段式闲鱼文案输出 + 合规自查清单 + 中英双语说明。

购买前先看 / Read before purchase

一次调用交付 / One-call delivery

• 中文：适用于闲鱼数字商品上架前的文案撰写与合规自查；输入产品事实清单，输出可直接粘贴的六段式文案与一份合规风险提示，不虚构评价、案例、资质或收益 / Use before listing a digital product on Xianyu; accept a fact sheet and return ready-to-paste copy plus a compliance risk list, without inventing reviews, cases, credentials, or earnings.
• English: Xianyu Listing Copy with Compliance Checks
• 输入与输出 / Input and output：按本技能定义提供结构化输入；输出为可执行的结构化结果、清单与验收提示。 / Provide the structured input defined by this skill; the output is an executable structured result, checklist, and acceptance cues.
• 适合 / Best for：需要明确产出、可复核边界、且不想为多个小步骤重复付款的任务。 / Tasks that need a clear, reviewable deliverable without paying separately for every small step.
• 不适合 / Not for：缺失必要字段、要求读取服务器本地路径、要求执行任意脚本或要求绕过平台的请求。 / Requests missing required fields, asking to access server paths, asking to execute arbitrary scripts, or asking to bypass the platform.
• 交付标准 / Acceptance：成功响应返回结构化结果、处理摘要与复核提示；输入不完整时先返回缺失项，不虚构结果。 / A successful response returns structured results, a summary, and review cues; incomplete input returns missing fields instead of invented output.

示例 / Example

POST /v1/pay/skills/xianyu-listing-copy/invoke

{"title": "iPhone 13 128G 国行", "condition": "95新", "specs": ["电池健康 92%", "无拆无修"], "price": 2600, "defects": "边框有一处轻微磕碰"}

使用契约 / Usage contract

售后与满意度 / Satisfaction & recovery

• 只有服务端实现同一订单的 retry_credit、幂等和补偿记录时，才能提供一次不重复计费的修正重试。
• 如果尚未实现补偿，只提供问题反馈和人工处理路径，不承诺免费再次调用或自动退款。
• 免费预览、基础能力和付费完整结果必须区分资源或端点；成功交付后可提供自愿打赏，但打赏不影响访问、验收或售后。

A free correction retry is allowed only when the server implements retry_credit, idempotency, and compensation records for the same order. Otherwise, provide support feedback without promising a free call or automatic refund.

线上收费 API 范围 / Hosted paid API scope

线上范围：按结构化请求产出本技能定义的结果、清单或报告；线上不读取服务器本地路径、不处理买家二进制文件、不执行买家脚本。

The hosted scope returns the result, checklist, or report defined by this skill from a structured request. It does not read server-local paths, process buyer binaries, or execute buyer scripts.

本次更新 / Version 1.0.5 update

中文：新增可选买方编排示例 买方宿主的支付宝官方组件（probe/pay/complete/retry/status；只输出支付宝官方 CLI 参数，不实现支付、不安装组件、不含密钥），并新增「买方支付操作示例」一节；同步修正「不含任何脚本」的自相矛盾表述。服务地址、Service ID、¥0.10 计费契约与 402 流程保持不变。

English: Added the optional buyer-side orchestration example 买方宿主的支付宝官方组件 (probe/pay/complete/retry/status; it only emits arguments for Alipay's official CLI — no payment implementation, no installs, no keys) and a buyer payment walkthrough section; fixed the self-contradictory "contains no scripts" wording. Service URL, service ID, ¥0.10 billing contract, and the 402 flow are unchanged.

已核对的输入示例 / Registered input example

{
  "title": "戴森吸尘器 V8",
  "price": "399",
  "condition": "9成新",
  "defects": "底部有轻微划痕"
}