自由软件与桌面应用

KAYZEN Flux

一款没有服务器的转换器:文件从不离开电脑,代码公开,可供验证。

年份
2026
技术栈
Electron · React · TypeScript · Tailwind · yt-dlp · FFmpeg
  • 产品设计
  • 桌面应用
  • 浏览器扩展
  • Web 开发
  • 应用安全
  • 介绍网站
https://flux.kayzen-lyon.com/
KAYZEN Flux网站首页——自由软件与桌面应用,由KAYZEN制作
没有付费版本,没有广告,无需账户
0 €
种输出格式:MP3、M4A、Opus、FLAC 和 MP4
5
个媒体经过 KAYZEN 的服务器
0
源代码许可证,在 GitHub 上公开
MIT
出发点

需要解决的问题。

背景

KAYZEN Flux 是 KAYZEN 在里昂开发并发行的免费自由软件,以 MIT 许可证发布。它根据一个链接下载视频或音乐,并将其转换为 MP3、M4A、Opus、FLAC 或 MP4。1.0.0 版本面向 Windows、macOS 和 Linux 分发,另有适用于 Android 的 APK 文件,以及适用于 Chrome、Edge 和 Firefox 的扩展。源代码在 GitHub 上公开。

限制

在线转换器让文件经过它们的服务器,并且大多靠广告维持运营:横幅、弹窗、跳转、高峰时段的排队。用户既不知道哪些内容被保留,也不知道由谁保留。我们需要保留它们赖以成功的那个动作——粘贴一个链接,拿到一个文件——但不要中间服务器,不要广告,并且让每个人都能自行验证。

对策

所有工作都在用户的电脑上完成。应用内置 yt-dlp 用于获取媒体,内置 FFmpeg 用于转换;一个只在本机监听的本地引擎负责调度任务队列、媒体库和订阅。介绍网站不下载任何东西:它只负责说明并分发安装程序。其余一切都遵循这条规则:没有账户,没有遥测,历史记录始终只是一个本地文件,代码以 MIT 许可证公开。

实测,而非自称

交付时测得的评分。

以下为线上网站的Lighthouse评分。我们如实公布:若某项分数偏低,其原因与改进计划会在下文写明,而不是避而不谈。

PageSpeed
100
性能:100分(满分100分)
100
无障碍:100分(满分100分)
100
最佳做法:100分(满分100分)
100
搜索引擎优化:100分(满分100分)
设计与艺术指导

每一个设计取舍,及其理由。

  1. 链接输入框就是首屏

    人们打开应用是为了粘贴一个地址:输入框占据“Convertir”(转换)界面的顶部,旁边是“Analyser”(分析)按钮。随后,音频和视频格式以可选卡片的形式呈现,每张卡片都有一行文字说明它的用途,而不是一份需要费力解读的设置清单。

  2. 一张示意图,标明文件止于何处

    网站首页用三个步骤描述这段路径:您粘贴一个链接,您的电脑完成工作,文件到达您的文件夹。“Serveurs KAYZEN”(KAYZEN 服务器)一格被单独列出,并注明没有任何媒体经过那里。这项承诺是画出来的,而不只是写出来的。

  3. 如实说明格式,不夸大

    FLAC 卡片写明,这种格式只保留源文件的音质,并不会增添音质,常见问题中也重申了这一点。如果一款转换器让人以为压缩过的文件转成 FLAC 就会变得更好,那就是在误导用户;因此界面把这句话写在了做出选择的地方。

  4. KAYZEN 的视觉规范,浅色主题与深色主题

    标题使用海军蓝,主要操作使用赤陶色,字体为 Outfit 和 Plus Jakarta Sans:网站和应用沿用了 kayzen-lyon.com 的视觉规范,让人一眼认出这款软件是本机构的产品。一个按钮即可在浅色主题与深色主题之间切换。

字体系统

标题字体

Outfit

正文字体

Plus Jakarta Sans

kayzen-lyon.com 的两个字体家族,让人认出这款软件是本机构的产品。

工程

