Buddy Tauri — AI skill for Claude Code

Buddy (Tauri)

⚠️ **项目说明：研究性实验，非稳定项目**

本仓库是为了**研究「用 AI 编程切换开发方案」**而产生的实验项目——即探索如何让 AI Agent 将一个完整的 Electron 应用移植到 Tauri 2（Rust 后端）。它不是一个面向生产环境的稳定项目，功能与质量不做保证。

**如果你希望更好地体验和使用 Buddy，请使用原项目：**

• 仓库：davidhoo/buddy
• 官网：https://davidhoo.github.io/buddy/

Buddy 是一个双 AI Agent 协作编码的 macOS 桌面应用（两个 AI Actor 轮流工作，双确认结束）。本仓库是它的 **Tauri 2 移植实验版**：后端由 Node.js 主进程重写为 Rust，前端渲染代码原样复用，数据目录与原版兼容。

特性

• 双 Actor 协作：执行方实现代码，审查方检查修正，循环推进直到双方确认完成
• 5 种 AI Actor：Claude Code、Codex、Cursor CLI、OpenCode、Kimi Code
• 双确认结束：双方均发出 type=break 才结束任务，单方 break 不终止
• 指令队列：在 Actor 运行期间排队发送指令，轮次结束后自动执行
• Git 集成：本地化 conventional commit 消息生成、变更查看、提交与推送
• 23 套预设主题：CSS 自定义属性驱动的主题引擎，支持自定义颜色
• 国际化：中文简体 / 中文繁体 / 英文，CJK 自动检测
• 可恢复：应用崩溃或重启后，任务状态从磁盘文件完整恢复

系统要求

• macOS 12+ (Monterey)
• 至少一个已安装的 AI CLI 工具：Claude Code、Codex CLI、Cursor CLI、OpenCode、Kimi Code
• 仅开发需要：Rust toolchain（rustup）、Node.js >= 18、pnpm 11

安装

从源码构建：

pnpm install
pnpm dist

DMG 输出在 `src-tauri/target/release/bundle/dmg/` 目录。

开发

pnpm install          # 安装依赖
pnpm dev              # 前端开发模式（仅 vite HMR，无后端）
pnpm tauri:dev        # 完整开发模式（Rust 后端 + 前端 HMR）
pnpm test             # 前端单元测试 (vitest)
pnpm test:rust        # Rust 单元测试 (cargo test --manifest-path src-tauri/Cargo.toml)
pnpm typecheck        # 类型检查
pnpm tauri build      # 构建应用包
pnpm dist             # 构建 + DMG（tauri build 的别名）

架构

Tauri 2 架构：**Rust 后端**承担原 Electron 主进程的全部职责，前端渲染代码与原版一致。桥接层 `src/lib/tauri-bridge.ts` 在 `window` 上挂出与原版 preload 同名同形的 `window.buddy` / `window.api`，内部走 `@tauri-apps/api` 的 `invoke`/`listen`。

┌──────────────────────────────────────────────┐
│            Rust Core (src-tauri)              │
│  BuddyCoreService