qoderwake的waker需通过三步实现项目背景长期记忆：先初始化配置并重建语义图谱以解析代码结构，再用cli或anchor.md文件注入非代码上下文，最后配置entityretention策略确保关键信息不被裁剪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake创建的Waker在多轮交互中持续记住项目背景，比如当前开发的模块名称、接口协议版本、团队约定的命名规范或尚未合并的PR分支名，而不是每次提问都要重复说明。这需要绕过默认的会话级记忆隔离，将项目上下文注入到Waker的长期记忆锚点中。
绑定项目根目录并启用语义图谱
Waker对项目背景的感知依赖于本地代码结构的主动解析，而非被动接收文字描述。未建立语义图谱时，它无法识别“user-service”是微服务模块、“v3.2”是API版本号这类隐含信息。
第一步：确保项目根目录下存在.qoder/config.yaml文件。若不存在，在终端执行qoder init --project-type=backend生成标准配置。
第二步：右键点击项目根目录 → 选择「Qoder → Rebuild Semantic Graph」→ 等待状态栏提示“Indexed 142 files, resolved 897 symbols”。这一步必须完成，否则后续所有记忆锚定都无数据支撑。
第三步：打开IDE右下角Qoder状态图标，确认其变为深蓝色脉冲动画——这表示Waker已加载该项目的AST符号表，具备理解类名、方法签名、注释关键词的能力。
写入项目背景记忆锚点
单纯靠语义图谱只能识别代码结构，要让Waker记住你口头交代的非代码信息（如“这个模块下周要对接支付中台”），必须通过记忆API显式注入带类型标签的条目。
方法一：使用CLI命令注入关键实体
qoderwake memory put --key project-context --value "支付中台对接;模块上线倒计时7天;PR需包含接口契约文档" --tags name:payment-gateway,id:proj-2026-Q3,date:2026-08-06
方法二：在项目根目录创建.qoder/memory/anchor.md文件，写入YAML格式记忆锚点：
anchor_type: project-background<br>priority: high<br>content: |<br> 当前聚焦支付中台v2.1协议对接<br> 所有HTTP请求头必须携带X-Trace-ID<br> 日志级别统一设为DEBUG
保存后执行qoderwake memory load-anchor --path .qoder/memory/anchor.md，系统将自动提取anchor_type字段作为记忆分类标识。
【注意：anchor.md文件必须放在.qoder目录下，且文件名不能含空格或中文】
配置记忆保留策略
默认情况下，Waker的记忆会在Token窗口满时被无差别裁剪。要确保项目背景这类高价值信息不被挤出，必须设置实体保留规则。
第一步：编辑~/.qoderwake/config.json，定位到agent → memory节点。
第二步：添加以下配置：
"entityRetention": [<br> {"pattern": "payment-gateway|paycenter|midas", "type": "service-name"},<br> {"keywords": ["倒计时", "上线", "对接"], "type": "deadline-clue"}<br>]
第三步：将enable_entity_retention字段设为true，保存文件。
第四步：执行qoderwake restart --graceful使策略生效。重启后，只要对话中出现“payment-gateway”或“倒计时”，Waker就会强制将关联记忆保留在当前窗口内。
