维护者运行手册（低负担）
面向 Maintainer / Triager / Founder：用规则与自动化减少重复劳动，把 Founder 精力集中在高影响变更与发版。
1. 设计原则
| 原则 | 做法 |
|---|---|
| 公开优先 | 使用类问题 → Discussions；可跟踪缺陷 → Issue |
| 机器先行 | CI、Labeler、Dependabot、Stale 处理常规事务 |
| 域内自治 | docs/user-guide/**、单主题目录 PR 由文档/主题维护者合并 |
| 守门聚焦 | Founder 主要 Review CODEOWNERS 路径（lib/db、next.config.js、package.json 等） |
2. 每周约 15 分钟（Maintainer）
- 浏览 Discussions：
组织成员申请、未回复的「使用问答」。 - 扫一眼 Dependabot PR（可批量合并 patch/dev 依赖）。
- 合并队列：优先
documentation/good first issue且 CI 全绿 的 PR。 - 仅在发版窗口处理
package.json版本与 changelog。
Founder 可跳过第 3 步中纯文档 PR（若已授权文档维护者）。
3. Issue / Discussion 分流
| 用户诉求 | 动作 | 管理者耗时 |
|---|---|---|
| 「怎么部署/配置」 | 转 Discussions，关 Issue 或贴链接 | 1 条评论 |
| 重复 Issue | 关为 duplicate，链到已有 | 1 条评论 |
| 缺版本/环境信息 | 贴 bug 模板 要求补全，标 needs-info | 1 条评论 |
| 长期无回复 | 交给 Stale bot（45+14 天） | 0 |
| 安全漏洞 | 转 Private Advisory，勿公开讨论 | 按 SECURITY.md |
4. PR 合并权限（建议）
| PR 类型 | 标签/路径 | 谁合并 | CI 要求 |
|---|---|---|---|
| 纯文档 | documentation、docs/** | 任一 Write 维护者 | docs-site job |
| 单主题 | theme、themes/<name>/** | 主题维护者或 Write | lint + test |
| 依赖机器人 | dependencies | 维护者批量 | CI 绿 |
| 核心 / 配置 | core、config、CODEOWNERS | Founder 或 2 人 Review | 全部 job |
禁止：未跑 CI 合并、Contributor 自合并自己的 PR（除非维护者明确授权）。
5. 自动化一览
| 工具 | 作用 |
|---|---|
| ci.yml | PR：lint、type-check、test、lockfile、文档构建 |
| labeler.yml | 按路径打 documentation / theme / core 等标签 |
| dependabot.yml | 每周依赖 PR（默认跳过 major） |
| stale.yml | 45 天无活动标 stale，14 天后关闭 Issue |
| deploy-docs-site.yml | main 文档自动发布 |
| CODEOWNERS | 仅高影响路径 @Founder |
6. Org Admin 一次性设置（合规 + 省力）
在 GOVERNANCE.zh-CN.md 基础上建议：
- [ ] Require status checks：
Lint & type-check、Unit tests、Lockfile consistency（文档 PR 可加VitePress build） - [ ] Require PR 进
main（Founder 亦走 PR，紧急 hotfix 例外并公告） - [ ] Allow auto-merge（可选）：仅对 CI 绿且仅改
docs/**的 PR 启用 - [ ] Secret scanning + Dependabot alerts 开启
- [ ] 仓库标签与 labeler.yml 一致：
documentation、theme、core、config、dependencies、stale、needs-info、good first issue、help wanted - [ ] Issue 模板勿默认 assign 给 Founder（已移除
assignees）
7. 发版（低频）
- 确认
mainCI 绿。 - 更新
docs/user-guide/changelog/latest.md。 - 由 Org Admin 打 tag / Release，或运行
bump-version-on-main（仅维护者）。 - Discussion 公告 一条即可。