Seele

谁不喜欢能帮你工作又听话的赛博妹妹呢~

---

这是一个贩卖焦虑的时代。在 AI 时代来临的这个时刻，每一天听到最多的就是某某技术已过时，某某技术颠覆人们认知。

诚然，已有的 AI 大模型在很大的程度上方便了我们的程序员的工作。但是对于很多未曾接触过技术领域的同学来说。所谓 AI 提效，不过是空中楼阁罢了。

哪怕是对于我个人而言。有许许多多的新技术我都没有用过，就如skill，小龙虾。

但是这并不能影响什么，倘若智能手机是未来的主旋律，那没有抢到首批 iPhone 对我们有什么影响呢

影刀RPA 一个2019年设计出来的产品。在这个所谓 AI 的时代依旧能打。

有些东西永远弥足珍贵，就好像你和我~

谢谢大家使用希儿！本项目使用语音识别+TTS+AI大模型+影刀RPA，实现的通过语音可以让电脑帮你执行工作流的功能！

只要将你的工作教给电脑一遍，它就能学会，并且100%复现，个人认为比有幻觉情况的大模型在执行复制任务时更有优势

另外，我也希望通过影刀RPA构建开源生态，打破技术壁垒，实现技术平权，让所有人都能体验技术带来的快乐！

当前架构

Seele 现在由三层组成：

• 桌面宠物：PyQt5 界面、角色 GIF、气泡、托盘和输入窗口。
• Botmux 连接：订阅 Botmux Dashboard 的会话与 SSE 事件，展示机器人正在工作、等待确认或离线等状态；未匹配本地工作流的输入可以转给 Botmux Agent。
• RPA 桥接：仅允许调用 uid.json / file_name.json 中登记的影刀工作流，并通过带 token 的本地 HTTP 接口提供给 Botmux MCP。

Botmux 扩展位于 botmux-skill/，不需要修改 Botmux 的 daemon、worker 或 CLI adapter。

版本与安装包

当前版本记录在 VERSION 中。GitHub Release 提供：

• Seele-<version>-windows-x64-setup.exe：Windows 安装版；
• Seele-<version>-windows-x64-portable.zip：Windows 便携版；
• Seele-<version>-windows_byte-x64-setup.exe：Windows 字节版安装包；
• Seele-<version>-windows_byte-x64-portable.zip：Windows 字节版便携包；
• Seele-<version>-mac_byte-macos-arm64.dmg：字节内部 Apple Silicon 安装版；
• Seele-<version>-mac_byte-macos-arm64.zip：字节内部 Apple Silicon 压缩包；
• Seele-mac_byte-macos-arm64.dmg / .zip：内容与对应版本文件相同的稳定别名，供文档通过 GitHub releases/latest/download 永久链接到最新版；
• SHA256SUMS-*.txt：发布文件的 SHA-256 校验值；
• release-manifest-*.json：版本、发行类型、提交和构建时间。

推送 v* Tag 或手动运行 Package and release GitHub Actions 工作流会执行测试、打包并发布 Release。打包任务使用 windows-packaging Environment，因此可以在仓库侧边栏的 Deployments 中查看发布记录。

安装

macOS：完整解压 ZIP，打开 Seele 后选择安装到“应用程序”，安装完成自动重启。 若系统应用目录不可写，会使用当前用户的 ~/Applications。 DMG 也可将 Seele 拖到 Applications。之后无需保留下载目录。

Windows：正式版双击 setup.exe 安装；便携版完整解压到固定目录后运行。

检查更新与设置保存

启动 5 秒后在后台检查 GitHub 最新正式版本，之后每小时检查一次。 右键菜单最后一项始终为“检查更新”；有新版时显示红点，点击即下载、 校验、替换并重启。无网络时后台静默，手动检查可显示失败提示。 源码运行支持检查，不替换项目文件。

角色、语音、自定义工作流、Botmux 设置和日志保存到当前用户专属目录：

• macOS：~/Library/Application Support/Seele/<edition>/；
• Windows：%LOCALAPPDATA%\Seele\<edition>\；
• Linux：$XDG_DATA_HOME/Seele/<edition>/（默认 ~/.local/share）。

第一次启动会迁移旧应用包内已有设置，此后新版不会覆盖。 普通版与字节版分别保存设置。Botmux 和 WSL 自身的已有登录与配置保留。 更新按发行类型和平台选择包，验证 SHA256、发布清单和包内版本， 运行启动自检；新版启动失败则恢复旧应用。更新时请保持设备开机。

源码运行

推荐使用 Conda 和 Python 3.11：

conda create -n Seele python=3.11
conda activate Seele
pip install -r requirements.txt
python Seele.py

Linux 还需由系统包管理器安装 Qt/XCB、PortAudio 和 Tk。Wayland、macOS 和部分 Linux 桌面可能不允许 keyboard 注册全局热键，此时可在桌面宠物右键菜单选择“唤醒输入”。

Windows 字节版

新增 windows_byte 发行类型：复用可用 WSL2，缺失时先安装； Windows 要求重启则保存进度，同一用户登录后自动继续。 WSL 内以普通用户部署 Botmux 和字节 CLI，启用 systemd/watchdog， Windows 登录任务及前台保活负责持续运行与恢复。

VIP 便携测试包完整解压后双击 启动希儿.vbs。源码可设置 SEELE_EDITION=windows_byte 后启动。详见 WINDOWS_BYTE_INSTALL.md。 正式构建输出 Seele-<version>-windows_byte-x64-setup.exe 和 Seele-<version>-windows_byte-x64-portable.zip，保留普通 Windows 包。 真实 Windows 首次安装、重启续装和账号授权仍需真机验收。

