# 贡献指南

本仓是发行库，不是写作工场。新卡默认先在私有知识库写完、过完边界和引用，再迁到这里。

## 现阶段接受什么

- 事实纠错（公式、口径、过期的框架参数）
- 补可公开复核的引用（论文、官方文档、厂商实测，写明档期）
- 补「什么时候不要用」和失败模式
- 主干路径上的笔误、断链、编号漂移

## 现阶段不接受什么

- 一次性提交大量新卡
- 没有边界说明、会和已有卡撞车的新主题
- 把构造的「示例场景」写成真实大厂结论
- 付费课原文、采集稿、未授权的源码还原
- 面试速成、刷题清单

## 一张卡怎样才算可合并

1. 标题能单独转发，不依赖仓库里的其它上下文才能看懂。
2. 开头写清：层级（原理 / 应用 / 生产）、难度（GUIDE / DEEP）、前置卡、后续卡。
3. 正文区分「示例场景」和「引用来源数据」。
4. 至少有一个明确的反例或关闭条件。
5. 不引入站点门禁、登录、统计脚本或密钥。

Issue 里说明「哪张卡、哪一段、为什么错、依据是什么」会比直接开超大 PR 更容易被处理。