夜雨聆风AI 编程正在经历一次关键跃迁：从"逐行补全"到"全局理解"。
过去一年，智能体模式的成熟让开发者可以用自然语言驱动代码生成、重构甚至跨文件修改。但当我们把 AI 编程工具放到真实的工程场景中，一个核心瓶颈越来越明显——AI 对你代码库的理解，远没有你以为的那么深。
你描述了一个跨模块的需求，AI 去读了几个文件，但它不清楚你的架构分层逻辑；你让它修复一个 bug，它找到了报错的函数，但不知道上游调用链路是什么。问题的本质不是模型不够强，而是模型缺少一份关于"你的代码库到底是什么"的系统认知。
上下文窗口在增长，但代码库的复杂度增长得更快。一个中型项目几千个文件、数十万行代码，哪怕 200K token 的上下文窗口也不可能一次性装下。而碎片化地"看几个文件"，永远无法替代对整个代码库的结构性理解。
这正是灵码推出 Repo Wiki 的出发点。
01
什么是 Repo Wiki
Repo Wiki 为你的项目自动生成一份结构化的知识文档——不是简单的代码注释汇总，而是一份覆盖模块关系、接口定义、实现逻辑的"代码库百科全书"。更重要的是，它不是一份静态文档，而是随代码持续更新的活知识。
你可以把它理解为：给 AI 装上了一个关于你代码库的长期记忆。
当你在开发过程中查询知识点、请求代码解释、添加新功能时，灵码智能体会优先从 Repo Wiki 中获取项目上下文——模块之间怎么通信、某个接口的设计意图是什么、数据流从哪里进到哪里出。这使得智能体的回答和代码生成不再是"通用的"，而是真正贴合你项目的。
02
为什么 Repo Wiki 会改变你的 AI 编程体验
智能体终于"看见"了全貌
在没有 Repo Wiki 的情况下，智能体面对一个请求，只能通过索引匹配、文件搜索等方式碎片化地获取信息。它看到的是若干棵"树"，而不是"森林"。
有了 Repo Wiki，智能体在处理任何任务之前，就已经具备了对项目结构和模块关系的全局认知。当你问"哪些服务依赖了这个模块？"或者"这个 API 的认证逻辑是在哪里实现的？"——智能体几乎不需要额外的文件检索，就能快速给出准确答案。
这不是"搜索能力的提升"，而是"认知维度的跃升"。
复杂任务的准确率显著提升
对于简单的代码补全，上下文窗口已经够用。但当任务涉及跨文件的功能开发、依赖关系梳理、架构层面的重构——智能体需要理解的信息远超单次对话能承载的范围。
Repo Wiki 扮演的角色，类似于一位新加入团队的工程师在阅读完内部技术文档后获得的认知。它让智能体在执行以下任务时表现得更加稳健：
添加新功能：理解现有模块划分和接口契约，避免重复造轮子或破坏封装
修复漏洞：快速追溯调用链路和数据流向，定位真正的问题根因
重构优化：基于全局依赖关系做出合理的重构决策，而非局部最优
代码审查辅助：结合架构设计意图评估变更的合理性
文档与代码，自动保持同步
传统技术文档最大的痛点是什么？写完就过时。代码在不断演进，但文档永远停在上次有人愿意更新它的那个版本。
Repo Wiki 的更新机制设计得很克制，但恰到好处：
初次生成——打开项目后一键生成，系统会分析整个代码库的结构，自动产出结构化文档。以一个包含 4,000 个文件的仓库为例，完整生成约需 120 分钟。
增量更新——当你修改了已被 Wiki 记录的内容（函数签名、类定义、API 端点等），系统会检测到代码与文档的不一致，你只需点击"更新"即可重新生成受影响的部分，而非重新跑一遍全量生成。
Git 目录同步——如果你在 Git 目录中直接编辑了 Wiki 的 Markdown 文件，系统同样能检测到差异并支持一键同步。
这意味着你的代码库知识始终是"活的"。
03
团队协作：Wiki 共享
Repo Wiki 不只是个人工具。当你在本地生成 Wiki 后，系统会在代码仓库中创建一个专用目录：.lingma/repowiki。
你可以将这个目录提交到远程分支。团队其他成员通过 git pull即可获得完整的 Wiki 内容——无需额外配置、无需每人重新生成。一个人生成，整个团队受益。
对于团队来说，这意味着：
新成员 onboarding 时，不再只靠"口口相传"和散落各处的旧文档，而是有一份与代码实时同步的结构化知识库；
Code Review 时，评审者可以快速理解某个模块的设计背景和依赖关系，而不是逐文件地"考古"；
智能体在团队任何一个人的 IDE 中，都具备相同深度的代码库认知。
04
多语言支持
Wiki 系统支持多语言生成。目前支持 English 和中文——你可以在生成时选择首选语言，系统会在 Git 目录下为每种语言创建独立目录（例如 repowiki/zh/、repowiki/en/）。
对于国际化团队或面向多语言社区的开源项目，这是一个实用的能力。
05
如何开始使用
Step 1：生成 Wiki
在灵码的智能体模式中打开你的项目，首次进入时系统会提示你生成 Repo Wiki。点击即可启动全量生成。
注意：项目文件数量上限为 10,000 个。如果你的项目超过这个规模，建议在灵码设置 → 代码库索引 → 索引排除中，排除 node_modules、build、dist等非核心路径。
Step 2：保持更新
当你的代码发生变更后，留意 Wiki 区域的更新提示。点击"更新"即可让 Wiki 与代码保持同步。增量更新只处理变更部分，速度很快。
Step 3：Git 目录同步
如果你直接在 Git 目录中编辑 Markdown 文件，系统会检测到 Git 内容与 Wiki 不一致。你可以点击同步将 Git 中的变更同步并更新 Wiki。
请不要编辑 Git 文件 repowiki/…/meta——这可能导致 Wiki 无法加载。该文件由系统自动管理。
Step 4（可选）：共享给团队
我们支持 Wiki 共享，助力团队内的知识更高效流动。当你在本地生成 Wiki 时，系统会在代码仓库中自动创建一个专用目录：.lingma/repowiki。
你可以将该目录提交并推送到远程分支。团队成员随后可通过 git pull拉取生成的 Wiki 内容——无需额外配置。
什么项目适合用 Repo Wiki
强烈推荐：
✅ 中大型项目（文件数 > 100），模块关系复杂，新人上手周期长
✅ 多人协作项目，需要频繁理解他人代码
✅ 长期维护的项目，代码历史长、架构演进多
✅ 需要让智能体辅助开发的项目——Wiki 是智能体深度理解代码库的基础设施
开始体验
Repo Wiki 目前处于 Beta 阶段，面向企业标准版和企业专属版用户提供免费体验额度。
如果你正在使用灵码的智能体模式，现在就可以为你的项目生成第一份 Repo Wiki——让 AI 真正理解你的代码，而不只是看到代码。
