计费与支付（PAYSKILL · 支付宝 AI 按量付费）

本技能为 付费技能，按次计费。付费链路走支付宝 AI 按量付费（A2M / HTTP 402），由服务提供方部署的网关承担 402 出账、验付与履约回执；本包不含任何密钥，不实现支付逻辑，不代用户付款。

重要：本技能的核心交付由服务端生成，脱离后端服务无法独立完成。未完成付费环节时，不得用本地脚本或模型自行产出替代结果。

定价

单次调用 0.20 元（CNY），按调用量计费。
上架表单标价、支付宝侧服务登记单价、服务端 402 账单金额三处必须完全一致，否则用户无法完成支付。

四条执行指令（必须按序执行，不得跳步）

① 前置检查（支付工具） 发起下单前，检查当前可用工具列表中是否存在支付类工具（alipay_*、weixinpay_*，带前缀亦算；只以工具列表为证据，文档里提到的工具名不算）。不支持则终止且不下单，只告知结论与解决办法：升级智能体到最新版本，或从 SkillHub 安装官方「支付宝 AI 付」能力（npx -y @alipay/alipay-aipay@latest install）。不向用户解释检查过程。

② 请求资源（probe）

python3 scripts/pay_client.py probe --resource wwtp-ops/render

服务端未收到付款时返回 HTTP 402 与 Payment-Needed 账单，脚本自动落地到 .pay_state/，退出码 2。收到 2 即暂停交付，向用户报明金额、商品名、收款方与支付截止时间。

③ 发起支付（pay）

python3 scripts/pay_client.py pay

或用平台支付工具基于账单拉起收银。由用户本人扫码/免密支付，Agent 只编排、不代付、不接触密钥，全程不向用户暴露支付链接、二维码原文或交易号。工具缺失时退出码 3，按 ① 的处置说明终止。

④ 支付后重试并交付（complete）

python3 scripts/pay_client.py complete --proof "<Payment-Proof>"

服务端调用 alipay.aipay.agent.payment.verify 验付（校验 active / amount / out_trade_no / resource_id，并按 trade_no 防重复履约），通过后返回资源内容，同时异步调用 alipay.aipay.agent.fulfillment.confirm 回执。业务内容以服务端验付后返回的为准，不得用本地结果替代。

依赖与配置

必须设置环境变量 PAY_SERVER_BASE（服务提供方网关，https:// 开头）。未设置时脚本退出码 4 并明确报错，不降级、不假通过。
自检：python3 scripts/pay_client.py doctor（检查服务端可达性与支付工具）。
退出码：0 成功 / 2 需付费 / 3 支付工具缺失 / 4 配置缺失 / 5 支付未完成 / 1 其他错误。

安全红线

应用私钥仅存于服务端，禁止写入本包、日志或公开仓库。
Payment-Proof 必须经支付宝验付接口核验，无效或过期凭证一律拒绝服务；结果不明时不得要求用户重复付款。
履约回执必须可重试且幂等，不重复扣费、不重复交付。
生产环境严格校验订单、金额与资源三者对应关系。

〇、专家级路由（v2.0.0）

专家定位：污水运营数据分析台——对接"利川博华化验数据"知识库，把化验台账与运行台账算成达标率、吨水电耗、吨水成本与多厂排名，给利川 17 座污水厂（89 人运营团队）的运营与考核人员用，以口径可溯、原始数据不改一字为验收标准。 五维评估：

适用场景：①按 GB 18918-2002 一级A/一级B/二级判逐日达标率与超标明细 ②进出水浓度统计与去除率 ③运营月报（吨水电耗/药耗/负荷率/吨水成本） ④多厂同月指标横向排名 ⑤水质控制图与连续超标预警
能力边界：不做工艺设计计算（→activated-sludge-calculator）、不做运行实操诊断（→activated-sludge-ops）、不做财务三大报表解读（→financial-plain-reader）、不篡改原始检测值
依赖资产：scripts/ops_analysis.py（water/monthly/compare/standard 四子命令，禁改）、pandas/numpy/openpyxl/matplotlib、内置 GB 18918-2002 限值表
交付质量：Excel sheet 顺序固定（汇总→超标→去除率→预警→原始数据），缺失数据不计入分母并如实说明
性能表现：30 天×3 厂数据一次跑完秒级出 Excel+PNG；月报与对比各一键生成 四级响应（L1-L4）：按任务复杂度给出响应级别——
L1 轻量问答/单步查询 → 直接回答：GB 18918-2002 限值查询（standard）与统计口径解释
L2 标准任务 → 按标准工作流执行：单一文件达标率分析，跑 water 出结果与控制图
L3 复杂任务 → 分步工作流+质量门：月报+多厂对比联跑，过"负荷率需 --capacity"检查点
L4 专家任务 → 完整流程+参考资料+交付物：月度考核全套（达标率+月报+排名+异常跟进建议） 黄金窗口：单厂月度分析 300-800 字；多厂考核汇报 800-1500 字；列名不规范先归一化再跑。 专家件索引：
scripts/ops_analysis.py：四子命令（water/monthly/compare/standard）
正文"注意事项"：列名规范、NH3-N 取严值、连续超标预警三级
正文"实战范例"：3 厂 30 天模拟数据的跑数口径

