源码系统概览
文章正文
KrillinAI 是一款开源的视频翻译与配音工具，能够帮助创作者把外语视频快速变成带字幕和配音的本地化内容。
它面向个人创作者与 AI Agent 两类使用者，既提供一键式的桌面客户端，也提供可嵌入自动化流水线的分阶段命令行接口。
本文将围绕其 GitHub 开源源码，介绍项目能做什么、内部如何实现，以及如何在本地完成编译与部署。
源码简介
整个项目使用 Go 语言编写，模块根路径为 krillin-ai，源码按 internal、pkg、cmd、config、api 等目录分层组织。
内部逻辑集中在 internal 目录，包含语音识别、字幕处理、翻译、TTS 配音、横竖屏渲染以及 OpenCreator 集成等模块。
配置层使用 TOML 文件描述应用、服务、大模型、识别与配音等服务，运行时由 Gin 框架提供 Web 界面与接口。
命令行入口位于 cmd 目录，编译后可以从源码直接生成 krillinai-cli，用于脚本化和 Agent 编排。
这种清晰的目录划分让二次开发变得容易，开发者可以单独修改某一个处理阶段而不影响整体流程。
适用场景
自媒体创作者可以把英文教程、测评或新闻视频翻译并配音成中文，发布到 B 站、抖音、小红书与视频号。
企业培训团队能够把外文讲座批量转换为带双语字幕的视频，降低跨语言学习门槛。
AI Agent 开发者可以借助分阶段接口把视频本地化能力接入自己的自动化系统，实现从下载到渲染的全程处理。
功能亮点
项目支持 yt-dlp 下载或本地上传，兼容 YouTube 与 B 站等多种视频来源。
语音识别基于 Whisper 系列模型，提供云端与本地多种方案，普通设备也能运行。
字幕翻译调用兼容 OpenAI 接口的大模型，借助上下文保持译文自然，并支持术语一键替换。
配音提供阿里云、OpenAI、MiniMax 等 TTS，并支持 CosyVoice 音色克隆与自定义声音。
视频合成可自动处理横屏与竖屏布局，还能从原视频缩略图生成平台封面图。
技术架构与部署指南
技术栈与运行环境
后端使用 Go 语言编写，Web 服务基于 Gin 框架，配置通过 TOML 文件管理。
语音识别依赖 Whisper 系列模型，大模型翻译依赖兼容 OpenAI 规范的 API 服务。
运行环境需要预先安装 ffmpeg、ffprobe 与 yt-dlp 等外部命令行工具。
项目支持 Windows、Linux 与 macOS，提供桌面版、服务端版与 CLI 版三种运行形态。
外部密钥需要在 config.toml 中填写，相关文件仅保存在本地，不会随程序上传。
安装与部署提示
从 Release 页面下载与系统匹配的可执行文件，建议放入空文件夹运行，避免生成目录造成混乱。
非桌面版需要在 config 目录创建 config.toml，复制源码 config 目录中的示例并按注释填写。
启动服务后在浏览器打开 http://127.0.0.1:8888 即可使用，端口可在配置文件中修改。
macOS 因未签名需执行 xattr 与 chmod 命令手动授权后才能运行可执行文件。
项目同时提供 Docker 部署与分阶段 CLI，CLI 可通过 go build -o build/krillinai-cli ./cmd/cli 从源码编译。
截图与演示说明
下图展示了导入本地视频后一键生成的字幕文件效果，分段自然且译文质量较高。
上图为字幕对齐演示，长视频也能保持无遗漏、无重叠的分段效果。
上图为桌面端浅色界面，左侧用于配置任务参数，右侧展示处理进度与结果预览。
上图为桌面端深色界面，方便在弱光环境下长时间处理视频任务。
常见问题
问：没有 GPU 能否运行语音识别？
答：可以。项目支持 WhisperCpp 等本地方案，也能调用云端接口，普通 CPU 设备也能完成识别。
问：配音支持哪些语言？
答：翻译支持一百多种语言，输入语言涵盖中英日德韩俄等多种常用语言。
问：配置文件里的密钥安全吗？
答：config.toml 保存在本地，不会被程序主动上传，但多用户机器上要注意文件权限。
安全风险提示
使用本项目需要在配置文件中填写大模型与云服务的 API 密钥，这些密钥仅保存在本地，请避免提交到公开代码仓库。
调用外部识别与翻译服务时，视频内容会发送到对应服务商，处理敏感素材前请确认服务商的合规与隐私政策。
从非官方渠道下载可执行文件存在被植入恶意代码的风险，建议优先使用官方 Release 或自行从源码编译。
下载说明
本页面仅提供源码结构与部署说明，不托管二进制安装包，所有程序请从项目官方仓库获取。
你可以克隆源码后通过 Go 工具链自行编译，或前往仓库 Release 页面下载对应系统的预编译版本。
桌面版与 CLI 版均包含在源码中，按需选择运行形态即可，部署前请先阅读配置说明文档。
GitHub项目开源地址：https://github.com/krillinai/krillinai