标书审查技能

用户提到标书审查、投标文件检查、废标项检查或标书检查时使用。字段说明见 @references/api.md。命令模板见 templates/workflow.sh。审查脚本在 scripts/bid_check.py，内置分析在 analysis/main.py，支付二维码脚本在 scripts/payment_guide.py。

执行流程

在本技能根目录按顺序执行。没有 analysis_id 时，只用内置分析，不要调用其他技能。

1. 缺少 analysis_id 时先分析招标文件：python analysis/main.py --file-path "招标文件绝对路径"。从结果读取 analysis_id。
2. 审查平台已生成的投标文件：python main.py --no-wait --analysis-id "ANALYSIS_ID"。审查用户自己的 .docx：python main.py --no-wait --analysis-id "ANALYSIS_ID" --file-path "投标文件绝对路径"。
3. 用触发结果里的 task_uuid 查询进度：python main.py --task-uuid "TASK_UUID" --once。不要用 analysis_id 代替 task_uuid。
4. 状态为完成后再取结果：python main.py --task-uuid "TASK_UUID" --get-result --bid-check-result-id "BID_CHECK_RESULT_ID"。
5. 把脚本 stdout 原样交给用户。批注稿和汇总表保存到本地。余额不足时，把脚本给出的支付二维码交给用户，到账后用同一次审查命令再执行一次。

能力说明

• 支持基于 analysis_id 触发平台内已生成标书审查
• 触发前自动审查投标文件是否已生成：未生成则提示并停止，避免无效审查
• task_uuid 必须来自触发响应：触发后返回的任务 UUID，用于后续 --task-uuid --once 查询进度
• 审查流程：先触发任务，再轮询状态，状态完成后再获取结果对象
• ⚠️ 无渐变进度条：标书审查采用状态切换模式，进度值仅显示 0%（进行中）和 100%（完成），中间无渐变。轮询输出以状态描述（如”正在加载标书文件””正在审查招标文件”）为主。
• 支持两条路径：
  • --no-wait：仅触发并返回 task_uuid，后续由外部定时任务或用户发起查询
  • --once：单次查询当前状态，适用于外部定时任务轮询
• 审查完成后可通过 --get-result 获取审查结果，并默认把 .docx 批注文件和 .xlsx 汇总表下载到用户桌面。结果中优先给出本地路径；不要引导到网盘
• 审查维度覆盖：商务、技术、资质、格式、内容质检、废标项、风险评估、整改建议

面向终端用户的表达（默认）

> 默认不要把命令行写给用户。 说明须先有已生成的投标文件与分析记录、审查需要等待、完成后会有下载链接即可；不要列出 python main.py、--task-uuid、--analysis-id 等，除非用户明确索要命令行。

与「仅输出脚本结果」的关系： 审查进度与结果下载等 stdout 原文仍须原样展示。

微信登录认证

• 没有可用 Token 时，运行本技能目录里的 python wx_login.py。几秒内命令结束，浏览器在后台继续等扫码，最长 5 分钟。二维码和这个后台浏览器绑在一起，浏览器一关码就失效。
• 只让用户扫二维码，不要提供浏览器登录链接。有的客户端打不开技能目录里的图片时，按下面顺序给图，不要只发文件路径：
  1. 把脚本输出里 WECHAT_QR_MARKDOWN: 后面的整行原样放进回复。这是内嵌二维码，不依赖用户能不能访问脚本所在磁盘。
  2. 本地 PNG 只作为补充。工作目录存在时，脚本还会导出 /workspace/微信登录二维码.png。文件卡片如果没有真正预览出来，就不要再靠路径。
• 不要只用读取工具打开这张 PNG。那样只有助手自己看得到，用户看不到。
• 用户用微信扫码后，必须在手机上点「确认登录」。只扫不点等于没登录。用户表示已经扫码后，再执行原来的业务命令。
• Token 写入 ~/.taitoubiao/token.json，五个技能共用。5 分钟内不要重复启动登录，否则旧码作废。
• 接口返回登录失效时，会清掉缓存并重新出一张码。自动化请设置 TAITOUBIAO_SKIP_AUTO_LOGIN=1。

🚫 输出规范（必须遵守）

> ⚠️ 核心原则：模型必须只输出脚本返回的原始结果，严禁自行生成中间状态消息或进度摘要！

🚫 严格禁止的行为：

