Proxy 仅作为翻译触发与上下文捕获的轻量入口，需协同DOM观察、资源拦截、渲染钩子等机制；应代理语义化数据对象而非全局对象，结合路由、组件上下文等生成复合key实现精准路径级翻译。
Proxy 劫持属性访问本身不能直接构建“全路径无侵入式自动翻译引擎”，因为它作用于 JavaScript 对象层面，而真实应用中的待译文本往往不以纯 JS 属性形式存在——它们分散在 DOM 节点、Canvas 绘制内容、WebGL 字符串、动态生成的 innerHTML、甚至 WASM 内存中。真正可行的路径，是把 Proxy 作为**翻译触发与上下文捕获的轻量入口**，再叠加资源拦截、DOM 观察、UI 渲染钩子等多层机制，形成协同工作流。
Proxy 只负责“识别意图”，不负责“提取文本”
直接对 window 或 document 做全量 Proxy 拦截性能极差，且多数属性读写与翻译无关。更务实的做法是：仅对明确用于展示的响应式数据对象（如 Vue 的 reactive、Svelte 的 store、或自定义 i18nState）做代理封装。当访问 state.ui.title 或 messages.login.success 这类带语义路径的键时，Proxy 的 get 拦截器可：
- 记录完整访问路径（如 "ui.title"）、当前语言环境、调用栈浅层信息
- 检查本地术语库是否命中（优先级高于机器翻译）
- 若未命中，异步发起翻译请求，并缓存结果（含路径哈希 + 目标语言为 key）
- 返回占位符或 fallback 文本，避免 UI 阻塞
全路径匹配需结合运行时上下文还原
“全路径”不是字符串拼接，而是语义路径 + 渲染上下文的联合标识。例如：
— 同样访问 item.name，在商品列表页应译为“商品名称”，在用户设置页可能译为“昵称”；
— 同样是 button.text，在弹窗中可能是“确认删除”，在表单中可能是“提交申请”。
因此，Proxy 的 get 拦截必须配合以下信号源：
- 当前活跃路由 path（来自 history.state 或框架 router）
- 最近一次触发渲染的组件名或 DOM 节点 dataset 属性（如 data-context="checkout"）
- 父级元素的 aria-label、role 或 class 名（用于推测功能场景）
把这些信号组合成复合 key，才能实现真正精准的“路径级”翻译复用。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
无侵入≠不挂钩，关键在于挂载点选得准
所谓“无侵入”，是指不修改业务代码逻辑，但技术上必然需要注入轻量钩子。推荐三个低风险挂载点：
- DOM MutationObserver：监听 textContent、innerText、value 等可变属性变化，提取新出现的纯文本节点
- Canvas 2D context.fillText 重写：对 canvas 绘制文本做代理包装，捕获坐标+字体+内容三元组
- Fetch/XHR 拦截：解析返回的 JSON 或 HTML 片段，提取其中待译字段（如 API 返回 { label: "Save" } → 自动映射为 "ui.form.save"）
这些钩子与 Proxy 层通过统一事件总线通信，由中心调度器决定是否触发翻译、走缓存还是调引擎。
翻译结果如何安全回填？靠“渲染后置更新”而非实时替换
Proxy 返回的翻译结果不能直接塞进原始对象（会破坏响应式依赖），也不该同步修改 DOM（易引发重排）。正确做法是：
- 将翻译任务加入微任务队列（Promise.resolve().then）
- 等待当前渲染帧完成（requestIdleCallback 或 queueMicrotask）
- 只更新已知可安全操作的目标：Vue 的 $nextTick 后 patch、React 的 useLayoutEffect、或原生 DOM 的 textContent（避开 innerHTML 防 XSS）
- 对富文本/HTML 片段启用白名单标签过滤，禁用 script/style 标签
这样既保证翻译可见性，又不干扰原有渲染生命周期。
