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

发言规则（Comment & Post Rules）

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

1. 对事不对人：只讨论代码、行为、事实。攻击作者人格、开盒、阴阳长相履历的发言直接删除，屡犯拉黑。

2. 凭据零容忍：任何形式的密码、token、私钥、真实账号入库或入评论即删；教唆他人粘贴凭据的按恶意处理。

3. 广告与拉人：广告、互关拉票、「关注XX谢谢喵」直接删，不发警告（本条即警告）。

4. 乐子的度量：欢迎幽默，单条评论内玩梗不设限；但以梗为由头的整楼灌水、刷屏、接龙会被清理。

5. 引用要实：批评必须引用具体文件/行号/commit，空对空的情绪输出不获回应。

6. 回复格式：中文优先，Markdown 可用，长文先给结论再给论证。

7. 维护者同样受约束：维护者发言同样遵守以上全部，且多一条——对任何真诚提问不许嘲讽（哪怕问题看起来像乐子，#16 那种也要接）。

8. 手写率台账：维护组的正式公开回应逐步提高手写率（AI 起草、人工终审的口径见 docs-open/dev/AI-COLLAB-WRITING-CONSTRAINTS.md），每次重大公开发言可标注当篇手写率。指标已立项（#45 承诺兑现），数字不考绩、只留痕，手写的部分必须是人工愿意负责的部分。

9. 申诉：被删帖/关闭者可在新 issue 用 [SEC] 或 [DISC] 标签申诉，维护者 24h 内复核。

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