feat(cms): 首页四项可配 + 开源页项目可见性 + GitHub README 开篇

- 首页：subtitle（markdown 短文本）｜latestPhotos 0-6（0 隐藏）｜
  perTrackLimit 4-8｜sections{tracks,photos,heatmap,projects} 开关，
  访问器 homeConfig() 夹取越界值，字段级回落默认（零配置=原形态）
- 开源页项目可见性：mode all|only|exclude + include[]/exclude[] +
  sort pinned-first|stars|updated + perSource both|github|gitea；
  projects.ts 加 LoadProjectsOptions + arrange()（来源→可见性→排序）
- 开源页开篇支持 GitHub README：intro_from off|github-readme，构建期
  取 wait4xx/wait4xx README（token 复用宿主 0600 文件）→ 缓存
  content/.github-readme.md 入仓 → renderMarkdown；失败逐级回落
  （缓存 → yaml blurb）。实测取到 3117 字符，现状仍 off 待用户开启
- 修既有 bug：orderPinned 内硬 slice(0,6) 把开源页 limit=99 也截到 6 条
  → 移除，开源页恢复全量 16 条
- 文档：写作指南加首页/项目墙两张字段表（含 YAML 1.1 `off` 需加引号坑、
  README 行为与外部徽章风险说明）

车道：op-gitea（3/3）；收编复验：构建 48 页 + E2E 37/37 + 开源页 16 条 +
首页默认形态（2 轨/热力图/项目墙）无回归

验证: node v26.13.0 构建 48 页 exit 0；E2E 37/37 PASS；playwright 实测

Spec: none (首页与开源页后台扩展，车道级交付)

Co-authored-by: GLM-5.3

docs/写作指南.md

@@ -195,6 +195,33 @@ markdown 原生语法，无需任何配置：
 图标可选 `github / rss / email / bilibili / x`，**留空则显示纯文字按钮**。
 首页名片区、以及任何引用该组件的页面都吃同一份数据（单一事实源，改一次全站生效）。
 
+#### 首页可配项（home.yaml）
+
+| 字段 | 取值 | 默认 | 作用 |
+|---|---|---|---|
+| `subtitle` | `{zh, en}`（markdown 短文本） | 空 | 身份语下方的副标题；留空不渲染 |
+| `latestPhotos` | 0-6 | 4 | 「最新影像」张数；**0 = 隐藏该区块** |
+| `perTrackLimit` | 4-8 | 6 | 首页阅读/技术两轨各显示条数 |
+| `sections` | `{tracks, photos, heatmap, projects}` 布尔 | 全开 | 区块开关，关掉即不渲染 |
+
+越界值会被夹取（如 perTrackLimit=20 按 8 处理），不报错；**全部留空 = 现有形态不变**。
+
+#### 开源页项目墙（opensource.yaml）
+
+| 字段 | 取值 | 默认 | 作用 |
+|---|---|---|---|
+| `mode` | `all` / `only` / `exclude` | all | 可见性模式 |
+| `include` | 仓短名数组 | 空 | mode=only 时的白名单 |
+| `exclude` | 仓短名数组 | 空 | mode=exclude 时的黑名单 |
+| `sort` | `pinned-first` / `stars` / `updated` | pinned-first | 排序方式 |
+| `perSource` | `both` / `github` / `gitea` | both | 来源过滤 |
+| `intro_from` | `"off"` / `github-readme` | off | 开篇文案来源 |
+
+> `intro_from` 建议**带引号写**：YAML 1.1 里裸 `off` 会被解析成布尔 false。
+> 选 `github-readme` 时构建期取 `wait4xx/wait4xx` 的 README 渲染为开篇，
+> 成功后缓存到 `content/.github-readme.md`（入仓）；token 缺位/取失败/仓无 README
+> 都会打印日志并回落 yaml 的 blurb。注意 README 里的相对链接与外部徽章会原样输出。
+
 #### 首页文章列表
 
 首页现在分两段：**阅读轨 6 条 + 技术轨 6 条**（各自带「全部文章」出口：阅读→书架、技术→归档）。