Skip to main content

知识卡片

提炼项目架构、代码规约与技术栈,供 Qoder 在任务中引用。

知识卡片是从代码库中提炼的高密度知识单元,与 Repo Wiki 共同为 Qoder 提供项目上下文。它记录架构设计、代码规约和技术栈信息,帮助智能体理解项目、编写代码和排查问题。

知识卡片类型

  • 架构文档:记录模块结构、服务依赖和设计决策,帮助理解系统架构与改动影响。
  • 代码规约(Spec):沉淀命名规范、接口约定和业务约束,供开发、代码审查和问题修复时参考。
  • 技术栈:记录项目所用的框架、库及版本信息,辅助依赖选择和代码实现。

生成与查看

  1. 在侧栏打开更多,选择 Repo Wiki,并打开目标代码仓库。
  2. 切换到知识卡片视图,在语言中选择 English 或简体中文。
  3. 检查自动更新、自动导出和智能体引用选项,选择生成。
  4. 在左侧搜索或选择知识卡片,在右侧查看详情。
建议在主分支或团队常用的开发分支上生成。开启自动更新后,代码变更时会自动增量更新知识卡片。 代码提交后,可按页面提示更新受影响的知识卡片。更新时查看进度;需要中断时暂停,之后继续。失败后按提示重试;只有需要整体重建时才选择重新生成。自动更新依赖 Git 提交差异,并遵循当前账号与组织策略。
Qoder App 知识卡片视图与概览

在任务中使用

开启智能体引用后,Qoder 可在同一工作区的任务中自动使用知识卡片。你也可以在指令中写明需要参考的知识,例如:“参照订单模块的架构设计和代码规约,增加订单取消接口。”

修改已生成的知识

在目标工作区的任务输入框中唤起 /knowledge-edit skill,描述需要修改的知识卡片和变更内容,也可以提供设计文档、API 说明等参考资料。完成后回到知识卡片页面检查内容;需要通过 Git 共享时,再执行导出。

共享与多语言知识

知识卡片支持 English 和简体中文。导出文件按语言保存在 .qoder/repowiki/knowledge/zh/ 或 .qoder/repowiki/knowledge/en/。 将 .qoder/repowiki 目录提交并推送到 Git 仓库后,团队成员可以通过 git pull 获取内容,再执行导入。支持团队知识共享时,还可以在更多(…)菜单中选择从团队拉取,获取团队已发布的知识。 账号和组织策略允许时,Qoder 可自动拉取当前仓库、分支和语言可用的团队知识。需要手动获取时,仍可使用从团队拉取。

导入与导出

在知识卡片概览页,点击更多(…):
  • 导出到 .qoder/repowiki:将当前分支、当前语言的知识卡片保存到项目根目录下的 .qoder/repowiki/knowledge/,按语言存放在 zh/ 或 en/ 子目录中。开启自动导出后,生成或更新完成时会自动导出。
  • 导入自 .qoder/repowiki:从项目根目录下的 .qoder/repowiki/knowledge/ 中读取对应语言子目录里的知识卡片,确认后替换当前对应内容。通过 Git 拉取或手动修改文件后,可执行导入,无需重新生成。
Qoder App 知识卡片导入与导出示意图
知识卡片保存在 .qoder/repowiki/knowledge/ 中,与 Wiki 页面分开存放。共享或迁移时,请保留 .qoder/repowiki 的完整目录结构。导入会替换当前分支、当前语言下对应的 Wiki 页面和知识卡片;导出会覆盖对应语言目录,手动修改文件后请先导入。

计费

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