语言与自动识别

简体中文 | English

Sensa、WebSensa 和参数图解提供简体中文与英文。可以在页首选择语言，或按浏览器偏好自动选择。参数路径、设备标识、用户命名与数字协议格式保留原值。

浏览器应用与参数图解

首次打开时，页面按浏览器的语言顺序选择简体中文或 English。手动切换后，当前标签页通过 sessionStorage["sensa.locale"] 记住选择，刷新和同源页面导航继续沿用。

离线文件页还在当前浏览历史项中保存手动选择；文件地址整理后若会话存储发生变化，刷新会从该历史项恢复语言，并回填可用的会话存储。

语言选择顺序：

当前标签页已保存的语言。
浏览器的 navigator.languages，再检查 navigator.language。
都没有匹配项时使用 English。

en_GB 等英语地区值使用英语；zh-TW、zh-Hant、zh-HK 等中文地区值显示简体中文。浏览器限制存储时，手动切换仍在当前页面生效。

页面链接保持简洁。已有链接中的 lang 查询项会在打开后移除，其他查询项和章节位置保留。语言切换保留映射草稿、脚本、图解场景、坐标和设备状态。独立打开的新标签页会按浏览器语言开始；应用、Pages 和本地文件按各自来源保存会话选择。

在线参数图解可直接分享；接收者会看到适合自己浏览器的语言。发行包中的 docs/parameter-geometry.html 也可离线打开，并在页面上切换语言。

WebSensa 优先使用明确语言或当前标签页的 sensa.locale，再读取 localStorage["websensa.locale"] 偏好与浏览器语言。切换时同时更新标签页和已保存偏好，使网站导航保持一致。设备连接与脚本状态保留在当前页面中。

文档入口

根及工具的 README.md 是英文正文，README.zh-CN.md 是完整中文，README.en.md 仅作英文入口别名。
普通指南继续使用 *.md 中文、*.en.md 英文；源码路径不因默认入口变化而批量改名。
文档站将这些文件渲染为 /en/ 与 /zh-CN/ 路由。明确语言路径优先于自动识别，语言切换跳转对应文档。
应用内图解链接指向本地随包 HTML。在线图解的文档链接进入本站；本机 file 页面保留相邻 Markdown 链接。

Unity 编辑器与 Avatar 菜单

Sensa 编辑器提供 Auto／English／简体中文，明确偏好存于 Unity EditorPrefs。Auto 优先编辑器实际 UI 语言；无法读取时用系统语言，其他语言回退 English。简繁中文均显示简体，序列化字段、资产身份和协议参数保持原有内容。

Avatar Expression Menu 的文字在构建时按编辑器所选语言生成，上传后各玩家看到同一套菜单。要更新菜单语言，请修改编辑器偏好后重新构建／上传；已有用户资产保留原样。

World Lab 本地语言

World Lab 用 VRCPlayerApi.GetCurrentLanguage() 和 OnLanguageChanged 自动选择本地语言；其他语言回退英语，中文变体显示简中。Sensa Lab Language 面板提供 Auto／English／简体中文。明确选择通过本地玩家标签优先于自动识别，作用范围是当前玩家的客户端会话；新会话重新按自动识别选择。其他玩家的语言和 OSC／设备状态保持各自原有状态。

实际 API 签名已在 Worlds SDK 3.10.5 核对；安装时请确认 SDK 提供这些 Udon 语言 API。更老版本的兼容性需单独核验。

六类动态 HUD 用 UGUI Text 翻译已知界面短语，保留英文测量／状态源和技术标识。静态 TextMesh 由编辑器生成英／中文显示子对象，同时保留原对象、Transform、身份和原文，并禁用原 Renderer。运行时通过 SetActive 切换显示子对象，静态文本内容在编辑器生成时确定。

Tools → Sensa Lab → Refresh display language - 刷新显示语言 用于升级打开场景的语言显示。Validate localization (Editor only) 的检查范围是 Udon 编译与纯编辑器呈现断言，保留用户实验场景、播放状态和设备状态。上传 VRChat 后，还需检查客户端字体、布局和 HMD 可读性，并单独记录结果。

维护规则

新增用户文本应同步中英，标识符与原始异常保留原文。CI 通过隔离单元和浏览器 E2E 检查语言规范化、优先级、存储受限与状态保留；具体结论以对应提交的实际报告为准。字体和布局通过实际页面审阅确认。开发与发布 · 使用指南