政府采购数据聚合工作台搭建
Overview
把分散在多个政府/公共资源交易网站（浙江政采网、县级政府网、乐采云等）的
采购公告数据，抓取、清洗后，烘焙进一个单文件、零外部依赖的 HTML 查询
工作台，并双线部署（自有域名 CVM + workbuddy.host 镜像）保证可访问与
可分享。本 skill 沉淀自「新昌采购交易查询工作台」从 0 到 1 的全过程，包含
多个逆向验证过的接口细节与排障铁律。
触发场景（用户可能这样开口）：
- "把浙江政采网的采购意向做成可查询的页面"
- "搭个政府采购公告工作台，能按地区/类型筛选"
- "抓取交易公告/中标结果并部署成网站"
- 任何涉及政采云（zfcg.czt.zj.gov.cn）、县级政府网（xjxc.gov.cn 类）、
乐采云（lecaiyun）数据聚合与展示的需求
> 仅涉及「浙江政采网接口速查」时，优先用 zfcg-zhejiang-api skill；
> 本 skill 侧重「多源聚合 → 单文件工作台 → 双线部署」的完整链路，
> 其数据层细节见 references/apis.md。
架构总览
[数据源] [清洗] [构建] [部署]
浙江政采网 ─┐
县级政府网 ├─► JSON 文件 ─► clean_*() ─► build_workbench ─► 单文件 HTML ─┬─► 自有域名 CVM (SFTP 原子替换)
乐采云 ─┘ (多源) (去脏) (零依赖) │ └─► workbuddy.host (domainPrefix 镜像)
└─► 定时任务自动刷新（重抓+重建+重部署）
关键设计决策：
- 数据"烤"进 HTML：静态页无后端，数据内联为 JS 数组，绝对零外部依赖
（不引 CDN、不引框架），保证断网/老旧浏览器也能打开。
- 双线部署：自有域名给用户日常访问（可绑备案域名+HTTPS+手机桌面），
workbuddy.host 作镜像兜底（免服务器运维）。两线内容必须一致。
- 构建时间注入：页面顶部显示「数据更新：<生成时间>（库内最新 <日期>）」，
用户一眼判断新鲜度。
Workflow
Step 1 — 数据采集（多源 → JSON）
按 references/apis.md 对接各数据源，每个源产出一份 JSON：
- 浙江政采网：POST /portal/category（无需签名，curl 直连），详情
GET /portal/detail?articleId=。见 zfcg-zhejiang-api skill。
- 县级政府网：多为服务端渲染或需 puppeteer 渲染，用 puppeteer-core 抓
列表+详情，从 meta/正文关键词提金额（详见 apis.md）。
- 乐采云：POST /announcement/lobby/queryPage，注意阿里云 WAF 间歇挑战
（返回 HTML 挑战页），需识别→刷新令牌→冷却降速（详见 apis.md）。
统一输出字段（供 Step 3 复用）：{s, title, date, district, w, ext, budget, ...}
- s 数据源 key（如 zjxc / lcytx）；w 中标单位（仅中标类保留）；
ext 外链；budget 预算/金额。
Step 2 — 数据清洗（去脏）
- 中标单位
w只在「中标/成交/结果/合同」类公告保留，其余类型一律置空。 clean_winner(w)过滤：纯数字、含"年/月/日"的日期串、噪声长句
（如"投标单位须在开标前缴纳X万元保证金"）。- 展示层再防御：
winnerList()按、,，;；/切分后过滤 length<3、
纯数字、含日期的项（详见 gotchas.md 例 3/4）。
Step 3 — 构建单文件工作台
用 scripts/scaffold_workbench.py 作为起点（已内含全部关键修复），或参考
其模式手写。务必落实 references/gotchas.md 的 4 条铁律：
1. 外链按钮用 data-ext + esc()，绝不内联 JSON.stringify
2. 弹层遮罩用显式 top/right/bottom/left，不用 inset
3. 中标单位清洗（Step 2）
4. 注入 __BUILD_TIME__ 与库内最新日期
Step 4 — 双线部署
按 references/deploy.md：自有域名 CVM 用 SFTP 原子替换
（写临时文件→rename），workbuddy.host 用 workbuddy_sites_deploy
+ 固定 domainPrefix（同目录同 prefix = 链接不变）。两线内容必须同步。
Step 5 — 自动刷新
定时任务（如每周一/三/五）串跑：重抓数据 → 重建 HTML → 重部署两线。
页面顶部新鲜度标识让"数据没更新"一眼可见。
资源
references/apis.md— 三个数据源的逆向接口细节（政采网/县级政府网/乐采云 WAF）references/deploy.md— 双线部署实操（CVM SFTP + workbuddy.host）references/gotchas.md— 4 个已验证排障铁律（含代码片段）scripts/scaffold_workbench.py— 通用单文件工作台生成器（含全部关键修复）
真实参考实现
完整可运行的 新昌 项目脚本在
C:\Users\Administrator\WorkBuddy\2026-08-31-11-30-27\xinchang_push\
（push.py / fetch_all.py / build_workbench.py / build_lecaiyun.py /
server_deploy/deploy_to_server.py），可作为二次开发的范本。
