# AI Training HTML Slides

## 项目用途

本项目用于制作 AI training 的 HTML 幻灯片。设计语言、中英文风格与交互方式沿用 AI Physics 报告，按本次培训的目标组织内容。

- 默认直接编写 HTML／CSS／JavaScript，固定 1920×1080（16:9）画布，整体缩放适配屏幕。
- 默认简体中文，提供完整英文版本，可随时点击切换；每次显示一种语言。
- 默认浅色 paper 风格，不增加主题／CSS 切换。
- 培训主题、听众、时长、大纲及交付文件名随具体任务确定。
- 用户对具体报告的最新要求优先于这里的默认值。

## 共享资料来源：AI Physics

**“AI Physics 文件夹”从本项目访问为 `../2026_AI_Physics/`。** 这是本项目长期复用的共享资料来源。查找已有设计、案例、图片、视频、交互网页和研究材料时，先查该目录。

设计依据为参考聊天「梳理 prev 报告资源」：`thread://01a114f4-16c1-7671-b6f9-8a5d1b75a7c8?hostId=local`。本项目初始化时已读取该聊天及共享目录的 `AGENTS.md`；后续需要依赖聊天中的具体细节时，用 `read_thread` 读取相应内容。

下表路径均相对于 `../2026_AI_Physics/`：

| 入口 | 用途 |
| --- | --- |
| `AGENTS.md` | 资源地图、已确认的设计偏好和案例索引；优先查看「本次报告的设计风格」「旧资源地图」「格式、组件与制作约定」 |
| `ai_agents_physics_education.html` | 已完成报告的展示效果与交互参考 |
| `ai_agents_physics_education.template.html` | 可编辑模板：配色、章节页、双语文案、导航、证据窗口 |
| `resources/` | 当前报告的双语 JSON、分节 HTML／CSS、图片、视频、离线交互与来源记录；教学素材见 `resources/education/` |
| `scripts/build_talk.py`、`scripts/verify_talk.cjs` | 构建与浏览器验证参考；复用前检查所需路径、依赖及报告专属逻辑 |
| `prev/wang2-html/` | HTML 模板、布局、运行时及设计／双语／QA 指南 |
| `prev/slide-kit/` | 轻量 HTML 示例、共享 CSS／JS、可滚动文档模板 |
| `prev/Physics_AI_Yi_Wang_full_modular.html` | 早期物理报告的模块化源文件 |
| `prev/resources/` | 历史网页、截图、视频及研究记录；按实际文件和引用查找 |
| `prev/2026-AI-Physics-Slidev/` | Slidev 历史版本、版式及字体；需要相应功能时参考 |
| `prev/2026_AI_edu_分享系列/ppt/` | 用 AI 做课件的原稿、交互录屏、素材审核、成片及来源记录 |
| `prev/2026_AI_edu_分享系列/video/` | 教学录像加工、索引／字幕跳转、Coleman 重制等素材与制作记录 |
| `prev/2026_AI_edu_分享系列/Pedagogical_Innovation_English.docx` | 英文教学创新案例，配套截图位于同目录 |
| `data/` | arXiv 统计、数学发现榜单等数据与研究材料 |

按需读取和复制实际使用的素材，记录来源路径、原始链接及必要日期。对本培训所需的修改保存到本项目；修改共享来源须有对应任务授权。历史报告的大纲、页码、日期、署名、致谢和具体研究结论按本次任务选择。

## 设计语言

| 用途 | 默认色值 |
| --- | --- |
| 暖白画布 | `#fcfcfa` |
| 灰绿外围 | `#e9ece9` |
| 深灰主文字 | `#253130` |
| 灰绿次文字 | `#63706e` |
| 橘色强调与交互状态 | `#cd5d0d` |
| 浅灰内容模块 | `#f0f0ec` |
| 封面局部橘色强调（按需） | `#cd5d0d` |

