标讯猎手 BidHunter

采集国央企/公共资源招投标公告 → 资质规则比对可投性 → 生成带研判简报 → 多通道推送 → （v1.5+）评分排序/日历提醒/多维筛选/零代码配规则 → （v2.0+）AI 速读标书与风险识别 → （v2.5+）投标策略建议 → （v3.5+）交标前法定红线扫描与废标预警。 自包含、已脱敏：不含任何私有主体、个人联系方式、公司档案。使用者按自己的营业执照与业务规则填充配置即可。

5 分钟跑通（新用户看这里）

两条路，挑一条：

A. 先看效果——不用配任何东西

python3 bidhunter.py paste 你的招标文件.pdf

丢一份招标文件进来，直接出废标风险报告（31 条法定红线本地扫描）。 不需要 AI key、不需要采集源、离线可跑。

B. 开始监控——三问生成配置

python3 bidhunter.py init

问三个问题（主体名称 / 主营什么 / 盯哪些地区），自动生成你的资质规则库， 再 bash pipeline.sh 开始采集。

行业不设固定选项——可以直接粘贴营业执照经营范围，自动拆成能力词。 想先看看效果不写盘：python3 bidhunter.py init --preview

卡住了？先跑诊断

任何异常先跑这一条，30 秒定位问题（E001E005 + W001W004，每条都带修复建议）：

python3 bidhunter.py doctor

最常见的失败原因是 E002：规则库仍是示例占位符。装上不等于能用—— 一条命令解决：python3 bidhunter.py init（三问自动生成，约 1 分钟）。

版本能力一览

★ v2.8 为什么是这一版

2026-10-05 复盘发现三个叠加缺陷，每一个都单独足以让读标结论不可信：

修复后实测（B02 保洁真实招标文件 PDF）：覆盖率 79.9% → 100%；合规命中 0 → 9 条；无 AI key 也能出评标办法/截止时间/预算/资格要求/未确认字段。

新增两个纯规则（零 API）模块：

• gap scan 待补材料清单：三态（HAVE / MISSING / CHECK）+ 高危红标（缺件项落在签字盖章页 = 形式审查直接不通过）+ 有效期提醒
• gap zero 零响应检测：空洞满足 / 借附件 / 待补占位 / 跨项目残留 / 承诺主体不明 / 数字型空洞（"不低于要求"却没数字）

新增评分点分值守恒校验：评分项合计 ≠ 100 时报警并要求解释差额——总分对不上通常意味着漏抄了评分项，这正是漏分的根因。

何时使用

• "抓一下招投标" / "今日哪些能投" / "重新分析一遍标讯"
• "AI 读一下这份标书" / "这份招标文件有什么风险" / "帮我出投标建议"
• "这份标会不会被废" / "交标前帮我过一遍" / "有没有废标风险" / "合规红线扫一下"
• "还差什么材料" / "待补材料清单" / "这些材料要不要盖章"（v2.8 gap scan）
• "帮我查查有没有漏项" / "有没有只写完全满足的" / "有没有上个项目的残留"（v2.8 gap zero）
• "评分表在哪" / "评分点有几个" / "这个分怎么拿"（v2.8 评分点逐项映射 + 分值守恒校验）
• "我们几家一起投 / 多主体投标会不会被认定串标"（v3.5 先查实施条例第34条）
• "这个标报多少" / "报价复核一下" / "出价前帮我过一遍" / "这个标值不值得投"（v2.7 走报价闸门）
• 需要判断公告可投性、归属投标主体、监控重点平台
• 搭建/优化招投标监控工作流

安装与初始化

1. 脚本已随 skill 就位（~/.workbuddy/skills/bidhunter/scripts/）。
2. 编辑 qual_rules.json 填入你的投标主体与资质能力词：
   • 零代码：运行 python3 bidhunter.py rules edit → 浏览器图形化编辑，内置「能源/建筑/IT/市政」行业模板可一键预填
   • 或复制 scripts/samples/demo_rules.json 改
   • 校验：python3 qual_check.py --validate-rules qual_rules.json
3. （可选）配置推送：python3 config_wizard.py（钉钉/企微/邮件）
4. （可选）配置 AI：~/.config/bidhunter/ai.json 写入 {"api_key":"你的MiniMaxKey"}（v2.0+ 用，仅消耗你的 API 余额，零云成本）。AI 速读 PDF/Word 建议先 pip install -r requirements.txt（PyPDF2/python-docx）；未装则自动降级为正则抽取。

先看效果再配：直接 python3 bidhunter.py demo 跑内置示例。

统一命令入口（v1.5 · A9，零命令行门槛）