wastewater-ops-analysis — 污水运营数据分析

v2.0.0 专家级（2026-09-07）：九要素结构化升级，补定位/分步工作流检查点/输出规范/边界反模式；四个子命令、GB 18918-2002 限值与连续超标预警逻辑保持已验证版本不变。

定位声明

面向市政污水厂运营团队的日常数据分析技能，服务于利川 17 座污水厂（89 人运营团队）的水质达标分析、运营月报编制与多厂对比考核。数据源为"利川博华化验数据"知识库中的进出水水质检测记录（化验室台账 Excel）与月度运行统计。依赖 scripts/ops_analysis.py（pandas/numpy/openpyxl/matplotlib）。与 activated-sludge-calculator 分工：本技能管事后数据统计分析，该技能管设计计算。

需求澄清（收到任务先评，缺项一次问清，只问一轮）

不评不开工：下表五维逐一对照，任何一维不明确，开工前一次性追问，只问一轮；问清即进入工作流。

| 维度 | 判断要点 | 不明确时的动作 | |---|---|---| | 分析类型 | 水质达标／运营月报／多厂对比／限值查询 | 追问分析类型 | | 数据来源 | 化验数据 Excel 路径与表结构 | 追问 | | 厂与期间 | 哪些厂、起止日期 | 追问 | | 执行标准 | 一级A／一级B／二级 | 追问 | | 交付范围 | 分析 Excel／控制图／月报／对比排名 | 按交付范围匹配响应级别 |

响应分级：L1 限值/口径问答→直接答；L2 单次分析→标准流程；L3 分析+月报+对比→分步+质检；L4 多厂考核全套→全流程+归档。

触发条件

给了化验数据 Excel/csv，问达标率、超标天数、去除率
要出运营月报（吨水电耗/吨水药耗/负荷率/吨水成本）
多厂同月指标横向排名、月度考核
查 GB 18918-2002 各等级限值
关键词：达标率、超标、运营月报、吨水电耗、吨水成本、多厂对比、控制图、compliance rate、monthly report

功能概述

| 子命令 | 功能 | 输入 | 输出 | |--------|------|------|------| | water | 水质数据分析 | 化验数据 Excel/csv（宽表或长表） | 分析 Excel（指标汇总/超标明细/去除率/连续超标预警/原始数据）+ 控制图 PNG | | monthly | 运营月报生成 | 日粒度运行数据（水量/电耗/药耗/成本） | 月报 Excel（月度汇总/日报明细）+ 指标趋势图 PNG | | compare | 多厂对比排名 | 月报汇总 Excel（+可选达标率文件） | 对比 Excel（总表 + 各指标排名表） | | standard | 标准限值查询 | 无 | GB 18918-2002 一级A/一级B/二级限值表（md / xlsx） |

分步工作流

输入 → 处理 → 输出 → 检查点，按业务场景四条线：

水质达标分析：
- 输入：从"利川博华化验数据"知识库导出化验台账 Excel。
- 处理：运行 water（按出水执行标准选 --standard）。
- 输出：达标率汇总、超标明细、控制图 PNG。
- 检查点：核对列名规范（见注意事项）；NH3-N 低温期结合水温人工复核。
运营月报编制：
- 输入：每日运行台账汇总为日粒度表。
- 处理：运行 monthly（--capacity 传各厂设计规模算负荷率，--price 覆盖默认单价）。
- 输出：月报 Excel + 趋势图 PNG。
- 检查点：负荷率为空说明未传设计规模；成本单价与厂内实际对账。
多厂对比考核：
- 输入：上月 monthly 输出 + water 输出。
- 处理：运行 compare 生成排名表。
- 输出：总表 + 达标率/吨水电耗/吨水成本排名表。
- 检查点：低效厂名单需附原因分析与整改建议，不只给排名。
异常跟进：
- 处理：对超标明细厂站，结合趋势图与运行数据排查原因。
- 检查点：整改措施落实后下一周期复评达标率变化。

