Skip to main content

知识卡片

知识卡片与 Repo Wiki 同步生成,是从代码中提炼的高密度知识单元。它以 Agent 易于直接消费的形式,存储架构文档、代码规约(Spec)和技术栈信息,并在每次 commit 过程中持续追踪代码变更,始终保持知识的实时性与准确性。
知识卡片

使用场景

  • 架构文档驱动的系统理解:Agent 基于预构建的架构文档,无需反复检索代码库,即可快速回答「该模块的整体设计思路是什么?」或「各服务之间的依赖关系如何?」之类的问题。
  • 代码规约(Spec)指导下的开发任务:当需要确保代码风格、接口设计或业务逻辑符合团队规范时,Agent 可直接参照规约知识作出判断,支持以下场景:
    • 新增功能时自动对齐命名规范与接口约定
    • 代码审查时快速核查实现是否符合规约要求
    • 修复漏洞时识别违反规约的潜在风险点
  • 技术栈知识加速技术决策:Agent 结合预置的技术栈信息,在上下文受限或跨语言/框架场景下高效支持以下任务:
    • 评估引入新依赖的兼容性
    • 生成符合当前技术栈风格的代码片段
    • 解答「当前项目使用了哪些框架及版本?」等技术环境类问题

知识卡片类型

  • 架构文档 记录模块的整体设计思路、服务依赖关系和关键决策,帮助 Agent 在无需逐行阅读代码的情况下理解系统全貌。
  • 代码规约(Spec) 沉淀团队的编码标准、命名规范、接口约定和业务逻辑约束,确保 Agent 在生成代码时与团队规范自动对齐。
  • 技术栈 记录项目所用的框架、库及版本信息,帮助 Agent 在引入新依赖或生成代码片段时,做出符合当前技术环境的决策。

知识卡片生成

建议选中主分支及核心开发分支进行生成,以覆盖项目的核心内容。生成过程中,已完成的卡片可实时预览,无需等待全部完成。
生成建议:优先在主分支(main / master)和团队常用的开发分支上生成知识卡片,以确保 Agent 能理解最核心的业务逻辑和代码结构。

修改已生成的知识

知识卡片生成后,你可以在输入框中通过 /knowledge 命令对已有知识进行人工干预修改。输入指令描述你希望的变更,或配合上传本地文件作为参考,即可更新知识卡片的内容。
修改知识

共享与多语言知识

支持知识卡片共享,助力团队内的知识更高效流动。 团队管理员在 Web 控制台开启知识中心开关后,团队中任何成员生成的知识卡片都会自动同步至团队。其他成员打开相同仓库的相同分支,点击生成即可自动获取团队最新知识——无需手动拉取。团队成员对该项目知识的任何变更,都会同步更新至所有人,确保团队知识始终保持一致且最新。
自动团队共享仅 Teams 版本支持,除此以外也可采用 Git 同步的方式管理知识。
知识卡片导出后保存在项目根目录下的 .qoder/repowiki/knowledge/ 中。你可以将该目录提交并推送到远程分支。团队成员随后可通过 git pull 获取知识卡片文件,再执行导入。 此外,知识卡片支持多语言。你可以在生成时选择首选语言(目前支持 English 和 中文)。导出文件按语言保存在 .qoder/repowiki/knowledge/zh/ 或 .qoder/repowiki/knowledge/en/。

知识卡片导入与导出

在知识卡片概览页的**更多(…)**菜单中,可以导入或导出知识卡片,便于备份和团队共享。
  • 导出到 .qoder/repowiki:将当前分支、当前语言的知识卡片保存到项目根目录下的 .qoder/repowiki/knowledge/,按语言存放在 zh/ 或 en/ 子目录中。开启自动导出后,生成或更新完成时会自动导出。
  • 导入自 .qoder/repowiki:从项目根目录下的 .qoder/repowiki/knowledge/ 中读取对应语言子目录里的知识卡片,同步到 IDE。通过 Git 拉取或手动修改卡片文件后,可执行导入。
知识卡片保存在 .qoder/repowiki/knowledge/ 中,与 Wiki 页面分开存放。共享或迁移时,请保留知识卡片目录中的 Markdown 文件和 YAML 配置。导入会替换对应分支、语言下的知识卡片;导出会覆盖对应语言目录,手动修改文件后请先导入。

计费

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