QoderWake需挂载代码与文档至知识库并完成解析后,方可自动生成可检索、可更新、带版本关联的Repo Wiki,支持侧边栏锚点或自然语言触发,并可通过绑定Agent工作流实现上下文实时联动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要让QoderWake自动从代码仓库、设计文档和会议纪要中提取结构化信息,生成可检索、可更新、带版本关联的项目文档Wiki,而不是手动复制粘贴或维护静态Markdown文件。这要求知识库挂载路径正确、解析策略匹配文档类型、且上下文锚点能被后续Agent任务主动调用。
挂载项目源码与文档到知识库
QoderWake不支持直接读取未挂载的本地目录,所有代码文件、README、API文档必须显式注入知识引擎,否则Quest模式无法进行跨文件语义理解。
1、打开QoderWake控制台 → 进入「数字员工管理」→ 选择目标实例 → 点击「知识库配置」。
2、点击「新增数据源」→ 选择「本地文件上传」→ 拖入以下三类内容:【项目根目录下的README.md、docs/目录全部文件、target/generated-sources/openapi/下的YAML或JSON】。
3、上传后系统自动执行分块:对Java/Go源码按类+方法粒度切分,对OpenAPI文档提取端点+参数+响应示例,对Markdown按H2标题切片。若上传后状态栏长期显示“解析中”,说明某文件含非法编码或超500页PDF,需先用VS Code预处理。
4、等待状态变为“已就绪”,此时Repo Wiki功能才可触发。
启用Repo Wiki自动生成
Repo Wiki不是独立页面,而是知识库挂载成功后自动激活的动态文档服务,它实时映射代码变更并生成可跳转的架构图谱。
方法一:通过侧边栏快捷入口
1、确保已启用侧边栏自定义模式(设置→界面偏好→侧边栏行为→开启)。
2、在侧边栏空白处右键 → 「插入知识锚点」→ 类型选“Repo Wiki” → 绑定当前Workspace。
代码编辑 CLI 工具集合:Cursor CLI(agent)和 Qoder CLI(qodercli),用于代码修改、重构、Code Review 及自动化代码任务。
3、点击该锚点,QoderWake立即扫描已挂载的源码,生成模块依赖图、接口清单、配置项摘要三张视图。
方法二:用自然语言触发
在聊天框输入:“生成当前项目的Repo Wiki概览”,QoderWake将返回带交互链接的HTML卡片,点击“服务拓扑”可展开Spring Boot各Module的Bean注入关系,“API清单”支持按Tag筛选端点,“配置摘要”高亮application.yml中被@Value引用的字段。
【注意:若返回空卡片,说明知识库尚未完成向量化,需回到上一步确认状态栏是否为“已就绪”】
绑定Wiki节点到Agent工作流
生成的Wiki内容默认只读,要让它参与真实任务,必须将其设为Agent的上下文输入源,否则Quest拆解任务时不会引用其中的类名或配置键。
第一步:打开「Agent技能编辑器」→ 新建一个名为“文档同步”的Skill。
第二步:在「上下文来源」区域点击「+ 添加知识源」→ 选择「Repo Wiki:当前Workspace」→ 勾选“启用实时变更监听”。
第三步:在提示词模板中插入指令:“基于Repo Wiki中最新版的UserService.java类签名与数据库连接池配置,重写用户注册流程的异常处理逻辑。”
第四步:保存Skill并测试——当代码中UserService.java被修改后,QoderWake会在10秒内刷新Wiki节点,并在下次调用该Skill时自动使用新签名。

















