AiNiee Documentation

一款专注于Ai翻译的工具,一键自动翻译RPG SLG游戏,Epub TXT小说,PDF Word MD文档,Srt Vtt Lrc字幕等等复杂长文本。

5,622 stars Python Python 1 file · ~2,832 tokens
RAW Doc

File: README.md


软件介绍🧾

  • 格式全能,覆盖广泛

    • 🎮 游戏翻译:深度支持 Mtool, Renpy, Translator++, ParaTranzr, VNText, SExtractor 等游戏文本导出工具。
    • 📚 多样支持:轻松处理 I18Next/.trans/Po/CSV 数据、Epub/TXT 电子书、Srt/Ass/Vtt/Lrc 字幕、Word/PDF/MD/PPT 文档等。
  • 智能高效,省时省心

    • 🚀 一键操作:一拖一点,自动识别文件与语言,无需设置。
    • ⏱️ 极速翻译:喝杯可乐的工夫,就能拿到译文。
  • 长文优化,质量出众

    • 🎯 突破局限:采用轻盈翻译格式、思维链翻译、AI术语表、上下文关联等技术,确保长文本翻译的连贯性与准确性。
    • 💎 质量追求:支持 基础提示、角色介绍、背景设定、翻译风格 等提示词调整,拥有 一键AI润色、一键提取术语 等功能,满足对翻译质量有更高要求的用户。

项目推荐 ✨

  • ReaDreamAI(作者:NEKOparapa) - 阅你所想,绘你所梦,从一个想法到一本完整的精彩小说。ReaDreamAI为你包办写作、插图与视频。
  • Wintermute(作者:NEKOparapa) - 一个长期陪伴你的个人 AI 执事。它会通过对话、录音、视频和更多关于你的数据流,逐渐理解你的语言习惯、长期偏好、正在推进的计划,以及你不希望被越过的边界。
  • AiNiee-Next(作者:ShadowLoveElysia) - 针对 AiNiee 核心逻辑进行工程化重构的命令行版本,引入 uv 与运行时稳定性优化,适合长时间挂机、服务器部署及自动化工作流。
  • ainiee-translate-skill(作者:xuanji86) - 独立、Agent 原生的小说翻译系统(任意源 → 目标语言,不限中译)

AiNiee三步走 📢

  • 第一步:配置接口

  • 第二步:拖入文件夹

    • 输入文件夹:将原文文件单独放置新的文件夹,并将该文件夹拖入框内。小说、字幕、文档可直接进行翻译,游戏需要文本提取工具进行配合。
  • 第三步:开始翻译