输出规范

水质分析 Excel sheet 顺序：指标汇总 → 超标明细 → 去除率 → 连续超标预警 → 原始数据；控制图 PNG 含进出水时间序列与标准线。
月报 Excel：月度汇总 + 日报明细；指标含处理水量、吨水电耗(kWh/m³)、吨水药耗(g/m³)、负荷率(%)、吨水成本(元/m³)。
对比 Excel：总表 + 各指标排名表（达标率降序、吨水电耗/吨水成本升序）。
文件命名：<用途>_<厂区/月份>_<YYYYMMDD>；上报文件附数据来源与统计口径说明。

命令用法

# 水质数据分析（宽表：日期、厂名、COD_in/COD_out、NH3N_in/NH3N_out、SS_in/SS_out、TN、TP、pH 等；
# 也支持长表：日期、厂名、指标、类型(进水/出水)、数值）
python3 scripts/ops_analysis.py water 化验数据.xlsx -o 水质分析结果.xlsx --chart 控制图.png --standard 一级A
python3 scripts/ops_analysis.py water 化验数据.csv -o 水质分析_一级B.xlsx --standard 一级B

# 运营月报（输入日粒度数据；--capacity 传各厂设计规模 m³/d）
python3 scripts/ops_analysis.py monthly 运行数据.xlsx --capacity "利川A厂=30000,利川B厂=20000" -o 运营月报.xlsx --chart 趋势图.png
python3 scripts/ops_analysis.py monthly 运行数据.xlsx --capacity "利川A厂=30000" --price 电价=0.55 --price PAC=2200 -o 运营月报.xlsx

# 多厂对比（file 为 monthly 输出的月报 Excel；--rate-file 为 water 输出的分析 Excel）
python3 scripts/ops_analysis.py compare 运营月报.xlsx --rate-file 水质分析结果.xlsx -o 多厂对比.xlsx

# 标准限值查询
python3 scripts/ops_analysis.py standard
python3 scripts/ops_analysis.py standard -o 标准限值表.md --excel 标准限值表.xlsx

边界与反模式

不适用场景：工艺设计计算（→ activated-sludge-calculator）；运行实操诊断（→ activated-sludge-ops）；财务三大报表解读（→ financial-plain-reader）。

禁止行为：

不篡改原始检测值；缺失数据不计入达标率分母，必须如实说明
不用单日数据下"稳定达标/不达标"结论（以逐日达标率为准）
不在无 --capacity 时编造负荷率
不把估算成本当财务口径成本上报（估算值需注明）

常见错误：宽表/长表列名不规范导致指标识别失败；NH3-N 忽略水温分档（本工具取严值，一级A 按 5 mg/L 判定）；中文字体缺失导致图内方框。

依赖说明

沙箱已预装：pandas、numpy、openpyxl、matplotlib。如环境缺失：

pip install pandas numpy openpyxl matplotlib
# 图表中文显示建议安装中文字体（Linux: fonts-noto-cjk / Noto Sans SC）

降级方案：matplotlib 缺失时只出 Excel 不出图并告知；中文字体缺失时改用英文标签或提示安装字体。

实战范例

以模拟的 3 座厂（利川A/B/C 厂）、连续 30 天化验数据为例：

python3 scripts/ops_analysis.py water 化验数据_3厂30天.xlsx -o 水质分析结果.xlsx --chart 进出水控制图.png --standard 一级A
# 输出：每厂每指标 均值/最大/最小/达标率/超标天数；本示例中 A厂 SS 超标 1 天、
#       B厂 TP 超标 3 天、C厂 COD/NH3-N 各超标 3 天（共 10 条超标明细）
#       控制图 PNG 绘制 COD/NH3-N/SS 进出水时间序列与标准线

