From c8642ede02df4f3b39f89912933dfd11d6d336a2 Mon Sep 17 00:00:00 2001 From: zhl Date: Tue, 3 Nov 2026 12:00:53 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E5=B0=86=E7=BD=91=E9=A1=B5=E5=85=A5?= =?UTF-8?q?=E5=8F=A3=E8=BF=81=E7=A7=BB=E8=87=B3=E9=A1=B9=E7=9B=AE=E6=A0=B9?= =?UTF-8?q?=E7=9B=AE=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 +- README.md | 21 ++++++++++++++++--- ...1129-知识库与腾讯ima教育应用培训PPT大纲.md | 8 +++++-- outputs/index.html => index.html | 0 scripts/build_web.py | 6 ++++-- 5 files changed, 29 insertions(+), 8 deletions(-) rename outputs/index.html => index.html (100%) diff --git a/AGENTS.md b/AGENTS.md index e58a31a..19998ef 100644 --- a/AGENTS.md +++ b/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与内容一致性 diff --git a/README.md b/README.md index ee6b42c..1ad1a1a 100644 --- a/README.md +++ b/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/`。 diff --git a/docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md b/docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md index af1e4d2..3c7eecd 100644 --- a/docs/261103_1129-知识库与腾讯ima教育应用培训PPT大纲.md +++ b/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整包下载。 diff --git a/outputs/index.html b/index.html similarity index 100% rename from outputs/index.html rename to index.html diff --git a/scripts/build_web.py b/scripts/build_web.py index bf3ae33..cc46f75 100644 --- a/scripts/build_web.py +++ b/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}")