Starkbot Neo：本地优先的 macOS/Linux 桌面 Agent，通过 Jev 导航器操控浏览器与原生应用

核心能力与快速开始

★ 0 · Rust

能做什么

通过 CDP 驱动浏览器、通过 macOS Accessibility / Linux AT-SPI 驱动原生应用；Jev 导航器分类器每步输出一个操作头、一个目标头和安全头；流式 ReAct Agent 循环，工具包括 browse、app 和 ax；确定性规则、Jev 安全头、确认队列与用户提问卡片，触发安全策略的动作会暂停等待批准；三个前端共用同一运行时——终端 TUI（ratatui）、独立 Tauri 桌面 GUI、以及 neo CLI；语音输入为终端按键说话与 GUI 开始/停止听写，转写文本可编辑后发送，无语音输出；项目支持 soul.md 常驻上下文、heartbeat.md 周期任务与独立心跳时钟；OpenTelemetry 插桩，可通过 OTLP/HTTP 导出 span。

适用场景

在网页上执行 SEO 与 GTM 工作流；通过操作真实媒体应用完成媒体制作，而不是生成文件；用语音或文本向桌面 Agent 下达任务；让 Agent 操作原生 macOS/Linux 应用（如示例中的 Numbers 选择模板）；以 neo nav / neo app 直接驱动单一界面并复用 Agent 的策略、元素预算与安全头；在项目中维护常驻上下文与周期性 heartbeat 任务。

项目形态

可直接使用的工具

部署方式

本地优先，从源码构建运行。macOS 与 Linux 均执行 git clone 后 ./run_gui.sh 启动 Tauri 桌面应用；首次启动会在 checkout 内安装前端依赖与固定版本 Tauri CLI，构建发布版桌面应用并启动，需要数分钟、网络与磁盘空间。无已发布安装包或发布下载。数据分别存放于 macOS 的 ~/Library/Application Support/com.starkbot.neo 与 Linux 的 XDG 目录（如 ~/.local/share/starkbot-neo）。

主要依赖

macOS（Apple Silicon 或 Intel）或 Linux x86-64 且具备 Wayland/X11 桌面会话（非无头服务器）；Git、rustup 安装的 Rust（仓库 rust-toolchain.toml 固定 1.91.0）、Node.js 22.12 或更新版本及 npm。Linux 需自行安装 webkit2gtk 4.1、GTK 3、libsoup 3、ALSA 等开发库；原生应用自动化需启用桌面 AT-SPI 无障碍服务；建议使用 Secret Service 提供方（GNOME Keyring、KWallet 或 KeePassXC）存储凭据。推理需 Claude Pro/Max 或符合条件的 ChatGPT 账户，或 OpenAI API key，另需 TypeSafe key 供导航器使用；浏览器自动化另需 Google Chrome。GUI 听写在两个平台均使用 OpenAI gpt-transcribe，需 OpenAI key。

使用限制

处于活跃开发中：媒体通过应用、packs 与 GTM 工作流尚未构建；M1 因等待 Apple 签名身份而正式受阻；无已发布安装包。项目定位不是 shell 或编程 Agent，没有 bash 工具，也没有通用文件访问。无语音输出。Linux 下 neo app 存在已知缺口：清除已含文本的字段需要 ⌃A，WebKitGTK 在 Wayland 下会将其读作裸 a；其他 Wayland 合成器目前报告不支持窗口放置。源构建的本地应用不是经过公证的发布版，重建 ad-hoc 签名应用可能重复触发权限或 Keychain 提示。OpenAI gpt-transcribe 与 Claude/ChatGPT 订阅凭据不通用。

许可证

MIT

最近推送

2026-09-22 11:06

资料检查：2026-09-23 07:00 · 卡片整理：2026-09-23 09:00
卡片由 AI 根据仓库资料整理，未进行安装或运行验证 · 本次更新未完成，保留上次成功内容