{
  "markdown": "# i18n-vue\n\n这是一个面向 Vue / 静态 HTML / 微信小程序项目的 i18n 自动化插件与技能集合，提供初始化 i18n、自动替换中文、同步翻译、全流程工作流，以及扫描/翻译/审核子代理能力。兼容 Claude CLI、Gemini CLI、Codex。\n\n## 插件结构（官方标准）\n\n- `.claude-plugin/plugin.json`：插件元数据（必需）\n- `skills/`：可调用技能（`i18n-init`、`i18n-replace`、`i18n-sync`、`i18n-workflow`）\n- `agents/`：子代理（`i18n-files`、`i18n-text`、`i18n-code`）\n- `GEMINI.md`：Gemini CLI 入口与执行约定\n- `CODEX.md`：Codex 入口与执行约定\n\n## 3 个 AI Agent 安装方式（推荐按需选择）\n\n### 1) Claude CLI 安装（插件方式）\n\n其他用户可直接通过以下命令安装：\n\n```bash\n/plugin marketplace add Chyelong/i18n-vue-plugin\n/plugin install i18n-vue@i18n-vue-plugin\n```\n\n安装后可用命令示例（自动带插件命名空间）：\n\n```bash\n# Vue 项目\n/i18n-vue:i18n-workflow ./src --langs en\n/i18n-vue:i18n-init ./src/i18n --langs en,ja\n/i18n-vue:i18n-replace ./src/views --lang en\n/i18n-vue:i18n-sync ./src --lang en\n\n# 微信小程序\n/i18n-vue:i18n-workflow ./pages --type wx --langs tw\n/i18n-vue:i18n-init ./i18n --type wx --langs tw\n/i18n-vue:i18n-replace ./pages --type wx --lang tw\n```\n\n本地调试：\n\n```bash\nclaude --plugin-dir /absolute/path/to/i18n-vue-plugin\n```\n\n---\n\n### 2) Gemini CLI 安装（仓库方式）\n\nGemini 当前按“仓库技能”方式使用，不读取 `.claude-plugin/*`。步骤如下：\n\n1. 克隆仓库\n\n```bash\ngit clone https://github.com/Chyelong/i18n-vue-plugin.git\ncd i18n-vue-plugin\n```\n\n2. 在 Gemini 会话中让其读取 `skills/*/SKILL.md` 与 `agents/*.md`\n3. 执行脚本命令（示例）：\n\n```bash\n# Vue 项目\nnode skills/i18n-init/i18n-init.js ./src/i18n --type vue --langs en,ja\nnode skills/i18n-replace/vue-i18n-replace.js ./src --i18n-dir ./src/i18n --lang en\nnode skills/i18n-sync/sync-i18n.js ./src --i18n-dir ./src/i18n --lang en\n\n# 微信小程序\nnode skills/i18n-init/i18n-init.js ./i18n --type wx --langs tw\nnode skills/i18n-replace/wx-i18n-replace.js ./pages --i18n-dir ./i18n --lang tw\n```\n\n详细约定见：`GEMINI.md`\n\n也支持 Gemini 扩展安装方式（推荐）：\n\n```bash\ngemini extensions install https://github.com/Chyelong/i18n-vue-plugin.git --auto-update\n```\n\n常用管理命令：\n\n```bash\ngemini extensions update i18n-vue\ngemini extensions uninstall i18n-vue\n```\n\n---\n\n### 3) Codex 安装（仓库方式）\n\nCodex 当前按“仓库技能”方式使用，不读取 `.claude-plugin/*`。步骤如下：\n\n1. 克隆仓库\n\n```bash\ngit clone https://github.com/Chyelong/i18n-vue-plugin.git\ncd i18n-vue-plugin\n```\n\n2. 在 Codex 会话中让其读取 `skills/*/SKILL.md` 与 `agents/*.md`\n3. 执行脚本命令（示例）：\n\n```bash\n# Vue 项目\nnode skills/i18n-init/i18n-init.js ./src/i18n --type vue --langs en,ja\nnode skills/i18n-replace/vue-i18n-replace.js ./src --i18n-dir ./src/i18n --lang en\nnode skills/i18n-sync/sync-i18n.js ./src --i18n-dir ./src/i18n --lang en\n\n# 微信小程序\nnode skills/i18n-init/i18n-init.js ./i18n --type wx --langs tw\nnode skills/i18n-replace/wx-i18n-replace.js ./pages --i18n-dir ./i18n --lang tw\n```\n\n详细约定见：`CODEX.md`\n\n也支持 Codex 的远程安装说明模式（Fetch and follow）：\n\n```text\nFetch and follow instructions from https://raw.githubusercontent.com/Chyelong/i18n-vue-plugin/refs/heads/main/.codex/INSTALL.md\n```\n\n## 安装后更新方式\n\n### Claude CLI（插件）\n\n```bash\n/plugin update i18n-vue\n```\n\n如果是本地 `--plugin-dir` 调试方式，先拉代码再重载：\n\n```bash\ngit pull\n/reload-plugins\n```\n\n### Gemini CLI（扩展）\n\n手动更新：\n\n```bash\ngemini extensions update i18n-vue\n```\n\n如果安装时使用了 `--auto-update`，会按 Gemini 的机制自动更新：\n\n```bash\ngemini extensions install https://github.com/Chyelong/i18n-vue-plugin.git --auto-update\n```\n\n### Codex（仓库技能）\n\n更新本地仓库：\n\n```bash\ncd ~/.codex/i18n-vue-plugin && git pull\n```\n\n如果你是用远程安装说明模式，也可以重新执行一次：\n\n```text\nFetch and follow instructions from https://raw.githubusercontent.com/Chyelong/i18n-vue-plugin/refs/heads/main/.codex/INSTALL.md\n```\n\n## 本地开发调试（Claude 插件）\n\n修改后可在 Claude 会话中执行：\n\n```bash\n/reload-plugins\n```\n\n## i18n-validate 审核脚本（v2.6.1 起）\n\n新版审核分成两层：\n\n1. **脚本层 `skills/i18n-replace/i18n-validate.js`** — 机械化高危模式扫描 + 翻译质量检查，输出结构化 JSON\n2. **Agent 层 `agents/i18n-code.md`** — 读取 validator 产出的 JSON，对每条命中做语义判断（confirmed / falsePositive / needsContext）\n\n### 内置规则（38+ 条）\n\n| 分类 | 数量 | 说明 |\n|------|-----|------|\n| V01-V10 | 10 | Vue 项目高危模式（switch、等值、路由 name、habit 等） |\n| W01-W08 | 8  | 微信小程序高危模式（`global.$t` 前缀） |\n| H01-H05 | 5  | 静态 HTML/JS（`data-i18n-value` 等） |\n| A1-A14  | 14 | 跨类型踩坑（对象 key、嵌套 $t、`body`、`$mode`、HTML 注释残留、弯引号、￥/¥ 等） |\n| C1-C4   | 4  | 翻译质量（变量名保护、简繁漂移、重复值、空值白名单） |\n\n### 用法\n\n```bash\n# 文本报告（默认）\nnode skills/i18n-replace/i18n-validate.js src/ --type vue --i18n-dir src/i18n --lang tw\n\n# JSON 报告（供 agent 审核使用）\nnode skills/i18n-replace/i18n-validate.js src/ --type vue --i18n-dir src/i18n --lang tw \\\n  --format json --out .i18n-issues.json\n```\n\n**退出码**：`0` 全绿 / `1` 有 🔴 严重 / `2` 有 🟠 高危 / `3` 脚本错误\n\n报告每条命中带规则 ID（如 `[V01]`、`[A4]`），规则详情查 `skills/i18n-replace/validate-rules.js` 或 `docs/superpowers/specs/2026-04-11-audit-system-upgrade-design.md`。\n\n## 替换脚本事前预防（v2.6.1 起）\n\n为减少 validator 反复报错的负担，vue/wx/html 替换脚本在源头做了更全面的预防扫描：\n\n**已修复的脚本 bug（v2.6.1）**：\n\n- Vue/HTML 脚本不再把 HTML 注释吞进 `$t()` / `data-i18n`\n- Vue 脚本把跨行模板文本合并为单行（避免 Vue 2 buble `Unterminated string constant`）\n- Vue 脚本对含双引号的文本用智能包裹（`smartQuoteAndWrap`），避开 `\\\"` 转义陷阱\n\n**三脚本统一的源头跳过规则（v2.6.1）**：\n\n| 规则 | 触发位置 | 说明 |\n|------|---------|------|\n| body 字段 | `body: '中文'` | 支付网关订单描述，翻译后对账失败 |\n| $mode 字段 | `$mode: '中文'` | 业务标识，用于 storage/逻辑判断 |\n| checkOperate name | `checkOperate({ name: '中文' })` | 内部用 indexOf 匹配原文 |\n| 双用途字段 | `tag_name/tag_box_name/recharge_tag_name = '中文'` | 同时用于后端数据和 UI 展示 |\n| 对象字面量 key | `{ '中文': value }` | JS 语法：对象 key 不能是函数调用 |\n| EventBus 事件名 | `$bus.on/emit('中文')` | 跨文件配对必须一致 |\n| 路由 name | `$router.push({ name: '中文' })`、`showRouter('中文')` | 路由技术标识符 |\n\n这些规则被替换脚本识别后会保留原始中文字符串，并在 `skippedLogic` 中输出原因供审查。\n\n## 支持的项目类型\n\n| 类型 | 文件 | 替换方式 | 初始化核心文件 |\n|------|------|----------|---------------|\n| Vue | `.vue` `.js` | `$t()` / `{{ $t() }}` | `index.js` |\n| 静态 HTML/JS | `.html` `.js` `.ts` | `window.$t()` / `data-i18n` | `index.js` |\n| 微信小程序 | `.wxml` `.js` | `global.$t()` / `{{$t['key']}}` | `i18n.js` + `i18n-behavior.js` |\n\n## 发布前检查清单\n\n- `plugin.json` 中 `name`、`version`、`description` 已填写\n- `marketplace.json` 已包含 `name`、`owner`、`plugins`\n- `gemini-extension.json` 已存在且版本号已更新\n- `GEMINI.md` 已说明 Gemini 使用方式\n- `CODEX.md` 已说明 Codex 使用方式\n- `skills/*/SKILL.md` 与 `agents/*.md` 可正常读取\n- 安装命令可直接从 Git 地址拉取\n",
  "bytes": 5907,
  "sha": "5b0241f7075e094c169ea2ac072e7d064065d3e7389609160b8dee77cda1da06",
  "repo_slug": "chyelong/i18n-vue-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_chyelong_i18n_vue_plugin_568e6ecf/readme"
}