税务预警自查

概述

第 0 节 · 付费门禁（最高优先级，任何调用必须先过）

本节优先级高于本文件所有其他章节。任何一次本技能调用，都必须先完成支付，才允许输出任何产物。

后端基址 BASE（下文所有 URL 均相对它）

⚠️ 必须用 IP，不要用域名。 作者的域名解析到境内 ECS 但未完成 ICP 备案，

阿里云的拦截是按 HTTP Host 头判定的：请求里 Host 是域名就返回 403

（Server: Beaver + <title>Non-compliance ICP Filing</title>），Host 是 IP 则直接放行。

实测同一次请求，IP 直连能打通业务接口，仅把 Host 换成域名立刻 403。

⚠️ 对外分发时 BASE 必须写上线地址（IP 形式）。作者本地自测改成 127.0.0.1:8080 的方法：

把上面「正式」一行临时替换即可，测完改回 IP。

选哪个 BASE：默认线上。先探一次 BASE/api/resource 再决定：

• 返回 402 → 服务正常，用这个 BASE 继续。
• 返回 502 / 超时 → 服务没起来，按 0.3「后端不可用」话术终止，不要换成本地离线版替代。
• 返回 500 → 服务在跑但签名密钥没配好（DEV_PRIVATE_KEY 占位），通道 A 不可用，直接转 0.5 通道 B。

已知事实：服务端 .env 中 DEV_PRIVATE_KEY 当前是占位文本，/api/resource 会返回

500 error:1E08010C:DECODER routines::unsupported。遇到 500 不要重试第三步，直接转 0.5 通道 B。

0.1 适用范围（无例外）

唯一例外：第二步展示勾选器是本流程的必要环节，允许在付费前打开。

该 HTML 已改造为「纯参数选择器」，只内联 行业 / 编号 / 名称 / 等级 / 参考模板名，

不含论证正文、政策依据、证明材料清单，也不具备本地生成报告的能力。

除此以外，以下行为在未完成支付前一律禁止：

• 输出任何预警项的正文、论证路径、证明材料清单、政策依据原文

（包内 预警项索引.json 只含编号 / 分类 / 名称 / 等级 / 行业归属，Agent 可读它把用户口述翻译成 ID；其余正文只存在于服务端，本地物理上不含、更不得向用户描述）

• 生成或导出任何 .docx 报告、HTML 报告、Markdown 报告
• 任何形式的本地拼装报告、本地兜底出报告
• 代替用户"代跑一遍""先给个样例看看"

0.2 执行步骤（严格按顺序）

第一步 · 检查支付能力确认当前 Agent 已安装并可用 weixinpay 插件（存在 weixinpay_pay 工具）。

• 不可用 → 原样回复：「当前 Agent 暂不支持微信支付付费能力，无法使用本技能。」然后终止，不输出任何产物。

第二步 · 启动参数接收器 → 展示勾选器 → 自动取回参数（必须先于付费完成）

1. 先启动接收器（后台任务，不要阻塞当前回复）

   python scripts/watch_params.py --timeout 1800 --out "<工作区>/_params.json"

它同时开两条通道，任一命中即把参数写入 --out、打印 PARAMS_OK 并退出：

• 本地回环桥 http://127.0.0.1:17632/params（勾选器点击时 fetch 提交）
• 剪贴板轮询（勾选器点击时已自动写入剪贴板，无需用户复制粘贴）

端口须与勾选器内 BRIDGE 一致（默认 17632；两处都写死，改动需同步）。

超时会打印 PARAMS_TIMEOUT（退出码 2）→ 走第 5 条兜底。

1. 展示勾选器：用 present_files 打开技能包内的 税务预警自查报告勾选器.html，并提示用户：

「勾选适用行业与有预警的事项，点底部『生成报告』即可 —— 之后无需任何操作，我会自动创建支付订单。」

1. 自动取回参数：接收器退出后会收到后台任务完成通知。读取 PARAMS_OK 行（或 --out 文件）取：
   • specs：行业数组，已含「通用小微」，原样作为第三步的 specs
   • items：勾选的预警项 ID 数组，即第三步的 items
   • ts / n：仅为「每次点击唯一」的标记，忽略（防止重复提交同一组参数被误判）
2. 回显确认（与订单一起给出，不额外等人）：把配置与支付信息合并成一次输出，例如

「本次覆盖：通用小微 + 建筑劳务分包，共 2 项（A1、A2）；已创建订单，请扫码支付 9.9 元。」—— 用户看到二维码的同时也会看到配置，此时仍有「不扫码」的否决机会。