• ❌ 禁止额外改写/总结：不得在脚本原文之外生成进度摘要、耗时统计或结果解读
• ❌ 禁止额外等待提示：不得在脚本原文之外插入等待/轮询安排类自然语言
• ❌ 禁止提前产出结论：任务未完成时不得输出任何”审查发现”中间结论
• ❌ 禁止自行解释状态：不得在脚本原文之外解释状态字段含义
• ❌ 禁止 UUID 混用：不得使用 analysis_id 替代 task_uuid 进行进度查询

✅ 正确行为：

• 用户侧沟通：见上文「面向终端用户的表达（默认）」— 默认不向用户贴命令行；脚本 stdout 仍须原样展示。
• 仅输出脚本原始结果：将脚本 stdout 原样展示给用户，不做修改或总结
• 终止当前本轮输出：单次查询若未终态，结束本轮输出，后续由外部定时器/用户再次调用
• 完成后再获取结果对象：仅在完成态执行 --get-result 并原样展示下载信息

示例：

❌ 错误输出（AI 自行生成）：

⏳ 审查任务进行中：当前进度 42%，我会 10 秒后自动再查一次。

✅ 正确输出（脚本原始结果）：

## 审查进行中，状态：正在加载标书文件

任务仍在处理中，请稍后再次执行查询命令。

或当审查完成时（先完成，再取结果对象）：

# 标书审查完成

任务已完成，请使用 --get-result 获取审查文件下载链接。

不同模式下的输出区别

本技能支持多种调用模式，输出格式有所差异：

状态查询模式（--task-uuid --once）：单次返回当前状态描述，用于外部定时任务轮询。

--no-wait 模式（仅触发）：返回受理信息，必须突出展示 task_uuid，供后续查询使用。

--get-result 模式（仅完成后调用）：返回结果对象与下载链接信息。

--list 模式（查询列表）：返回审查记录列表表格。

--detail 模式（查看详情）：返回某条记录的详细审查项。

使用限制

• 触发审查前必须提供有效的 analysis_id
• 若不存在分析记录（缺少 analysis_id），在本技能目录执行内置分析 python analysis/main.py，不要调用其他技能
• 平台已生成的投标文件：只传 analysis_id。若还没有生成投标文件，脚本会停止并说明需要先生成
• 用户自己的投标文件：同时传 analysis_id 和本地 .docx 的 file_path。脚本按网站同一流程上传后审查，不再提示功能未开放
• 自上传文件只接受 .docx，大小不超过 500MB。暗标检查默认关闭
• 余额不足：脚本按网站标书检查套餐（套餐 4）自动生成微信支付二维码，路径为技能目录 .cache/bid-check-pay-qr.png。把这张图给用户扫码，到账后再重新发起审查

调用方式

步骤 0 - 审查分析记录（强制前置）

• 若用户已经给了 analysis_id，直接进入审查
• 若缺少 analysis_id，在本技能目录执行内置分析，不要调用名为 tender-analysis 的外部技能
  bash python analysis/main.py --map-query "/absolute/path/to/tender.pdf" python analysis/main.py --file-path "/absolute/path/to/tender.pdf" python analysis/main.py --task-uuid "TASK_UUID" --poll
• 从 # 招标文件分析结果 读取 analysis_id，再执行步骤 1

> 🔴 重要：analysis_id 和 task_uuid 是两类不同标识，严禁混用！
> - analysis_id：来自本技能 analysis/main.py 的输出，用于触发审查
> - task_uuid：来自审查触发响应，用于查询进度

步骤 0.5 - 审查投标文件是否已生成（自动执行）

• 用户没有提供本地投标文件时，脚本按平台已生成文件触发审查
• 若未找到已生成文件：停止并提示用户「未审查到已生成的投标文件」，询问是否需要启动标书生成
• 用户提供了本地 .docx 时，走自上传流程，不要求平台里已经生成投标文件

步骤 1 - 触发审查（拿到 task_uuid）

平台已生成的投标文件：

python ./main.py --no-wait --analysis-id "ANALYSIS_ID"

用户自己的投标文件（.docx，不超过 500MB）：

python ./main.py --no-wait --analysis-id "ANALYSIS_ID" --file-path "/absolute/path/to/bid.docx"

bidDocumentId 能从分析结果读到时不必再传。读不到时加上 --bid-document-id。

触发成功后，必须从脚本输出中提取 task_uuid。

--no-wait 模式关键要求：必须保存并展示 task_uuid，并在后续使用该值查询进度。

步骤 2 - 查询进度（单次查询模式）

> 🔴 task_uuid 必须来自步骤 1 的触发结果，严禁自行构造或复用其他 UUID。

