源码与架构
本页提供桌面端源码构建命令、密钥存储说明以及客户端系统架构图。如暂不编译运行,可直接从目录跳转至「系统架构」。
本地构建
请先在本地安装项目要求版本的 Rust、Node.js,以及当前操作系统对应的 Tauri 编译依赖。环境就绪后,在仓库根目录依次执行以下命令启动桌面开发版:
cd openless-all/app
npm ci
npm run tauri dev以上命令适用于桌面端 Tauri 客户端(macOS / Windows)。如需构建 Linux 原生端或各移动端(Android / iOS / HarmonyOS),请参阅平台构建指南获取完整依赖与构建命令。
启动后的验证建议:客户端拉起后,先在一个空白输入框中试录一句话,确认录音转写与光标插入两条核心链路均工作正常,再着手代码改动。若你当前仅需阅读源码而无须本地运行,可直接从下方的系统架构图定位目标平台宿主,再沿着数据流向下追踪共享后端逻辑。
服务密钥放在哪儿?
接入第三方云端语音或语言模型服务时,需使用你自己的服务密钥。在桌面客户端中,所有密钥均交由操作系统的安全凭据库管理,不会明文写入项目源码或提交至版本库。开发与调试时可放心使用,同时仍应避免在日志截图或公开讨论中暴露密钥。
系统架构
为了兼顾各操作系统的原生体验与核心行为一致性,OpenLess 在各端采用各自界面,底层共用 openless-core。下方三张架构图分别展示端侧分层、单次听写的数据流转以及启动录音的权限流程;想追踪一句话如何从麦克风落到光标处,建议先看「数据流」。