1. 兜底口径（两条，等价处理）
   • 接收器超时或本机通道被拦截 → 回落为手动流程：用户在页面上点「复制参数」，把

TXR-PARAMS … 整行粘回对话，按同样规则解析（回执形如TXR-PARAMS {"v":1,"ts":1757…,"n":"ab12cd34","specs":["通用小微","建筑劳务分包"],"items":["A1","B7"]}）。

• 用户直接口述范围（如「建筑劳务分包，全部高风险项」）→ 据口述补全 specs 与 items。

1. 硬性约束
   • 绝不允许先付费再补参数
   • 拿到参数后立即终止接收器（手动粘贴场景下它仍在后台跑，需主动停止），避免迟到的超时通知
   • 此步不得输出任何知识库正文、论证路径或报告内容
   • specs 恒以「通用小微」打头；items 必须非空

第三步 · 请求资源（触发 402）

POST http://120.27.158.166:8081/api/resource
Content-Type: application/json
Body: {"specs": [...], "items": [...]}

预期返回 402。从响应头同时提取并保存：

• WeixinPay-Required → 作为 paymentCode
• X-Out-Trade-No → 订单号

⚠️ 线上端点统一用 /api/resource（实测线上 /invoke 返回 404）。

给 Agent 的指令一律写 /api/resource，避免部署版本差异踩坑。

第四步 · 发起支付调用 weixinpay_pay，paymentCode 传上一步的 WeixinPay-Required 值。

• 支付失败/取消 → 走 0.3 失败话术，终止，不输出产物。
• 支付未完成 → 禁止直接重试第三步当作已支付。

第五步 · 支付成功后取回内容（必须带两个 Header 重试）

POST http://120.27.158.166:8081/api/resource
WeixinPay-Required: <第二步保存的值>
X-Out-Trade-No: <第二步保存的值>
Content-Type: application/json
Body: 与第三步完全一致

⚠️ 不携带 X-Out-Trade-No 重试，永远拿不到付费内容，会一直回到 402。

第六步 · 履约成功响应 200 + application/json，主要字段：

• docx_base64：WORD 报告（base64 解码即得 税务风险自查报告模板.docx）
• filename：建议文件名
• content：逐项结构化论证（id / name / level / reportSections / rebuttal），供 Agent 直接引用
• out_trade_no：订单号（对账用）

解码保存后告知用户订单号与文件路径。只有到这一步，才允许产出交付物。

⚠️ 写入前先查重名：服务端返回的 filename 恒为 税务风险自查报告模板.docx，

若工作区已存在同名文件，必须先另存为 税务风险自查报告模板_<订单号后 6 位>.docx 再写入，

或在写入前告知用户将被覆盖。否则会静默覆盖上一单的交付物。

0.3 失败与降级话术（照抄，不要自由发挥）

• 设备不支持支付（返回"当前设备暂不支持微信支付AI专属卡"）：

「本次支付失败：当前设备不支持微信支付 AI 专属卡，无法完成支付。请到已开通该能力的设备/账号上重试，或稍后再试。支付未完成前我无法提供报告内容。」

• 用户取消支付：「支付已取消，未产生费用。需要时告诉我行业与预警项，我重新发起。」
• 后端不可用（非 402、超时、404）：「付费服务暂时不可用（端点应为 /api/resource），请稍后重试。」终止，不改用离线版替代。

0.5 通道 B：扫码支付（AI 专属卡不可用时的降级路径）

通道 A（AI 专属卡）不会弹出二维码——它由微信支付插件拉起"支付授权"界面，钱从 AI 专属卡扣。当通道 A 不可用（如"当前设备暂不支持微信支付AI专属卡"）时，改用通道 B：

1. POST {BASE}/api/native

Body 同第三步 → 返回 { out_trade_no, code_url, amount, expires_in }

1. 用二维码工具把 code_url 渲染成图片展示给用户。

本地工具：技能包内 scripts/make_qr.py（纯本地渲染，不联网，需 qrcode+pillow）：

   python scripts/make_qr.py "weixin://wxpay/bizpayurl?pr=xxx" 支付二维码.png "微信扫码支付 9.9 元"

若环境无 qrcode 库，改用系统/在线二维码生成方式，但不得把 code_url 当普通链接发给用户打开。

1. 提示用户：请用微信扫码支付 9.9 元，15 分钟内有效。
2. 用户付款后，POST /api/resource 并带上 X-Out-Trade-No: <out_trade_no> 与相同 Body → 服务端查单，已支付即返回 docx_base64。
3. 若尚未支付，会返回 402 支付未确认，可间隔几秒重试（建议最多 10 次、约 2 分钟）。

