笔记整理与出题助手使用说明
这是使用手册：讲怎么跟这个助手说话、会得到什么结果、文件都放在哪。 规则细节不在这里——规则写在《笔记整理规范》里，本文不重复，避免两份规则对不上。
一、它是什么
ZCode 里有一个叫 note-organizer 的技能，负责两件事：
- 整理笔记：把学习资料（视频截图、PPT、PDF、手写照片、课程代码）变成规范的 Markdown 笔记，写进博客仓库。
- 出题与批改：给每篇笔记出练习题、生成可直接运行的练习文件、批改你写的代码、把错题挑出来重做。
它的执行入口是 .agents/skills/note-organizer/SKILL.md，那个文件只是指针，不用手动改。
二、怎么跟它说话
| 你说 | 它做什么 | 产出在哪里 |
|---|---|---|
| 「整理成笔记」「记到笔记里」（附图片/PPT/PDF） | 读资料 → 查证 → 写成规范笔记 | src/content/posts/编程学习/Python学习笔记/NN-笔记名.md |
| 「补全某篇笔记」「追加到 26」 | 补充或追加到既有笔记，加 updated | 同上 |
| 「出题 26」 | 在笔记末尾写题（知识回顾 + 裸写题 + 折叠提示），每道题后附折叠的参考答案，并生成练习文件 | 笔记末尾 + 练习库 |
| 「批改 26」 | 真的运行你写的代码，把批改结论写回笔记里每道题下面；错题打 ❌ | 笔记里对应题目下 |
| 「批改 27-33」 | 批量批改一个范围：逐篇跑代码、逐篇写回结论，最后给一份汇总（哪几篇错、错在哪类知识点） | 笔记里 + 聊天汇总 |
| 「重做错题 26」 | 挑出带 ❌ 的题，生成不带提示、不带答案的重做文件 | retry_NN_主题.py |
| 「看答案 26 第3题」 | 把参考答案发给你（答案本来就在笔记里折叠着，这条是想让别人念给你听时用） | 聊天里 |
| 「规范里加一条 X」 | 改《笔记整理规范》，并同步本文 | 规范文章 |
编号（26）就是笔记文件名开头的两位数字；也可以直接说笔记名，比如「出题 Python3 集合」。
三、一次完整流程长什么样
以「26-Python-with关键字」为例：
- 学完一章：把 PPT/截图发给它 → 得到
26-Python-with关键字.md，含概念、代码、易错点提示。 - 说「出题 26」：笔记末尾多出一个
## 练习题区块——- 一、知识回顾（8~10 条速查条目，答案直接写出来，读一遍即复习）
- 二、裸写题 3 道（只给需求，不给 API 提示；想不起来可以逐级展开折叠的三级提示）
- 三、综合题 0~1 道（分步引导） 同时在
Daily-Learning/python/26-Python-with关键字/生成test_01_xxx.py，里面只有题目和「在下面写你的代码」。
- 在 PyCharm 里做题：打开练习文件，在
# 在下面写你的代码：下面写。已经写过的代码它不会覆盖，重新出题只刷新题目部分。 - 做完自己对答案：每道题后面都跟着一个折叠的「参考答案（做完再点开）」——练习文件里故意不放答案，就是为了做题时看不到；做完回笔记点开对照即可。
- 想让助手检查（可选）：说「批改 26」；做完一整个阶段可以一次性说「批改 27-33」，它会逐篇跑你的代码、把结论写回笔记，最后给一份汇总告诉你哪几类知识点还需要练。做错的题在题目行标 ❌。
- 说「重做错题 26」：为带 ❌ 的题生成
retry_01_xxx.py（这轮不给任何提示），重做通过后把笔记里的 ❌ 去掉。
四、文件都放在哪
| 内容 | 位置 |
|---|---|
| 笔记（Python 课程） | src/content/posts/编程学习/Python学习笔记/NN-笔记名.md |
| 笔记（LangChain 课程） | src/content/posts/编程学习/LangChain学习笔记/NN-笔记名.md |
| 笔记配图 | 同目录下 assets/NN-笔记名/ |
| 练习（Python 课程） | E:\GithubProgect\MyRunProject\Daily-Learning\python\NN-笔记名\test_NN_主题.py |
| 练习（LangChain 课程） | E:\GithubProgect\MyRunProject\Daily-Learning\langchain1.2_tutorial\NN-笔记名\test_NN_主题.py |
| 规范（规则） | 编程学习/学习方法/笔记整理规范.md |
| 本文（使用手册） | 编程学习/学习方法/笔记整理与出题助手使用说明.md |
| 技能本体 | .agents/skills/note-organizer/SKILL.md（指针，别改） |
每个课程一个根目录：新课程 = 新的笔记文件夹 + 新的练习根目录，编号各自从
01开始（LangChain 课就是 2026-09-21 新开的一门）。
五、规则想改怎么办
- 改规则只改一处：《笔记整理规范》。技能是它的指针，改了规范不用动技能。
- 也可以直接跟我说「规范里加一条……」，我会改规范文章，同时更新本文（功能有变化时）。
- 本文末尾的「更新记录」会记下每次功能变化，方便你回头看它是什么时候变的。
六、常见问题
为什么练习文件里没有答案？ 避免边做边瞄——编辑器里看不到，做题时更专注。答案就在笔记里每道题下面折叠着，做完点开对照即可；也可以说「看答案 26 第3题」让它发给你。
为什么题目不像以前那样直接给出方法名？ 以前那种 -> list.append(元素) 等于把答案写在题干里，照着抄一遍记不住。现在改成折叠的三级提示（思路 → 方法名 → 骨架），先自己想，实在想不出来再逐级展开——展开本身也是学习信号。
题量太少会不会覆盖不全？ 覆盖面交给「知识回顾」：8~10 条速查条目，把这篇笔记的 API/概念直接写清楚，读一遍就算复习（不再用要手填的空）；动手交给实践题（裸写题），再难的用综合题串起来。出完题还会对照知识点清单逐条检查有无遗漏。
旧的题（2026-09-18 之前出的）会和现在不一样吗？ 会。旧题的提示更直接、答案写在练习文件里、目录按标题命名——它们保留原样不改造，新题才按新规范。
七、更新记录
| 日期 | 变化 |
|---|---|
| 2026-09-28 | 第一批作业批改 + 全站格式统一：Python 课程你写过的 133 个练习文件全部实跑批改（结论写进笔记、错题标 ❌，附汇总）；练习题固定「知识回顾 + 裸写题（+ 综合题）」三段、每题一份折叠答案、题面不出现库方法名（运算符与内置函数可以留）；练习文件统一模板（44 个 =、题目2-N、不含答案）；结构项（frontmatter 顺序、tags、## 相关、坏标题、文件尾换行）全站对齐。旧格式那 20 篇已一并改造，规范里"旧题保留原样"的豁免作废 |
| 2026-09-19 | 初版：整理笔记 + 出题 / 批改 / 重做错题 / 看答案 |
| 2026-09-19 | 本文与《笔记整理规范》从 Python学习笔记/ 移到 编程学习/学习方法/，去掉文件名编号 |
| 2026-09-19 | 参考答案改为直接写在笔记里（折叠，做完点开）；新增范围批改「批改 27-33」；第 3 章 AI 应用系列 15 篇补齐练习题与练习文件 |
| 2026-09-21 | 支持多课程：新课程用独立的笔记文件夹与独立编号（新增 LangChain学习笔记/，练习放 Daily-Learning/langchain1.2_tutorial/） |
| 2026-09-23 | 「回忆填空」改为「知识回顾」：答案直接写在条目里、不再留 ____（在 Obsidian 里填空要先删下划线，太别扭）；动手只留在实践题 |
| 2026-09-21 | 资料里的插图默认全部提取插入笔记（PDF 用 PyMuPDF 提图 → 压缩 → 放 assets/<笔记名>/ → 插在讲对应内容的小节里）；不再允许压缩课程内容，整理完要逐节对照原资料自查。起因：LangChain 笔记漏掉全部插图与多节内容，被站长指出后补回 124 张图、约 8000 行内容 |
规则细节：《笔记整理规范》