Repo Wiki 会为你的项目自动生成结构化文档,并持续跟踪代码与文档的变更。
当你在开发过程中查询知识点、代码解释、增加功能特性时,Repo Wiki 会深入分析项目结构和代码实现,结合 Repo Wiki 与上下文信息,给出更准确、详细的解答和文档支持,并且让智能体具备更深入代码库认知。
使用场景
-
架构与实现相关查询
智能体凭借预构建的架构知识,几乎无需调用工具,即可快速解答诸如“X 是如何实现的?”或“哪些服务依赖此模块?”之类的问题。
-
智能体驱动的开发任务
在上下文宽度受限时,Repo Wiki 可加速代码定位,支持以下任务:
Repo Wiki 生成
仓库中的 Wiki 不是静态的——它会与代码保持同步。
Wiki 会在三种关键情况下更新。了解它们的触发时机与原因,有助于你保持 Wiki 的实时更新。
-
初次生成 Wiki
当你首次打开项目时,默认不存在 Wiki。你可以一键从零生成。
-
检测到代码变更
初次生成后,系统会持续监控代码的变更。
如果你修改了已被 Wiki 记录的内容(例如函数签名、类定义、API 端点),系统会检测到当前代码与现有 Wiki 的不一致。你可以点击 更新 仅重新生成受影响的部分。
-
Git 目录同步
如果你直接在 Git 目录中编辑 Markdown 文件,系统会检测到 Git 内容与 Wiki 不一致。你可以点击 同步 将 Git 中的变更同步并更新 Wiki。
-
生成限制
- 每个项目最多 10,000 个文件。如果项目包含超过 10,000 个文件,建议在 Qoder 设置 → 代码库索引 → 索引排除 中排除非必要路径。
- 仅支持 Git 仓库且至少包含一次提交。
Repo Wiki 共享
支持 Wiki 共享,助力团队内的知识更高效流动。
团队管理员在 Web 控制台开启知识引擎开关后,团队中任何成员生成的 Repo Wiki 都会自动同步至团队。其他成员打开相同仓库的相同分支,点击生成即可自动获取团队最新知识——无需手动拉取。团队成员对该项目知识的任何变更,都会同步更新至所有人,确保团队知识始终保持一致且最新。
自动团队共享仅 Teams 版本支持,除此以外也可采用 Git 同步的方式管理知识。
当在本地生成 Wiki 时,系统会在代码仓库中自动创建一个专用目录:.qoder/repowiki。
你可以将该目录提交并推送到远程分支。团队成员随后可通过 git pull 拉取生成的 Wiki 内容——无需额外配置。
多语言支持
Wiki 系统支持多语言——你可以在生成 Wiki 时选择首选语言。目前支持 English 和 中文。
在生成 Wiki 时,系统会根据你的语言选择,在 Git 目录下为每种选定的语言自动创建独立目录(例如 repowiki/zh/、repowiki/en/)。
生成和更新会正常消耗 Credits,可去用量详情-Credits中查看消耗记录。