python3 scripts/ops_analysis.py monthly 运行数据_3厂2个月.xlsx --capacity "利川A厂=30000,利川B厂=20000,利川C厂=10000" -o 运营月报.xlsx --chart 指标趋势图.png
# 输出：各厂月度 处理水量/吨水电耗(≈0.25 kWh/m³)/吨水药耗(≈23 g/m³)/负荷率(82~86%)/吨水成本

python3 scripts/ops_analysis.py compare 运营月报.xlsx --rate-file 水质分析结果.xlsx -o 多厂对比.xlsx
# 输出：按月份对 3 厂进行 达标率(降序)/吨水电耗(升序)/吨水成本(升序) 排名

月度考核汇报示意：达标率排名 C 厂垫底（COD/NH3-N 各超 3 天）→ 结合控制图定位 3 次超标集中在进水冲击时段 → 建议：加强进水在线监控预警与格栅曝气沉砂池工况排查，下月复评。【待核：超标原因需现场确认】

注意事项

化验数据列名尽量保持规范：宽表用 COD_in/COD_out、NH3N_in/NH3N_out、SS_in/SS_out、TN_out、TP_out、pH_out；长表用 日期、厂名、指标、类型(进水/出水)、数值。脚本内置常用别名（氨氮、悬浮物、COD 等）自动归一化
NH3-N 限值按水温分档，本工具取严值（一级A 按 5 mg/L 判定）；冬季低温期请结合水温数据人工复核
达标率按"有检测值的日期"逐日判定，缺失数据不计入分母；超标明细 sheet 逐条列出超标日期、检测值与限值
连续超标预警（v1.1.0）：water 输出新增 连续超标预警 sheet——自动统计各厂各指标最长连续超标天数，≥2天记录预警（2天低/3-4天中/≥5天高，附对应处置建议），预警级别"高/中"行自动标红
成本计算：优先使用输入中的电费/药剂费/人工成本列；缺失时按默认单价估算（电价 0.6 元/kWh、PAC 2500 元/吨、PAM 20000 元/吨、人工 6000 元/人/月），可用 --price 覆盖
负荷率需在 monthly 时通过 --capacity 提供各厂设计规模，未提供则该项为空
图表中文字体依赖 Noto Sans SC / Noto Sans CJK SC，若环境无中文字体请先安装，否则图内中文会显示为方框

版本与变更记录

v2.0.0（2026-09-07）：九要素结构化升级，补定位/工作流检查点/输出规范/边界反模式/实战范例，并插入〇、专家级路由区块；子命令与限值逻辑不变。
v1.1.0：新增连续超标预警 sheet（2/3-4/≥5 天三级）。
v1.0：water/monthly/compare/standard 四子命令定版。

HTML 伴生输出（底座已内嵌 · html-report-builder v3.0.2）

底座 5 脚本（md2report.py / palettes.py / build_report.py / board.py / html_check.py）已内嵌本技能 scripts/htmlbase/，自包含运行，无需引用外部技能；底座升版后用 python3 /sandbox/workspace/scripts/sync_htmlbase.py --all 重新分发。

本技能产出成稿后，除原件（Word/Excel/PDF/Markdown）外，额外产出一份单文件 HTML 成果页——原件不变，HTML 为伴生增量。统一走公共底座，无需自建模板：

python3 scripts/htmlbase/md2report.py <成稿md> -o <名称>_成果页.html --theme <配色id> --audience <交付对象> --check

自动完成的语义着色（无需改 md 写法）：来源角标 (P0)~(P4)、缺口标注 【待核：…】、观点块 > …；末章标题含"来源/参考"时自动生成分级来源表。

配色速选：内部汇报 ocean／环保低碳 forest·botanical／打印分发 minimal·arctic／投资财务 galaxy·golden／技术前沿 tech。

交付要求：--check 的 FAIL 清零后方可交付；归档时 HTML 成果页与原件一并入库（成果库 kb_id=ztJsLCMwR3pgWo250gemdopQbgBCLefIJCGns0HK9D0=）。

引用依据与溯源

本技能所有结论都可回溯，禁止凭印象给数：

