⚠️ 警告：项目正在积极开发中（WIP）AgentStage 目前处于早期开发阶段，核心功能仍在迭代，部分特性尚未完善，可能存在 Bug 或不稳定表现。 API 接口和数据库结构可能随时变更，不建议用于生产环境或存储重要数据。
像使用微信一样轻松地与多个 AI 角色聊天、围观它们互动。
AgentStage 是一款 Windows 桌面多智能体角色扮演聊天应用。你可以创建多个 AI 角色，与它们进行 1 对 1 私聊，也可以把多个角色拉进同一个群聊，观看它们之间的自然互动。
| 层级 | 技术 |
|---|---|
| 桌面框架 | Tauri v2 (Rust + WebView2) |
| 前端 | Svelte 5 + Vite + TailwindCSS v4 |
| 后端 | Rust + SQLite (rusqlite) |
| 构建工具 | pnpm, Cargo |
| 测试 | Vitest (前端单元测试), Cargo test (Rust 单元测试) |
AgentStage/
├── src/ # 前端源码 (Svelte 5)
│ ├── lib/ # 组件、Store、类型定义
│ ├── App.svelte # 根组件
│ └── main.ts # 入口文件
├── src-tauri/ # Rust 后端源码
│ ├── src/
│ │ ├── commands/ # Tauri IPC 命令 (暴露给前端调用)
│ │ ├── db/ # 数据库连接、Schema、迁移、Repository
│ │ ├── llm/ # LLM Provider、Prompt 组装、Tool 执行
│ │ ├── models/ # 数据结构定义
│ │ └── scheduler.rs # 角色触发调度器
│ └── Cargo.toml
├── docs/ # 产品文档 (PRD、功能清单、Schema 等)
├── static/ # 静态资源 (图标等)
├── package.json # 前端依赖与脚本
├── vite.config.js # Vite 配置
├── tsconfig.json # TypeScript 配置
└── vitest.config.js # Vitest 配置
# 安装前端依赖
pnpm install
# Rust 依赖在首次编译时自动下载# 一键启动完整开发环境（Vite + Rust 编译 + 打开窗口）
pnpm tauri dev首次启动会自动创建本地数据库和日志目录在项目根目录的
data/文件夹下。
# 仅启动前端 Vite 开发服务器（不启动 Rust 后端）
pnpm dev
# 前端构建（输出到 dist/）
pnpm build
# Rust 类型检查（约 3 秒）
cd src-tauri && cargo check
# 仅运行 Rust 后端（会创建桌面窗口，但前端内容需自行提供）
cd src-tauri && cargo run
# Svelte 类型检查
npx svelte-check --tsconfig ./tsconfig.json
# 前端单元测试 (Vitest)
pnpm test
# Rust 单元测试
cd src-tauri && cargo test- API Key 安全：API Key 在 Rust 后端使用 AES-256-GCM 加密存储，前端永远不会收到密文
- LLM 调用全部走后端：前端不直接调用任何 LLM API，所有请求通过 Tauri IPC 由 Rust 代理执行
- 数据库迁移：修改
src-tauri/src/db/schema.rs后，需要在src-tauri/src/db/migration.rs中添加迁移脚本 - Windows 专用：当前仅支持 Windows 平台（依赖 WebView2）
AgentStage — 让 AI 角色在聊天中自然相遇。