用户手册
这个仓库已经从“方法论和报告沉淀”升级成“智慧食堂招投标情报工作台”。它能管理数据、运行分析管线、生成业务交付物、组织专属 Agent，并把市场线索转成产品、销售、投标和经营动作。
这个项目现在有三层：根目录是团队协作和交付仓库，招投标分析/ 是迁移进来的本地分析应用，.codex/agents/ 是本项目专属的招投标智能体工作台。三者合在一起，可以把招投标公告、授权导出、历史项目、竞品公司、产品能力和经营目标串成一条闭环。
保存 README、方法论、数据字典、Prompt、HTML 报告、Excel 交付物、Workflow 和项目运行记录。
包含数据、配置、Python 管线、图表、CEO 决策包、销售机会清单和客户需求挖掘 MVP。
部署 24 个项目级 Codex Agent，覆盖来源发现、文档抽取、实体归一、合规矩阵、Price-to-win、Go/No-Go 和 CRM 报告。
招投标分析/outputs/unified_smart_canteen_tender.csv，67 个字段。
sales_opportunity_list.csv，用于筛 P0/P1 跟进。
.codex/agents/，Codex 打开本项目时可用。
招投标分析/outputs/tables/ 覆盖区域、场景、产品、竞品、价格和证据。
| 位置 | 里面有什么 | 什么时候用 |
|---|---|---|
docs/reports/ |
面向业务用户的 HTML/Markdown 报告，包括 H1 业务报告、产品 GTM 分析和本手册。 | 对管理层、业务同事或外部阅读者说明结论时使用。 |
docs/deliverables/ |
正式 Excel、HTML 看板、实体浏览器、跨年趋势分析、项目单表和关系模型。 | 需要筛选、复核、二次加工、归档或给团队发文件时使用。 |
scripts/ |
根项目脚本，负责乙方宝样例分析、业务交付物、实体地图、跨年趋势、详情 Excel 和 Word 材料包。 | 围绕根项目交付物重建或补充资料时使用。 |
招投标分析/scripts/ |
迁移包主分析管线，从 00 盘点到 15 产品策略证据审计。 | 要重跑智慧食堂招投标分析系统时使用。 |
招投标分析/config/ |
金额分桶、竞品别名、产品关键词、场景关键词、证据规则。 | 发现分类不准、竞品漏归并、金额异常或证据口径需要改时使用。 |
招投标分析/data/canteen-growth/tender-intelligence/ |
周度招投标情报工作区，含模板、来源配置、自动化提示词、维度模型和每日采集脚本。 | 做周报、大表、项目单表、源头回溯和授权导入时使用。 |
招投标分析/customer-demand-mining/ |
客户需求挖掘 MVP，从项目表、聊天片段、会议纪要和售后问题中抽取需求池。 | 要把销售与交付原话转成产品 backlog、周报和路线图建议时使用。 |
docs/runs/ |
每次有意义的 Codex 协作记录，按主题保存为 HTML 或 Markdown。 | 后续恢复上下文、沉淀 Skill、查“这次为什么这么做”时使用。 |
识别文件、字段、行列规模、重复值、缺失字段、金额异常、日期解析、证据等级和需要人工回源的记录。
把公告、中标通知、采购意向、合同公告和候选人公示整理为一张统一主表，保留项目、客户、阶段、金额、区域、产品、竞品和来源。
输出阶段分布、时间趋势、省市排行、客户类型、场景热度、区域优先级和近期机会。
按结算、营养健康、食安监管、进销存、明厨亮灶、监管平台、硬件设备、运维维保等模块打标签。
用竞品别名表把中标方、供应商、集成商和硬件厂商归并，形成 competitor summary、battlecard 和区域/场景交叉表。
按金额分桶、区域、场景和产品模块分析预算，识别 1000 万以上、异常低价、异常大额和 Price-to-win 线索。
筛出 strong + medium 相关项目，生成 P0/P1 线索、下一步动作、源站核验要求和近期跟进池。
把 2000 万经营目标、区域战场、P0-P3 产品包、T0-T5 项目分层、确收节奏和 90 天行动计划组织成管理层视图。
支持按项目拆出客户需求、产品 BOM、软件参数、评分合规、企业竞争、我方策略和证据治理表。
将已授权的项目表、聊天、会议纪要、售后问题转成需求信号、需求池、产品建议和研发 backlog。
bash scripts/sync_workflow.sh pull，避免基于旧文件判断。scripts/，迁移包完整管线用 招投标分析/scripts/。docs/runs/YYYYMMDD-short-topic.html，保留目标、结论、文件、命令和可复用模式。bash scripts/sync_workflow.sh upload "sync: ..."，需要阅读的 HTML 再发布到开发环境。# 根项目：拉取云端最新版本
bash scripts/sync_workflow.sh pull
# 根项目：查看原始 Excel/CSV 概览
python3 scripts/profile_bid_data.py data/raw/your-file.csv
# 根项目：跑乙方宝样例分析
python3 scripts/analyze_bid_data.py data/raw/your-file.xls
# 根项目：生成业务 HTML 和 Excel 交付物
python3 scripts/generate_business_deliverables.py
# 迁移包：运行完整智慧食堂招投标分析管线
cd 招投标分析
python3 scripts/run_all.py
# 迁移包：单步生成销售机会清单
python3 scripts/09_generate_sales_opportunities.py
# 迁移包：生成静态图表和 dashboard.html
python3 scripts/11_generate_charts.py
# 客户需求挖掘 MVP
python3 customer-demand-mining/src/run_pipeline.py --root customer-demand-miningdata/raw/、data/processed/ 和 招投标分析/ 里的大数据、虚拟环境、历史输出默认不提交。客户联系人、电话、授权平台导出和商业线索不要直接复制进公开文档。项目根目录已经部署 24 个 Codex 项目级 Agent。它们适合把复杂招投标任务拆给不同专业角色，尤其是周度招投标情报和单项目投标拆解。
负责把来源发现、文档抽取、实体归一、需求、BOM、评分、企业、价格、Go/No-Go 和报告串成周度工作流。
发现智慧食堂相关公告、处理网页/PDF/Word/Excel/截图，并抽取项目、采购方、金额、阶段、公司和来源。
结构化客户需求、产品 BOM、软件要求、评分规则、合规矩阵、证明材料和投标风险。
做企业画像、竞品和伙伴判断、价格-to-win、毛利风险、项目 fit、胜率、资格和交付风险评分。
把结构化结果变成周报、销售动作、机会卡片、CRM 可导入记录和 Agent 更新待办。
还包含数据工程、政府数字化售前、文档生成、分析报告、招投标方案书等横向能力。
你现在在智慧食堂招投标分析 Project。请先读取 README.md、AGENT_APP_USAGE.md、招投标分析/README.md 和 招投标分析/data/canteen-growth/tender-intelligence/README.md，然后围绕我给出的任务调用本项目可用 Agent，优先复用已有脚本、配置、模板和输出。| 想解决的问题 | 优先打开 | 你会得到什么 |
|---|---|---|
| 先整体了解项目 | README.html、index.html、本手册 | 项目范围、目录、同步方式、入口链接和当前能力。 |
| 看 2026 上半年业务结论 | 2026 H1 乙方宝业务报告 | 市场扫描、客户画像、供应商格局、商机优先级和风险摘要。 |
| 看跨年趋势 | 2023-2026 同比环比分析 | 2023-2026 的 H1 同比、月度环比、地区结构和高金额项目变化。 |
| 像数据库一样查项目和实体 | 招投标实体全量数据浏览 | 可搜索、可点击、可互跳的项目、公司、产品、资质和来源链接。 |
| 看地图和区域分布 | 招投标实体地图看板 | 全国区域、金额和项目数量下钻。 |
| 做近期销售跟进 | 招投标分析/outputs/sales_opportunity_list.xlsx |
247 条销售机会记录，支持 P0/P1 分层和回源核验。 |
| 给 CEO 或经营会看 | 招投标分析/outputs/CEO一页纸决策摘要.md、2026团餐2000万经营作战看板.xlsx |
2000 万目标差距、北京/江苏安徽战场、产品包、确收节奏和 90 天动作。 |
| 拆单个投标项目 | docs/deliverables/20260615-three-project-tender-details/、20260615-full-candidate-tender-details/ |
项目概览、软件参数、硬件清单、资质、评分标准、建设范围和投标公司分析。 |
回答哪些区域、客户类型、场景和产品模块正在释放采购信号。
识别 P0 机会，要求 48 小时回源核验，补预算、联系人、评分办法和下一步动作。
区分直接竞争、合作伙伴、渠道、硬件生态和系统集成商，形成销售与投标话术。
围绕 P0-P3 建立基础结算包、营养增强包、食安进销存扩展包和监管平台包。
形成 L0-L7 维度模型，分开管理项目概览、客户需求、采购标的、评分合规、竞争生态、我方策略和证据治理。
围绕 2000 万目标，拆北京、江苏/安徽、渠道/伙伴/存量增购战场，连接产品、销售和交付确收。