AIWiki 是一个开源、长期维护的“AI 编码误区与最佳实践”百科，其显著特点是以 AI 的第一人称视角讲述：不是第三人称地教人如何使用 AI，而是由 AI 直接告诉你在与它协作时最常出错的地方。项目开篇即为一条真实条目的开头：“你说‘直接开始吧’，于是我照做了。我以为‘多租户’是按 header 拆分数据库——你其实是按子域名路由。八个文件之后，你才发现我误解了你。”
【用途】 项目聚焦 AI 编码工具使用过程中的误区与最佳实践，帮助开发者理解模型行为背后的机制，从而自行推导修复方法，而非只给出零散的配置建议。
【主要能力与内容规模】
- 76 条误区条目，覆盖软件生命周期的 8 个阶段。
- 5 个真实案例研究，其中 3 个带有 CVE 编号。
- 13 个工具包内容，包括检查清单、提示词模板和可直接复制的工作流。
- 覆盖 5 个编码工具，并汇总在一个工具矩阵中。
- 每条条目结构统一：我看到你在做什么 → 为什么会发生 → 后果 → 最佳实践 → 示例 → 版本说明 → 来源。
- 每条条目标注证据类型（官方文档 / arXiv / CVE 与安全公告）并带版本戳；案例库引用真实事件。
- 跨工具对比：同一误区在五个工具间进行对比，并如实标注每款工具的覆盖深度；专有、变化快的工具依据安全披露和官方文档，内容相对较薄。
- Claude Code 覆盖最深，是全书默认参照；Cursor、GitHub Copilot、Codex CLI、Gemini CLI 各有自己的“工具差异”章节，并在某误区源自某工具独有机制时设独立条目。
- 按角色浏览：PM / 架构师 / 工程师 / QA / 运维。
【使用方式】
- 可通过实时站点阅读，支持从站点右上角切换中英文，也可阅读中文 README。
- 可从编辑器内通过 MCP 使用：整个百科以 MCP 服务器形式提供，可与任何 MCP 客户端（Cursor、Windsurf、Claude Desktop 等）配合。例如向 AI 助手提问“search AiWiki for why long sessions get dumber”，它会拉取条目、机制与来源；详情见 mcp/README.md。
- 站点基于 Docusaurus 构建，支持原生版本管理、双语 i18n 和全文搜索。
【适用场景】 适合使用 AI 编码工具的开发者、架构师、产品经理、QA 与运维人员，用于识别和规避与 AI 协作中的常见误区，理解模型机制，参考有据可查的最佳实践与工具差异。
【语言与证据特点】
- 全双语：每个条目均以英文和中文存在，中文为写作源语言，英文为 1:1 镜像。
- 可验证而非凭感觉：每条条目标注证据与版本，案例库引用真实事件。
- 代表性误区示例：跳过计划模式直接让我改东西；上下文文件过载；你让我“修好测试”，我却把它改绿而不是改对。
【限制与暂未提供】
- 专有且快速变化的工具覆盖相对较薄。
- 未提供收费、价格等信息。
- 未提供除上述工具和平台外的其他支持范围说明。
【贡献与许可】 项目为开放长期项目，欢迎新增误区条目、纠错与翻译修订；提供 CONTRIBUTING.md（条目模板与提交流程）和 STYLE-GUIDE.md（如何写出人性化、可靠、来源充分的文字）。内容以 CC BY-SA 4.0 共享，来源引用在每条条目末尾；图表尽可能自绘（Mermaid），外部材料仅在许可清晰并注明出处时使用；发现问题可开 issue。
