README

公开工程文档站

当前源码在 site-react/，构建产物发布到 site/ 与兼容入口 site/next/。 本站是项目介绍、来源目录、设计和留存运行/案例证据入口；实际账户、问答、调查和研报产品位于代码仓库 apps/web，部署路径 /product/。

维护来源

内容	当前 owner
页面、导航和样式	site-react/src/pages/、src/main.jsx、src/styles.css
双语介绍和模块信息	site-react/src/data.js
来源目录	site/data/source-catalog.zh.js 与 .en.js，构建时生成 sourceCatalog.generated.json
案例素材	构建前由 scripts/sync-cases.cjs 同步；保持原始来源角色与事实范围
工程状态	代码仓库 scripts/build_site_status.py 生成 site/project-status.json
留存运行统计	site/data/data-plane-runtime.js；明确展示测量时间，不冒充实时 API
历史静态专题/图解	site/diagrams/ 等原路径继续服务；与 React 生成资源分开维护

代码仓库来源配置计数与运行快照的健康/吞吐属于不同时间坐标。 首页配置数从本次发布的 project-status.json 获取；数据未取得时展示不可用， 不填旧的 101/66/39。健康和前一小时统计标明留存快照时间。 历史 benchmark 和案例不重标为当前代码的新测试结果。

构建与发布

从 Wiki 仓库运行：

cd site-react
npm ci
npm run build:promote

构建依次同步案例/目录、校验双语文案、执行 Vite，再由 promote-site.cjs 替换生成 HTML 和带 hash 的资源。不要手改 bundle；promote 保留非生成的专题资源。 site/next/ 与主入口使用同一构建，不维护第二套产品状态。

从代码仓库检查：

make site-check WIKI_PATH=../SecFusionAgent.wiki
make site-status WIKI_PATH=../SecFusionAgent.wiki SITE_STATUS_OUTPUT=../SecFusionAgent.wiki/site/project-status.json

GitHub Pages 工作流从代码仓库 main 检出代码，拉取 Wiki，校验站点并生成工程状态， 然后发布 Pages。代码 main push、每日 schedule 或手工 workflow dispatch 会触发； 单独 Wiki push 不直接触发该工作流。页面发布证明文档站 CD，不证明产品应用已部署。

呈现与检查

中英文入口成对维护；链接、来源身份、案例中的 confirmed/related/context/mechanism/unknown 边界不得因营销表达而合并。未知数不补零，静态示意不冒充 live execution。 更新内容后检查页面加载、双语链接、来源目录同步和移动端可读性。

当前产品美术规则在 Product-Web-Visual-System， 产品前端组件在代码仓库 apps/web；不要把旧工程文档站的六入口、线束装饰或 材料工作室设想重新作为 Product 的实现指令。

当前需求与待办统一见 验收台账。此前本文件的长篇设计推导 保留在 Git 历史，不继续作为当前 React 源码与发布流程的操作说明。