幕后的技术实现。

  • Electron
  • React
  • TypeScript
  • Tailwind
  • yt-dlp
  • FFmpeg
  1. 一个仓库,五个模块

    该项目是一个以 TypeScript 编写的 pnpm monorepo:一个纯逻辑核心(地址、格式、yt-dlp 参数、进度、错误)、一个本地引擎、一套基于 React 和 Tailwind 的界面、Electron 桌面应用以及扩展。核心要求测试覆盖率不低于 80 %,安装程序由 GitHub Actions 构建。

  2. 只在本机监听的本地引擎

    引擎仅在 127.0.0.1 上响应。它会校验 Host 请求头,要求整个 API 都携带会话令牌,并且写入时只接受 JSON。界面只能读取媒体库中的文件。因此,在浏览器中打开的网页无法在用户不知情的情况下操控下载。

  3. 不经命令解释器启动的 yt-dlp

    粘贴的地址会经过校验,私有网络地址会被拒绝,yt-dlp 不经 shell 执行,其参数以数组形式传入,地址放在分隔符“--”之后。yt-dlp 的个人配置会被忽略。一个被动过手脚的地址无法变成一条命令。

  4. 内置的二进制文件,启动时校验

    应用自带 yt-dlp 和 FFmpeg 的副本,每次启动时都通过 SHA-256 哈希进行校验。窗口处于隔离状态,无法访问 Node,外部链接会在浏览器中打开。代价写在仓库里:安装程序约 330 MB,我们计划将其缩小。

  5. 一个什么都不下载的扩展

    这款 Manifest V3 扩展会在播放时拦截广告,跳过 SponsorBlock 标记的赞助片段,并添加一个“Envoyer vers KAYZEN Flux”(发送到 KAYZEN Flux)按钮,通过 kayzenflux:// 链接打开应用。对于 SponsorBlock,它只发送视频标识符哈希值中的四个字符:数据库并不知道用户在看什么。

  6. 无需在线服务的转写与摘要

    带时间戳的文本在有字幕时取自字幕,否则来自在电脑上用 whisper.cpp 运行的语音识别。如果用户安装了 Ollama,摘要就由它生成。这些功能都不会把内容发送给第三方服务,与产品的规则保持一致。

搜索引擎优化

网站如何被搜索到。

  1. 一个没有服务器函数的静态网站

    介绍网站由静态页面组成:首页、扩展安装指南、法律声明、使用条款和隐私。它不在服务器端执行任何代码,也不下载任何媒体。安装程序由另一个独立的域名 telechargements.kayzen-lyon.com 提供。

  2. 安装之前人们会问的问题

    页面回应了围绕转换器的真实搜索:它合法吗,为什么是应用而不是网站,FLAC 会提升音质吗,陷阱在哪里。一张表格把这款工具与常见的在线转换器逐项对比,没有提及任何竞争对手。

  3. 安装方面的局限,写得明明白白

    Windows 安装程序和 macOS 镜像尚未签名,APK 需在 Play Store 之外安装,扩展在上架商店之前需要手动加载。每一条提示都连同操作步骤一起写在下载页面上,而不是让用户在安装时才发现。

无障碍

人人都能使用。

自2025年6月起,《欧洲无障碍法案》(European Accessibility Act)要求大量在线服务实现数字无障碍。我们在设计阶段就着手处理,而非事后补救。

  1. 由用户选择的主题与键盘快捷键

    网站和应用都提供浅色主题与深色主题,由用户自行选择。应用可以用键盘操作:一个快捷键可从任意界面回到链接输入框,还有一个页面列出了全部快捷键。迄今尚未进行任何独立的无障碍审计。

网站结构

交付了哪些内容。

  • 首页——文件的路径、功能、对比表
  • 扩展——无广告播放、SponsorBlock、发送到应用
  • 自由且免费——MIT 许可证、源代码、没有追踪
  • 下载——Windows、macOS、Linux、Android 与扩展
  • 扩展安装指南
  • 法律声明、使用条款、隐私
方法

项目的推进过程。

  1. 核心与引擎

    处理地址、格式和错误的逻辑,单独编写并测试;带任务队列、实时进度跟踪和媒体库的本地引擎。

  2. 桌面应用

    React 界面、集成到 Electron、内置并经过校验的二进制文件、用于从浏览器接收地址的 kayzenflux:// 链接。

  3. 扩展

    无广告播放、跳过赞助片段、发送到应用的按钮;Chromium 版和 Firefox 版出自同一套代码。

  4. 网站与发布

    静态网站、法律页面、由持续集成构建并从专用域名提供的安装程序;1.0.0 版本于 2026 年 11 月发布。

问答

客户常问的问题。

不会。下载和转换都在用户的电脑上完成,使用的是应用内置的 yt-dlp 和 FFmpeg。介绍网站不下载任何媒体,历史记录是一个本地文件。源代码是公开的:每个人都可以验证这款软件在做什么。

它是一件工具:用户对自己的使用方式负责。它面向的是您有权复制的内容,例如您自己的视频、采用自由许可证的内容,或在适用情况下的私人复制。受技术措施(DRM)保护的内容不受支持,而且下载行为可能违反某些平台的使用条款。

因为处理是在用户的机器上进行的。转换网站必须在自己的服务器上接收文件,然后为这些服务器付费,而这笔钱大多来自广告。应用没有中间服务器,没有排队,也没有什么需要筹资维持的:它可以一直免费,没有广告。

同样严格的标准,用于您的网站。

免费审核您现有的网站,24小时内报价,并附上书面分析——就像您刚刚读到的这篇。可分三期免息付款;可申请的地方补贴在签约前核实。

分享