提炼项目架构、代码规约与技术栈,供 Qoder CN 在任务中引用。
知识卡片是从代码库中提炼的高密度知识单元,与 Repo Wiki 共同为 Qoder CN 提供项目上下文。它记录架构设计、代码规约和技术栈信息,帮助智能体理解项目、编写代码和排查问题。
开启智能体引用后,Qoder CN 可在同一工作区的任务中自动使用知识卡片。你也可以在指令中写明需要参考的知识,例如:“参照订单模块的架构设计和代码规约,增加订单取消接口。”
在目标工作区的任务输入框中唤起
知识卡片支持 English 和简体中文。导出文件按语言保存在
在知识卡片概览页,点击更多(…):
生成和更新会正常消耗 Credits,可去用量详情-Credits中查看消耗记录。
知识卡片类型
- 架构文档:记录模块结构、服务依赖和设计决策,帮助理解系统架构与改动影响。
- 代码规约(Spec):沉淀命名规范、接口约定和业务约束,供开发、代码审查和问题修复时参考。
- 技术栈:记录项目所用的框架、库及版本信息,辅助依赖选择和代码实现。
生成与查看
- 在侧栏打开更多,选择 Repo Wiki,并打开目标代码仓库。
- 切换到知识卡片视图,在语言中选择 English 或简体中文。
- 检查自动更新、自动导出和智能体引用选项,选择生成。
- 在左侧搜索或选择知识卡片,在右侧查看详情。

在任务中使用
开启智能体引用后,Qoder CN 可在同一工作区的任务中自动使用知识卡片。你也可以在指令中写明需要参考的知识,例如:“参照订单模块的架构设计和代码规约,增加订单取消接口。”
修改已生成的知识
在目标工作区的任务输入框中唤起 /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/repowiki/knowledge/ 中,与 Wiki 页面分开存放。共享或迁移时,请保留 .qoder/repowiki 的完整目录结构。导入会替换当前分支、当前语言下对应的 Wiki 页面和知识卡片;导出会覆盖对应语言目录,手动修改文件后请先导入。