文件 / 開發與專案
文件 · 源码与架构
OPENLESS / HANDBOOK

源码与架构

本页提供桌面端源码构建命令、密钥存储说明以及客户端系统架构图。如暂不编译运行,可直接从目录跳转至「系统架构」。

本地构建

请先在本地安装项目要求版本的 Rust、Node.js,以及当前操作系统对应的 Tauri 编译依赖。环境就绪后,在仓库根目录依次执行以下命令启动桌面开发版:

cd openless-all/app
npm ci
npm run tauri dev

以上命令适用于桌面端 Tauri 客户端(macOS / Windows)。如需构建 Linux 原生端或各移动端(Android / iOS / HarmonyOS),请参阅平台构建指南获取完整依赖与构建命令。

启动后的验证建议:客户端拉起后,先在一个空白输入框中试录一句话,确认录音转写与光标插入两条核心链路均工作正常,再着手代码改动。若你当前仅需阅读源码而无须本地运行,可直接从下方的系统架构图定位目标平台宿主,再沿着数据流向下追踪共享后端逻辑。

服务密钥放在哪儿?

接入第三方云端语音或语言模型服务时,需使用你自己的服务密钥。在桌面客户端中,所有密钥均交由操作系统的安全凭据库管理,不会明文写入项目源码或提交至版本库。开发与调试时可放心使用,同时仍应避免在日志截图或公开讨论中暴露密钥。

系统架构

为了兼顾各操作系统的原生体验与核心行为一致性,OpenLess 在各端采用各自界面,底层共用 openless-core。下方三张架构图分别展示端侧分层、单次听写的数据流转以及启动录音的权限流程;想追踪一句话如何从麦克风落到光标处,建议先看「数据流」。

客户端架构

客户端架构
放大查看官方 SVG · Mermaid 源码
数据流
数据流
放大查看官方 SVG · Mermaid 源码
启动、权限与录音
启动、权限与录音
放大查看官方 SVG · Mermaid 源码