用户习惯记录

软链接命名规范

• 格式：原目录名_中文注释
• 隐藏原始目录（VS Code files.exclude），只暴露软链接
• _config.yml exclude 中排除软链接，避免 Jekyll 生成重复 URL

已创建的软链接

验证方式

python3 scripts/validate-symlinks.py

对话记录 (2026-06-07)

目标

• 整理三级修学项目的目录结构，规范软链接命名，移动资源文件，更新配置文件。

已完成

• 修复 .vscode/settings.json 排除规则：深层原始目录排除路径改为通过符号链接名访问的路径
• 更新 AGENTS.md 语言偏好记录
• g2/s1/dcd/ 下 10 个章节目录重命名：01-dqjc→u01, 02-yzszs→u02, … 10-xptx→u10
• 创建 28 个软链接（格式迭代：- → () → _），涵盖 g1/g2/g3、u0-u6、s1-s4、dcd、u01-u10、bf、explain、rxl
• 更新 scripts/validate-symlinks.py 正则匹配新命名规范
• g1/u1~u6：删除 index.md，将 fc.md 重命名为 index.md
• 搜索 g1/ 和 g2/ 下所有 PDF 文件（100 个），复制到 /pdf 保留完整目录结构
• 更新 .gitignore 排除 pdf/
• 更新 _config.yml 的 exclude 添加 "pdf" 并更新软链接排除模式
• 更新 AGENTS.md 软链接表格
• 提交 git commit c91fcf4
• g1/ 课程目录移入对应单元目录（u0-u6），创建 55 个课程软链接
• 更新 g1/index.md 中所有课程路径链接
• 更新 .vscode/settings.json、_config.yml 的排除规则
• 更新 AGENTS.md 软链接表格（现在共 80 个软链接）
• xfzdrstd 合集拆分：复制 mp3/PDF 到 /pdf/g1/u2/12/13/14/，提取课文到各课程 text.md，删除 xfzdrstd/ 目录和 g1/u2/19_菩提导航攻略 错误软链接
• 修复 19 号课程软链接位置：g1/u2/19_菩提导航攻略(错误位置, 已删除) → g1/u3/19_菩提导航攻略(正确位置, 新建)
• 重构 /pdf/ 目录结构：删除旧扁平路径拷贝，按新单元路径 u{0-6}/XX/ 重新复制全部 PDF
• git rm 删除 g1/ 下所有 PDF（79 个），更新 markdown 中 PDF 相对链接为 /pdf/ 绝对路径
• 修复 g1/u2/10/text.md、g1/u2/11/text.md、g1/u2/14/text.md、g1/u2/15/index.md 中损坏的 PDF 链接（链接目标与文件名不匹配、URL 编码错误等）

关键决策

• 软链接命名：最终采用 原名_注释（下划线），验证脚本正则已同步更新
• PDF 移入 /pdf 后原始目录下 PDF 全部删除（git rm），由 markdown 中的 /pdf/ 绝对链接引用
• g1/u1-u6 的 fc.md 替代 index.md 作为主页（删除旧 index.md，重命名 fc.md）

注意事项

• 验证软链接：python3 scripts/validate-symlinks.py（当前 104/104 通过）
• VS Code 排除规则：原始目录通过符号链接访问时，排除路径必须用符号链接名（如 g2_同修/s1_第一阶段/dcd/），而非原始名
• _config.yml 用 glob 模式排除软链接防止 Jekyll 重复 URL
• assets/script.js 面包屑导航 Rename 字典键名为 u01~u10

对话记录 (2026-08-15)

目标

• 修正课程目录链接混乱：index.md（辅助材料）中”阅读正文”的链接未指向 text.md（法义正文），text.md 中”辅助材料”链接指向不存在的 fc 页面。

已完成

