localize-plugin-storelisted
Install: claude install-skill tyh5410/codex-plugin-store-localizer
# Codex 插件商店本地化
需要查看当前远端目录缓存和本地词库的覆盖差距时,可运行只读报告:
```bash
/usr/bin/python3 ../../scripts/catalog_report.py --limit 20
```
报告不会联网、不会改动官方缓存,也不会自��生成或写入翻译。
需要更新全量词库时,使用 `generate_catalog_translations.py`。生成器以官方
目录全部 `LISTED` 项目为分母,使用稳定项目 ID 生成覆盖清单;运行时词库
按项目名和英文原文精确匹配。不得再使用固定精选项目列表作为全量依据。
使用插件根目录的 `scripts/manage.py` 管理独立启动器。启动器通过 Chromium 的私有 pipe 调试通道,将固定、本地可审计的词库注入最终渲染页面。简中使用全量词库 `assets/dom-translations.zh-Hans.json`;其他语言使用审计过的 `assets/locale-packs.json`,未收录的目录内容保留英文。
## 语言
支持 15 种语言:`zh-Hans`、`zh-Hant`、`en`、`ja`、`ko`、`es`、`fr`、`de`、`pt-BR`、`ru`、`ar`、`hi`、`id`、`tr`、`vi`。
查看当前选择和支持列表:
```bash
/usr/bin/python3 ../../scripts/manage.py locale
```
切换语言(下次从启动器打开时生效):
```bash
/usr/bin/python3 ../../scripts/manage.py locale ja
```
也可设置进程环境变量 `CODEX_PLUGIN_STORE_LOCALE` 临时覆盖保存的选择。阿拉伯语会在插件目录页启用从右到左排版。
## 边界
- 不修改 macOS `ChatGPT.app`、Windows `.exe`、官方插件源码、公共目录响应或 Codex 目录缓存。
- 只处理 `app://` 渲染目标,且只在插件名称与英文原文都匹配时替换说明。
- 不开放 TCP 调试端口,不提供通用 JavaScript 执行接口,不上传 DOM 或会话内容。
- 英文原文或 DOM 结构变化时停止匹配并报告,不猜测替换。
- 全量词库使用索引和��量 DOM 扫描;注入异常时保留 Codex 正常运行并降级为英文。
- 普通方式启动没有注入效果;必须从安装后的“ChatGPT 插件商店汉化版”入口启动。macOS 入口是 `.app`,Windows 入口是 `%LOCALAPPDATA%\\Codex Plugin Helpers\\ChatGPT 插件商店汉化版.cmd`。
## 工作流
脚本路径相对于本 `SKILL.md` 所在目录。先运行只读检查:
```bash
/usr/bin/python3 ../../scripts/manage.py status
```
安装或更新稳定运行时目录和用户级启动入口(macOS `.app` / Windows `.cmd`)是外部写操作;必须有用户当前请求的明确授权:
```bash
/usr/bin/python3 ../../scripts/manage.py install
```
安装不会自动退出当前 ChatGPT。真实界面验证需要先保存当前任务,完全退出 ChatGPT,再从新入口启动。只有用户