diff --git a/.workbuddy/memory/2026-10-23.md b/.workbuddy/memory/2026-10-23.md index 0604154..ed00e28 100644 --- a/.workbuddy/memory/2026-10-23.md +++ b/.workbuddy/memory/2026-10-23.md @@ -58,3 +58,36 @@ README.md 结构说明 + 三轮读法 - 网页核验:01/06/07/10 四个文件残留 `$` 全为 0 **待定**:第 2 讲、第 4 讲仍是最早的三件套结构,等用户确认新格式后按同一套重做。 + +## 题级双向链接(同日,第3讲) + +用户要求:双向链接不能只在每个点底部,要**嵌到每道题里**,便于随时跳转。 + +**做法**:24 道题每题末尾加一行 + +``` +> **关联** · 盘点 [§2.1 判据总表](…) | 上游 [点 1 题 1](…) | 下游 [点 2 题 1 求秩](…) | 速查 [十个判据](…) +``` + +四向:盘点(定义定理出处)/ 上游(做这题前要先会)/ 下游(结论在哪被用)/ 速查(考前十分钟)。 +24 题共 96 条出链。反向索引由同一映射自动生成:盘点 §0.4 升级为「章节 ↔ 题目」(23 节 42 条),速查「回查」升级到题目级(8 条 24 条)。 + +**Gitea 锚点规则实测(关键,两条方向相反)**: + +| 链接 | 写法 | 结果 | +|---|---|---| +| 同文件 `[x](#测试-2-乙)` | 不加前缀 | Gitea 自动补成 `#user-content-…` ✅ | +| 同文件 `[x](#user-content-…)` | 手写前缀 | 变成双前缀 ❌ | +| 跨文件 `[x](f.md#21-判据总表)` | 不加前缀 | 原样保留,跳不到 ❌ | +| 跨文件 `[x](f.md#user-content-21-判据总表)` | 手写前缀 | 正好命中 ✅ | + +标题 id = `user-content-` + 小写化(空格→`-`,其余标点全删)。`·` 两侧空格 → `--`。 +含公式标题也一致:`## 问题 3 · 抽象:$AB=O$ 能推出什么` → `user-content-问题-3--抽象abo-能推出什么`。 + +**新增 `check_md_links.py`**:校验 md 内部链接的目标文件与锚点是否存在。本次 11 文件 235 条链接 0 异常。 + +**云端端到端实测**:抓 11 个页面比对 id 集合,159 条跨文件锚点链接 **0 异常**。 + +**踩坑**:① 插入 `---` 前必须留空行,否则 `---` 被当成 setext 标题下划线;② git checkout 后工作区是 CRLF,正则 `\n---\n` 匹配不上,脚本要按 `\r\n` 兼容读写。 + +提交 `2b1788b`,已推送。 diff --git a/.workbuddy/memory/MEMORY.md b/.workbuddy/memory/MEMORY.md index ddbb62c..b025a0b 100644 --- a/.workbuddy/memory/MEMORY.md +++ b/.workbuddy/memory/MEMORY.md @@ -27,7 +27,13 @@ - **不再生成 PDF**(2026-10-23 起)。讲义只出 Markdown,在网页端或 App 里看;`md2pdf.js` 工具链保留但不主动调用。 - **讲义结构:知识点盘点 + 以题带点分册**。每讲 = `README` + `01-知识点盘点` + 每个考点一个分册 + 速查卡。盘点只做「定义/定理/判据/公式」的高密度地图,不展开例题;题目全部嵌在点分册里,绝不退回「考点册 + 试题册 + 解析册」三件套。 - **单个 md 不超过 1.3 万字符(约 6000 汉字),超了就拆文件**。一个文件塞太多内容会逼着压缩,压缩就丢细节(第3讲 1.8 万字符塞 7 个点的教训)。 -- **文件间用相对路径 Markdown 链接做双向链接**(`[点 2](03-点2-秩与极大无关组.md)`),不用 `[[ ]]`:Gitea 会渲染成可点路径,Obsidian 也能进反链面板。点分册底部固定「本点关联」表(盘点/上游/下游/速查),盘点里放反向的「章节 ↔ 练习」对照。 +- **文件间用相对路径 Markdown 链接做双向链接**(`[点 2](03-点2-秩与极大无关组.md)`),不用 `[[ ]]`:Gitea 会渲染成可点路径,Obsidian 也能进反链面板。 +- **双向链接做到「题级」**(用户 2026-10-23 要求):不止点末一张表,**每道题末尾都要有一行 `> **关联** · 盘点 … | 上游 … | 下游 … | 速查 …`**,四向都指向具体题目的锚点;盘点/速查里的反向索引(§0.4「章节 ↔ 题目」、速查「回查」)由同一份映射**反向生成**,保证对称不漏。 +- **Gitea 锚点规则(两条方向相反,极易踩)**:标题 id $=$ `user-content-` $+$ 小写化(保留字母数字汉字与下划线,空格→`-`,**其余标点全删**,`·` 两侧空格 → 两个 `-`) + - **同文件**写 `#问题-2--变换后的向量组` —— Gitea 渲染时**自动**补 `user-content-` + - **跨文件**写 `03-xxx.md#user-content-问题-1--…` —— Gitea **不补**,必须手写前缀 + - 含公式的标题同样适用:`## 问题 3 · 抽象:$AB=O$ 能推出什么` → `user-content-问题-3--抽象abo-能推出什么` + - 校验:`python .workbuddy/tools/md2pdf/check_md_links.py <目录>`(查目标文件与锚点是否存在) ## 工具链(本项目自建,可复用)