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时自动使用新签名。
