<img src =“data/image/logo.svg”align =“right”width =“150”alt =“⬟ SL5 Aura徽标”>

⬟ SL5 Aura – 你的声音。你的规则。

100%离线、隐私优先的语音助手框架。
准确定义您的声音的作用 - 从一个单词
完整的 Python 脚本。没有云。没有数据离开您的计算机。
在 Linux、macOS 和 Windows 上的终端、浏览器或后台服务中运行。

👵 初学者	🎓 学习者	🧑u200d💻 开发者

| grandma-mode：只需写一个字，剩下的由 Aura 完成 |与 Koans 一起学习 — 一次一个概念 |完整的 Python 脚本、插件、API 调用 | | 🗄️ 状态管理 | Trino + Airflow 编排、fzf、CopyQ、语音/终端命令、浏览器 UI

⚡ ~2.87 J 每次测试（在 >800 个地图上进行 39 次测试 @ 0.09 秒温暖/0.45 秒寒冷🌿 使用 Eco-CI 测量） · 无云计算

<详情>

快速入门

快速入门

1.下载或克隆此存储库 2. 运行适用于您的操作系统的安装脚本（请参阅“setup/”文件夹）：

• Linux (Arch/Manjaro): bash setup/manjaro_arch_setup.sh ===> 🧩 阅读 docs/LINUX_WAYLAND_dotool

• Linux (Ubuntu/Debian): bash setup/ubuntu_setup.sh

• Linux (openSUSE): bash setup/suse_setup.sh

• Linux (NixOS)：nix-shell setup/shell.nix 然后 bash setup/nixos_setup.sh ===> ⚠️ 实验性的——未经作者测试，欢迎反馈！ X空格符X

• macOS：bash setup/macos_setup.sh

• Windows：setup/windows11_setup_with_ahk_copyq.bat 3.启动Aura：./scripts/restart_venv_and_run-server.sh

4. 按热键并说话 — full guide →

⚠️系统要求和兼容性

• Windows： ✅ 完全支持（使用 AutoHotkey/PowerShell）。

• macOS： ✅ 完全支持（使用 AppleScript）。

• Linux (X11/Xorg)： ✅ 完全支持。

• Linux (Wayland)： ✅ 完全支持（在 KDE Plasma 6 / Wayland 上测试）。

• Linux（CachyOS / 基于 Arch 的滚动版本）： ✅ 完全支持。 由于 glibc 2.43 兼容性，需要 mimalloc (sudo pacman -S mimalloc)。

• Linux (NixOS)： 🧪 实验性 — 社区贡献的设置，尚未测试。 如果您尝试一下，请用您的发现提出问题或 PR！ X空格符X

• Linux (Manjaro)： 新/实验性：系统范围的热键打开类似 fzf 的键盘驱动界面，以便您可以从桌面上的任何位置运行 Aura 命令（与活动窗口完全解耦）。这个热键驱动的启动器目前在 Linux (Manjaro) 上实现和测试；其他发行版可能也可以工作，但需要进行设置。参见👉 docs/Feature_Spotlight/CopyQ_Shortcut_Super_s.md

X空格符X SL5 Aura 是一款完整的离线语音助手，基于 Vosk（用于语音转文本）和 LanguageTool（用于语法/风格）构建，具有可选的本地 LLM (Ollama) 后备，用于创意响应和高级模糊匹配。它将您的声音转换为精确的操作和文本，旨在通过可插入的规则系统和动态脚本引擎实现最终定制。 X空格符X 翻译：该文档也存在于other languages中。

注意：许多文本是原始英文文档的机器生成翻译，仅供一般指导。如有差异或歧义，始终以英文版本为准。我们欢迎社区帮助改进此翻译！

</详情>

<详情> <摘要>演示</摘要>

📺 终端演示

提示： 为了获得更好的终端体验，请参见Zsh Integration。

🎥 视频教程

（替代链接：skipvids.com）

</详情>

<详情> <摘要>主要功能</摘要>

主要特点

• 离线和私人： 100% 本地。任何数据都不会离开您的机器。

• 动态脚本引擎： 超越文本替换。规则可以执行自定义 Python 脚本（on_match_exec）来执行高级操作，例如调用 API（例如，搜索维基百科）、与文件交互（例如，管理待办事项列表）或生成动态内容（例如，上下文感知的电子邮件问候语）。

• 上下文感知规则： 将规则限制到特定应用程序。使用“only_in_windows”，您可以确保规则仅在特定窗口标题（例如“终端”、“VS Code”或“浏览器”）处于活动状态时触发。这适用于跨平台（Linux、Windows、macOS）。

• 高控制转换引擎： 实现配置驱动、高度可定制的处理管道。规则优先级、命令检测和文本转换纯粹由模糊映射中规则的顺序决定，需要配置，而不是编码。

• 保守的 RAM 使用： 智能管理内存，仅在有足够的可用 RAM 时才预加载模型，确保其他应用程序（例如您的 PC 游戏）始终具有优先权。

• 跨平台： 适用于 Linux、macOS 和 Windows。

• 完全自动化： 管理自己的 LanguageTool 服务器（但您也可以使用外部服务器）。

• 极快： 智能缓存可确保即时“正在收听…”通知和快速处理。

• 通过 Trino 进行动态状态管理： 接口感知配置引擎 分离 speech、terminal 和 web 的设置 — 更改一个而不需要 影响其他人。包括实时管理仪表板（端口 8084）。 </详情>

<详情>

🔌 即用型集成

X空格符X ## 🔌 即用型集成

SL5-Aura 配备了一个庞大的生态系统，包含超过 100 多个预配置插件。以下是一些亮点：

OculiX / SikuliX IDE 语音控制

SL5-Aura 为 OculiX 和 SikuliX IDE 提供一流的语音支持。这种集成允许您“说出”您的自动化代码。

• 语音到片段： 说“单击”、“等待”或“查找全部”，服务会立即在 IDE 中键入正确的 Python 代码（例如，click("image.png")）。

• Window-Aware： 该插件是上下文相关的；它仅在 OculiX/SikuliX 窗口聚焦时激活。

• 智能英语支持： 针对“en-US”进行了优化，特别关注非母语口音（例如德语-英语语音），确保全球社区的高识别准确性。

• 可扩展： 使用易于编辑的“FUZZY_MAP_pre.py”格式。

状态： 被 OculiX 团队认可为社区插件（请参阅 Issue #204）。

LibreOffice IDE 语音控制

0 A.D. 语音控制

---

</详情>

<详情> <摘要>文档</摘要>

文档

如需完整的技术参考，包括所有模块和脚本，请访问我们的官方文档页面。它是自动生成的并且始终是最新的。

👉 Go to Documentation sl5net.github.io/SL5-aura-service

特色亮点

• Interactive Rule Search & Run — 双窗格“fzf”规则搜索、实时上下文预览、通过“Enter”/“Ctrl+R”即时命令执行以及通过“Ctrl+E”进行编辑器集成。由全局热键（“Super+S”）和通过语音命令预先配置的多个专用搜索环境支持。

构建状态

<div对齐=“左”>