综合介绍
AiryLark 是一个开源的文档处理与翻译工具,托管在 GitHub 上,由开发者 wizd 基于 Next.js 框架打造。它支持多种文件格式(如 PDF、Word、TXT、Markdown)的输入和处理,同时提供智能翻译功能。用户可以通过在线版本体验,也可以下载代码自托管部署。这个工具适合需要高效处理文档和翻译的用户,尤其是开发者、研究人员或企业团队。它的核心优势在于多功能性和开源特性,用户可以自由修改和优化。
功能列表
- 支持多种文件格式处理,包括 PDF、Word、TXT 和 Markdown。
- 提供智能翻译功能,自动分析文档并优化翻译结果。
- 显示翻译过程中的思考步骤,提升透明度。
- 自动校对翻译内容并给出质量评分。
- 允许用户编辑翻译结果,适合专业校对需求。
- 支持流式处理,实时展示翻译进度。
- 提供 API 集成,方便嵌入其他项目。
使用帮助
AiryLark 有在线试用版本和本地部署两种使用方式。以下是详细的操作指南,分为在线使用和本地部署两部分。
在线试用
- 在页面上选择上传文件(支持拖放)或粘贴文本内容。
- 支持的文件类型包括:
.pdf
(PDF 文档).doc
或.docx
(Word 文档).txt
(文本文件).md
(Markdown 文件)
- 也可以输入网页链接(
http
或https
),让工具提取内容。 - 上传后,选择目标语言,点击“开始翻译”。
- 系统会分析文档类型和内容,自动生成翻译结果。
- 翻译完成后,可以查看:
- 原文与译文的逐段对比。
- 关键术语的对照表。
- 翻译质量评分和修改建议。
- 如果需要调整结果,进入“专家编辑模式”,手动修改翻译内容。
本地部署
本地部署适合需要自定义功能或离线使用的用户。以下是详细步骤。
准备工作
- 确保电脑已安装 Node.js(推荐版本 16 或以上)。检查版本:
node -v
- 安装 Git,用于下载代码。检查版本:
git --version
下载代码
- 访问 https://github.com/wizd/airylark。
- 点击
Code
按钮,复制地址https://github.com/wizd/airylark.git
。 - 在终端运行:
git clone https://github.com/wizd/airylark.git
- 进入项目文件夹:
cd airylark
安装依赖
- 在项目文件夹中运行:
npm install
或者使用其他包管理器:
yarn install
pnpm install
bun install
- 等待依赖安装完成。
配置环境变量
- 创建
.env
文件,填入以下内容:
PORT=3030
MCP_PORT=3031
TRANSLATION_API_KEY=your_api_key
TRANSLATION_MODEL=your_model
TRANSLATION_BASE_URL=your_base_url
- 替换
your_api_key
、your_model
和your_base_url
为实际值。具体值需参考翻译服务提供商(如 Google Translate API)的文档。
运行开发模式
- 启动开发服务器:
npm run dev
- 打开浏览器,访问
http://localhost:3030
,即可使用本地版本。 - 如果需要 MCP 服务器支持,需额外配置并运行。
部署生产环境
方法 1:传统部署
- 构建应用:
npm run build
- 启动服务器:
npm start
- 访问
http://localhost:3030
。
方法 2:Docker 部署
- 安装 Docker,检查版本:
docker --version
- 拉取镜像:
docker pull docker.io/wizdy/airylark:latest
docker pull docker.io/wizdy/airylark-mcp-server:latest
- 创建
.env
文件,填入环境变量。 - 运行容器:
docker run -p 3030:3030 --env-file .env -d docker.io/wizdy/airylark:latest
docker run -p 3031:3031 --env-file .env -d docker.io/wizdy/airylark-mcp-server:latest
- 访问
http://localhost:3030
。
方法 3:Vercel 部署
- 将代码推送到 GitHub。
- 登录 Vercel,导入项目。
- 在 Vercel 界面配置环境变量。
- 点击“Deploy”部署,获取在线地址。
主要功能操作
处理文档
- 上传文件或粘贴文本后,系统会自动识别格式并解析内容。
- 处理大型文档时,进度会实时显示。
智能翻译
- 系统分析文档后,根据内容风格和领域选择翻译策略。
- 翻译结果保留上下文一致性,专业术语会高亮显示。
- 查看“思考过程可视化”,了解翻译逻辑。
质量优化
- 翻译完成后,点击“校对”按钮,查看评分和建议。
- 在“专家编辑模式”中调整译文,确保准确性。
通过以上步骤,你可以轻松使用 AiryLark 处理文档和翻译内容。无论是在线试用还是本地部署,操作都很直观。
应用场景
- 学术研究
- 研究人员需要翻译外文论文时,AiryLark 可以处理 PDF 文件并提供高质量翻译,还能校对术语准确性。
- 企业文档管理
- 公司需要将多语言合同或手册翻译成其他语言,AiryLark 支持批量处理和质量评估。
- 个人学习
- 学生想阅读英文技术文档,AiryLark 可以将 TXT 或 Markdown 文件翻译为中文,方便理解。
QA
- AiryLark 支持离线使用吗?
- 支持。只要本地部署并配置好环境变量,无需网络也能运行。
- 翻译质量如何?
- 它提供上下文感知翻译和质量评估,比普通工具更准确,但具体效果取决于配置的翻译模型。
- 需要编程知识吗?
- 在线试用不需要,但本地部署和自定义功能需要基础编程能力。