城市更新政策性资金平台 · 工程化构建技能
用途
把「城市更新政策性资金 / 各类政策资金通道」领域知识,稳定产出一份单文件、可离线打开、国企风、可交互的 HTML 平台。覆盖:资金详解、资金对比(雷达图 + 覆盖矩阵)、项目资金评估器、社会资本模式、典型案例、专家观点、申报困境、自查清单、政策文件库、区域视角。
风格、布局、图表实现方式全部固化,任何修改都跑一遍 scripts/validate.py 即可确认「格式没坏」。
何时使用
- 用户要求做「城市更新政策资金平台 / 资金查询评估工具 / 资金对比看板 / 资金通道梳理」。
- 用户转发了某篇讲政策性资金的公众号文章(如「树茧」的城市更新资金平台)并要求「基于这个重做一个能用的」。
- 用户要求产出形态为「一份 HTML / 可分享链接 / 单文件」,且强调「国企风、简洁、稳重」。
- 类比可迁移:把 domain 换成「专项债项目 / 中央预算内投资 / 城中村改造资金 / 新基建政策性金融工具」等任一政策资金主题,复用同一套骨架与护栏。
工作流(严格按序)
0. 立项与素材
- 确认主题与范围(几类资金、要不要评估器、要不要案例库)。
- 抓取权威来源:原平台/公众号文章、gov.cn 政策原文、行业报道(中国房地产报、经济日报、北大/社科院专家观点等)。
- 关键坑:很多开源 Demo 用 ECharts 且把库放在
_shared/之类下划线目录 → GitHub Pages 的 Jekyll 会忽略下划线目录 → 库 404 → 图表全空白。本技能一律纯 SVG / 原生表格,彻底不依赖外部 CDN。
1. 搭骨架(复制模板)
cp assets/skeleton.html my-platform.html
骨架已含:.wrap 两栏 Grid(240px 1fr)、左侧 sidebar 导航、移动端抽屉(tb-toggle + overlay)、15 个内容容器锚点(fundList / radarBig / radarMulti / radarLegend / mtxTable / steps / qbox / result / probA / probB / ckList / libList / modelGrid / caseList / expertList)。
2. 填数据(数据层)
在 <script> 顶部维护数据数组(结构见 references/data-model.md):
- FUNDS[]:每类资金的名称、配色、主管部门、关键数据、提示。
- RADAR[]:雷达图六维分值(无需偿还/申报竞争/资金额度/政策稳定/适用广泛/落地速度,0–3 分)。
- MATCH{}:评估器评分矩阵(资金 × 5 维 × 0–3 分,满分 15)。
- QUESTIONS[]:评估器 5 步向导的题目与选项。
- 各内容板块数组(MODELS / CASES / EXPERTS / PROBLEMS / CHECKLIST / LIB)。
3. 套样式(唯一样式真源)
# 把 assets/style.css 的内容整体拷进 my-platform.html 的 <style> 中
- 禁止在正文写裸 hex 或破坏令牌;配色只走
:root(--gov #a4232b/--navy #1a3a6b/ 中性灰)。 - JS 注入的颜色统一从数据数组取(
f.c),不要内联新色值。
4. 渲染(复制渲染函数)
从本技能 references/svg-charts.md 复制已验证的渲染函数:renderFunds、drawRadarBig/Multi/Legend、renderMatrix、renderAssessor(评估器 5 步向导 + 结果排序)、renderModels/Cases/Experts/Probs/Checklist/Lib、bindSidebar(滚动高亮 + 点击滚动)。
5. 校验(铁律,必跑)
python3 scripts/validate.py my-platform.html
- 全 PASS → 格式契约未被破坏,可发布。
- 任一 FAIL → 引入了花哨样式或布局错位,先回退再发。
- 校验项:无
linear-gradient/radial-gradient/box-shadow、两栏grid 240px 1fr、overlay全局display:none、含--gov/--navy令牌、script 标签配对、JS 语法node --check通过。
6. 部署与交付
cp my-platform.html /tmp/deploy/index.html
# 用 workbuddy_cloudstudio_deploy 部署为可分享链接
- 本地双击即开(离线可用,因无外部依赖)。
资源索引
assets/skeleton.html— 两栏布局骨架(导航 + 15 容器 + 移动端抽屉 + 渲染函数占位)。assets/style.css— 唯一样式真源(国企风,含令牌、组件类、多端适配 960px 断点)。references/design-contract.md— 格式设计契约(不可违背的 6 条 + 踩坑清单)。references/data-model.md— 数据层契约(FUNDS / RADAR / MATCH / QUESTIONS 字段与口径)。references/svg-charts.md— 雷达图(组合大图+小倍数+图例+预设)与覆盖矩阵(原生热力表)的已验证 SVG/HTML 实现范式。scripts/validate.py— 格式稳定性校验脚本(路径参数,默认校验当前平台文件)。
禁忌
- 禁止引入
echarts / d3 / 任何 CDN <script src>;图表一律纯 SVG 或原生表格。 - 禁止
linear-gradient / radial-gradient / box-shadow;禁止圆角 >3px、禁止高饱和荧光/彩虹/橙紫粉色。 - 禁止把
overlay留在 grid 流中可见(会抢占第一格导致 sidebar/main 错位到左侧)——必须display:none+position:fixed。 - 禁止在 JS 字符串里混用半角双引号
"(中文文案),否则语法错误;统一用反引号模板字符串或转义。 - 禁止绕过
validate.py直接发布。