LinguaFlow

AI 驱动的多语言翻译工作台

LinguaFlow 帮助你将文档、字幕、电子书等内容翻译成多种语言。上传源文件，配置 AI 后端，即可开始批量翻译。支持术语管理、质量检测、翻译审核、进度追踪，让翻译工作更高效、更准确。

以项目为单位组织翻译工作。每个项目设置源语言和目标语言，上传源文件后即可创建翻译任务。

• 创建、编辑、删除项目
• 内置 12 种语言预设（英、简中、繁中、日、韩、西、法、德、葡、俄、阿拉伯、意大利）互译，源语言支持自动识别
• 项目级别的术语表管理

集成主流 AI 翻译服务，支持自定义翻译策略和提示词。

• 支持 OpenAI、Anthropic、Google Gemini
• 兼容 Azure OpenAI、Ollama、LM Studio 等 OpenAI API 兼容服务
• 统一思考强度（thinking_level）：最低 / 低 / 中 / 高档位与显式关闭，由适配层映射为各厂商原生参数
• 超时可关闭：适配本地大模型或慢响应网关
• 流式请求模式（stream），适配只接受 stream:true 的兼容网关，内部累积为完整响应后返回
• 自动检测源语言
• 上下文感知，保持段落间连贯性
• 代码块、链接、占位符等特殊内容自动保护
• 即时翻译：首页就是一个翻译框，粘贴单段文本即可出译文，可挂术语表，译文临时不落库
• 单段试译预览：对单段原文用某执行计划先跑一遍看效果，带诊断详情，满意后再应用译文
• 单段修订预览：以段落上待处理的语义问题为修复目标，对现有译文做定点最小修订，预览满意后再应用写回

一次翻译整个目录的文件，支持增量更新；每个文件内部可按段落分批并发调用模型。

• 拖拽上传文件或文件夹（多文件合并为批次任务，按文件数汇总进度）
• 增量更新：保留已有译文，仅翻译新增内容
• 文件内段落分批并发（目录/资源之间按顺序处理）
• 实时进度追踪，预估剩余时间
• 任务可暂停 / 恢复：从轮次断点续跑，已完成译文不重跑；失败或取消的任务也可断点重试

针对电子书与办公文档的专用支持。

• EPUB：编辑视图左侧章节侧栏按章节浏览与翻译、章节级进度、HTML 内容预览，支持章节级批量翻译 / QA 重检；译文全程校验 XML 结构合法性，保证导出的电子书始终可正常打开
• DOCX：直接解析 Word ZIP + XML，保留样式外壳
• HTML：按块级元素切段，结构字节级回写

创建术语表确保专业词汇翻译一致。支持自动术语提取，让 AI 帮你发现关键术语。支持术语精简，自动识别冗余和冲突条目。

• CSV 格式导入导出
• 禁译（forbidden）/ 强制（mandatory）属性：禁译词不得出现在译文，强制词须使用指定译法，由规则质检自动核验
• 自动术语提取（Bootstrap）
• 术语精简（Prune）— 诊断冗余、冲突、低质量条目
• 术语修改后自动同步已翻译段落

逐段查看翻译结果，支持批量审核与质量定位。内置规则质检与 AI 语义质检双层把关，自动发现翻译问题并在译文中高亮定位。

• 按状态筛选（待翻译/已翻译/已编辑/已批准/已驳回）
• 按质量问题筛选（长度异常、重复翻译、未翻译、源语残留，以及逐字直译、漏译、增译等语义类问题）
• 译文修改 + 键盘导航；批量通过/拒绝；添加备注
• 搜索定位（Ctrl+F）：跨章节搜索原文 / 译文，支持正则、全字、大小写选项，结果一键跳转并在正文高亮
• 搜索替换：对译文批量查找替换（子串/正则、区分大小写、全字匹配），先预览影响范围再应用，可撤销
• 质量问题人工驳回：判定不是问题的可标记驳回（可撤销），已驳回问题不再计入筛选与自动修复
  • 质量检测：
  • 规则质检（19 项确定性 checker）：长度异常、重复、未翻译、源语残留、标点配对、标点缺失、标点多出、外层引号包裹丢失、异常空白、全/半角混用、文字系统混用（如简繁混排）、数字/URL/邮箱/字幕行数不一致、禁译/强制术语命中、占位符残留、XML 标签不一致、跨段同源异译等；另由翻译轮产出注音守恒警告
  • 语义质检（LLM）：捕获规则查不出的语义错误（逐字借译、术语误译、漏译、增译、语法错误、语体错位等），结果带文本区间高亮、直接进人审
  • 本地改写：纯本地机械修复译文丢引号、全/半角混用等高频安全问题，不调 LLM
  • LLM 修订：调 LLM 对现有译文按待处理语义问题做定点最小修订，系统提示词内置
  • AI 质量裁决：对软规则误报逐条复核降噪（见下）
  • QA 重检：按执行配置当前质检设置对既有译文重跑 QA，继承人工裁决、不动译文