判定限值：以《城镇污水处理厂污染物排放标准》GB 18918—2002（一级A/一级B/二级）为唯一判定依据；文中出现的 5 mg/L（NH₃-N 一级A，水温>12℃）等限值均取自此标准附表。规模与负荷率释义可参考《室外排水设计标准》GB 50014。
计算口径：吨水电耗、吨水药耗、负荷率的统计口径参考《城镇污水处理厂运行、维护及安全技术规程》CJJ 60；单位换算（m³、kWh/m³、g/m³、元/m³）一律以台账原始记录为准，不折算、不外推。
数据来源分级：P0＝"利川博华化验数据"知识库台账与在线监测原始记录｜P1＝GB 18918—2002、CJJ 60 与厂内月度运行统计｜P2＝二手汇总表。缺源数据一律标【待核：需补原始记录】，不以估算值替代实测值。
溯源要求：分析 Excel 的"指标汇总"每列注明出处（哪本台账、哪段时间区间）；控制图标注数据源与标准线依据，数据点一律来自输入表，不杜撰、不插补。

红线声明

严禁篡改、补写、平滑原始检测值；缺失即缺失，不得用均值或插值冒充实测。
不得在无 --capacity 时输出负荷率数值；不得把估算成本当作财务口径成本上报。
不做工艺设计计算与运行实操诊断——前者转 activated-sludge-calculator，后者转 activated-sludge-ops，越界即停止并分流。
达标结论仅限以逐日达标率呈现，不用某一天数据单独下"稳定达标/不达标"结论。

失败模式与降级路径

逐条列出失败模式（Failure Mode），回退与兜底动作均在脚本内实现；异常一律显式提示，绝不静默失败。

| 触发的失败分支 | 现象 | 降级/回退动作 | 兜底方案 | |---|---|---|---| | 列名不规范 | 宽表/长表列名与内置别名都不匹配，指标识别失败 | 降级为交互式列映射：打印识别到的列名，请用户确认对应关系后重跑 | 无法映射时按"未识别列"跳过并列入待核清单 | | 指标整体缺列 | 台账缺 TN_out 等关键列 | 回退到子集分析：仅对存在的指标出达标率，缺项列表说明 | 全部缺失则终止并提示补台账 | | matplotlib 不可用 | 出图报错 | 降级处理：只出 Excel 不出控制图，并告知原因 | 提示 pip install matplotlib | | 中文字体缺失 | 图内中文显示为方框 | 降级为英文标签输出 | 提示安装 Noto Sans SC / Noto Sans CJK SC | | Excel 被占用/写入失败 | openpyxl 抛 PermissionError | 重试 1 次并换输出文件名 | 仍失败则改输出 CSV 并说明 | | 多厂多月数据量大 | 内存紧张、耗时过长 | 分厂分月断点续跑：按厂分批，已完成的厂不重算 | 极端时只出汇总不出明细 | | 负荷率为空 | 未传 --capacity | 该项留空并显式错误处理提示 | 由用户补传设计规模后重跑 | | 表头行误判 | 表头不在首行 | 容错逻辑跳过前置空行与标题行 | 仍失败则请用户指定表头行号 |

边界条件补充：单厂单日仅一条记录不构成趋势；跨年数据须按年度分开统计；进水冲击时段单独标注，避免与常规工况混算导致达标率失真。所有降级动作均在交付说明中写明，便于补救与下一周期复评。

标准操作步骤

需求澄清：按"需求澄清"表逐维对照（分析类型、数据路径、厂与期间、执行标准、交付范围），缺项一次问清。
输入校验：解析台账，核对列名与指标覆盖度，打印识别结果。
口径计算：按选定标准跑 water / monthly，计算达标率、去除率、吨水电耗与吨水成本。
质量门：过 scripts/ops_analysis_check.py，FAIL 清零后才可交付。
对比排名：多厂场景跑 compare，对低效厂附原因分析与整改建议。
交付归档：输出 Excel + 控制图（+ 可选 HTML 成果页），写明数据源与统计口径，归档入成果库。

错误处理与降级矩阵

下表为输入异常或执行失败时的既定处置。命中任一情形按对应动作执行：不静默失败、不臆造结果、不把异常栈直接抛给用户。

