SnowCatQQ/CHARTER.md

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、私钥不得入库，示例一律用 或环境变量。

维护者纪律

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