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 仓库且至少包含一次提交。
干预 Wiki 生成
Repo Wiki 不是”一次生成后只读”的产物。你可以在生成前通过配置文件引导方向，也可以在生成后随时修改。团队对知识的每一次修订，都会被系统识别为新的认知沉淀，不会被下一次自动更新覆盖，而是反向同步到对应的知识卡片中——真正把人的判断写进了知识资产。
/knowledge 命令
在对话框中输入 /knowledge，可对 Repo Wiki 和知识卡片进行干预：
| 操作 | 说明 |
|---|
| 生成 | 首次为项目生成 Wiki 或知识卡片 |
| 修改 | 对已有知识内容进行局部修改 |
| 补充 | 向已有知识中追加新内容 |
| 重写 | 完全重写某个知识页面或卡片 |
- 在输入框中唤起
/knowledge
- 输入指令，描述需要的变更内容
- 可配合上传本地文件作为参考（如设计文档、API 文档等）
- Agent 会根据指令修改对应的知识内容
人工修改的内容会被系统标记和保护——下次自动更新时不会被覆盖，让团队的每一次知识修订都成为持久的知识资产。
wiki_plan.yaml — 前置干预配置
通过配置文件，可以在 Wiki 生成前注入引导意图，控制生成方向和范围。
文件位置：
<项目根目录>/.qoder/repowiki/wiki_plan.yaml
version: 1
repowiki:
template: "" # 预制模板（architecture / product_requirement）
notes: # 注入规划阶段的引导提示
- text: "提示文本"
author: "署名"
documents: # 页面白名单（提供时严格按列表输出）
- title: "页面标题"
goal: "该页面的写作意图"
parent: "" # 可选，父页面标题
hints: "" # 可选，额外写作提示
knowledgecard:
notes: # 注入知识卡规划阶段的引导提示
- text: "提示文本"
scope:
include: [] # 文件白名单（.gitignore 语法）
exclude: [] # 文件黑名单（.gitignore 语法）
| 配置项 | 说明 |
|---|
repowiki.template | 预制模板：architecture（全面分析技术架构）或 product_requirement（按产品需求格式输出） |
repowiki.notes | 引导提示，注入规划阶段引导 AI 关注指定重点 |
repowiki.documents | 页面白名单，提供时严格按列表生成对应页面 |
knowledgecard.notes | 知识卡引导提示，影响模块划分方向 |
scope.include / exclude | 控制生成时可见的文件范围 |
version: 1
repowiki:
notes:
- text: "文档应聚焦业务流程而非代码细节，面向新入职工程师"
documents:
- title: "系统架构概览"
goal: "描述系统整体架构、核心模块及其交互关系"
- title: "订单系统"
goal: "说明订单全生命周期"
parent: "系统架构概览"
knowledgecard:
notes:
- text: "重点建模支付和订单两个核心子系统"
scope:
include:
- "src/**"
exclude:
- "**/test/**"
修改 wiki_plan.yaml 后，需手动触发「生成」或「重新生成」才会生效。
Repo Wiki 共享
支持 Wiki 共享，助力团队内的知识更高效流动。
团队管理员在 Web 控制台开启知识引擎开关后，团队中任何成员生成的 Repo Wiki 都会自动同步至团队。其他成员打开相同仓库的相同分支，点击生成即可自动获取团队最新知识——无需手动拉取。团队成员对该项目知识的任何变更，都会同步更新至所有人，确保团队知识始终保持一致且最新。
自动团队共享仅 Teams 版本支持，除此以外也可采用 Git 同步的方式管理知识。
.qoder/repowiki。
你可以将该目录提交并推送到远程分支。团队成员随后可通过 git pull 拉取生成的 Wiki 内容——无需额外配置。
多语言支持
Wiki 系统支持多语言——你可以在生成 Wiki 时选择首选语言。目前支持 English 和 中文。
在生成 Wiki 时，系统会根据你的语言选择，在 Git 目录下为每种选定的语言自动创建独立目录（例如 repowiki/zh/、repowiki/en/）。
生成和更新会正常消耗 Credits，可去用量详情-Credits中查看消耗记录。 