游戏翻译[](#游戏翻译)

工具准备

  • 📖游戏文本提取工具

    工具名 介绍 项目类型
    Mtool 上手简单,推荐新人使用 Mtool导出文件
    Translator++ 上手复杂,功能强大,推荐大佬使用 T++导出文件或Trans工程文件
    ParaTranz 上手中等,功能强大,推荐大佬使用 ParaTranz导出文件
    RenPy SDK 上手中等,功能强大,推荐大佬使用 renpy导出文件
  • 🧰本地模型运行工具

    工具名 说明
    Sakura_Launcher_GUI Sakura模型的专属GUI启动器
    LM Studio 一个本地部署大语言模型(LLM)平台,致力于简化LLM的使用和管理。
    ollama 开源跨平台大模型工具

翻译教程


功能说明[](#功能说明)

设置说明

表格说明

其他说明

  • 多key轮询

    如果想使用多个key来分担消耗压力,根据key数量进行加速翻译,请使用同类型账号的key,而且输入时在每个key中间加上英文逗号,不要换行。例如:key1,key2,key3

  • 批量文件翻译

    把所有需要翻译的文件放在输入文件夹即可,也支持多文件夹结构

  • 配置迁移

    配置信息都会存储在resource的config.json中,下载新版本可以把它复制到新版本的resource中。


贡献指南[](#贡献指南)

  • 改进或增加支持文件: 需要有一定的代码编程能力,拉取源码进行改进。文件具体读取代码在ModuleFolders\FileReader与FileOutputer文件夹中。读写器系统编写指南。UI支持在UserInterface\Setting的ProjectSettingsPage。

  • 完善正则库: 正则库的完备将极大帮助游戏内嵌工作的进行,并利好下一次游戏翻译工作和造福其他翻译用户,正则库在Resource\Regex文件夹中

  • 改进界面翻译: 多语言界面的UI文本可能翻译不够准确合适,可以提交你的修改意见,或者直接进行修改。本地化文本在Resource\Localization文件夹中


特别声明[](#特别声明)

该款AI翻译工具仅供个人合法用途,任何使用该工具进行直接或者间接非法盈利活动的行为,均不属于授权范围,也不受到任何支持和认可。

  • 关于开发者 @neavo 合作说明: 在AiNiee v5.2版本,已退出AiNiee的开发工作。我们对他在此期间(2024-09至2025-02),特别是在V5版本的UI改良美化所付出的努力表示非常感谢。详细说明

  • 交♂交流群: Q群(反馈与交流):7296101五零,Q群(聊天吹水):8216248九零,入群答案:github。备用TG群:https://t.me/+JVHbDSGo8SI2Njhl ,


赞助💖


File: README_EN.md


Introduction🧾

  • All-in-One Format Support, Broad Coverage

    • 🎮 Game Translation: In-depth support for game text export tools like Mtool, Renpy, Translator++, ParaTranzr, VNText, and SExtractor.
    • 📚 Diverse Support: Effortlessly processes I18Next data, Epub/TXT e-books, Srt/Vtt/Lrc subtitles, Word/PDF/MD documents, and more.
  • Smart & Efficient, Saves Time & Effort

    • 🚀 One-Click Operation: Simply drag and drop; automatically identifies files and languages, no setup required.
    • ⏱️ Rapid Translation: Get your translated text in the time it takes to enjoy a cup of tea.
  • Optimized for Long Texts, Exceptional Quality

    • 🎯 Overcoming Limitations: Employs techniques like streamlined translation formats, chain-of-thought translation, AI glossaries, and contextual awareness to ensure coherence and accuracy in long-text translations.

    • 💎 Quality Focus: Supports prompt adjustments for basic instructions, character introductions, background settings, translation styles, etc. Equipped with features such as one-click AI refinement, one-click AI formatting, and AI terminology extraction, it caters to users who demand higher translation quality.


Three Steps to Use AiNiee 📢

  • Step 1: Configure Interface

  • Step 2: Drag into the folder

    • Target Language: In the translation settings, change the target language to the one you need.

    • Input Folder: Place the original files in this folder; novels, subtitles, documents can be translated directly, games require text extraction tools

  • Step 3: Start Translation


Feature Description[](#feature-description)

Settings Description

Table Description

Other Notes

  • Multiple Key Rotation

    If you want to use multiple keys to distribute the load and speed up translation based on the number of keys, please use keys from the same account type. When inputting, add an English comma between each key, without line breaks. For example: key1,key2,key3

  • Batch File Translation

    Simply place all files that need translation into the input folder. It also supports multi-folder structures.

  • Configuration Migration

    Configuration information is stored in resource/config.json. When you download a new version, you can copy this file to the resource folder of the new version.


Contribution Guidelines[](#contribution-guidelines)

  • Improve or Add Supported Files: Requires some programming ability to pull the source code and make improvements. Specific file reading code is in the ModuleFolders\FileReader and FileOutputer folders. Reader-Writer System Development Guide. UI support is in UserInterface\Setting\ProjectSettingsPage.

  • Improve the Regex Library: A comprehensive regex library will greatly help with in-game embedding work and benefit future game translation work and other translation users. The regex library is in the Resource\Regex folder

  • Improve Interface Translation: The UI text for multilingual interfaces may not be translated accurately or appropriately. You can submit your modification suggestions or make changes directly. Localization text is in the Resource\Localization folder


Special Statement[](#special-statement)

AiNiee's continuous development and iteration to this day is due to ongoing personal research and development of key functional frameworks since the project's inception, user feedback and suggestions, and the joint efforts and creations of contributors through PRs.
This is a process of continuous exploration, improvement, and joint construction over two years, which has formed AiNiee's relatively mature and complete AI translation system today.
Please respect the open-source spirit while using and learning, attribute the source project, and don't forget to give the project a star.

This AI translation tool is for personal legal use only. Any direct or indirect illegal profit-making activities using this tool are not within the scope of authorization and are not supported or endorsed.