- 使用清晰的无衬线字体，参考 Noto Sans／Noto Sans CJK SC；为离线交付提供本地字体或可靠回退。
- 封面采用醒目标题和精简元信息；章节页用大字与留白。信息页用浅灰模块、对齐和留白表达关系，橘色只突出重点。
- 每页围绕一个主要论点或问题。卡片用于并列、比较或步骤；同组按内容安排宽高和条目对齐。
- 页眉与右侧目录、工具栏使用相同字号、行高，并在同一高度居中对齐；页眉与主标题之间留出清楚的空隙，避免小节标识紧贴标题。调整后检查正文和页脚的位置。
- 标题、关键结论和放得下的完整句子优先单行；需要换行时按语义断开，避免孤立汉字或英文短词。多行标题行高通常至少 1.2。
- 长句超过一行时，按逻辑主动安排断行：优先在分号、完整分句、例子入口或操作步骤之间换行，让同一行表达完整意思。例如“早期 function_call / function，后来 tool_calls / tool；”与“Responses 使用独立调用项和结果项。”分别成行。不要等浏览器在词语中间或句末几个字之前自动折行，也不要对所有标点机械添加换行。逐页分别检查中英文的实际断行，同时检查新增行数是否挤压正文或页脚；可复制的原始提示词、代码和引用内容保持完整。
- 1080 高画布正文通常至少 28 像素、注释至少 22 像素；以实际投影尺寸检查可读性。
- 普通中文不插入装饰性空格。强调色文字与普通颜色文字相邻时，在两段文字之间插入一个半角空格；这条规则适用于封面、标题和正文中的行内强调。连续的同色词句不因此拆开，标点仍紧贴前文。中英文分别检查实际间距与换行，避免漏空格或重复空格。例如封面显示“与 AI 智能体 一起做科研”，橘色“AI 智能体”前后各与深色文字留一个空格。
- 数学公式和正文中的数学变量统一用 LaTeX 编写，通过 KaTeX 等数学排版器渲染，包括分数、根号、积分、上下标、极限及图解标签。不要用 Unicode 上下标、希腊字母、根号与斜杠拼公式，也不要用 HTML `<sub>`／`<sup>` 代替公式排版。普通代码和原始证据保留原文。公式按语义整体排版；中英文分别检查字号、基线、行距和溢出。当前项目在构建时用本地 KaTeX 渲染，并随项目保留样式、字体和许可证。
- 数据、图像和真实演示需要充足面积；保留图表语义颜色、公式、标签与对象关系，媒体保持原比例。
- 以图像为绝对主体的幻灯片，优先把图放到可用画布的最大尺寸；不要沿用普通文字页的大标题、段落和宽边距而把图挤小。标题、必要说明和来源集中为紧凑的底部说明带，保留顶部导航空间；按原比例完整显示有意义的画面，不裁掉证据、不拉伸、不用滚动框。分别检查中英文，保证说明与控件不遮挡图像。
- 不添加重复标题、徽章、装饰性编号或「滚动查看」等无助于操作的提示。

## 中英文与文案

- 标题直接点明主题，删除“几个”“一些”“真正”等不增加信息的修饰，以及“先来看看”等铺垫。正文说明具体机制、材料、操作或判断依据；有明确含义的范围限定仍保留。
- 本次面向同行交流分享，听众包括资深科研人员。标题和正文不用“课程／培训”框定活动，不预设听众水平；以分享做法、说明依据和共同讨论的口吻表达。操作步骤仍写具体。
- 面向听众的文案不讲“沿用 AI Physics”等素材制作来源；直接介绍研究问题、做法和结果。必要的论文、数据及原始对话来源保留，素材归档路径记在制作记录中。
- 概念页先说明是什么、为什么与使用有关，再与具体例子对应；可以同页呈现。标题与过渡句必须和实际页序一致，不提前承诺后面没有展开的内容。
- 中文讲述中的 Agent、Coding Agent、Harness 分别统一写作“智能体”“编程智能体”“运行框架”，不再附英文括注。目录、页眉、标题、正文和提示词保持一致。英文版本与原始代码、接口标记、引用原文保留其原文。
- 名称必须统一：同一个部分或小节，在总目录（outline）、章内目录、页眉、导航菜单和正式标题中使用同一名称，中文和英文分别保持一致。名称集中定义并复用；不能把“原理”“原理概述”等作为同一部分的不同叫法。
- 每个大部分下设主题小节，按 1、2、3 编号，并在各部分内重新开始。小节可跨多页；章首页列出小节，后续页面保留所属小节，避免把每张幻灯片都编号成独立小节。

