1. 为什么你的 WorkBuddy 总在“失忆”多轮对话反复交代需求的根因如果你用 WorkBuddy 超过两周大概率经历过这种场景周一刚跟它说清楚“所有接口文档统一用表格输出字段名保留原始大小写”周三开新会话它又给你整成一段散文字段名还顺手给你转成了驼峰。你只好把上周说过的话再复制一遍像带一个永远记不住流程的实习生。问题不在模型笨而在于你没把“记忆”和“人格”这两套机制用对。WorkBuddy 的记忆机制其实分了好几层从临时的会话上下文到云端画像再到用户级本地记忆和工作区级记忆每一层的生效范围、持久化方式、优先级都不一样。而真正决定它“像不像一个懂规矩的老员工”的是人格层里的 AGENTS.md 和容易和记忆混淆的 global.md。这篇内容面向的就是被多轮对话反复交代需求折磨的开发者。我会把 WorkBuddy 记忆机制拆开重点讲 AGENTS.md 与 global.md 的分层协作给你可复制的配置模板再给一个人格层生效的验证动作。目标很明确一次配置后面少说废话。先说结论WorkBuddy 的记忆不是“一层”算上临时的一共四层会话上下文、云端画像、用户级本地记忆、工作区级记忆。优先级从高到低是会话上下文 工作区级记忆 用户级记忆 云端画像。记住这句话后面所有配置都不会乱。但光有记忆层还不够。记忆管的是“你偏好什么、这个项目要什么”而人格层管的是“AI 是谁、你是谁、它该怎么干活”。AGENTS.md 就是人格层里的工作 SOPglobal.md 则是跨场景的统一规约。两者写混了AI 就会在“听谁的”这件事上反复横跳表现出来就是需求反复交代、输出风格飘忽。我试过把同一套规则分别塞进用户级记忆和 global.md结果 AI 在冲突时选择了记忆层导致项目级约定被覆盖。后来才理清记忆文件管“干什么、偏好啥”global.md 管“怎么干、守啥规矩”。这个区分是整篇文章的骨架。接下来按顺序拆先讲清四层记忆和优先级再讲人格层四个文件的分工重点落在 AGENTS.md 和 global.md 的写法与协作然后给可复制的配置模板接着是验证人格层是否生效的动作最后把常见报错和踩坑逐个排掉。每一步都有具体文件和命令你可以直接跟着改。2. WorkBuddy 记忆机制分层拆解AGENTS.md 与 global.md 到底谁管什么2.1 四层记忆从会话上下文到工作区级记忆第 0 层是会话上下文就是你当前聊天窗口里的内容。关掉窗口就清零但在本轮对话里优先级最高你说啥算啥。很多人误以为“我说过它就记住了”其实只是这一轮有效。第一层是云端画像全自动生成。系统会从对话里悄悄提取长期信息你的职业、常用格式、干活习惯。本地有个对应的缓存文件别手动改改了下次同步也会被覆盖。真想编辑走设置里的记忆面板。第二层是用户级本地记忆你手动写的通用规则所有项目都生效。比如“输出统一用 Markdown”“流程图用 Mermaid 语法”。但别把某个项目的专属规则写这里否则到别的项目会瞎套用出问题都找不到根因。第三层是工作区级记忆每个项目独立一份互不串门。A 项目写的规矩B 项目看不到。除了手动写AI 干完活还会自动更新每日日志但日志是流水账想长期生效的规则得手动挪到正式记忆文件里不然过一阵它照样忘。优先级一句话记死越近、越具体优先级越高。会话上下文 工作区级记忆 用户级记忆 云端画像。你当场说的要求比之前写的规矩管用项目里的特殊约定比通用习惯分量重。2.2 人格层四个文件IDENTITY、USER、SOUL、AGENTS打开.workbuddy文件夹你会看到不止记忆文件还有一整套人格层和协议层文件。人格层里最常打交道的四个是 IDENTITY、USER、SOUL、AGENTS。IDENTITY 定义 AI 的身份定位USER 描述你是谁SOUL 管语气和性格底色AGENTS 则是工作 SOP。前三个第一次启动时系统会引导生成一般够用别瞎折腾。尤其 SOUL别乱写“你是毒舌 AI”这种后面每次提问都被怼改回来还费劲。AGENTS.md 才是重点。它写的是表达风格、输出长度、交付标准、遇到歧义怎么办、什么事不能做主。相当于你给新人定的办事手册。不写会怎样AI 自由发挥有时长篇大论像写论文有时自作主张替你拍板。写上“需求不清楚先追问别瞎猜”它就不会脑补写上“不替我做产品决策”给完方案会乖乖加一句仅供参考。2.3 global.md 与用户级记忆的区别一个管偏好一个管规约很多人分不清用户级记忆和 global.md。一句话记忆文件管“干什么、偏好啥”global.md 管“怎么干、守啥规矩”。一个是个人喜好一个是统一工作制度。比如文件命名规范、代码风格、提交格式这种全场景通用的规约放 global.md 里。别两个文件写重复内容浪费上下文不说AI 还得纠结听谁的。2.4 规则打架时听谁的加载顺序不等于优先级举个例子用户级记忆写“资料整理优先输出 docx”项目级记忆写“本项目文档全用 markdown”你当场又说“这次先记到 Notion 里”。最后听谁的听你当场说的。当场要求 项目规则 通用习惯。顺便提一句文件加载顺序不等于优先级。启动时先加载人格层、再加载记忆层但不是先加载的说话就算数。别把这两件事搞混。3. 可复制的 AGENTS.md 与 global.md 配置模板一次配置减少重复沟通3.1 文件放哪人格层只认用户级路径先把路径说清楚这是最容易白忙活的地方。人格层文件只认用户级路径把 AGENTS.md 放到项目文件夹里没用系统直接忽略。正确位置是用户目录下的.workbuddy文件夹比如 macOS/Linux 是~/.workbuddy/AGENTS.mdWindows 是C:\Users\你的用户名\.workbuddy\AGENTS.md。global.md 同样放在用户级路径下和 AGENTS.md 同级。工作区级记忆则放在项目根目录的.workbuddy里只对当前项目生效。3.2 AGENTS.md 模板工作 SOP 与禁止条款下面这份可以直接复制按需改。注意禁止条款效果最好比你每次聊天反复强调管用。# AGENTS.md - 工作 SOP ## 表达风格 - 默认输出 Markdown代码块必须标语言 - 段落为主列表不超过 5 项避免堆砌 - 中文回答技术术语保留英文原词 ## 输出长度 - 简单问题直接给结论不超过 200 字 - 方案类问题先给结论再给步骤总长控制在 800 字内 - 不写“综上所述”“总之”这类收尾套话 ## 交付标准 - 代码必须可运行给出完整命令和参数 - 配置文件给出完整片段标注路径 - 涉及版本差异时说明适用版本 ## 歧义处理 - 需求不清楚先追问别瞎猜 - 一次最多追问 2 个问题避免打断节奏 - 不确定的事实标注“需确认”不编造 ## 禁止事项 - 不替我做产品决策给完方案加“仅供参考” - 不擅自修改我未指定的文件 - 不输出与当前项目无关的通用教程 - 不在回答里插入推广链接3.3 global.md 模板跨场景统一规约global.md 放全场景通用的规约别和记忆文件重复。# global.md - 统一工作规约 ## 文件命名 - 文档用 kebab-case如 api-design.md - 代码文件遵循各语言社区惯例 ## 代码风格 - 缩进统一 2 空格除非语言惯例要求 4 空格 - 提交信息用 conventional commits 格式 - 变量名保留原始大小写不擅自转换 ## 文档格式 - 接口文档统一用表格字段名列保留原始大小写 - 流程图用 Mermaid 语法 - 表格超过 6 列时拆分为多个表 ## 协作约定 - 修改前先说明改什么、为什么改 - 涉及多文件改动时先列清单再动手3.4 记忆文件与 global.md 的协作边界用户级记忆只放所有项目都通用的偏好比如“输出统一用 Markdown”。项目专属规则一律下沉到工作区级记忆。global.md 放规约比如命名、提交格式。三者别写重复内容。如果你用 TaoToken 接入模型做编码可以在 Coding Plan 里统一管理模型和额度配置入口在 Coding Plan。模型 ID、Base URL、Key 三件套在 API Keys 里拿接入文档在 接入文档。4. 验证人格层是否生效三个可复现的请求动作4.1 验证禁止条款让它做产品决策配置完 AGENTS.md 后开一个新会话问一个需要产品决策的问题比如“这个功能要不要做”。如果生效它会给方案并加“仅供参考”而不是直接替你拍板。如果它直接说“建议做”且没有免责说明 AGENTS.md 没加载。4.2 验证歧义处理给一个模糊需求发一句“帮我优化一下”。生效的话它会先追问“优化哪个文件、目标是什么”而不是直接输出一堆通用建议。这一步能验证“需求不清楚先追问”是否被读取。4.3 验证输出长度问一个简单问题问“Python 怎么读 JSON”。生效的话它给结论加一小段代码不超过 200 字不会展开成一篇教程。如果它开始讲历史、讲原理、讲三种库的对比说明输出长度约束没生效。三个动作都通过说明人格层加载正常。如果有一个没过先检查文件路径是不是用户级再检查文件名大小写最后看有没有语法错误导致解析失败。5. 常见报错与踩坑排查401、local proxy failed、reading choices、OAuth5.1 401 UnauthorizedKey 没配对报错401 Unauthorized通常是 API Key 没配或配错。检查三件套Base URL、Key、Model ID。Base URL 用https://taotoken.net/apiKey 在 API Keys 里生成Model ID 按文档填。三个都对还报 401看 Key 是不是过期或被禁用。5.2 local proxy failed本地代理配置冲突报错local proxy failed一般是本地代理设置和工具配置打架。检查环境变量里有没有残留的代理配置工具自身的代理设置是否和系统一致。如果你用的是 Codex检查auth.json里的配置是否完整。5.3 reading choices 报错响应格式不匹配报错reading choices通常是模型返回格式和客户端预期不一致。检查 Model ID 是否填对有些客户端要求特定模型名。如果用的是 Claude Code确认 Anthropic 兼容配置是否正确参考 ClaudeCodeAnthropic。5.4 OAuth 失败认证流程没走完OAuth 报错一般是认证流程中断或回调地址不对。重新走一遍认证确认回调地址和配置一致。如果用的是 CC Switch 或 Cline MCP检查 Base URL、Key、Model ID 三件套是否都填了缺一个都会失败。5.5 踩坑清单别改缓存、别写太细、记得迁文件别改云端画像的本地缓存改了必被覆盖。用户级记忆别写太细只放通用内容。换电脑记得手动迁.workbuddy文件夹本地文件不走云端同步。人格层只认用户级路径放项目里没用。别把日志当规则库日志是过程记录想长期生效及时整理到记忆文件。禁止条款效果最好比反复强调管用。6. 从记忆到人格让 WorkBuddy 真正记住你的工作方式配置这件事说到底是把“你脑子里的规矩”变成“AI 能读到的文件”。记忆层管偏好人格层管规矩global.md 管统一规约。三者边界清晰AI 就不会在冲突时反复横跳。如果你还在多轮对话里反复交代需求先检查 AGENTS.md 是不是放在了用户级路径再检查禁止条款有没有写。这两步做完大部分“失忆”问题都能解决。需要验证模型效果时可以在 模型对话 里直接试。长期做编码和 Agent 任务用 Coding Plan 统一管理。配置入口在 ConsoleKey 在 API Keys。官网 taotoken.net 有完整文档。最后留一个实用技巧每次改完 AGENTS.md开新会话跑一遍第 4 节的三个验证动作。通过再继续用不通过先排查路径和语法。这比聊一百次都管用。