python3 bidhunter.py run [--fresh] [--summary] [--calendar]   # 采集+比对+报告(+推送)
python3 bidhunter.py status                                    # 今日状态
python3 bidhunter.py doctor                                    # 一键诊断
python3 bidhunter.py demo                                      # 示例效果
python3 bidhunter.py calendar [--days 7]                        # 投标日历
python3 bidhunter.py faq [关键词]                               # 查常见问题
python3 bidhunter.py rules edit [--port 8080]                  # 图形化配规则
python3 bidhunter.py ai read <标书.pdf>                        # v2.0 AI 速读
python3 bidhunter.py ai advise <标书.pdf>                      # v2.5 投标建议
python3 bidhunter.py api serve [--port 8765]                   # v3.0 本地API
python3 bidhunter.py compliance scan <标书> [--mode tender|bid] # v3.5 合规红线扫描
python3 bidhunter.py compliance checklist                      # v3.5 交标前自查清单
python3 bidhunter.py gap scan <招标文件>                          # v2.8 待补材料清单
python3 bidhunter.py gap zero <投标文件草稿>                      # v2.8 零响应检测
python3 bidhunter.py quote params [--show]                     # v2.7 报价参数库（首次填一次）
python3 bidhunter.py quote check --help                        # v2.7 报价闸门（不过禁止出金额）
python3 bidhunter.py gap scan <招标文件>                        # v2.8 待补材料清单（零 API）
python3 bidhunter.py gap zero <投标文件草稿> [--our-project 名称] # v2.8 零响应检测（零 API）

待补材料清单与零响应检测（v2.8）★

读完标只是第一步，最容易丢分的是"以为写完了"。这两条命令专治这件事，纯规则、零 API 成本。

# 交标前还差什么：资格要求逐条三态判定 + 高危红标
python3 bidhunter.py gap scan 招标文件.pdf
python3 bidhunter.py gap scan 招标文件.pdf --json

# 草稿写完后查零响应：空洞满足 / 借附件 / 待补占位 / 跨项目残留 / 数字型空洞
python3 bidhunter.py gap zero 投标文件草稿.docx
python3 bidhunter.py gap zero 草稿.docx --our-project "XX项目" --other-projects 上一标的项目名

gap scan 输出

共 3 项：缺 1 · 待确认 2 · 高风险 1 · 带有效期 2

🔴 [MISSING] 3.3 业绩证明文件（资格评审第 4 项）★须按规定格式提交业绩表…
     ⚠️ 出现在签字盖章页——缺件即形式审查不通过
     标记：需盖章

三态含义：

• HAVE — 规则库已有证据线索
• MISSING — 原文写"必须/应/须"但未找到我方证据 → 最高优先级
• CHECK — 表述含糊，人工确认

高危判定：缺件项若涉及合同/业绩/资质/承诺函/人员简历/盖章 → 🔴。因为这些要进签字盖章页，占位符上会 = 形式审查直接不通过，不用到评标。

gap zero 检出的六类零响应

评分点台账与覆盖矩阵（v2.9）★

gap 回答"我还差什么"，score 回答"分丢在哪"。两张表在交标前互为补充：台账管评分项有没有写，覆盖矩阵管每条要求有没有答。纯规则、零 API 成本。

# B1 评分点台账：五态跟踪 + 四条必报警
python3 bidhunter.py score ledger 招标文件.pdf
python3 bidhunter.py score ledger 招标文件.pdf --csv 台账.csv --xlsx 台账.xlsx
python3 bidhunter.py score ledger 招标文件.pdf --deadline 2026-10-20

# B2 正向覆盖矩阵：逐条要求判 A/B/C（需同时给投标文件草稿）
python3 bidhunter.py score coverage 招标文件.pdf --response 投标文件草稿.docx

# 两张表一起出 + 机器可读
python3 bidhunter.py score both 招标文件.pdf --response 草稿.docx --json

# 内置自测（11 用例：四个反例 + 三个 L3 回归 + 报警/降级）
python3 bidhunter.py score selftest

⚠️ B1 必须配 --response：不给投标文件草稿时，台账只会判「未开始」—— 定位到评分表只说明这项存在，不代表我方已写。这是 v2.9 修掉的 L1 缺陷 （此前不给草稿也报"全部已完成"）。 用 --prev-ledger 上版.json 可激活 A3 状态回退检测。

B1 五态（每个评分项在台账里的位置）

B1 四条必报警（不报警即算实现错误）

B2 覆盖三档（非布尔——中间那档才是有用的信息）

B2 关键用法：--response 必须给投标文件草稿。不给时全部降为 C 并提示"未提供草稿，无法判定（不猜）"——因为拿招标文件自己的措辞去比对毫无意义，硬要素天然"齐全"，会刷出假的 A。