• g1 系列 19 个 index.md：正文链接 ](.) → ](text)
• g1 系列 15 个 text.md：辅助材料链接 ](fc) → ](.)
• g2 六个目录结构重组（index.md=正文 → text.md，fc.md=辅助材料 → index.md）：g2/s1/02、g2/s1/03、g2/s1/05、g2/s2/01、g2/s2/02、g2/s2/03
• _ 开头文件改名发布（Jekyll 不处理下划线文件）：g2/s1/02/_note.md→note.md、_share.md→share.md、g2/s1/03/_map.md→map.md、_note.md→note.md、g1/u3/21/_map.md→map.md、g1/u3/22/_佛教的财富观/map.md→map.md（移出下划线目录）
• g1/u3/19/_菩提导航攻略/ 拆解：faq.md、map.md 移至顶层发布，删除重复的 index.md
• 资源链接全面改写：/pdf/... → /assets/...（assets/g1、assets/g2 实为资源目录，已从 _config.yml exclude 移除）；相对 mp3/jpg 链接改为 /assets/ 绝对路径
• 修复各类死链：g1/u2/07（正文/辅助材料链接）、g1/u1/04（share 死链）、g2/s3/rxl（原文/注释/讲记链接、锚点）、g2/s1/dcd（原文链接）、g2/s1/index.md（01/04 课内容缺失，去链接标注”内容待补充”）、g2/s1/szyds（删 PDF 死链）
• 删除 macOS AppleDouble 垃圾文件（._text.md 等）

关键决策

• 资源实际存放在 assets/g1/、assets/g2/（约 1.1G，被 .gitignore 忽略，不入 git）；部署到 GitHub Pages 时这些资源不会随仓库发布，需另行处理
• g2/s2/bf/NN（index.md=讲记正文，无辅助材料）、g2/s3/rxl/NN、g2/s2/bxdzp/06/12、g2/s1/06（index.md=辅助材料，缺 text.md）等目录保持现状，未强行重构

注意事项

• 全站相对链接检查：python3 /tmp/check_links2.py（当前 576 个链接 0 坏链）
• 2026-08-15 推送：远程旧历史（1GB）无法 fetch 合并，经用户确认 squash 为单提交 66f70f9 后 force push 覆盖远程 main；原 36 个提交历史保留在本地 backup-main 分支
• 推送认证：本机使用 SSH key（~/.ssh/id_ed25519），origin 为 git@github.com:mindfulpeace/mindfulpeace.github.io.git

  已完成（text.md 头部规范化）

• 122 个 text.md 在标题后统一加 > _修学前请先阅读【[辅助材料](.)】_
• 8 个有 assets 资源的课程补 > _相关下载：_ 下载列表；例外：bxdzp/05/text.md（空文件）、rxl/35-test（测试残留无 index.md）
• 强调符号统一 _、辅助材料链接相对化 (.)、下载文字规范化；修复 u2/11 之三 mp3 链接
• 提交 f39757d（未推送）

  已完成（index.md 学一学规范化）

• 32 个有 text.md 的课程 index.md：## 学一学 后加 > _参考阅读:【[法义](text)】_ + > _相关下载：_（按 assets 资源）；去除学一学/记一记内联链接（保留文字）
• 未处理 21 个无 text.md 的 index.md（单元页/实践课，无法义页可引）
• 提交 0ca72ee（未推送）

  已完成（index.md 下载块全覆盖 + bf 重构）

• 53 个含 ## 学一学 的 index.md：已处理的 32 个补”无资料”下载块（8 个无资源）；21 个无 text.md 的加”相关下载：无资料”块 + 去除学一学/记一记内联链接（含 u2/15、u2/18、u3/19 顶部块文件）
• g2/s2/03（## 修学内容）：加参考阅读法义 + 下载块（2 资源）
• 其他辅助材料约 160 个（dcd/rxl/szyds/bxdzp/g2/s1-05-06 等，用【观听内容】【修学内容】【阅读内容】结构，含纯文本标题的 rxl）在观听/修学/阅读内容后加”相关下载：无资料”块
• g2/s2/bf/01-23 重构：index.md（讲记正文）→ text.md，生成新辅助材料 index.md（学一学 + 参考阅读法义 + 无资料下载）
• 例外：g1/u6/46/index.md（HTML 重定向页）、g2/s2/bxdzp/03/index.md（空文件）、g2/s2/bf/explain/index.md（讲记目录页）保持原样
• 本轮改动未提交 git（用户决定提交时机）

语言偏好

• 与用户交流一律使用简体中文

开发与运行

• 本地开发：bundle exec jekyll serve，默认地址 http://localhost:4000
• 当前站内链接用绝对路径（如 /g2/s1/）而非锚点

项目结构说明

• 三级修学：g1 同喜班 / g2 同修班 / g3 同德班
• g2/s1/dcd/ = 《菩提道次第略论》77 课，分 10 个章节板块
• 每课统一格式：index.md（学修导航）+ text.md（法义）+ origin.md（原文）