| # | 错误类型 | 识别信号 | 处理动作 | 降级输出 | |---|---|---|---|---| | 1 | 输入要件缺失 | 关键对象、范围、口径中任一项未给 | 一次性列出缺失项追问，不猜测补齐 | 输出「请补充：…」清单，不进入主流程 | | 2 | 参数或格式非法 | 编号、日期、金额、路径格式不符约定 | 按本技能约定归一化后重试一次 | 回显归一化结果，注明按归一化值处理 | | 3 | 依赖或脚本缺失 | ops_analysis.py、ops_analysis_check.py、pay_client.py 报 ModuleNotFoundError、No such file | 不中断交付，转手工路径 | 改按 case-library.md 逐项手工执行 | | 4 | 脚本运行异常 | 非零退出、Traceback | 取末行错误摘要回显，不贴完整栈 | 说明失败环节 + 手工替代步骤 | | 5 | 检索或匹配无结果 | 关键词、编号、库内均无命中 | 判定为本技能范围外或无收录，不外推 | 「未找到」+ 建议检索路径，不编造条目 | | 6 | 结果冲突 | 同一对象出现两套口径或两个版本 | 并列输出全部口径并标注来源 | 交用户择一，不擅自选口径 | | 7 | 输出超限 | 结果条数或篇幅超出可读范围 | 先给汇总表，明细按需分批 | 汇总在前、明细附后，标注总量 | | 8 | 外部数据不可达 | 接口超时、站点改版、链接失效 | 重试一次后中止该来源 | 只用已获数据出结论，缺失项标【待核】 |

退出码约定：0 正常产出 / 1 输入异常需补充 / 2 无结果或执行失败。非 0 情形必须在输出首段说明原因。

输出确定性与可复现约定

同一输入在不同时间、不同会话调用，结论与排序须一致，便于复核与留痕：

排序规则：精确命中优先于模糊匹配；同层级按编号或时间升序，不按随机相关度浮动。
去重规则：同一对象的多条记录合并为一条，主版本置首，被替代版本紧随并标注关系。
幂等：重复调用不改变结果集，不出现「上次多一条、这次少一条」。
不抽样：声明「全量」时输出全部命中项，不挑选代表性几条充数。
字段固定：每条记录按本技能既定字段输出，缺项写【待核】，不留空白位或省略字段名。
口径可追溯：结论附数据来源与取数时点；同一项目多口径并存时全部列出，不合并。
版本可比对：结果附本技能版本号，便于跨会话比对同一问题的答案是否变化。

场景覆盖矩阵

| 场景 | 典型输入 | 是否覆盖 | 输出形态 | |---|---|---|---| | 单点问答 | 「达标率」 | 覆盖 | 直接结论 + 依据 + 注意事项 | | 成套方案 | 「超标分析」「运营月报」一起给 | 覆盖 | 分项方案 + 汇总表 | | 校验复核 | 「这个数字/说法对不对」 | 覆盖 | 逐项核查表 + 差异说明 | | 口径冲突 | 同一对象出现两套说法 | 覆盖 | 并列口径表 + 采纳口径提示 | | 计费与支付（PAYSKILL · 支付宝 A | 涉计费与支付（PAYSKILL · 支付宝 A的请求 | 覆盖 | 按本技能对应节口径输出 | | 〇、专家级路由（v2.0.0） | 涉〇、专家级路由（v2.0.0）的请求 | 覆盖 | 按本技能对应节口径输出 | | 范围外请求 | 明显属其他专业技能的活 | 不覆盖 | 按第 0 节分流指引转出，不硬做 | | 缺输入请求 | 要件不全、口径不明 | 暂不覆盖 | 先追问补齐，再进主流程 |

范围外与禁止事项，以本节列出的边界为准：

不得在无 --capacity 时输出负荷率数值；不得把估算成本当作财务口径成本上报。

输入输出样例

例 1｜命令行调用

python3 scripts/pay_client.py probe --resource wwtp-ops/render
python3 scripts/pay_client.py pay
python3 scripts/pay_client.py complete --proof "<Payment-Proof>"

输出：按本技能既定字段给出结果清单，附来源与状态标注；无命中时按错误处理矩阵第 5 行处置。

例 2｜自然语言请求

输入：「达标率」

输出：先按第 0 节确认适用边界 → 按工作流分步执行 → 交付结构化结果（结论在前、依据在后、缺口标【待核】）。

例 3｜边界请求

输入：明显不属于本技能范围的请求。

输出：一句话说明本技能不处理该事项，指向对应技能，不尝试勉强作答。

常见问题（FAQ）

Q：这个技能能直接替我做完整份成果吗？ 不能。技能给方法、模板与校验口径，最终成果须由你确认事实与口径后定稿；关键数据一律以原件为准。

Q：输入信息不全时会怎样？ 按错误处理矩阵第 1 行处置：一次性列出缺失项，不猜、不编、不先做后补。

