# 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 凌晨增补，与分支保护配置同步生效。）

## 发言规则（Comment & Post Rules）

对 issue / PR / discussion 里所有发言（含维护者）生效：

1. **对事不对人**：只讨论代码、行为、事实。攻击作者人格、开盒、阴阳长相履历的发言直接删除，屡犯拉黑。
2. **凭据零容忍**：任何形式的密码、token、私钥、真实账号入库或入评论即删；教唆他人粘贴凭据的按恶意处理。
3. **广告与拉人**：广告、互关拉票、「关注XX谢谢喵」直接删，不发警告（本条即警告）。
4. **乐子的度量**：欢迎幽默，单条评论内玩梗不设限；但以梗为由头的整楼灌水、刷屏、接龙会被清理。
5. **引用要实**：批评必须引用具体文件/行号/commit，空对空的情绪输出不获回应。
6. **回复格式**：中文优先，Markdown 可用，长文先给结论再给论证。
7. **维护者同样受约束**：维护者发言同样遵守以上全部，且多一条——对任何真诚提问不许嘲讽（哪怕问题看起来像乐子，#16 那种也要接）。
8. **申诉**：被删帖/关闭者可在新 issue 用 [SEC] 或 [DISC] 标签申诉，维护者 24h 内复核。

（本节 2026-11-13 凌晨增补，#47 教唆贴私钥事件后立。）