PLC 品牌术语对照（Pay Skill）
三菱程序看不懂西门子写法？博图里的 TON 对应三菱哪个指令？查这张表就够。
每次成功调用 ¥0.05（支付宝 AI 按量付费 / A2M 协议自动收款）。
功能说明
输入 PLC 概念或指令关键词（支持一次多个，空格/逗号分隔），返回三菱 / 西门子 / 欧姆龙三个品牌的对应写法对照表，输出 JSON 格式。服务端为纯本地对照库（19 类常用概念），不外联第三方、不读取用户本地文件。付费采用支付宝 AI 按量付费（A2M 协议）：402 报价 → 用户支付 → 服务端验付 → 履约确认 → 返回结果。
适用场景
- 拿到三菱程序要看懂、但只熟西门子（或反之）
- 写跨品牌技术文档 / 投标方案时的指令对照
- 维护多品牌产线（三菱 FX5U + 西门子 S7 + 欧姆龙 CJ/CP）时的快速速查
不适用 / 能力边界
- 不替代品牌官方编程手册，具体以各品牌软件版本为准
- 只覆盖 19 类常用概念，冷门特殊指令（安全 PLC、运动控制专用指令等）不在库内
- 只做"概念 → 三家写法"映射，不解释指令用法细节
使用方法（A2M 四步完整流程）
第一步：请求资源（无凭证首调，预期返回 402）
GET https://gk-diagnose-308980-8-1461759720.sh.run.tcloudbase.com/api/term-map?q=定时器
q：概念关键词，必填；多关键词用空格/逗号分隔（如q=MOV 置位、q=定时器,计数器）。- 也可用打包脚本一键走完整流程：
python scripts/term_map_client.py --q "定时器"
第二步：处理 402 账单
无有效凭证时返回 HTTP 402，响应头 Payment-Needed 为 Base64url 编码的账单（含订单号、金额、卖方 RSA2 签名）。把该头原样保存到仅当前用户可访问的安全文件，不得解码改写账单内容。
第三步：发起支付
读取 alipay-payment-skill，按其 402-buyer-pay 流程将账单交给支付宝收银：
alipay-bot 402-buyer-pay --session-id '<当前会话ID>' --file '<账单安全文件>' \
--resource-url '<第一步的完整URL>' \
--intent-summary '原始请求：查询 PLC 品牌术语对照' --method GET
向用户展示收银二维码/链接，由用户在支付宝 App 内授权付款（首次使用需开通 Agent 支付）。
第四步：付款后取回结果（必须执行）
用户付款后按 alipay-payment-skill 取得 Payment-Proof，带 Payment-Proof 头重放第一步的同一 URL。服务端验付并履约后返回对照结果，响应头 Payment-Validation 即履约确认凭证（请留存备查）。
触发示例
- 「三菱的 T0 K10 相当于西门子什么指令？」→ 调用
q=定时器 - 「这个欧姆龙的 TIM 是什么意思？」→ 调用
q=定时器 - 「帮我对照一下 MOV、SET、RST 三家怎么写」→ 调用
q=MOV 置位 复位
参数说明
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
q |
query | ✅ | 概念关键词，多值用空格/逗号分隔，如 定时器、MOV 置位 |
Payment-Proof |
请求头 | 付款后重放时必带 | 支付宝返回的支付凭证（Base64url），原样携带 |
Payment-Needed（响应） |
响应头 | — | 402 时返回的账单（Base64url），交给 alipay-bot 402-buyer-pay |
Payment-Validation（响应） |
响应头 | — | 履约确认凭证，付款重放成功时返回 |
示例输出
{
"query": "定时器",
"matched": 1,
"results": [
{"概念": "定时器", "三菱": "T0 K10", "西门子": "TON / TONR（IEC）", "欧姆龙": "TIM / TIMH"}
]
}
履约确认与订单持久化幂等（服务端保证）
- 订单持久化：每次 402 生成全局唯一
out_trade_no（前缀 GK + 毫秒时间戳 + 随机串），订单即时写入服务端 SQLite orders 表（out_trade_no主键 +trade_no唯一索引），含金额、商品名与 30 分钟支付时限。 - 服务端验付：收到 Payment-Proof 后，服务端先调支付宝「AI 按量付费验付接口」核验凭证真伪，并比对订单号、金额、商品一致性，任一不符按未支付处理。
- 履约确认：验付通过后执行支付宝「履约确认」接口，并以响应头
Payment-Validation回传确认结果。 - 幂等：同一订单只履约一次——重放同一 Payment-Proof 直接复用已生成结果，不会重复扣费、不会重复计价；订单状态 UNFULFILLED → PENDING_CONFIRM → FULFILLED 全程留痕可对账。
测试验证
- 2026-09-14 线上实测：
GET /api/term-map?q=定时器→ HTTP 402，返回out_trade_no=GK17893…、amount=0.05、currency=CNY、goods_name=PLC 品牌术语对照，Payment-Needed头同步携带 Base64url 账单（卖方 RSA2 签名）✅ - 付费重放后返回
results对照数据并携带Payment-Validation履约确认头 ✅ - 服务端订单库可按
out_trade_no对账查询 ✅
异常处理
q缺失 → 422（参数校验），补q重试- 账单过期（30 分钟）或验付失败 → 再次返回 402 新订单，重新走支付流程即可
- 重放时未带
Payment-Proof→ 按 402 处理，不会误判为已支付
版本更新
- v1.0.1（2026-09-14）：补充履约确认与订单持久化幂等说明；新增
scripts/term_map_client.py一键付费流程脚本；补触发词、示例输出与线上测试记录。 - v1.0.0（2026-09-12）：首发 19 类对照库。
说明
- 对照为常用写法速查，具体以各品牌编程手册与软件版本为准
- 服务端纯本地对照表，不外联、不读取用户文件
- 内容由 AI 整理生成
