chore: 将网页入口迁移至项目根目录

README.md

@@ -4,7 +4,7 @@
 
 ## 课程文件
 
-- [离线网页演示](outputs/index.html)
+- [离线网页演示](index.html)
 - [PowerPoint 演示文稿](outputs/知识库与腾讯ima教育应用培训-v1.pptx)
 - [课程大纲](docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md)
 - [现场练习单](materials/05_现场练习单.md)
@@ -15,9 +15,9 @@
 
 ## 维护方式
 
-网页页面源码位于 `src/slides/*.html`，每页一个文件；`src/deck.json` 维护稳定页面ID及播放顺序。修改后运行 `python3 scripts/build_web.py --check`，再运行 `python3 scripts/build_web.py`。双击 `outputs/index.html` 即可离线播放，发送这个单文件即可分享。
+网页页面源码位于 `src/slides/*.html`，每页一个文件；`src/deck.json` 维护稳定页面ID及播放顺序。修改后运行 `python3 scripts/build_web.py --check`，再运行 `python3 scripts/build_web.py`。双击 `index.html` 即可离线播放，发送这个单文件即可分享。
 
-PPT首版源码位于 `scripts/build.mjs`，其标题索引生成至 `src/pptx-deck.json`。改动PPT内容时同步更新大纲及版本记录，具体见 [AGENTS.md](AGENTS.md)。生成文件放在 `outputs/`，不要直接修改后遗漏源码和大纲。
+PPT首版源码位于 `scripts/build.mjs`，其标题索引生成至 `src/pptx-deck.json`。改动PPT内容时同步更新大纲及版本记录，具体见 [AGENTS.md](AGENTS.md)。网页入口生成在项目根目录 `index.html`；PPT、ZIP练习包及预览图保留在 `outputs/`。生成结果不要直接修改，应修改源码后重新构建。
 
 本机重建使用已安装的官方演示文稿运行库。使用该运行库 Node 执行 `scripts/build.mjs`，参数1为仓库绝对路径，参数2为新的输出文件名，例如 `知识库与腾讯ima教育应用培训-v2.pptx`。构建会生成逐页预览、检查文件并导出新版本，保留旧版本。运行库位置见源码开头，换电脑需要调整。
 
@@ -42,3 +42,18 @@ PPT首版源码位于 `scripts/build.mjs`，其标题索引生成至 `src/pptx-d
 - 生成文件无网络依赖，访问官网或使用ima需要联网。网页不调用AI、不上传资料。
 
 此版仅生成本地网页，尚未发布到公网，也未自动提交或推送。
+
+## 文件组织
+
+```text
+index.html              # 网页入口，构建生成，可单独离线分享
+src/                    # 网页页面、播放器、样式与顺序清单
+scripts/                # 网页与PPT构建脚本
+assets/                 # 图片素材
+materials/              # 练习资料源码
+docs/                   # 课程大纲
+outputs/                # PPT、ZIP练习包及预览图
+work/                   # 验证记录
+```
+
+在仓库根目录运行 `python3 scripts/build_web.py` 会重新生成根目录 `index.html`，并更新 `outputs/培训练习材料.zip`。`--output` 可指定其他HTML输出位置，ZIP练习包始终保存在 `outputs/`。