让官方 Oh My Pi（OMP） 的原生 /settings 和内置斜杠命令补全说明显示简体中文，并让直接运行 omp stats 打开的网页支持中文 / English。设置与补全使用 Extension；Stats 使用可撤销的本地 PATH 启动器，仍运行实际安装的官方 CLI。不分叉、不替换官方二进制，不改变设置、命令执行与统计计算。
设置名称与说明显示中文；官方页签、分组、控件和设置值保持不变。
直接运行 omp stats，在原服务地址使用中文 / English 切换。截图中的“API 等价费用”是估算，不是实际账单。
- 当前版本：
18.12.6；正式发布状态以 GitHub Releases 的实际 tag/Release 为准。main、源码编号和本机升级不等于 Release - 目标官方宿主：OMP 18.12.6（真实内嵌 Bun 1.4.3）；通过受支持的
omp update从 18.12.5 升级，保留原官方二进制与受管启动器。已有进程不会热加载新代码 - Settings：419/419 项 UI 元数据，Schema 漂移 0；相对 18.12.5 新增/删除/原文变化均为 0，37 个注册域及导入选项来源保持。修复延迟启动与主会话关闭交错后遗留中文的竞态；关闭串行恢复英文并阻止迟到的中文挂载，子会话隔离不变
- 设置汉化：离线，无网络请求和遥测；不读取当前设置值或凭据，不写
config.yml - Commands：87 定义、95 个命令名/别名、8 别名、27 个动态回调保持，静态原文/别名漂移 0；六个官方命令实现文件有变化，但未改变显示合同。viewSession、有效服务层级、同步/异步/partial/取消、匹配排序与原 provider 插入执行不变
- Stats：实际官方 OMP 18.12.6 编译 CLI；92 源码/73 客户端与 18.12.5 逐字不变，609 键/105 严格模板保持。真实十一页双语、请求/工具追踪、图表、390px/键盘、同 origin 重启、自然 SSE/React 17→18、37 份完整 API 与 12 项 HTTP 对照已实测。真实系统
/usr/bin/open的原始 URL、每次一次调用、中文/English/刷新及正常/故意断言失败后的定向回收已补验；不再使用 18.12.1 例外，失败历史与分轮资源证据见 CONTEXT.md - 18.6.5：Settings 选项与命令参数原文隔离，修复
/effort参数说明泄漏；omp update透传前恢复官方目录优先，避免上游更新覆盖 PATH 启动器。Stats 18.6.1 客户端与 18.6.0 无变化，既有译文和边界保持 - 18.6.6：保留
/effort的off等官方级别字面量；Errors 页错误特征筛选器的正文与 tooltip 均保持原始错误数据，不与 UI 词典混淆
| 插件 | 已验证 OMP | 声明的宿主范围 |
|---|---|---|
| 0.2.0 | 18.4.4 | >=18.4.4 <19 |
| 18.4.6 | 18.4.6 | >=18.4.6 <19 |
| 18.5.0 | 18.5.0 | >=18.5.0 <19 |
| 18.5.1 | 18.5.1 | >=18.5.1 <19 |
| 18.6.0 | 18.6.0 | >=18.6.0 <19 |
| 18.6.1 | 18.6.0 | >=18.6.0 <19 |
| 18.6.2 | 18.6.0 | >=18.6.0 <19 |
| 18.6.3 | 18.6.0 | >=18.6.0 <19 |
| 18.6.4 | 18.6.0 | >=18.6.0 <19 |
| 18.6.5 | 18.6.1 | >=18.6.1 <19 |
| 18.6.6 | 18.6.1 | >=18.6.1 <19 |
| 18.6.7 | 18.6.3 | >=18.6.3 <19 |
| 18.8.0 | 18.8.0 | >=18.8.0 <19 |
| 18.8.4 | 18.8.4 | >=18.8.4 <19 |
| 18.8.8 | 18.8.8 | >=18.8.8 <19 |
| 18.9.1 | 18.9.1 | >=18.9.1 <19 |
| 18.10.2 | 18.10.2 | >=18.10.2 <19 |
| 18.10.3 | 18.10.3 | >=18.10.3 <19 |
| 18.11.1 | 18.11.1 | >=18.11.1 <19 |
| 18.11.3（历史未发布候选） | 18.11.3（macOS 编译版；资源门禁未通过） | >=18.11.3 <19 |
| 18.12.1 | 18.12.1（macOS/Linux 编译版；默认opener验收例外见上文） | >=18.12.1 <19 |
| 18.12.2（未发布候选） | 18.12.2（本机 macOS 编译版；默认 opener 门禁受阻） | >=18.12.2 <19 |
| 18.12.3（未发布候选） | 18.12.3（本机 macOS 编译版；默认 opener 门禁受阻，分项证据见 CONTEXT） | >=18.12.3 <19 |
| 18.12.5（未发布候选） | 18.12.5（本机 macOS 编译版；默认 opener 实时确认阻塞，完整门禁未通过） | >=18.12.5 <19 |
| 18.12.6 | 18.12.6（macOS 编译版及 macOS/Linux CI；真实默认 opener 补验通过） | >=18.12.6 <19 |
声明范围不等于所有版本都经过验证。内部模块或元数据结构不兼容时，插件报告兼容性错误，不冒险继续覆盖。
从 18.4.6 起，宿主适配发布以目标 OMP 稳定版编号为基线；同一宿主基线上的独立功能或修复递增插件补丁号，不代表上游出现同号版本。已用编号不复用，实际宿主以兼容表为准。上游无设置变更时复用已有译文，但仍验证接口、完整检查和实际编译版；变化需先补译或复核，检查失败不发布。历史版本和标签不覆盖。
设置面板保留官方页签、分组标题、面板标题和操作提示。 设置汉化不修改分组标识、排序或面板实现。从磁盘导入 UI 副本不能证明已修改编译宿主的共享对象；18.4.4 适配时已实测发现这种差异。
Advisor、Prewalk、Mnemopi、Snapcompact、Archive、MCP、LSP、API、eval、工具名、模型名和提供商名等保留更清楚的英文形式。Archive 指 Agent 在 eval 中浏览提示词历史、项目、会话和回顾的只读能力，不是压缩包或归档操作。动态快捷键说明沿用宿主 getter 的实际键位图标；切回原版会恢复原始属性描述符。
当前版本要求官方 OMP >=18.12.6 <19；各版本实际验证基线见上表，是否正式发布以 GitHub Release 为准。发布主线仅 macOS/Linux。Windows PR #1现场仍 CLOSED、isDraft:true、mergedAt:null，草稿由非发布tag archive/windows-support-20261018保留，不宣称正式支持；本地与远端均只有main工作分支。通过官方插件管理器安装：
omp plugin install github:rockythink/omp-settings-zh安装后重新启动 OMP，然后照常输入 /settings。启动默认应用中文，正常应用时保持安静。
Stats 翻译随插件默认安装，不需要另行启用，也没有独立启用命令。正常 GitHub/npm 安装验证时自动生成可撤销 PATH 启动器；重新打开终端即可直接运行 omp stats。本地 link 的首次扩展加载同样自动安装。要求 macOS/Linux、zsh 或 Bash，且 Bun 符合项目 engines；GUI 启动缺少 SHELL 时读取实际账户的登录 shell，不猜测默认值。macOS 下 Bun 缺少账户环境名时按真实 UID 解析，不把 unknown 当作当前账户。
command -v omp 应指向 ~/.local/share/omp-settings-zh/bin/omp；原官方可执行文件不变。安装器只维护自己的 PATH 块，重复加载幂等，不覆盖其他工具的同名文件。已有终端不会继承子进程修改的 PATH，因此需要新终端，但不需要 Stats 开关或安装命令。
/settings-language # 打开原版 / 简体中文选择器
/settings-language zh # 挂载中文显示元数据
/settings-language en # 撤销汉化，恢复宿主原始文案
无需重启；切换后重新打开 /settings 或补全列表即可。这两个模式影响设置和内置命令补全文案，不控制模型回复语言。选择保留在当前进程内，下次启动默认中文，不写入用户配置。
这里的热插拔指汉化效果即时挂载和撤销。OMP 的原生插件安装、禁用、卸载和 /reload-plugins 生命周期不由本插件改写；在当前 OMP 中不能把禁用或 /reload-plugins 当作已加载 Extension 的即时卸载。想立即恢复原版，先执行 /settings-language en，再按需禁用或卸载插件。
omp stats # 官方统计服务 + 默认中文的网页
omp stats --json # 官方原始 JSON，直接透传
omp stats --summary # 官方终端摘要，直接透传网页顶部提供 中文 / English 按钮，切换即时生效。首次默认中文，选择保存在该网页 origin 的 localStorage 中，刷新与路由切换保留；同 host/port 重启也保留，换地址则使用该地址自己的偏好。网页语言与 /settings-language 相互独立。
启动器保留原始 argv、cwd、Profile、stdio 与官方 CLI 的独立评估上下文；非 Stats、JSON、摘要和帮助直接执行原 OMP。Web 模式先构建本地翻译脚本，通过 BUN_OPTIONS --preload 包装该子进程的 Bun.serve 页面响应：仅在官方 Stats HTML 注入同源脚本，在同一个监听器提供 JS，API 与 SSE 保持原处理器。只有原官方 Stats 服务，原 --port / -p、--host、浏览器打开动作和 URL 均不变；默认地址 http://127.0.0.1:3847 直接显示语言按钮，不再输出第二个代理地址。现有 BUN_OPTIONS 保留；Ctrl+C/正常退出清理子进程与私有预加载文件。
会话里的 /stats 不被接管，仍为官方入口。与终端 omp stats 使用相同 Profile / Agent 数据目录时，两者都汇总该目录内的多个项目与会话，不是全局与单会话的区别；/stats 的付费评估绑定当前会话，而 CLI 使用独立上下文。/trace 是当前会话的追踪深链接。
译文仅覆盖已识别的界面标题、导航、说明、控件、空态和显示属性。模型、提供商、工具与项目名称、路径、请求和会话正文、原始错误、统计数值及 API 返回内容保留原文；未知文案与 canvas 文字也保留原文，不宣称完整 Web 汉化。Frustration 的评估和费用确认继续使用官方流程，语言按钮不会发起评估。
这是 Bun 启动期 Hook，而非 OMP 正式 Locale 接口；只对新启动的 CLI 生效，不热注入已运行的服务。OMP/Bun 升级必须重新验证真实编译版。浏览器未能自动打开时使用原 CLI 输出的 URL；绝对路径执行原 OMP 会绕过启动器，保持原版行为。
omp plugin list --json
omp plugin doctor omp-settings-zh --json
omp plugin upgrade omp-settings-zh
omp plugin disable omp-settings-zh
omp plugin enable omp-settings-zh
omp plugin uninstall omp-settings-zh升级、启用或禁用后重新启动 OMP，以加载新的 Extension 状态。/settings-language 控制设置与内置命令补全文案；Stats 默认中文，只在网页内切换中文 / English，没有独立命令开关。禁用 Extension 不撤销已有 CLI 启动器。通过前置 PATH 的正常 omp plugin uninstall omp-settings-zh 卸载时，先预检受管文件，官方卸载成功后自动清理启动器和 PATH 块；--dry-run 不清理。撤销仅影响本插件创建的内容，不迁移用户设置。
当前 OMP 支持按插件名更新 GitHub/npm 安装的插件：omp plugin upgrade omp-settings-zh。GitHub 插件重新解析安装时记录的分支或标签；固定标签不会自动跳到新标签。也可以使用 omp plugin install github:rockythink/omp-settings-zh --force 重新安装仓库默认分支。npm 插件更新到最新发布版本，本地 link 插件直接使用源目录文件，无需 upgrade。
omp plugin upgrade 不带插件名时仅更新 marketplace 插件，不会遍历 GitHub/npm 插件。当前实现的 upgrade 不处理 --dry-run，不要用它预览更新；需要预览重新安装时使用 omp plugin install github:rockythink/omp-settings-zh --force --dry-run。
bun install --frozen-lockfile
bun run check
omp plugin link . --scope projectbun test：设置可逆性与原生面板契约；单服务预加载的服务隔离、原授权/错误状态、SSE 流式与启动器安装/卸载边界。bun run typecheck：TypeScript 类型检查。bun run coverage:check：设置项翻译完整性。bun run drift:check：设置路径、选项值和英文原文哈希漂移。bun run commands:check：全量内置命令覆盖、新增/删除、原文、别名及标识冲突门禁；已纳入bun run check。复用运行时的原文匹配规则，仅允许已知动态快捷键占位变化。bun run smoke：真实宿主元数据的三轮应用/撤销、原生面板派生、行为元数据不变和零网络请求检查。
面板或宿主适配变化还必须在实际使用的官方编译版中验证加载、中文搜索、设置编辑和同进程语言切换。源码模式通过不代表编译版共享对象可用。
命令补全适配须另在真实编译版验证 / 列表、别名、动态状态/键位、中英文往返及 Tab/Enter 插入和执行。静态命令门禁只检查锁定开发依赖，不代替升级后的宿主注册表、动态模板源码审查或实际 UI 验证。Stats 也需独立完成实际官方 CLI 与浏览器验证。
翻译按完整 setting path 和 option value 绑定，禁止按英文字符串全局替换；活动译文仅依据目标 OMP 的官方英文元数据独立生成与复核。
详见 项目上下文、产品需求、技术设计、翻译规范、贡献指南 和 第三方声明。
本项目不是 Oh My Pi 官方项目。OMP 名称、源码和产品归其原作者及贡献者所有。本项目提供独立的简体中文设置显示元数据与 Stats 网页显示适配。