qclaw需按目录路径精准切换语言模型与上下文：前端src//.{ts,tsx,js,jsx,vue}绑定hy3 preview，后端backend//.{java,py,go}绑定deepseek-v4 pro；同步i18n键值、接入openapi schema、禁用跨目录上下文继承以杜绝语言污染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在QClaw中为前后端分离的多语言项目（如Vue+Spring Boot、React+Django）配置精准的代码补全，避免前端JSX里误出Python提示、后端Java文件里混入TypeScript类型推导。这要求QClaw能按文件路径、后缀、项目结构自动切换语言模型与语义上下文。
启用项目级语言识别与模型路由
QClaw默认按单文件后缀判断语言，但前后端分离项目常共存于同一仓库，需强制按目录层级绑定语言栈。
1、打开QClaw设置 → 【AI编程辅助】→【语言识别策略】。
2、关闭【仅依据文件扩展名识别】开关，勾选【启用基于目录结构的语言映射】。
3、点击【添加规则】，输入前端路径模式：【src/**/*.{ts,tsx,js,jsx,vue}】 → 绑定模型：Hy3 preview（已训练React/Vue AST）；后端路径模式：【backend/**/*.{java,py,go}】 → 绑定模型：DeepSeek-V4 Pro（含Spring Boot/Django语义解析）。
4、保存后重启QClaw核心服务——此步不可跳过，否则路径规则不加载。
为前端项目注入i18n键值上下文
前端组件中频繁调用t('LoginPage.title')等i18n函数，若补全无法感知可用键，会降低开发效率。需将翻译资源注入QClaw语义索引。
方法一：自动同步本地i18n目录
1、确保项目中已存在/src/i18n/locales/en/translation.json等标准路径。
2、在QClaw设置 → 【文件空间】→【本地接入】中，点击【添加路径】，选择整个/src/i18n目录。
3、QClaw将扫描所有translation.json文件，构建键名词典，并在你输入t('')时自动补全已定义键。
方法二：CLI手动注册键集（适用于未生成i18n结构的项目）
1、在终端执行：qclaw generate translations --from-comments --output ./i18n-keys.json，从注释提取待翻译文本并生成键列表。
2、回到QClaw设置 → 【AI编程辅助】→【上下文增强】→【导入自定义键集】，选择该JSON文件。
3、勾选【启用键名补全优先级高于通用变量】——这能防止t('user')被错误补全为user.id而非i18n键。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
隔离后端API响应结构供前端调用补全
前端调用fetch('/api/login')后，期望自动补全response.data.user.token等字段，但QClaw默认无法跨进程理解后端返回体。必须显式提供OpenAPI或TS接口定义。
第一步：确认后端已暴露OpenAPI文档
检查/backend/src/main/resources/static/swagger-ui.html是否可访问，或是否存在/openapi.json文件。
第二步：在QClaw中绑定API Schema
1、进入设置 → 【AI编程辅助】→【API上下文】→【添加OpenAPI源】。
2、粘贴后端OpenAPI JSON URL（如http://localhost:8080/v3/api-docs），或上传本地openapi.json文件。
3、点击【解析并加载】，等待状态变为“已索引 12 个接口，7 个响应模型”。
第三步：触发前端响应补全
在React组件中写到const res = await fetch('/api/login'); const data = await res.json(); data.时，光标停在data.后，QClaw将基于OpenAPI中LoginResponse定义，列出id、token、expiresAt等字段。
禁用跨语言污染的全局补全行为
当QClaw同时监听前端和后端目录时，可能因缓存混淆导致Vue模板中出现Java关键字补全，或Python文件里弹出JSX语法建议。这是模型上下文泄漏的典型表现。
1、进入【设置】→【AI编程辅助】→【补全行为策略】。
2、关闭【跨目录上下文继承】——此项开启时，QClaw会将/backend/utils.py中的函数名注入/src/views/目录的补全候选池，必须禁用。
3、将【补全作用域】设为“当前文件所在目录树一级”，即/src/下的文件只参考/src/内其他文件，不扫描/backend/。
4、重启QClaw，验证在/src/App.vue中输入“v-”不再出现Java的“volatile”关键字。
