bot-forge · 纵向讲演网站
一、设计原则
1. 用同一次安装贯穿全场
用户只表达环境目标；平台、来源、依赖、资源与恢复随着同一次安装逐步展开。
不从简单体验突然跳到架构总览，也不把后台讲成彼此无关的功能清单。
2. 前台简单与后台复杂始终同屏
每张机制页都说明“用户仍然在做什么”和“系统此刻正在处理什么”。
亮蓝表示用户看到的简单路径，深蓝表示系统承担的工作，橙色表示中断或限制，完成结果使用绿色语义。
3. 初学者与团队管理者共享同一事实
初学者直接运行 bot-forge，选择环境级别后理解缺口、计划、进度和下一步；团队管理者通过固定配置与机器数据复用同一标准。
阅读方式可以不同，工具选择、执行计划和最终状态不能漂移。
4. 性能不能改变安装正确性
CPU、内存、网络、磁盘等容量资源与安装目标互斥共同决定任务能否启动。
动态再平衡只调整后续任务的资源配额，不重启运行中的构建，也不改变命令、依赖或提交规则。
5. 复杂度必须翻译为用户价值
平台、来源、资源和状态机制不为展示术语而存在，分别对应少选择、少等待、真正完成和失败可继续。
技术细节用具体例子与 18 核调度过程表达，不要求听众先理解内部模块名。
6. 一页是一张投影画布
网站面向桌面端和现场投影，最小宽度为 1180px；每页以 1080px 为基准高度，视口更高时自动铺满。
禁止横向溢出、底部裁切、文字重叠和依赖滚动才能读完单页。
7. 导航表达安装正在推进
顶部导航显示简单开始、工程化执行和价值回归三幕；页面顶端细线显示全局阅读进度。
不设置幕间分块页。右侧导航从 04 工程链入口开始，依次显示目标展开、缓存与来源、依赖图、资源调度、动态适配、运行反馈和完成闭环。
二、当前架构
01 封面：让开发环境标准化交付
02 用户：两类用户，一套环境标准
03 交互：一条命令收敛首次安装
04 工程链入口：简洁入口连接计划、获取、执行与提交
05 规划：目标展开形成唯一执行计划
06 获取：缓存优先，八类来源适配
07 规划：依赖图固化顺序并持续补位
08 执行：多维资源按阶段安全重叠
09 优化：动态分配兼顾吞吐与尾速
10 反馈：进度、资源等待与机器事件可解释
11 提交：验证完成条件并支持中断恢复
12 复用与回看：两种入口共享事实，一条命令承载完整工程链
13 交付：一次选择形成可交付的开发环境
三、目录说明
index.html 13 页内容、页面结构、章节锚点和可访问性标记
styles.css 基础色板、字体和通用布局
layer-story.css 投影画布、阶段导航和参考站点的共用版式
forge.css bot-forge 蓝色视觉、页面专属组件与覆盖规则
app.js 阅读进度、顶部导航、后台工作导航和章节状态
README.txt 设计、运行、维护、验收和部署约定
四、本地运行
cd ./docs/web
python3 -m http.server 4170
浏览器访问：
http://localhost:4170/
网站是纯静态页面，不需要安装依赖或执行构建。修改 HTML、CSS 或 JavaScript 后刷新浏览器即可查看结果。
五、操作说明
上下滚动阅读完整汇报。
顶部导航可跳转到三幕的首个内容页。
进入工程化执行后，右侧导航显示系统当前承担的工作和已完成阶段；点击阶段可直接跳转。
页面元素随滚动渐入；页面核心内容不依赖动画才能阅读。
六、维护流程
1. 先在 index.html 中确定新内容属于哪一页、哪个生命周期阶段。
2. 优先复用现有流程、卡片、状态块和资源图，不重复创建近似组件。
3. 基础规则放在 styles.css；参考版式放在 layer-story.css；bot-forge 专属视觉放在 forge.css。
4. 修改页面数量时，同步更新封面总页数、各页编号、CSS 页码后缀和本 README。
5. 修改章节 ID 时，同步更新顶部导航、后台工作导航和 app.js 状态映射。
6. 内容事实以 ../../README.md 和 ../manual 为依据，不在网站维护第二套产品语义。
七、验收要求
使用 1280×720 与 1440×900 桌面视口检查全部 13 页。
每页高度完整，页面与内容块没有横向溢出，标题、命令和说明文字不重叠。
顶部导航、后台工作导航和所有锚点可以正确跳转。
阅读进度、当前阶段和已完成阶段随滚动正确更新。
浏览器控制台没有 JavaScript 错误或资源加载错误。
所有 CSS 与 JavaScript 均从 docs/web 的相对路径正常加载。
八、部署
docs/web 是独立纯静态站点目录，可部署到 GitHub Pages、Cloudflare Pages、Netlify、Nginx 或任意静态文件服务器。
部署时将 docs/web 设置为站点根目录，并确保服务器默认返回 index.html；不需要复制 docs/manual，也不需要构建步骤。
网站使用相对路径加载资源；部署到子路径时保持 docs/web 内部目录结构不变。