QoderWake中创建Waker必须绑定Workspace并以.git为根锚点，否则默认空会话导致补全失效；需选择含.git和.qoder/config.yaml的路径，注入QODER_CONTEXT_SCOPE等参数，并通过!debug context验证git_commit、semantic_graph_status和active_branch三项就绪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在QoderWake中创建Waker时，若不显式设置工作上下文，Waker将默认使用空会话环境运行，无法访问项目代码、Git状态或用户偏好，导致补全失效、诊断失败或任务执行中断。
绑定Workspace作为默认工作上下文
Waker必须挂载到一个已注册的Workspace，否则无法加载语义图谱与上下文锚点。
1、启动QoderWake → 点击左上角「+ New Quest」→ 输入任务名（如“API调试”）→ 在「Workspace」下拉菜单中选择目标项目路径（例如/home/user/my-api-project）。
2、确认该路径下存在有效的.git目录和.qoder/config.yaml文件；若缺失，Waker会降级为无上下文模式，仅支持基础文本响应。
3、点击「Create」后，新Waker窗口右下角状态栏应显示WS: my-api-project ✅，表示上下文绑定成功。
配置.git为强制上下文锚点
QoderWake要求所有Waker以.git目录为根锚点识别项目边界，这是跨文件分析与Git-aware操作的前提。
方法一：自动识别
在创建Waker时，QoderWake会扫描所选路径及其父级目录，找到第一个.git并将其设为context_root。这一步无需手动干预，但【若路径下无.git，Waker将拒绝初始化并报错】。
方法二：手动覆盖
若项目使用子模块或非标准Git布局，可在Waker启动后立即执行CLI命令：qoder config set context.root /path/to/real-git-root。注意该命令需在Waker进程内执行，且修改仅对当前会话生效。
注入多层级上下文参数
单靠路径绑定不足以支撑复杂任务，需通过参数注入增强上下文粒度。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
第一步：进入Waker设置面板 → 点击右上角齿轮图标 → 选择「Context Injection」。
第二步：在「Environment Variables」区域添加键值对：
QODER_CONTEXT_SCOPE=full —— 启用完整AST解析与符号追踪；
QODER_CONTEXT_BRANCH=main —— 显式指定分支，避免Waker误读HEAD detached状态；
QODER_CONTEXT_DEPTH=3 —— 控制跨文件引用深度，设为0则禁用跨文件补全。
第三步：勾选「Persist to Workspace Config」，使这些参数写入.qoder/workspace-config.json，下次启动自动加载。
验证上下文是否就绪
完成设置后，必须验证Waker是否真正接入上下文，而非仅显示路径。
在Waker输入框中键入：!debug context → 回车。
若返回包含"git_commit":"a1b2c3d"、"semantic_graph_status":"ready"、"active_branch":"main"三项，则上下文设置完成。
若其中任一项为空或显示"status":"unbound"，说明.git未被识别、语义图谱未构建或分支信息未同步，需返回前序步骤排查。