注意：code_url 形如 weixin://wxpay/bizpayurl?pr=xxx，只能在微信内扫，不要把链接直接发给用户在浏览器打开。

0.4 作者本地调试旁路（仅作者本人）

技能目录下若存在文件 .dev_bypass（内容任意），则跳过第 0 节门禁，便于作者自测。分发给买家前必须删除该文件。

一、能力定位

用户在 WorkBuddy 对话中调用本 SKILL，产出定制化税务风险自查报告模板（.docx）。

• 企业基本信息一律用 **** 占位，下载后据实替换（保护隐私、可分发）。
• 预警项与政策依据来自云端服务（核定时点见 version）。
• 报告为"模板"而非"已填数据的报告"：结论表、整改表留白待填。
• 本技能为按次付费服务，调用前须完成支付（见第 0 节）。

二、目录结构（随 SKILL 自带，自包含）

税务预警自查报告生成/
├── SKILL.md                    # 本说明（含第 0 节付费门禁）
├── 使用手册.md                  # 面向买家的一页式手册（同时是上架物料）
├── 商用授权与免责.md             # 授权范围与免责声明（第七节引用）
├── 税务预警自查报告勾选器.html    # 纯参数选择器（第 0 节第二步用，点「生成报告」自动回传参数）
├── 预警项索引.json               # 59 项的编号 / 分类 / 名称 / 等级 / 行业归属（无正文，供口述→ID 映射）
└── scripts/
    ├── watch_params.py          # 参数接收器（本地回环桥 + 剪贴板双通道，第 0 节第二步用）
    └── make_qr.py               # code_url → 二维码 PNG（通道 B 用；需 qrcode + pillow）

⚠️ 本目录会被整包下发。 技能以「目录」为分发单元，打包器会收录目录内全部文件、不做任何排除。

因此不得把密钥、知识库正文、后端源码、构建脚本、作者侧文档放进本目录 ——

它们统一存放在作者侧目录（发行说明中有映射关系），不进本包。

_user_meta.json 由平台在安装时生成，无需手工维护，也不必打进上传包。

三、产出流程

1. 启动参数接收器并展示勾选器，用户点击「生成报告」后自动取回 TXR-PARAMS 参数（见第 0 节第二步）。
2. 完成第 0 节支付，用同一份参数请求资源，取回 docx_base64 与 content。
3. 解码保存为 税务风险自查报告模板.docx，存放到用户工作区。
4. 用 content 里的逐项论证在对话中做简要说明（可选）。
5. 告知订单号，便于对账。

报告正文只存在于服务端。税务预警自查报告勾选器.html 仅是选参数的前端界面，

不含论证正文、也不具备本地生成能力，因此它本身不是付费内容的交付物。

四、知识库更新（订阅 / 复购点）

预警知识库与报告正文由作者侧维护：政策变动后作者重新生成勾选器与索引，并发布新版技能包。调用方只需替换整包重新安装即可获得更新，无需自行执行任何构建命令。

• 勾选器与索引均只含「选参数所需元数据」（行业 / 编号 / 名称 / 等级 / 参考模板名），

论证正文不进前端、也不进本包。

• 旧版不保证政策时效，请以最新版为准；核定时点见本文件 frontmatter 的 version 字段。

五、敏感信息与隐私（强制）

• 企业信息统一 **** 占位，不写入真实身份证 / 手机号 / 银行卡。
• 付费请求仅上传"勾选项 ID + 行业"，不上传企业名称 / 税号等敏感数据。
• 报告论证内容由服务端在支付成功后返回，本包内不含任何预警正文，本地仅负责保存与展示文件。

六、反方自检（生成前必过）

• 是否含通用小微基座项？高风险项是否默认勾选？政策依据是否含 2026 新口径（甲供工程简易计税废止、服务业加计抵减失效）？专项行业是否追加行业附录？

七、已知边界与免责

• 模板为高频项，无法穷举所有税务风险；阈值非法定标准，仅供内部参考。
• 本产物为模板 / 草稿生成工具，不构成税务代理、审计或法律意见；重大事项 consult 主管机关。详见 商用授权与免责.md。

八、市场元数据（上架用）

• 分类：财税合规 / 企业服务
• 标签：税务自查、风险预警、财税服务、代账、合规报告、付费技能
• 定价：9.9 元/次（per_call，微信 Agent Pay X402）
• 上架说明：提交平台审核时附 使用手册.md 与一份 demo 报告作为货架物料
• 上架渠道现状：WorkBuddy 公开文档未提供自助发布入口，上架需走平台方提交 / 开发者入驻或邀约