- 每次新增或修改内容，同时更新中文和英文，包括章节名、按钮、提示、图注和无障碍标签；文案可集中存放于 JSON 或语言字典。
- 翻译结合整页与前后叙事，保持含义、语气、强调和术语一致；分别检查两种语言的字号、断行、模块高度和溢出。
- 原始聊天、代码、论文、截图等证据保留原文；外围讲述文字和操作控件随语言切换。需要双语同时展示的教学示例按页面目的单独设计。
- 直接说明做什么、得到什么、依据是什么。删除防御性补充、自我削弱的免责声明、无信息增量的否定对照和模板化 AI 措辞；具体限制写清事实及影响。
- 可变信息如模型、价格、工具版本、研究进展和在线链接，在用于当前培训时重新核实。

## 交互与交付

- 日常维护模块化 HTML 幻灯片。用户已于 2026-10-16 要求 standalone 单文件版：使用 `python3 scripts/build_standalone.py` 先构建再打包，生成根目录下的 `ai_agents_research_training.standalone.html`。单文件需内嵌实际依赖并验证独立离线运行；不生成 ZIP。后续修改源文件后，按交付需要重新运行脚本，勿手工编辑生成的单文件。

- 翻页按钮、页码输入、中文／EN 和全屏统一放右上角；控件支持键盘、明确的焦点与选中状态。页码按 Enter 跳转并限制在有效范围。
- 支持 PageUp／PageDown 翻页、F 全屏；输入框、代码编辑、图表交互和文档滚动应保留各自操作。
- 章节跳转使用稳定的章节 ID，避免把链接写死为页码；页数由实际页面计算。
- 备注通过右上角笔记本图标按钮打开／隐藏（不显示“备注”文字；字号视觉尺度与中心高度和目录图标匹配，保留可访问名称和悬停提示），默认隐藏。右侧半透明面板显示全套备注，按稳定页面 ID 自动定位并高亮当前页；备注页码和标题可跳转。手动滚动备注不翻页，面板内保留原生滚动按键；备注保持原文语言，不随幻灯片切换而翻译。备注和页码由源文件生成。无备注的页面只保留页码与标题，不显示占位文字或空正文段落。
- 只有用户明确要求时才添加备注，不主动把制作说明、审阅记录、资料核对或讲解建议放入备注。用户说“添加备注”时，默认针对当前正在讨论的页面，默认使用中文，并写入该页的备注字段，通过上述备注面板呈现；不加入幻灯片正文，也不另建英文译文。当前页依据对话中的标题、页码或明确引用判断；无法确定时再简短确认，不为此读取或控制用户桌面。用户明确指定页面或语言时按其要求执行。
- 长文档、聊天、代码和推导用可滚动 iframe／artifact frame；可复用关键词定位与高亮功能。窗口初次打开停在全文顶部，关键词默认不选中，只有主动点击关键词才定位和高亮；翻页或切换语言不要自动重新定位已阅读的窗口。展示材料中的本机绝对路径去掉个人目录前缀，只保留有意义的相对目录或文件名。原始存档保留，展示时转换。
- 互动网页保留实际操作，视频和动画保持可播放，离开所在页时暂停；嵌入或离线交付前核实依赖。
- 优先支持直接打开 HTML 离线演示；本地资源引用使用相对路径或构建时内嵌。共享目录的绝对路径用于作者查找资料，不写入交付 HTML 的运行时依赖。
- 素材按需存放在本项目 `resources/`；构建和验证脚本按需放 `scripts/`。交付文件遵循源文件位置，不另建 `output/` 或 `outputs/`。
- 采用模板／模块化构建时先修改源文件再重新生成交付 HTML；记录实际可用的构建命令。

## 制作、验证与收尾