三条铁律同 v2.8：不猜不编（分值为空留空，不填 0）、指不到页码标"待人工核实"、检测器不是裁判（A/B/C 是规则判断，人工结论仍归人）。 openpyxl 非必需依赖：缺失时自动降级 CSV 并打印原因，CSV 是保底输出。

标准流程

1. 采集 + 比对 + 报告

bash pipeline.sh                  # 全流程（缓存优先）
bash pipeline.sh --fresh         # 强制重采当天
bash pipeline.sh --calendar      # 生成后额外打印投标日历
# A4 多维筛选（后过滤）
bash pipeline.sh --budget-min 500000 --budget-max 20000000 --region 天津 --industry 智能设备

报告：bid_reports/report_YYYY-MM-DD.txt（文字，适配 IM）、report_YYYY-MM-DD.html（浏览器）。

2. 多通道推送（v1.2）

首次 python3 config_wizard.py 配置；pipeline.sh 生成报告后自动推送。push_manager.py 支持 test/history/stats/health-check/retry-failed。关闭用 pipeline.sh --no-push。

3. v1.5 新能力

• 匹配度评分（A1）：可投标按 0-100 分排序，等级 强烈推荐/建议跟/可投一般。报告直接显示分数。
• 投标日历（A2）：python3 calendar.py <qual文件> --days 30 看开标/截止日；--remind 对临近截止（默认48h）自动推送提醒。
• 多维筛选（A4）：规则库设 region_priority.high / industry_categories+industry_priority / budget_priority，运行时用 --region/--industry/--budget-min/--budget-max 过滤。
• 规则编辑器（可视化）：python3 bidhunter.py rules edit → http://localhost:8080，选行业模板、填能力词、实时试标、保存。
• 诊断中心（A6）：python3 doctor.py 输出带错误码（E001E005 / W001W004）的诊断与下一步。
• 示例模式（A7）：python3 demo.py [--summary] [--calendar] 用内置示例看完整效果。
• 集中 FAQ（A8）：python3 faq.py <关键词> 检索常见问题。
• 平台扩展（A5）：内置 3 适配器（cnooc/cebpubservice/ccgp）+ 自定义数据源 sources.json（json/rss/html 三种模式，零代码接入任意公开平台）。

4. v2.0 本地 AI 增强（零云成本）

python3 bidhunter.py ai read 招标文件.pdf     # 解析+结构化抽取+风险扫描
python3 bidhunter.py ai read 招标文件.pdf --llm   # 加 LLM 风险扫描
python3 ai/analytics.py --days 30              # 本地业主/品类画像

调用你自己的 MiniMax API（仅耗余额），不外传数据到任何 BidHunter 云端（我们无云端）。

5. v2.5 投标策略建议

python3 bidhunter.py ai advise 招标文件.pdf    # 资质自检+评分得分点+报价策略+时间节点

合规边界：只建议不代劳——不自动填报价、不伪造资质、不写技术方案。所有建议标注"仅供参考，人工确认"。

6. v3.0 本地开放能力（零云成本子集）

python3 api_server.py --port 8765             # 本地查询 API（127.0.0.1，无云端）
python3 webhook_publish.py qual_xxx.jsonl     # 把标讯签名推送到你自己的系统

v3.0 原规划的云/SaaS 部分（多租户、第三方插件市场、数据市场、Salesforce/金蝶连接器）因涉及付费云基础设施，按成本约束未启用。本机 API + 签名 webhook 是其零成本替代。

7. v3.5 合规红线引擎（零 API 成本）★

找到标只是第一步，交了标不被废才是最后一公里。v3.5 把《招标投标法》《实施条例》《评标委员会和评标方法暂行规定》（12号令）蒸馏成机器可读的 31 条法定红线，本地扫描，不调用任何 LLM，零 API 成本。

# 扫招标文件：找出文件里埋了哪些"雷"（实质性要求、违规条款、致命形式要件）
python3 bidhunter.py compliance scan 招标文件.pdf --mode tender

# 扫投标文件：交标前最后一检，找自己文件里的致命项
python3 bidhunter.py compliance scan 投标文件.pdf --mode bid

# 交标前自查清单（31 条，逐条打勾）
python3 bidhunter.py compliance checklist

# 输出 JSON（供其他系统消费）/ 追加 LLM 深度扫描（耗 MiniMax 余额）
python3 bidhunter.py compliance scan 招标文件.pdf --json
python3 bidhunter.py compliance scan 招标文件.pdf --llm

红线分类（31 条）

三条最值钱的认知（其余详见 compliance/redlines.json）：

