Skip to main content
知识中心

Repo Wiki

Repo Wiki 会为你的项目自动生成结构化文档，并持续跟踪代码与文档的变更。 当你在开发过程中查询知识点、代码解释、增加功能特性时，Repo Wiki 会深入分析项目结构和代码实现，结合 Repo Wiki 与上下文信息，给出更准确、详细的解答和文档支持，并且让智能体具备更深入代码库认知。
Repo Wiki

使用场景

  • 架构与实现相关查询
    智能体凭借预构建的架构知识，几乎无需调用工具，即可快速解答诸如“X 是如何实现的？”或“哪些服务依赖此模块？”之类的问题。
  • 智能体驱动的开发任务
    在上下文宽度受限时，Repo Wiki 可加速代码定位，支持以下任务：
    • 添加新功能
    • 修复漏洞

Repo Wiki 生成

仓库中的 Wiki 不是静态的——它会与代码保持同步。 Wiki 会在三种关键情况下更新。了解它们的触发时机与原因，有助于你保持 Wiki 的实时更新。
  1. 初次生成 Wiki 当你首次打开项目时，默认不存在 Wiki。你可以一键从零生成。
  2. 检测到代码变更 初次生成后，系统会持续监控代码的变更。 如果你修改了已被 Wiki 记录的内容（例如函数签名、类定义、API 端点），系统会检测到当前代码与现有 Wiki 的不一致。你可以点击 更新 仅重新生成受影响的部分。
  3. Git 目录同步 如果你直接在 Git 目录中编辑 Markdown 文件，系统会检测到 Git 内容与 Wiki 不一致。你可以点击 同步 将 Git 中的变更同步并更新 Wiki。
  4. 生成限制
    • 每个项目最多 10,000 个文件。如果项目包含超过 10,000 个文件，建议在 Qoder CN 设置 → 代码库索引 → 索引排除 中排除非必要路径。
    • 仅支持 Git 仓库且至少包含一次提交。

干预 Wiki 生成

Repo Wiki 不是"一次生成后只读"的产物。你可以在生成前通过配置文件引导方向，也可以在生成后随时修改。团队对知识的每一次修订，都会被系统识别为新的认知沉淀，不会被下一次自动更新覆盖，而是反向同步到对应的知识卡片中——真正把人的判断写进了知识资产。

/knowledge 命令

在对话框中输入 /knowledge，可对 Repo Wiki 和知识卡片进行干预：
操作说明
生成首次为项目生成 Wiki 或知识卡片
修改对已有知识内容进行局部修改
补充向已有知识中追加新内容
重写完全重写某个知识页面或卡片
使用方式：
  1. 在输入框中唤起 /knowledge
  2. 输入指令，描述需要的变更内容
  3. 可配合上传本地文件作为参考（如设计文档、API 文档等）
  4. Agent 会根据指令修改对应的知识内容
人工修改的内容会被系统标记和保护——下次自动更新时不会被覆盖，让团队的每一次知识修订都成为持久的知识资产。

wiki_plan.yaml — 前置干预配置

通过配置文件，可以在 Wiki 生成前注入引导意图，控制生成方向和范围。 在对话框中输入 /knowledge-plan 命令即可创建或编辑 wiki_plan.yaml 前置干预配置文件，控制 Wiki 与知识卡片的生成策略。
/knowledge-plan 命令
wiki_plan.yaml 前置干预配置
 文件位置： 
<项目根目录>/.qoder/repowiki/wiki_plan.yaml
该文件随 Git 提交共享给团队。 配置结构： 
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 同步的方式管理知识。
团队共享同步的是已生成的 Wiki 文档内容，不涉及源代码本身的上传。
当在本地生成 Wiki 时，系统会在代码仓库中自动创建一个专用目录：.qoder/repowiki。
Wiki 共享
 你可以将该目录提交并推送到远程分支。团队成员随后可通过 git pull 拉取生成的 Wiki 内容——无需额外配置。

多语言支持

Wiki 系统支持多语言——你可以在生成 Wiki 时选择首选语言。目前支持 English 和 中文。 在生成 Wiki 时，系统会根据你的语言选择，在 Git 目录下为每种选定的语言自动创建独立目录（例如 repowiki/zh/、repowiki/en/）。

计费

生成和更新会正常消耗 Credits，可去用量详情-Credits中查看消耗记录。

数据安全

Repo Wiki 在你的本地客户端完成生成：会在本地启动多个 Agent，进行任务规划、代码检索、文档结构规划等工作。Agent 只会根据任务需要读取仓库中的必要文件。
  • 不上传全量代码：不会在生成过程中将完整代码库上传到云端。
  • 不在服务端留存：也不会在服务端存储你的代码，生成结果仅保存在你的本地仓库中。
  • 默认关闭：Repo Wiki 功能默认关闭，需你主动开启；自动增量更新也可自行选择开启或关闭。
产品概述
快速入门
用户指南
上下文
扩展能力
配置
服务支持