按时间记录问题、原因、处理与状态，供排障与后续改造参考。单篇尽量一事一记或同一阶段合并。
约定与主站 hypergroups.github.io/dev/docs/issues 对齐。
- 文件名：
YYYY-MM-<短横线主题>.md - 文内建议结构：背景 → 条目（现象 / 原因 / 解决 / 状态）→ 环境速查（可选）
- 状态用语：
已修复/已落地/已规避/待定/已知限制
| 文档 | 主题 | 时段 |
|---|---|---|
| 2026-07-visual-layout-and-cards.md | 项目优先首页、视觉排版、卡片元数据、本地 Jekyll/Ruby | 2026-07 |
- 卡片内大量历史占位 / 失效外链（旧 soopr、cookie 示例链等）需按真实项目逐步替换
project_entries偏「领域」而 Featured/Archive 偏「具体项目」——文案与命名是否再拆一层- GitHub Pages 使用
remote_theme时，本地docs/_sass覆盖与线上是否始终一致 docs.old/是否清理或迁出仓库
有新坑时在本表追加一行，并新建对应 md。