1. 多主体投同一标段，先查《实施条例》第34条（C02）：单位负责人为同一人、或存在控股/管理关系的不同单位不得参加同一标段投标，违反则相关投标均无效。这是资格硬禁止，无需任何串通证据，且优先于一切串标推定。
2. 细微偏差不影响投标有效性（D02，12号令第26条）：个别漏项只会被要求补正，招标文件没规定量化标准的不得扣分。与"重大偏差=否决"严格区分——这条能救命。
3. 标底不能作为否决依据（D01，实施条例第50条）：招标文件若写"报价超出标底±X%作废标处理"，该条款本身违法，可据此质疑投诉。扫描器会自动识别此类违规条款并标为"盾牌"。

合规边界（与 v2.5 一致）：

• ✅ 做：法条索引、风险提示、自查清单、违规条款识别
• ❌ 不做：法律意见、胜诉承诺、代填报价、伪造资质
• ⚠️ 扫描结果不构成法律意见，最终判定以招标文件、评标委员会认定及有权机关解释为准。法规未给出量化标准的（如"低于成本"），本引擎不设阈值

深度审查联动：本地扫描是"浅层快速筛"，需要逐条法理分析和举证策略时，联动蒸馏姊妹 skill（需另行安装）：bid-rejection-guard（25条红线深度审查）、bid-price-redline（低于成本举证自救）、multi-entity-bid-isolation（多主体串标隔离 10 条清单）。

报价闸门（v2.7）—— 出价前必须过的四道算式卡

找到标、保住标之后，最贵的教训在报价上：沿用旧价没换算规模、单价算错量级、毛利倒挂——错的数字会被下游当成可信基数一路沿用。

# 第一次填一次参数库（最低工资 / 毛利红线 / 容差），只写本机，不上传
python3 bidhunter.py quote params
python3 bidhunter.py quote params --show      # 查看 + 过期提醒（默认 90 天）

# 跑闸门：给什么算什么，缺什么列什么
python3 bidhunter.py quote check --labor --heads 7 --months 12 --cost 200000 --quote 260000
python3 bidhunter.py quote check --prior-amount 600000 --prior-scale 300 --new-scale 60 --quote 120000
python3 bidhunter.py quote check --help
python3 bidhunter.py quote --selftest

四道算式卡（任一道不过 → 禁止输出结论金额）：

外加 5 项算式扫不出来、必须人工确认的核对卡：条款逐字读完、市场价带反推、服务模式逐项加减、敏感性分析覆盖全部变量、成本口径与服务口径配套。

闸门铁律：

• 结论只有三种：已过闸门 / 禁止出价 / 参数待补
• 只有「已过闸门」才回显金额；另外两种只给"卡在哪 + 缺什么参数"
• 缺参数时只允许交成本模型框架与参数待补清单，不得交带金额的报价函
• 参数库在 ~/.config/bidhunter/quote_params.json（权限 600）；最低工资随年度调整，超期会自动提醒

边界：闸门只做算式校验与清单提示，不产生报价意见、不替代人工判断，也不联网取数。

系统组件（位于 scripts/）

已知坑点

• IM 发文件失败：个人 IM 不支持发文件，只能文字。可视化网页供电脑浏览器看。
• list API 无截止日：部分平台返回仅 id/title，截止日需 detail 接口（常 401），故只采集当天近似；日历日期从标题解析，未含明确日期的标归入"待核实截止日"。
• IP 限流：连发约 20 次后可能 401/403，翻页 sleep 2s + 失败重试冷却 10s。
• 匹配边界：边界感知规则会挡掉词中误匹配（如"电气设备"里的"电气"因前有 CJK 被挡属正常防误匹配）。能力词尽量让其出现在词首边界可稳定命中。
• AI 依赖：v2.0/v2.5 需配置 MiniMax API Key；未配置时 AI 功能自动跳过。v2.8 起不配置也能出完整简报（规则引擎兜底），只损失策略建议的文字部分。
• 标书解析：最佳效果需 pip install PyPDF2 python-docx（可选）；未装时 PDF 走正则降级、DOCX 可能解析不全。
• 纯扫描件无文字层：v2.8 起会明确报错并提示需 OCR，不再静默降级为"读了但其实没读"。
• 覆盖率标注：v2.8 起所有读标输出都带 coverage_pct。若显示覆盖率明显低于 100%（例如文件解析后只剩零散片段），结论不可信，须换解析后端或先 OCR。

反馈（零成本，30 秒）

反馈模块不上传任何数据：全程只在本机生成文本、写剪贴板、唤起你的浏览器，无任何后端与网络请求。

参考文档

• references/platforms.md：支持平台清单、自定义数据源指南
• references/filter_rules.md：筛选规则结构
• references/field_standard.md：标讯字段标准
• docs/FAQ.md：常见问题（faq.py 检索）
• samples/：示例规则与模板（demo / 行业模板）