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

AGENTS.md

@@ -12,7 +12,7 @@
 - 页内脚本由构建器包裹，可使用 `root` 查询本页。不得查询其他页面或在全局保存页内状态。计时器由公共播放器统一维护。
 - 图片放在 `assets/`，页面通过 `src="asset:文件名.png"` 引用；不在页面源码粘贴 Base64。`materials/` 为练习资料，构建时自动内嵌。
 - 不手写页码、总页数、section ID、active 或可见状态。页脚用 `{{PAGE_NUMBER}}` 与 `{{PAGE_COUNT}}`。
-- `python3 scripts/build_web.py --check` 检查；`python3 scripts/build_web.py` 生成 `outputs/index.html` 与ZIP练习包。`outputs/` 为生成结果，禁止直接编辑。
+- `python3 scripts/build_web.py --check` 检查；`python3 scripts/build_web.py` 生成根目录 `index.html` 与 `outputs/培训练习材料.zip`。根目录 `index.html` 和 `outputs/` 均为生成结果，禁止直接编辑。
 - `work/` 仅放验证记录或临时工作，不运行历史修补脚本。
 
 ## PPT与内容一致性

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/`。

docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md

@@ -1,7 +1,7 @@
 ---
 created_at: 2026-11-03 11:29:02 +0800
 type: 面向教育行业的知识库与腾讯 ima 应用培训 PPT 大纲
-revision: 第3次
+revision: 第4次
 revisions:
   - time: 2026-11-03 11:29:02 +0800
     version: 第1次
@@ -15,6 +15,10 @@ revisions:
     version: 第3次
     author: GPT-6
     content: 新增与PPT首版对应的30页离线网页，加入目录搜索、讲师备注、阅读模式、截图放大、提问复制、练习计时与资料下载，更新源码维护路径。
+  - time: 2026-11-03 11:59:45 +0800
+    version: 第4次
+    author: GPT-6
+    content: 调整文件组织，网页入口迁至项目根目录index.html，构建脚本和文档同步更新，PPT及ZIP练习包继续保留在outputs，课程内容不变。
 summary: 面向中小学教师、教研组长及学校管理人员，设计120分钟知识库与腾讯ima应用培训，通过知识库基础、产品操作、单元备课、练习设计、教研共享、校务查询和现场练习，掌握资料入库、提问、查证与成果沉淀。
 ---
 
@@ -314,7 +318,7 @@ summary: 面向中小学教师、教研组长及学校管理人员，设计120
 
 ### 六、网页演示版
 
-- 输出文件：`outputs/index.html`。共30页，与已提交PPT首版的课程内容一致，采用原深绿、薄荷绿和浅色版式。
+- 输出文件：项目根目录 `index.html`，由构建脚本生成；ZIP练习包保存在 `outputs/培训练习材料.zip`。共30页，与已提交PPT首版的课程内容一致，采用原深绿、薄荷绿和浅色版式。
 - 单页源码：`src/slides/*.html`，包含正文、标题、章节、讲师备注及页内样式；顺序由 `src/deck.json` 管理。
 - 公共文件：`src/shell.html`、`src/styles/theme.css`、`src/runtime/player.js`，使用 `python3 scripts/build_web.py` 构建；`--check` 仅检查。
 - 网页功能：键盘与触屏翻页、目录搜索与跳转、讲师备注、全屏、长文阅读模式、截图放大、第14/27页提示词复制、第26页12分钟计时器、第28页完成清单、五份材料单独下载与ZIP整包下载。

scripts/build_web.py

@@ -13,7 +13,8 @@ from html.parser import HTMLParser
 from pathlib import Path
 
 ROOT = Path(__file__).resolve().parents[1]
-OUTPUT = ROOT / "outputs/index.html"
+OUTPUT = ROOT / "index.html"
+MATERIAL_OUTPUT = ROOT / "outputs/培训练习材料.zip"
 
 
 class Markup(HTMLParser):
@@ -156,7 +157,8 @@ def main():
     temp = args.output.with_suffix(".html.tmp")
     temp.write_text(result, encoding="utf-8")
     temp.replace(args.output)
-    (args.output.parent / "培训练习材料.zip").write_bytes(material)
+    MATERIAL_OUTPUT.parent.mkdir(parents=True, exist_ok=True)
+    MATERIAL_OUTPUT.write_bytes(material)
     print(f"已生成 {count} 页：{args.output}")