python ./main.py --task-uuid "TASK_UUID" --once

• 推荐由外部定时任务每 10 秒 查询一次
• 停止条件：
  • FINISHED / COMPLETED / SUCCESS：停止并执行步骤 3 获取结果对象
  • FAILED / FAIL：停止并返回失败
  • 任务未找到：停止并提示校验 UUID

步骤 3 - 审查完成后获取结果对象（下载链接）

python ./main.py --task-uuid "TASK_UUID" --get-result --bid-check-result-id "BID_CHECK_RESULT_ID"

> 仅当步骤 2 判定为完成态（FINISHED / COMPLETED / SUCCESS）时才能执行步骤 3。

🔴 状态判定规则（必须遵守）

--task-uuid --once 的脚本输出中，status 字段决定后续行为：

1. 审查进行中（非完成态，且非失败态）

   • 必须终止本轮后续查询请求（不得继续发送下一次查询）
   • 必须让用户看到脚本原文中的进度信息（progress/currentProgress / description）
   • 等待外部定时器或用户再次调用脚本发起下一次查询

2. 审查失败（status = FAILED 或 status = FAIL）

   • 必须立即停止后续任何进度查询与轮询
   • 不得再发送下一次查询

3. 审查完成（status = FINISHED / COMPLETED / SUCCESS）

   • 必须停止进度查询
   • 必须调用 --get-result 并完整展示结果对象（下载链接）

4. 任务未找到

   • 必须停止轮询并原样展示脚本结果

状态查询与完成判定

查询通过脚本执行，传入 task_uuid 即可获取当前状态。

标书审查无渐变进度条，状态为开关式切换：

• STARTED/RUNNING/PROCESSING/PENDING：审查进行中，状态描述会变化（如"正在加载标书文件"→"正在审查招标文件"→"生成报告"）
• FINISHED/COMPLETED/SUCCESS：审查完成，可执行 --get-result
• FAILED/FAIL：审查失败
• 进度值仅显示 0%（进行中）和 100%（完成），不作为判断依据

判定建议：

• FINISHED / COMPLETED / SUCCESS：审查完成，停止轮询并执行 --get-result
• FAILED / FAIL：审查失败，停止轮询并返回失败原文
• 任务未找到：停止轮询，提示校验 task_uuid
• 其他状态：仅输出脚本原文，等待下一次查询

轮询时长建议

• 推荐轮询间隔：10 秒一次（外部定时器反复执行 --task-uuid --once）
• 正常耗时：30 分钟以内（视文件大小而定）
• 默认总超时：触发+轮询模式 2100 秒（35 分钟），单次查询模式 1800 秒（30 分钟）
• 超时后停止轮询，返回脚本原文并提示用户稍后重试

异常处理约定

• 脚本返回非成功状态、401/403、Token 无效：立即返回失败，不继续轮询
• 查询链路失败（进度查询或结果对象查询失败）：返回明确错误原因
• 网络超时/连接异常：返回失败并建议重试

内置招标文件分析

分析代码在本技能的 analysis/ 目录，发布本技能时一并带上，不依赖单独安装的标书分析技能。

• 用户只上传招标文件时，先运行 python analysis/main.py，从结果读取 analysis_id
• 用户已经提供 analysis_id 时，跳过分析，直接审查
• 审查对象仍是该分析记录下已经生成的投标文件。还没有生成文件时，脚本会停止并说明需要先完成标书生成

可选参数

结果字段说明

• 查询状态：status、description（状态描述）
• 结果对象：审查项列表，每条包含 clauseId、label（符合项/高风险/缺陷/用户自查）、reason
• 常见下载产物：
  • 带批注的投标文件（.docx）
  • 审查结果汇总表（.xlsx）
• 失败信息：error 或明确失败提示文本

审查完成后的下载入口

当状态为 FINISHED / COMPLETED / SUCCESS 时，必须向用户提供结果下载信息：

1. 使用 --get-result --bid-check-result-id 获取结果对象
2. 从脚本返回中提取下载链接
3. 原样展示给用户，不做改写

推荐脚本

• 无分析记录时：先执行本技能的 python analysis/main.py，获取 analysis_id
• 仅触发：--analysis-id ... --no-wait
• 单次查询（供外部定时任务调用）：--task-uuid ... --once
• 获取结果：--task-uuid ... --get-result --bid-check-result-id ...
• 查询列表：--list
• 查看详情：--detail 记录ID 或 --detail 记录ID --label 高风险