自定义翻译流水线的每个环节。

• 提示词模板：翻译、术语提取、术语精简三类独立模板
• 执行配置：分段策略、内容保护、响应修复、质量检测等
• 执行计划：组合后端、提示词、配置，定义模式化多轮翻译流程（翻译、提取、本地改写、LLM 修订、质量裁决、语义质检轮次），顶层引用执行配置

规则质检偏敏感，难免误报。质量裁决轮次（adjudicate）调用 AI 对已标出的问题逐条复核，将明确误报标记为「已驳回」（保留记录，不再计入筛选与修复），实现质检降噪；也可在审校界面对单条质量问题人工驳回或撤销裁决。可裁决 source_residual（源语残留）、punctuation_surplus（标点多出）、length_ratio（长度异常）与 untranslated（未翻译）等软规则——未翻译检测按语言对分级（源/目标语共用文字系统时降为警告），专名、品牌等合理原样保留可由裁决复核；duplicate（重复翻译）为硬规则，不可裁决。

裁决只对已有规则问题做"保留/驳回"、不新增问题；若需捕获规则查不出的语义错误（逐字借译、漏译、增译、语法错误、语体错位等），可在执行计划中再加一轮语义质检（semantic_qa），产出的语义类问题带文本区间高亮、直接进人审，二者可叠加使用。对译文丢引号、全/半角混用等可确定修复的安全问题，可加一轮本地改写（correct），纯本地机械改写、不调 LLM；对语义质检/裁决产出但未决的语义问题，可加一轮LLM 修订（revise），调 LLM 对现有译文做定点最小修订，系统提示词内置。三者都与裁决、语义质检互补。

启动服务后访问 Web 界面，可视化管理翻译工作。本地模式默认嵌入前端静态资源；服务器模式下可选用 --no-ui 关闭嵌入式 Web UI，仅暴露 API 供第三方前端调用。

• 项目、资源、作业、术语表的完整管理
• 拖拽上传文件
• 实时作业进度追踪（SSE 事件流，支持断线重连）
• 暗色/亮色主题切换

CLI 适合集成到自动化流程或批量处理场景。

# 翻译单个文件
linguaflow translate -i README.md -o README_zh.md --to zh

# 翻译整个目录
linguaflow translate -i ./docs -o ./docs-zh --to zh

# 使用术语表
linguaflow translate -i docs.md -o out.md --to zh --glossary-path terms.csv

从 GitHub Releases 下载对应平台的二进制文件。

支持的平台：

• Linux (amd64, arm64)
• macOS (amd64, arm64)
• Windows (amd64, arm64)

每个二进制文件附带 SHA256 校验和，可用于验证文件完整性。

docker pull ghcr.io/meowsalty/linguaflow:latest
docker run -p 8080:8080 ghcr.io/meowsalty/linguaflow:latest

git clone https://github.com/MeowSalty/LinguaFlow.git
cd LinguaFlow
task frontend:install
task backend:install
task openapi:generate
task backend:local:build

本地模式无需登录，适合个人使用。

双击运行：直接双击编译好的 linguaflow（或 linguaflow.exe）即可启动，会自动打开浏览器。

命令行启动：

./bin/linguaflow local

服务默认监听 http://localhost:18080，如果端口被占用会自动递增。

1. 配置 AI 后端 — 在「AI 后端」页面添加你的 OpenAI/Anthropic/Google Gemini 账号
2. 创建项目 — 在「项目」页面创建新项目，设置源语言和目标语言
3. 上传文件 — 进入项目工作区，拖拽上传源文件
4. 创建作业 — 选择资源，创建翻译作业
5. 审核译文 — 翻译完成后在「段落」标签页查看结果、修改译文并审批/拒绝

服务器模式支持多租户和权限管理。

半成品，还没做完，不建议使用

./bin/linguaflow serve

# 仅提供 API，关闭嵌入式 Web UI
./bin/linguaflow serve --no-ui

项目采用前后端分离架构，支持单机部署或分离部署。本地模式默认使用嵌入式 SQLite 开箱即用；服务器模式除 SQLite 外，还支持通过环境变量切换到 PostgreSQL 以满足高并发场景。

详细文档请访问 LinguaFlow 文档：

• 快速开始 · Web
• 快速开始 · CLI
• 即时翻译
• 核心概念
• 安装部署
• 使用模式
• 项目管理
• 格式支持
• 翻译配置 · 使用
• 翻译配置 · 参考
• 术语表
• 翻译审校
• CLI 参考
• 流水线与原理（含质量裁决、语义质检、单段试译）
• FAQ
• API 参考

本项目采用双许可模式：

• 开源用户：遵循 AGPL v3 协议，修改后的代码需开源
• 商业用户：如需闭源使用或私有部署，请等待商业许可上线

详情请参阅 LICENSE 文件。