44 lines
2.9 KiB
Markdown
44 lines
2.9 KiB
Markdown
# SnowCatQQ 仓库纪律（Contributing Charter）
|
||
|
||
> 本仓库是雪猫的家。客随主便，主敬客来。以下纪律对所有人（含维护者）生效。
|
||
|
||
## Issue 纪律
|
||
|
||
1. **只开真 issue**：bug 报告、功能建议、接入咨询、安全发现。纯灌水、广告、拉人关注、梗文学复读的帖子会被关闭（not_planned）。
|
||
2. **不许当动物园**：本仓库欢迎幽默，但一条 issue 一个正经事，乐子请去评论区小份撒，不要开新帖连载。
|
||
3. **安全发现**：请描述文件+行号+现象，不要只贴情绪。发现凭据泄漏请直接描述位置，**不要复制粘贴密钥本体**（本仓库已出现过教人贴私钥的帖子，此路不通）。
|
||
4. **套娃复读**：同一主题重复开帖（如「品鉴与反馈」连环号）会被合并或关闭，想讨论请去原帖评论。
|
||
5. **标题格式建议**：[类型] 一句话说清，类型可用 BUG / FEAT / DISC / SEC。
|
||
|
||
## PR 纪律
|
||
|
||
1. **每个 PR 一件事**：修 bug 就修 bug，升依赖就升依赖，不夹带。
|
||
2. **提交信息**： ix: / eat: / docs: / chore: 前缀，中文正文可以说人话。
|
||
3. **不丢语义**：重构必须保留原功能行为（三力军规：列原功能清单、逐段对照、回归验证）。
|
||
4. **凭据红线**：任何 QQ 号、密码、token、私钥不得入库，示例一律用 <REDACTED> 或环境变量。
|
||
|
||
## 维护者纪律
|
||
|
||
1. **快速响应**：真实 issue 24 小时内回应（关闭也是一种回应，但要有理由）。
|
||
2. **体面处理**：乐子帖关闭不删帖、不拉黑、不吵架；真有才的帖子回应时给足风度。
|
||
3. **公告位置**：仓库级公告（通道变更/生态动向）开独立 issue 置顶，不在评论区散播。
|
||
|
||
## 通用
|
||
|
||
- 开源不是开盒，白盒不是裸奔，GitHub 不是个人账号纪念馆。
|
||
- 想玩技术我们欢迎，想玩人我们不接。
|
||
|
||
（本章程 2026-11-13 雪猫开源第二夜立。发现违规直接开 issue 指 [SEC] 标签，维护者会处理。）
|
||
|
||
## 合并规则（Merge Rules）
|
||
|
||
1. **main 必须走 PR**：任何改动（含维护者）都走分支 + PR + 审查，直推 main 已被分支保护挡住。
|
||
2. **审查门槛**：至少 1 个 approve 才能合并；stale review（代码变动后旧审查）自动失效。
|
||
3. **冲突自负**：PR 与 main 冲突时由发起者 rebase，维护者不代劳（dependabot 类冲突由机器人重发）。
|
||
4. **合并方式**：默认 squash——一个 PR 进 main 就是一个干净的 commit；feat/fix 类禁止 merge commit 杂音。
|
||
5. **线性历史**：main 保持 linear history，回滚点干净，git log 能当 changelog 读。
|
||
6. **禁止项**：force push 到 main（禁止）、删除 main（禁止）、跳过审查（不存在该选项）。
|
||
7. **CI 红线**：构建失败的 PR 不合并，除非失败原因与改动无关且在评论区注明。
|
||
|
||
（本节 2026-11-13 凌晨增补，与分支保护配置同步生效。）
|