Project Documentation

招投标中标数据分析协作仓库

由项目内 Markdown 源文件转换生成的 HTML 版本，用于浏览器阅读和团队共享。

招投标中标数据分析协作仓库

这个仓库用于沉淀招投标/中标通知数据分析的方法论、Prompt、字段标准和可复用脚本，方便团队协作。

首次拉取注意：这是 Codeup 私有仓库。对方第一次使用前必须有 Codeup 仓库权限，并通过 Codex 引导生成 HTTPS 克隆密码/Token 或配置 SSH 公钥。只安装 Git 不等于能拉取私有仓库。

当前范围

目录

docs/
  codeup-auth.md      Codeup 私有仓库首次认证处理
  methodology.md      分析方法论
  data-dictionary.md  字段口径和清洗规则
  sources.md          方法来源和参考项目
  final-results/      每次分析一个独立最终结果文件夹，只放最终 HTML/Excel
  reports/            给业务用户看的 HTML/Markdown 报告
  deliverables/       Excel 等正式交付文件
prompts/
  bid-analysis-master-prompt.md  主分析 Prompt
scripts/
  profile_bid_data.py            本地数据概览脚本
  analyze_bid_data.py            正式分析脚本
  generate_business_deliverables.py  HTML + Excel 交付物生成脚本
  tyc_company_cli.py             天眼查官方 tyc CLI 的项目级批量包装器
workflows/
  cloud-sync-workflow.md         云端拉取/上传标准流程
  codex-auto-workflow.md         Codex 自动拉取、同步与问答沉淀流程
  tianyancha-cli-workflow.md     天眼查 CLI 企业补全流程
data/
  raw/                原始文件本地放置目录，不提交
  processed/          处理后文件本地放置目录，不提交

快速使用

发给小白的第一步说明

如果你要把项目发给别人使用，直接把这份说明发给对方：

打开 Codex，新建一个空对话，把下面整段话复制给 Codex。你不需要自己安装或操作 Git。

请全程替我完成项目初始化。不要要求我手动输入 Git 命令。

项目云端地址：
https://codeup.aliyun.com/60069db88deaa14d9e02b875/zhct/bid-analysis-methodology.git

请按下面步骤执行：

1. 先做 Codeup 认证预检：这是私有仓库，不能匿名拉取。
2. 如果当前环境没有 Codeup HTTPS 凭据或 SSH 授权，请通过问答形式引导我完成一次性授权。
3. 请先给我这个链接，让我打开并登录自己的 Codeup 账号，设置或查看 HTTPS 克隆账号和 HTTPS 克隆密码/Token：
   https://help.aliyun.com/zh/yunxiao/user-guide/configure-https-clone-account-password
4. 等我把 HTTPS 克隆账号和 HTTPS 克隆密码/Token 贴回来后，请把它保存到我这台电脑的 Git 凭据助手里。
5. 如果没有系统凭据助手，请先说明会使用当前用户级 credential store 保存到本机，再继续。
6. 不要把令牌写进仓库文件、README、日志或问答沉淀文档。
7. 如果出现 terminal prompts disabled，说明 Git 不能弹出用户名/令牌输入框，请走上面的凭据保存流程。
8. 再判断当前 Codex 环境能否管理 Git 仓库：如果有内置 Git / Clone / Add repository 能力，优先使用内置能力。
9. 如果需要命令行，请由你自己检查和执行，不要让我手动执行。
10. 如果 Git 不存在，请先尝试帮我安装或启用 Git；如果不能安装，请明确告诉我需要先安装 Git。
11. 项目目录默认放在 macOS/Linux 的 ~/code/zhct/bid-analysis-methodology，Windows 的 %USERPROFILE%\code\zhct\bid-analysis-methodology。
12. 如果项目目录已存在，请更新云端最新版本；如果不存在，请把云端项目拉到这个目录。
13. 进入项目后读取并遵守 AGENTS.md。

以后我不会手动操作 Git。每次回答前请先自动拉取云端最新版本；完成任务后，请把本次问答沉淀到 docs/runs/ 的主题文档里，然后自动提交并推送到云端。

如果拉取或更新失败，请直接告诉我失败原因：Codex 当前环境不能访问本地文件系统、没有 Git 且无法安装、没 Codeup 权限、缺少 Codeup HTTPS 克隆账号和 HTTPS 克隆密码/Token、Git credential helper 不可用、网络不通或仓库地址错误。

完成后请先回复：项目已拉取到本地，当前路径是 <实际路径>。

完整小白说明见 docs/codex-first-use.md。Codex 自动沉淀规则见 workflows/codex-auto-workflow.md。

小白标准流程

每次使用都先拉取云端最新版本：

bash scripts/sync_workflow.sh pull

做完一次任务后，把本次可提交的修改上传到云端：

bash scripts/sync_workflow.sh upload "sync: update bid analysis"

如果一个命令就能完成任务，直接用自动 workflow：

bash scripts/sync_workflow.sh run "sync: profile bid data" -- python3 scripts/profile_bid_data.py data/raw/your-file.csv

详细说明见 workflows/cloud-sync-workflow.md。AI 助手协作规则见 AGENTS.md。

数据分析流程

  1. 把 Excel/CSV 原始文件放入 data/raw/。
  2. 运行数据概览：
python3 scripts/profile_bid_data.py data/raw/your-file.csv

如果输入是 .xls，脚本会尝试调用本机 soffice 转成临时 CSV 后分析。

  1. 运行正式分析：
python3 scripts/analyze_bid_data.py data/raw/your-file.xls
  1. 生成给业务用户看的 HTML 和 Excel：
python3 scripts/generate_business_deliverables.py
  1. 打开 docs/final-results/<本次分析主题>/，只看这个文件夹里的最终 HTML/Excel。每个最终 HTML 报告都应配套同目录 Excel 工作簿，表格、 清单、排序和行动项要能在 Excel 里筛选、复制和继续加工。过程记录、 中间表、脚本和原始数据不要放进最终结果文件夹。

天眼查 CLI 企业补全

本项目已接入官方 tyc-cli，用于把天眼查 MCP 企业信息查询纳入招投标线索补全流程。先检查本机环境和鉴权状态：

python3 scripts/tyc_company_cli.py doctor

首次使用需用用户自己的天眼查授权完成登录或 token 初始化；token 只写入本机 ~/.tyc/config.json，不要写进仓库：

python3 scripts/tyc_company_cli.py auth --login

批量查询前先 dry-run：

python3 scripts/tyc_company_cli.py batch examples/tyc-company-list.example.txt --task search --limit 5 --dry-run

完整流程见 workflows/tianyancha-cli-workflow.md 和 workflows/tianyancha-cli-workflow.html。

当前样例已生成：

数据安全

原始招投标数据可能包含联系人、电话、客户线索和商业机会，默认不提交到 Git。团队需要共享原始数据时，应走企业内部文件盘或云效制品/附件，并明确访问权限。

协作任务