规范
本文档定义「刷题整理」体系下所有文档的整理规范,后续每次整理新题时请严格遵循。
一、体系结构
「刷题整理」包含四个子文档,各司其职:
| 文档 | 职责 | 更新时机 |
|---|---|---|
| 规范 | 本文件,定义整理规则与流程 | 规则变更时 |
| 时间线索引 | 按做题日期索引所有题目 | 每做一题 + 每次整理后 |
| 类型索引 | 按题目类型分类索引所有题目 | 每做一题 + 每次整理后 |
| 刷题规划 | 20 天刷题计划与进度勾选 | 每完成一题 |
二、做题与整理流程
做题时,将完整题解(题目、代码、笔记)记录在当天日记中
定期整理时:
每次整理后日记原文保留,不删除、不移动
每次整理完成后,必须同步更新所有相关索引——包括时间线索引、类型索引、笔记、待归档。索引是体系的门户,整理而不更新索引 = 白整理
更新索引时,insert 的 previousID 必须指向目标文档内真实存在的块 ID(用 block.get 或 SQL 验证后再用);若 previousID 无效,插入会落到错误位置或丢失。插入完成后用 SQL 复查:SELECT COUNT(*) FROM blocks WHERE root_id=’文档ID’ AND type=’h’ AND subtype=’h3’,确认数量与预期一致
三、索引条目格式规范
每个题目条目结构固定为「H3 纯文本标题 + 两个段落」:
题号. 题名
分组用
##二级标题:时间线索引按日期(如## 2026-08-07),类型索引按分类(如## 数组)H3 为「题号. 题名」纯文本,不带任何链接
H3 下固定两个段落:
- 第一段:
链接:[题号. 题名](力扣题目链接)(指向力扣原题) - 第二段:
📎 原笔记:((日记中该题标题块的ID "题号.题名"))(指向日记完整题解)
- 第一段:
所有链接的锚文本统一使用「题号. 题名」格式,与「笔记」文档中「来源」链接的锚文本保持一致
题号、题名必须与力扣页面一致
「原笔记」链接必须指向日记中该题的标题块(用
block.get获取,不可编造 ID)新日期(或新分类)直接追加
##标题及条目即可,保持时间/分类升序
四、类型分类标准
| 分类 | 判定依据 |
|---|---|
| 数组 | 核心数据结构为一维数组(含双指针、前缀和、滑动窗口等) |
| 字符串 | 对字符串的直接操作、匹配与转换 |
| 链表 | 涉及链表节点、指针操作 |
| 矩阵 | 二维数组/矩阵(含遍历、置零、对角线、棋盘) |
| 模拟与贪心 | 按规则逐步模拟过程,或每步取局部最优 |
| 数学 | 数学推导、位运算、幂运算等 |
一题涉及多个类型时,取最主要的一个分类;分类体系可随题目扩展,但需同步更新本表。
五、笔记整理规则
- 按知识点分类整理,而非按题目分类(同知识点合并,不重复)
- 每条笔记必须标注来源题目(题号 + 原笔记链接)
- 代码示例保留,注释用中文
- 长文笔记(如算法详解)提炼核心要点,完整内容跳转原文
六、更新示例
新做一题「1. 两数之和」后的完整更新动作:
时间线索引:在
## 2026-08-07下添加### 1. 两数之和及两个段落(链接:[1. 两数之和](力扣链接)、📎 原笔记:[1. 两数之和](原笔记链接))类型索引:在
## 数组下添加同样条目笔记:若该题产生了新知识点(如字典哈希表),在对应分类下补充并标注来源(锚文本同样为「题号. 题名」)
⚠️ 禁止用
update修改列表块:对 NodeList 块执行update时,markdown 多行列表只会保留第一项,其余全部丢失(工具返回 success 但实际已破坏)。修改列表的正确方式:- 删除整个列表块,用
insert(previousID 指向列表前的标题块)重建完整列表 - 或保留首项,用
append(parentID 指向列表块)追加其余项 - 完成后必须用
get_children或get_kramdown复查列表项数量
- 删除整个列表块,用