文本去重与格式清洗

概述

本技能调用商家的远程服务。将用户原始文本保存为 UTF-8 文件，使用随包脚本完成请求和恢复；清洗由服务端执行。默认将 CRLF 换成 LF、修剪每行首尾空白、去空行、大小写敏感地按行保序去重，不排序。单次输入最多 20,000 个 Unicode 字符，不能全为空白或包含 NUL；超出限制时先说明，不自动拆成多笔收费订单。

调用前

• 确认用户已同意把本次文本发送给收费服务。只有用户授权本次交易后才能调用微信付款工具；已有明确授权不重复询问。价格以接口返回的 amount_fen（人民币分）为准，1 分仅是开发测试建议价。
• 真实收费调用前，先确认当前环境中存在名称包含 weixinpay_ 的微信支付工具（使用工具发现能力检查实际可用工具；带命名空间的 mcp__weixinpay__weixinpay_pay 等也算）。不存在则停止收费流程，说明需要安装或升级支持微信支付工具的客户端；不要伪造支付成功。
• 查看同目录的 config.json。本包已配置商家 HTTPS 服务地址 https://www.moshuinsight.com/skillpay。以实际发布与商家验证结果为准。
• 只有用户明确要求本地演练时，才可使用 mock 模式且可跳过微信工具检查。mock 支付码绝不能传给真实微信支付工具；演练确认付款由项目演练流程执行。

发起一次清洗

为每个新的清洗任务选择一个尚不存在的会话文件，放在用户工作目录或临时工作目录，必须位于技能目录之外。会话保存原始文本、幂等键和订单号，是恢复订单的依据，不能打包发布、提交到代码仓库或发送给无关服务。

在技能目录执行（也可使用脚本绝对路径）：

python scripts/invoke.py start --file /absolute/path/input.txt --session /absolute/path/work/text-clean-session.json

脚本从 config.json 读取服务地址，也可使用 --base-url https://merchant.example 指定已确认的商家地址。四项选项默认均为真；按用户要求可加入 --no-trim-lines、--no-remove-empty-lines、--no-deduplicate 或 --no-case-sensitive。此处的示例域名不是可调用服务。

脚本在首次网络请求前保存会话，并返回 JSON：

• code: PAYMENT_REQUIRED（HTTP 402）表示正常待付款。向用户说明本次金额和交付内容。真实模式下，按当前微信工具的实际参数定义传入服务返回的 WeixinPay.WeixinPay-Required（与 payment_code 对应）和需要的支付信息，完成用户授权和付款。不要猜测工具名称、参数或支付结果。
• code: SUCCESS 表示已交付，展示 result.text 以及输入行数、输出行数、删除空行数和重复行数。already_fulfilled: true 表示返回原订单结果，不应再付费。
• 服务模式或金额与用户授权不符时停在付款之前，说明返回值；不要自行接受新的价格。

支付后取结果与断线恢复

付款后必须恢复原会话：

python scripts/invoke.py resume --session /absolute/path/work/text-clean-session.json

resume 自动保持原请求正文、Idempotency-Key 和已知的 X-Out-Trade-No。即使首次响应丢失，也会用已保存的幂等键找回原订单。

• 仍返回 402：订单还未确认支付，保留会话，检查支付工具结果后再恢复查询。不能把 402 自动解释为需要再次付款。
• 超时、断线、5xx、非 JSON 响应或付款状态不明：保留会话并说明状态未确认，只能恢复原会话；不要删除会话后重建订单、自动重付或生成新幂等键。
• REFUNDED（HTTP 409）：已退款，停止此订单的交付流程并说明状态。新购服务需要新的用户交易授权。
• 其他错误：报告服务返回的错误，保留会话供排查。仅在旧任务已经明确结束、用户确实发起另一项清洗任务时才使用新的 start。

脚本标准输出始终为 JSON。402 和 200 返回退出码 0，网络或服务错误返回 1，参数和本地会话错误返回 2。脚本拒绝覆盖已有会话、拒绝自动跟随 HTTP 重定向；生产地址仅允许 HTTPS，HTTP 仅允许 localhost 或回环 IP。