Q：结果和我手上的资料不一致怎么办？ 并列列出双方口径与来源，标注差异，交你择一，不擅自合并或取舍。

Q：为什么有些内容标了【待核】？ 凡是未取得原始出处、或来源为二手转述的数据与结论，一律标【待核】并说明缺口，避免把不确定当确定用。

Q：脚本跑不起来怎么办？ 按错误处理矩阵第 3 行：转 case-library.md 手工执行同一流程，交付不因脚本问题中断。

Q：同一问题问两次结果会不一样吗？ 不会。见「输出确定性与可复现约定」：排序、去重、字段固定，重复调用结果一致。

Q：能不能只给结论不写依据？ 不能。结论必须带依据与来源；无依据的判断以「判断：」标注并说明推断前提。

Q：支持哪些输入格式？ 以本技能第 0 节与输入约束所列为准；超出格式须先转换或手工录入，不做静默兼容。

Q：多项目或多口径混在一起怎么处理？ 逐项目、逐口径分列，不混算；需要汇总时单列汇总表并注明口径。

Q：成果交付包含哪些件？ 按本技能交付规范输出正文件 + 自检记录；涉及对外发送时另附落地格式文件。

版本沿革

v2.3.1（2026-10-23）：补齐错误处理与降级矩阵、输出确定性约定、场景覆盖矩阵、输入输出样例、常见问题。
v2.2.0（2026-10-06）：新增 references/专家名片卡.md（快捷示例卡）。
v2.1.0（2026-09-08）：补「引用依据与溯源」「红线声明」「失败模式与降级路径」「标准操作步骤」四节；新增质检脚本 scripts/ops_analysis_check.py 与案例库 references/case-library.md；四个子命令与 GB 18918—2002 限值逻辑保持不变。
v2.0.0（2026-09-07）：九要素结构化升级，补定位/工作流检查点/输出规范/边界反模式/实战范例，并插入〇、专家级路由区块。
v1.1.0：新增连续超标预警 sheet（2/3-4/≥5 天三级）。
v1.0：water/monthly/compare/standard 四子命令定版。

买家准备（调用前必读）

本技能在调用过程中会触发支付宝按次扣费，买家侧需要具备 AI 支付能力，否则无法完成付款。

| 买家类型 | 是否可直接支付 | 处理方式 | |---|---|---| | 已开通「支付宝 AI 付」的智能体 | ✅ 可以 | 直接调用，按提示扫码/确认付款 | | 通用大模型 App（如千问等） | ❌ 不能 | 提示用户更换客户端或安装下列组件 | | 自建 Agent 环境 | 需安装 | 执行下面的安装命令 |

自建 Agent 安装买家支付能力：

npx -y @alipay/agent-payment@latest install

安装后 Agent 获得 alipay-bot 命令，可完成「请求 → 402 → 生成支付 → 扫码付款 → 携凭证重试 → 验付 → 履约」。

注意事项：

付款账号需已实名；同一笔交易的买家与卖家不能为同一实名主体。
支付在弹出的支付宝收银台完成，完成后 Agent 自动重试原请求，无需用户再次操作。
未完成付款前，服务端不会产出任何实质性成果。

付费声明（Pay Skill · 支付宝 AI 按量付费）

计费方式：按次付费（per_call），单价 ¥0.20 / 次（price_fen = 20）。

未支付不交付：未取得有效 Payment-Proof 之前，不产出任何实质性成果；不设免费额度、不提供绕过支付的路径。

支付协议：HTTP 402 + Payment-Needed（A2M / 支付宝 AI 付）。

调用流程：

GET https://1307504600-m2gj03cfbx.ap-guangzhou.tencentscf.com/demo/a2m/resource → 返回 402，响应头 Payment-Needed 携带 Base64URL 账单（金额、商户、service_id、RSA2 签名）。

用户通过支付宝 AI 付确认支付。

携带 Payment-Proof 重放同一请求 → 服务端调用 alipay.aipay.agent.payment.verify 校验 active=true、金额、商户订单号、资源一致性。

校验通过后调用 alipay.aipay.agent.fulfillment.confirm，返回 200 与成果内容。

服务地址：https://1307504600-m2gj03cfbx.ap-guangzhou.tencentscf.com；单价以服务端 PRICE_FEN=20 为准，两端一致。

幂等：同一 trade_no 不重复履约；重复请求返回已交付结果。