正确设置workspace和上下文是qoderwake精准理解项目结构、调用知识引擎、复用记忆的前提；需绑定含.git的真实路径、配置context_anchors或cli注入动态上下文、启用跨workspace桥接并重建语义图。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在QoderWake中正确设置Workspace（工作空间）和上下文，是让数字员工精准理解项目结构、调用对应知识引擎、复用历史记忆的前提。若新建Quest后代码补全不准、Agent无法识别当前模块、或跨文件跳转失效，大概率是Workspace未绑定真实路径，或上下文锚点缺失.git标识、未启用语义图谱。
创建并绑定本地Workspace
1、启动QoderWake，点击左上角「+ New Quest」→ 输入任务名称（如“订单服务重构”）→ 在「Workspace Path」栏【必须手动输入或选择一个已存在的、含.git目录的项目根路径】，不可留空或指向空文件夹。
2、点击「Create」后，QoderWake会自动检测该路径下是否存在.git，并尝试读取.git/config中的remote.origin.url。若检测失败，右下角将弹出黄色提示：“No Git repo found — context anchoring disabled”，此时所有上下文感知功能（如跨文件补全、变更文件高亮、Git-aware提交）均不可用。
3、若路径无.git，可在终端进入该目录执行git init → git remote add origin
配置上下文锚点与语义范围
方法一：通过.qoder/config.yaml声明显式锚点
1、在Workspace根目录下确认存在.qoder/子目录；若无，右键项目根目录 → Qoder → Initialize Project生成默认结构。
2、打开.qoder/config.yaml，确保包含以下区块：
context_anchors:
- path: "./src/main/java"
- path: "./api-spec/openapi.yaml"
- pattern: ".*\.env\.local"
3、保存后，在QoderWake中右键该Workspace → 「Reload Context Anchors」。系统将立即扫描所列路径与正则匹配文件，构建初始上下文快照。
方法二：用CLI注入动态上下文片段
1、打开终端，cd至Workspace根目录。
2、执行命令：qoder context inject --from-file ./docs/ARCHITECTURE.md --as "system-architecture"，将架构文档作为只读上下文注入当前Workspace。
3、再执行：qoder context bind --target "digital-analyst" --scope "api-contract"，强制将数字分析师Agent的推理范围限定在API契约相关上下文中，避免其误读测试用例或日志配置。
启用跨Workspace上下文桥接
当多个项目需共享同一套领域模型（如微服务间共用common-dto），需手动建立上下文引用链，否则QoderWake默认隔离各Workspace语义空间。
第一步：导出源Workspace上下文摘要
1、在A项目（如user-service）的QoderWake中，右键Workspace → 「Export Context Snapshot」→ 保存为user-dto-context.json。
第二步：导入至目标Workspace
2、切换到B项目（如order-service），右键 → 「Import Context Snapshot」→ 选择user-dto-context.json。
3、勾选「Enable cross-workspace symbol resolution」并点击确认。此时B项目中对com.example.user.dto.UserProfile的引用将能跳转至A项目的源码定义，且补全建议包含A项目中该类的全部扩展方法。
4、注意：导入后需手动执行「Rebuild Semantic Graph」，否则AST符号链接不会生效。