mac_byte 版本

仓库根目录的 EDITION 为 mac_byte 时，Seele 会在 macOS 首次启动时检查完整工具链：

• 独立检测 Node.js、npm、tmux、Trae CLI、Lark CLI、AgentBuddy 和 Botmux；Trae CLI 还会校验 backend cn 能力，旧版命令虽存在但不支持该能力时自动升级；
• 缺少 tmux 时优先使用已有 Homebrew 安装；Homebrew 也不存在时先运行官方安装脚本，再安装 tmux；安装确认自动输入 Y 并回车；
• 工具链完整但没有机器人配置：直接打开 botmux setup；
• 工具链完整且 Botmux 已配置：不重复打开安装流程；
• 安装脚本要求字节内网；mac_byte 从 npm 官方源安装 Botmux 3.52.0， windows_byte 使用官方安装器指定相同版本；已有其他版本也会纠正并校验， 保留机器人配置。版本只随用户明确要求调整，入口为 botmux_install.py；
• Trae、Lark CLI、AgentBuddy 和 Botmux 登录均在 Terminal 中完成，链接和二维码不会被桌面窗口遮挡；
• Trae、Lark CLI 和 AgentBuddy 使用官方登录命令，授权成功并通过状态校验后自动进入下一阶段；
• Trae、Lark CLI 和 AgentBuddy 登录默认不抢占 Terminal，语音播放与浏览器授权可并行；旧记录在后台清理，链接超时或命令失败时才唤起 Terminal；
• Botmux 配置仍把 Terminal 激活到前台，因为需要输入名称、管理员邮箱和处理菜单选项；
• 提示音播放前检测 macOS 输出音量；静音或低于 20% 时临时调整到 20%，流程退出后恢复原设置；
• 登录命令输出 HTTPS 授权地址后自动优先使用 Google Chrome 打开，Chrome 不可用时回退系统默认浏览器；
• Lark CLI 应用初始化每轮最多执行一次；网页流程结束后独立读取本机配置，未落盘时停止并提示重启 Seele 续跑，避免同轮重复创建应用；
• Botmux 保留需要用户决定的原生 setup 选项，希儿按当前提示播放对应语音；
• 固定的 CLI 适配器和工作目录选项自动选择 traex 与 Botmux 默认值；
• 安装、下载和扫码衔接均由进程退出码或真实终端提示驱动，不使用固定等待秒数；
• 配置结束后自动安装 Seele 插件、启动 Botmux 并开启开机自启，不再要求用户按回车。

安装流程使用 17 个固定的 16 kHz WAV 文件，详见 audio/mac_byte/README.md。动态提示音不存在时会回退到 macOS 系统语音，不影响安装。 自动检测条件、完整安装命令和仅配置命令详见 MAC_BYTE_AUTO_INSTALL_COMMANDS.md。 各 CLI 的官方无交互能力、隔离验证结果和低感知安装方案详见 MAC_BYTE_ZERO_TOUCH_RESEARCH.md。

Botmux 配置

复制 botmux_config.example.json 为 botmux_config.json：

{
  "enabled": true,
  "dashboard_url": "http://127.0.0.1:7891",
  "dashboard_token": "Botmux Dashboard token",
  "bot_id": "cli_xxx",
  "events_enabled": true,
  "route_unmatched_input": true,
  "bridge": {
    "enabled": true,
    "host": "127.0.0.1",
    "port": 8765,
    "token": "use-a-long-random-token"
  }
}

botmux_config.json 已加入 .gitignore，不要把 Dashboard token 或 Bridge token 提交到仓库。 Bridge token 可用 python -c "import secrets; print(secrets.token_urlsafe(32))" 生成。

Seele 使用以下 Botmux Dashboard 接口：

• GET /api/sessions：首次加载会话状态；
• GET /events：订阅实时状态；
• POST /api/trigger：把未匹配本地 RPA 的输入交给 Agent。

安装仓库内插件：

cd botmux-skill
npm test
botmux plugin install . --link
botmux plugin enable seele

具体环境变量和 WSL2 配置见 botmux-skill/README.md。

Windows、macOS 与 Linux

• Windows：支持现有影刀快捷方式、shadowbot: 协议、快启动触发文件和 Windows Win+H 听写。
• macOS：桌面宠物、Botmux 状态和协议 URL 启动可用；需要授予辅助功能、麦克风和输入监控权限。系统不支持 Win+H，输入框仍可直接使用。
• Linux：桌面宠物和 Botmux 状态可用；影刀是否可运行取决于本机是否有对应客户端或兼容的触发文件消费者。
• Botmux 官方更适合运行在 Linux/macOS；Windows 推荐 WSL2。Seele 保持运行在 Windows，通过本地 Bridge 与 WSL2 中的 Botmux 通信。

可以通过 SEELE_TOOLS_DIR 覆盖 RPA 触发目录。默认值是 Windows 的 D:\SeeleTools/C:\SeeleTools，macOS/Linux 的 ~/.seele/tools。

安全边界

• Bridge 只接受配置中已有的工作流名称或 ID，不执行任意 shell 命令。
• 非 loopback 监听必须设置 bearer token。
• Botmux MCP 要求宿主注入可信飞书调用者身份。
• request_id 是幂等键，同一请求不会重复启动工作流。
• accepted 只表示已提交。需要影刀工作流回调 /v1/jobs/:request_id/status 后，才能显示真实的 completed 或 failed。