codebuddy通过{state:xxx}占位符实现状态管理：第一步定义占位符，第二步在指令中引用，第三步在api请求state字段传值；支持【重置所有{state:xxx}】清空或[scope:session]限定作用域，需配x-codebuddy-state-mode头。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在CodeBuddy提示词中嵌入状态管理逻辑，是为了让AI在多轮对话中准确记住用户设定的角色、上下文约束或临时变量（如“当前分析的文件是report_v2.pdf”“本次不解释原理，只输出JSON”），避免每次提问都重复声明。
用占位符+指令组合实现轻量状态绑定
第一步：在提示词开头定义状态占位符，格式为{state:xxx}，例如{state:file_name}或{state:output_format}。
第二步：在后续指令中直接引用该占位符，如“请基于{state:file_name}中的第三页数据生成摘要”，AI会将实际值代入执行。
第三步：调用CodeBuddy API时，在请求体的state字段传入键值对，例如{"file_name": "log_202405.txt", "output_format": "markdown"}。这一步漏填会导致占位符原样输出，无法替换。
用分段指令控制状态生命周期
方法一：显式清空指令
在提示词末尾加入一句“【重置所有{state:xxx}占位符】”，CodeBuddy识别到该固定短语后，会忽略此前传入的state字段值，后续轮次从空状态开始。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
方法二：作用域限定指令
用[scope:session]包裹某段提示词，表示其中引用的{state:xxx}仅在当前API调用生效，不会污染下一次请求。不加此标记的状态默认跨请求持久化。
【必须在API请求头中添加X-CodeBuddy-State-Mode: scoped才能使[scope:session]生效】
避免状态污染的关键写法
不要在提示词里写“记住上一条消息里的参数”，CodeBuddy不自动继承历史输入；所有状态必须通过{state:xxx}显式声明和传参。
当多个状态名语义接近时（如{state:mode}和{state:run_mode}），务必保持命名唯一，否则后传的值会覆盖先传的同名项，且无警告。
