ainiee-translate
独立、Agent 原生的小说翻译系统（任意源 → 目标语言，不限中译）——工作方式类似 AiNiee，但不依赖 AiNiee 应用运行（无 GUI / HTTP / MCP）。由**编码 agent 本身（Claude Code / Codex）**充当翻译引擎，跑在订阅额度上，而非按 token 计费的外部 API。
安装
前置依赖：本版本自包含——解析/导出已内置（skills/ainiee-translate/scripts/ainiee_translate/_vendor/，改写自 AiNiee、剥离其 App 框架），无需克隆 AiNiee 仓库。只需一个装了几个轻量库的 Python（≥3.12）：
python3 -m venv ~/.venvs/ainiee-translate
~/.venvs/ainiee-translate/bin/pip install msgspec beautifulsoup4 lxml rich openpyxl polib python-pptx chardet
自带格式：epub / txt / md / docx / xlsx / pptx / csv / srt / vtt / ass / lrc / po / json 系列等。仅 PDF 与 Windows Office 转换未自包含——要用时设 AINIEE_REPO 回退到 AiNiee。安装技能后设 SKILL_DIR（技能目录）与 AINIEE_PY（上面 venv 的 python）即可。
方式一：作为 Claude Code 插件安装（推荐）
/plugin marketplace add xuanji86/ainiee-translate-skill
/plugin install ainiee-translate@ainiee-translate
之后按 skills/ainiee-translate/SKILL.md「前置依赖与安装」设三个环境变量（SKILL_DIR 指向已安装的技能目录、AINIEE_REPO 指向本地 AiNiee 仓库、AINIEE_PY 指向 AiNiee venv 的 python），即可对它说「用 agent 翻译这本 epub」。更新：/plugin marketplace update ainiee-translate 后 /reload-plugins。
方式二：手动安装（不走插件）
git clone https://github.com/xuanji86/ainiee-translate-skill.git
cp -r ainiee-translate-skill/skills/ainiee-translate ~/.claude/skills/ # 个人技能目录
技能自带管道脚本（skills/ainiee-translate/scripts/），无需 pip install；同样设好上面三个环境变量即可。
方式三：在 Codex（OpenAI Codex CLI）中使用
SKILL.md 是跨平台标准格式，可直接装进 Codex 的技能目录（~/.codex/skills），Codex 会自动发现：
git clone https://github.com/xuanji86/ainiee-translate-skill.git
ln -s "$PWD/ainiee-translate-skill/skills/ainiee-translate" ~/.codex/skills/ainiee-translate
设好 SKILL_DIR（指向 ~/.codex/skills/ainiee-translate）、AINIEE_REPO、AINIEE_PY，对 Codex 说「用 ainiee-translate 翻译这本 epub」即可。工具名对照（Bash→shell、Task→spawn_agent…）、多 agent 并行所需的 multi_agent 配置见 skills/ainiee-translate/references/codex-tools.md。
它做什么
- 复用 AiNiee 的
ModuleFolders.Domain 解析/导出模块当库（epub 等格式），不跑其应用。
- 取 AiNiee 公共术语表为 seed，清洗并锁定一张工作权威表（去重、归一、人名/地名分类）。
- 由 agent 按 AiNiee 原生提示词 ＋ 用户自定义提示词（自己写规则，如人名/头衔/风格，复用 AiNiee 配置或手写）＋ 锁定表 逐章翻译，写回缓存并导出成品。
- 状态驱动、可恢复、可跨时间窗；三种介入模式（抽样自动 / 每章过目 / 全自动）。
- 导入已有项目：直接导入 AiNiee 的工程缓存（
AinieeCacheData.json）或既有 cache.json，接着续翻 / 润色 / 校验 / 重新导出（缓存自带原书路径，导出无需再指）。
- 模块化：把整套任务设置（翻译/润色提示词、词汇表、禁翻表、风格、源/目标语言）存成可复用模块（
~/.ainiee-translate/modules/），一个插件应对不同书；可一键从 AiNiee profile 导入。
- 命令菜单：装成插件后用
/ainiee-translate:* 斜杠命令完成导入/切换模块、生成提示词、翻译、润色、导出、校验等（/ainiee-translate:menu 看清单）。
命令
分两层：斜杠命令（装成插件后用，/ainiee-translate:*）和它们底层调用的 Python CLI（Codex / 手动 / 调试用）。多数命令需先设好 AINIEE_REPO、AINIEE_PY、SKILL_DIR 三个环境变量（见上「安装」）。
斜杠命令（13 个）
翻译流程
| 命令 | 用法 | 作用 |
|---|
/ainiee-translate:translate | <输入文件> [模块名] | 端到端翻译一本 epub/txt（解析→词汇表→翻译→导出→校验） |
/ainiee-translate:import-project | [list | <AinieeCacheData.json 或项目ID> <项目目录>] | 导入已有项目（AiNiee 缓存或既有 cache.json）继续翻译/润色/校验/导出 |
/ainiee-translate:glossary | [--config PATH] [--analysis PATH] | 从 AiNiee 配置/profile 构建并锁定工作词汇表 |
/ainiee-translate:polish | [批大小] | 对已翻译文本跑润色 pass（按模块润色提示词二次加工） |
/ainiee-translate:export | <原始输入文件> | 把翻译好的缓存导出为成品 epub/txt |
/ainiee-translate:verify | （无参数） | 校验残留规则违规（漏译、人名未保留） |
/ainiee-translate:status | （无参数） | 查看项目状态（已绑模块 / 未译·已译计数 / 续跑点） |
模块与提示词
| 命令 | 用法 | 作用 |
|---|
/ainiee-translate:import-profile | <profile.json> <模块名> | 导入 AiNiee profile/config 为可复用模块 |
/ainiee-translate:module | <list|show|create|load> [名字] [--work 项目目录] | 管理模块（列出/查看/新建/加载进项目） |
/ainiee-translate:switch-prompt | [模块名] | 切换当前项目使用的模块/提示词 |
/ainiee-translate:show-prompt | [模块名] | 查看模块的提示词与词汇表摘要 |
/ainiee-translate:gen-prompt | <translate|polish> [模块名] | 让 agent 帮你起草翻译/润色提示词（AiNiee 风格）写进模块 |
/ainiee-translate:menu | （无参数） | 显示命令菜单 |
底层 Python CLI
前缀 <PFX> = AINIEE_REPO="$AINIEE_REPO" PYTHONPATH="$SKILL_DIR/scripts" "$AINIEE_PY"，调用形如 <PFX> -m ainiee_translate.<模块> …：
