qoderwake工作上下文配置包括:1. 设置含.git的默认workspace并启用.git锚点;2. 绑定多源知识锚点至侧边栏;3. 配置跨任务上下文继承白名单;4. 启用摘要驱动的记忆压缩。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

配置QoderWake自动化任务的工作上下文,是为了让AI数字员工在执行定时任务、周报生成或跨系统数据采集时,能准确识别当前项目路径、Git仓库状态、环境变量及关联知识片段,避免因上下文错位导致代码路径错误、权限越界或模板填充失效。
设置默认Workspace与.git锚点
首次配置必须显式指定一个含.git目录的本地路径作为根上下文,否则所有自动化任务将默认运行在用户主目录下,极易引发路径解析失败或权限拒绝。
1、打开QoderWake控制台 → 【设置】→【工作区管理】→【默认Workspace】
2、点击「浏览」按钮,选择你日常开发的主项目文件夹(例如/Users/you/workspace/frontend-app),该路径内必须存在.git子目录
3、勾选「启用.git为上下文锚点」,系统会自动读取.git/config中的remote.origin.url,并将其哈希值注入session_memory_anchor的绑定逻辑中
【未含.git的路径将被拒绝保存,且不会触发任何自动化任务的上下文加载】
绑定多源知识锚点至侧边栏
当自动化任务涉及特定业务规则(如数据库连接超时处理、支付回调验签流程)时,需将对应文档直接挂载为上下文增强源,使Agent在生成代码或诊断日志时能实时引用。
方法一:挂载本地Markdown知识片段
在侧边栏空白处右键 →「插入知识锚点」→ 输入路径~/docs/db-connection-troubleshooting.md → 设置触发关键词“连接超时”
方法二:嵌入Notion页面
粘贴Notion公开分享链接https://www.notion.so/xxx-pay-callback-spec → 选择「仅同步标题与段落结构」→ 启用「变更自动拉取」
方法三:绑定Confluence空间ID
输入Confluence空间Key:DEVOPS → 指定页面路径/pages/CI-CD-Pipeline-Guide → 勾选「仅加载带标签#urgent的内容块」
配置跨任务上下文继承白名单
自动化任务常需复用前序任务输出(如A任务生成的API密钥需传给B任务调用),但默认情况下QoderWake会为每个任务创建隔离上下文。必须手动开启继承机制并限定字段范围,否则敏感参数可能泄露或覆盖。
第一步:进入【自动化】→【任务调度】→【全局上下文策略】
第二步:将context_inheritance_whitelist设为以下JSON数组:
["api_token", "workspace_id", "last_commit_hash", "env_type"]
第三步:在任务脚本中显式声明继承关系,例如:
/report weekly --include=pr,alert --inherit-from=deploy-prod-20260728
第四步:验证继承效果——执行qoder debug context --task deploy-prod-20260728,确认白名单字段出现在inherited_context节点下
启用摘要驱动的记忆压缩
长周期自动化任务(如每日构建+静态扫描+安全审计)会产生大量中间日志,若不压缩,3天后上下文窗口将被冗余信息填满,导致关键约束(如“跳过test模块”)被截断丢弃。
1、打开~/.qoderwake/config.json
2、在agent → memory节点下添加:
"summaryCompression": {"enabled": true, "intervalRounds": 5, "retainFields": ["issues", "conclusion", "pending_action"]}
3、保存后执行qoderwake restart --graceful
这一步操作起来很简单,直接把文件拖进去就行。但注意:intervalRounds设为5意味着每完成5轮子任务就触发一次摘要,若任务链少于5步则不会压缩。










