qoderwake需配置含.git的项目根路径为默认上下文锚点，再通过cli或config.yaml设置多级继承白名单，并用snapshot create与context activate绑定运行时环境快照以确保waker准确理解代码环境与用户意图。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让QoderWake的Waker模块准确理解当前任务所处的代码环境、业务目标和用户意图，必须为其显式配置工作上下文，否则它会默认使用空项目根或全局沙盒，导致补全失效、指令误判或Quest流程中断。
设置默认上下文锚点
Waker需要一个稳定、可识别的起点来加载语义图谱与权限边界，【含.git目录的项目根路径】是唯一被官方支持的锚点类型，其他路径（如桌面、文档）将触发降级模式。
1、启动QoderWake后，在左侧导航栏点击「Settings」→「Context Management」→「Default Anchor」
2、点击「Browse」按钮，弹出文件选择器 → 导航至你正在开发的项目目录 → 确认该目录下存在.git子目录 → 选中该目录并点击「Select Folder」
3、界面自动填充路径，例如：/Users/alice/workspace/payment-service。若路径右侧显示红色警告图标，说明.git未被识别，此时请检查是否误选了子目录而非根目录。
启用多级上下文继承
单一层级锚点无法覆盖跨模块调用场景，比如在微服务A中调用B的SDK时，Waker需同时感知两个项目的符号空间。此功能依赖于上下文继承白名单机制。
方法一：通过CLI命令注入
在终端中执行：qoder config set context.inheritance.whitelist '["payment-service", "auth-sdk", "common-utils"]'
注意：数组内字符串必须与各项目根目录下的.qoder/config.yaml中定义的project_id字段完全一致，大小写敏感，且不能包含路径分隔符。
方法二：在主项目配置文件中声明
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
打开/path/to/payment-service/.qoder/config.yaml，在agent节点下添加：
context_inheritance: enabled: true whitelist: - auth-sdk - common-utils
绑定运行时上下文快照
当Waker响应一次「qwake debug api /v1/orders」指令时，它需要知道当前调试会话关联的是测试环境还是预发环境——这由运行时快照决定，而非静态配置。
第一步：生成环境快照
在项目根目录执行：qoderwake snapshot create --env staging --tag v2.4.1 --include-env-vars DATABASE_URL,REDIS_HOST
第二步：激活快照
执行：qoderwake context activate staging-v2.4.1，该命令会将快照ID写入~/.qoderwake/runtime/context.active，Waker后续所有推理均以此为上下文基线。
第三步：验证快照状态
运行：qoderwake context status，输出中必须包含active_snapshot: staging-v2.4.1且status: bound，否则Waker仍将回退到默认上下文。
