使用场景
- 架构与实现相关查询
智能体凭借预构建的架构知识，几乎无需调用工具，即可快速解答诸如“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 仓库且至少包含一次提交。
干预 Wiki 生成
Repo Wiki 不是”一次生成后只读”的产物。你可以在生成前通过配置文件引导方向，也可以在生成后随时修改。团队对知识的每一次修订，都会被系统识别为新的认知沉淀，不会被下一次自动更新覆盖，而是反向同步到对应的知识卡片中——真正把人的判断写进了知识资产。/knowledge 命令
在对话框中输入/knowledge，可对 Repo Wiki 和知识卡片进行干预：
使用方式：
- 在输入框中唤起
/knowledge - 输入指令，描述需要的变更内容
- 可配合上传本地文件作为参考（如设计文档、API 文档等）
- Agent 会根据指令修改对应的知识内容
wiki_plan.yaml — 前置干预配置
通过配置文件，可以在 Wiki 生成前注入引导意图，控制生成方向和范围。 在对话框中输入/knowledge-plan 命令即可创建或编辑 wiki_plan.yaml 前置干预配置文件，控制 Wiki 与知识卡片的生成策略。
示例：
修改
wiki_plan.yaml 后，需手动触发「生成」或「重新生成」才会生效。Repo Wiki 共享
支持 Wiki 共享，助力团队内的知识更高效流动。 团队管理员在 Web 控制台开启知识引擎开关后，团队中任何成员生成的 Repo Wiki 都会自动同步至团队。其他成员打开相同仓库的相同分支，点击生成即可自动获取团队最新知识——无需手动拉取。团队成员对该项目知识的任何变更，都会同步更新至所有人，确保团队知识始终保持一致且最新。 当在本地生成 Wiki 时，系统会在代码仓库中自动创建一个专用目录：.qoder/repowiki。
git pull 拉取生成的 Wiki 内容——无需额外配置。
多语言支持
Wiki 系统支持多语言——你可以在生成 Wiki 时选择首选语言。目前支持 English 和 中文。 在生成 Wiki 时，系统会根据你的语言选择，在 Git 目录下为每种选定的语言自动创建独立目录（例如repowiki/zh/、repowiki/en/）。