必须通过结构化扫描、语境识别与多语言键值映射三步完成文本剥离，具体包括：一、启用Claw Settings国际化资源扫描模式；二、构建多Agent画布工作流；三、使用自定义指令/i18n-extract一键提取；四、通过SPEC模式驱动规范化重构。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用CodeBuddy进行代码开发时，发现源码中存在大量分散的硬编码字符串（如中文提示、按钮文字、错误信息等），需统一提取并纳入国际化流程，则必须通过结构化扫描、语境识别与多语言键值映射三步完成文本剥离。以下是实现该目标的多种协同路径：
一、启用Claw Settings中的国际化资源扫描模式
该方式调用CodeBuddy内置的多格式硬编码识别器，可自动遍历Java/Kotlin/Python/TypeScript等主流语言文件，定位字符串字面量、注释内标记及XML/JSON资源节点，并依据上下文注释（如“// i18n: 登录失败提示”）生成带语义标签的键名，避免无上下文直译导致的歧义。
1、点击CodeBuddy右上角个人中心图标，进入设置菜单。
2、选择Claw Settings，切换至“国际化支持”标签页。
3、开启“启用源码硬编码自动扫描”，并在“支持语言”中勾选Java、Kotlin、Python、TypeScript、Vue SFC等实际项目所用类型。
4、在“上下文识别规则”中，将“注释触发前缀”设为// i18n:或/* i18n: */，确保开发者标注的用途、位置、复数形态等元信息被完整捕获。
5、点击“保存并刷新扫描器”，状态栏显示“硬编码提取引擎已就绪”后，即可拖入项目根目录或指定src文件夹启动批量扫描。
二、构建多Agent画布执行提取-键化-注入工作流
该方法将硬编码识别、键名生成、多语言占位符注入拆分为四个可审计Agent节点，在可视化画布中串联执行，支持跨语言混合处理（如同时解析Java后端+Vue前端），且每个环节输出可回溯、可重试、可人工干预。
1、在CodeBuddy主界面点击“新建项目”，选择“多Agent协同”模板。
2、添加四个Agent节点，分别命名为“硬编码定位器”“键名生成器”“占位符注入器”“校验报告器”。
3、为“硬编码定位器”配置系统提示词：你运行于Linux环境，执行grep -r --include="*.java" --include="*.ts" --include="*.py" -n '"[^"]\+"' ./src | grep -v 'import\|from\|require' | head -50，输出含文件路径、行号与原始字符串的结构化清单。
4、为“键名生成器”配置命名策略：读取每条字符串的父类名、方法名、所在组件名及注释中的i18n标签，拼接为AuthLoginService_loginFailureMessage格式，若无注释则调用codebuddy-cli keygen --context auto --length 32生成唯一哈希键。
5、为“占位符注入器”配置替换逻辑：在原字符串位置插入$t('AuthLoginService_loginFailureMessage')（Vue）或gettext('AuthLoginService_loginFailureMessage')（Python），并保留原始字符串作为注释备份。
三、使用CodeBuddy自定义指令一键触发硬编码抽取
该方式无需进入设置或画布，直接在任意编辑器中输入预设斜杠命令，由CodeBuddy自动解析当前文件上下文，执行轻量级硬编码扫描与临时键映射，适用于单文件快速整理或紧急修复场景，结果以Markdown表格形式即时返回，支持复制粘贴至i18n配置文件。
1、在打开的源码文件编辑区，光标置于任意位置，输入/i18n-extract并回车。
2、CodeBuddy自动分析当前文件语法树，识别所有双引号/单引号包裹的非空字符串字面量。
3、对每个字符串，检查其前后3行是否含// i18n-key:或/* KEY=等人工标记，若有则优先采用该键名；否则基于变量名、函数名、注释关键词生成候选键。
4、弹出浮动面板，展示待提取字符串列表，每行包含原文、建议键名、上下文片段及“采纳”“跳过”“重命名”操作按钮。
5、点击“全部采纳”后，CodeBuddy自动生成对应语言的i18n配置片段（如en-US.json新增键值对），并高亮显示插入位置供人工确认。
四、通过SPEC模式驱动规范化的国际化重构
该方式基于CodeBuddy首创的SPEC（Specification-Driven Engineering Cycle）白盒流程，强制AI按“需求说明→任务拆解→变更预览→人工确认”四步推进，确保硬编码抽取过程符合工程规范，杜绝未经审核的键名污染与上下文丢失，适用于中大型项目上线前的合规性整改。
1、在CodeBuddy侧边栏点击“SPEC向导”，选择“国际化重构”模板。
2、上传一份简要需求说明文档（支持Markdown或纯文本），内容需包含目标语言、资源格式（如i18n/en.json）、键命名规则（如PascalCase+模块前缀）及禁止替换范围（如日志模板字符串）。
3、系统自动生成任务清单：例如“扫描/src/main/java/com/example/auth/下全部Java文件”“提取所有非log.info()调用中的字符串”“排除含${}的动态模板串”。
4、点击“预览变更”，CodeBuddy以diff形式展示每处替换前后的代码对比，左侧为原始硬编码，右侧为带
5、勾选需执行的变更项，点击“应用”，CodeBuddy批量写入修改，同时在项目根目录生成i18n-extraction-report.md记录全部操作轨迹与人工决策点。