- 制作或审查幻灯片前，完整读取 `../2026_AI_Physics/prev/wang2-html/references/slide-guidelines.md`；按任务补读同目录的 `internationalization.md`、`artifact-frames.md`、`project-workflow.md`、`slide-review.md`、`qa-and-delivery.md`。
- 本项目的 16:9、paper、默认简体中文与右上角统一控件覆盖通用套件的其他默认设置。
- 先明确每页讲述意图并打磨少量样页，再扩展内容；延续已经确认的设计。
- 制作或修改幻灯片后，在真实浏览器逐页切换中英文，检查 1920×1080 与 1280×720 下的排版、文字溢出、图像、公式、滚动、媒体与所有可见控件；其他画幅或主题启用后也需检查。
- 实际测试语言切换、页码输入、章节跳转、键盘、全屏、互动与视频离页暂停；离线交付同时检查离线加载。
- 仅修改项目说明时检查内容与引用路径，无需启动浏览器。
- 记录本任务启动的浏览器、预览服务器和后台进程 PID／会话标识，采用顺序或有界并发验证；完成、失败或中断后清理本任务资源及临时浏览器 profile。
- 每个独立任务完成并验证后自动创建 Git 提交，只暂存该任务的修改；保留无关既有改动，不把共享资料目录或历史仓库整体纳入本项目。

## 初始化记录

- `resources/phys1002-exam-case/README.md`：PHYS1002 两次考试命题的单文件报告。内含往年试卷／课程课件／音频转写作为输入、80 道候选题、教师中文“好／可／不要”筛选、按覆盖和难度组主卷与备用卷、教师最终审核的流程；两次实际统计及一页／两页双语幻灯片文案已内嵌。例题只展示第一次考试；第二次仅保留流程和统计。`evidence.json` 保存聊天摘录、来源哈希、第一次例题及核验数据，供跨电脑制作幻灯片使用。

- 经费申请放在第五部分“报告、教学与其他工作”的独立小节，强调丰富的已有材料与方法如何支持智能体整合出申请书；第四部分专注科研。CCC 私有仓库已有丰富内容是此案例的重要基础。

- `resources/grf-application-case/`：2026 年 GRF 申请协作案例，含提供材料、两版初始提示词原文、逐条修改索引和聊天依据。22 条修改／制作指令分布于 14 个执行回合；从初稿后计为 21 条、13 个执行回合。用于讲研究材料输入、完整初稿及内容／预算／语气／格式的连续迭代，详见该目录 `README.md`。

- `resources/talkie1930/`：从 `/home/wangyi/code/0 prev/talkie1930/` 归档的 Talkie 1930 聊天适配器，含命令行／桌面／网页版本、上游架构 adapter 与 tokenizer 参考、来源清单及提示词教学说明。用于讲 system、user、assistant 角色、特殊 token、多轮历史和 assistant prefill；原程序未插入 system 消息。先读该目录 `README.md`，网页副本的口令通过 `TALKIE_ACCESS_KEY` 设置。

- `resources/arc-0911-ideas/`：从 `~/code/arc-dev/local` 与 `~/code/0 prev/arc-codex-test/prev` 收集的 ARC 科研想法案例。以 0911.3380 为入口的六组记录共 35 个候选条目，按 8 类物理问题归组；含输入原文、逐条中英文原题／中文概括、完整导出、历史评审与来源哈希。另有 20 个以其他论文为种子的相邻候选附录。讲想法生成与评审收窄时先读 `README.md`，F04 保存两轮 signed-tilt／三四点闭合提案与反馈。

- ARC 案例跨电脑交接用 `resources/arc-0911-ideas/frequency.md`：单文件内含统计、六组输入原文、全部 55 条候选的原题／目标／执行步骤／预期产物和 49 份原始完整计划。强混合直接候选 6 条；化学势直接候选 2 条，计入核心鉴别与后续对照后涉及 7 条。化学势与 ghost 的重叠、暂停候选及 T05 原始计划缺失均有记录。`frequency.json` 是相同内容的结构化版本；A. J. 可用单文件编写幻灯片。

2026-10-11：建立项目约定，读取参考聊天及 AI Physics 的项目说明和 HTML 模板，确认共享资料路径。当前仅初始化项目说明，尚未创建培训幻灯片。