Repo Wiki - Qoder - 程序猿·D·安宇雨 DeepMind

Repo Wiki - Qoder

安宇雨 - 随手采集
2026-09-12 12:02:54
随手采集
0000-未整理-等待研究

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

Repo Wiki

[

](#%E4%BD%BF%E7%94%A8%E5%9C%BA%E6%99%AF)

使用场景

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

[

](#repo-wiki-%E7%94%9F%E6%88%90)

Repo Wiki 生成

仓库中的 Wiki 不是静态的——它会与代码保持同步。 Wiki 会在三种关键情况下更新。了解它们的触发时机与原因，有助于你保持 Wiki 的实时更新。

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

[

](#%E5%B9%B2%E9%A2%84-wiki-%E7%94%9F%E6%88%90)

干预 Wiki 生成

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

[

](#knowledge-%E5%91%BD%E4%BB%A4)

/knowledge 命令

在对话框中输入 /knowledge，可对 Repo Wiki 和知识卡片进行干预：

操作

说明

生成

首次为项目生成 Wiki 或知识卡片

修改

对已有知识内容进行局部修改

补充

向已有知识中追加新内容

重写

完全重写某个知识页面或卡片

使用方式：

在输入框中唤起 /knowledge
输入指令，描述需要的变更内容
可配合上传本地文件作为参考（如设计文档、API 文档等）
Agent 会根据指令修改对应的知识内容

人工修改的内容会被系统标记和保护——下次自动更新时不会被覆盖，让团队的每一次知识修订都成为持久的知识资产。

[

](#wiki-plan-yaml-%E5%89%8D%E7%BD%AE%E5%B9%B2%E9%A2%84%E9%85%8D%E7%BD%AE)

wiki_plan.yaml — 前置干预配置

通过配置文件，可以在 Wiki 生成前注入引导意图，控制生成方向和范围。在对话框中输入 /knowledge-plan 命令即可创建或编辑 wiki_plan.yaml 前置干预配置文件，控制 Wiki 与知识卡片的生成策略。

/knowledge-plan 命令

文件位置：

Copy

<项目根目录>/.qoder/repowiki/wiki_plan.yaml

该文件随 Git 提交共享给团队。 配置结构：

Copy

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

控制生成时可见的文件范围

示例：

Copy

version: 1

repowiki:
  notes:
    - text: "文档应聚焦业务流程而非代码细节，面向新入职工程师"
  documents:
    - title: "系统架构概览"
      goal: "描述系统整体架构、核心模块及其交互关系"
    - title: "订单系统"
      goal: "说明订单全生命周期"
      parent: "系统架构概览"

knowledgecard:
  notes:
    - text: "重点建模支付和订单两个核心子系统"

scope:
  include:
    - "src/**"
  exclude:
    - "**/test/**"

修改 wiki_plan.yaml 后，需手动触发「生成」或「重新生成」才会生效。

[

](#repo-wiki-%E5%85%B1%E4%BA%AB)

Repo Wiki 共享

支持 Wiki 共享，助力团队内的知识更高效流动。团队管理员在 Web 控制台开启知识中心开关后，团队中任何成员生成的 Repo Wiki 都会自动同步至团队。其他成员打开相同仓库的相同分支，点击生成即可自动获取团队最新知识——无需手动拉取。团队成员对该项目知识的任何变更，都会同步更新至所有人，确保团队知识始终保持一致且最新。

自动团队共享仅 Teams 版本支持，除此以外也可采用 Git 同步的方式管理知识。

当在本地生成 Wiki 时，系统会在代码仓库中自动创建一个专用目录：.qoder/repowiki。

Wiki 共享