AgentStage

KO | EN

gitlite — search

#javascript #react #go #golang #machine-learning #deep-learning #java #awesome #pytorch #security #openai #mcp #ios #open-source

(★ 16)

No description available.

AgentStage Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AgentStage

> 📖 **[功能使用指南](./docs/user-guide.md)** — 快速了解如何创建角色、配置模型、发起会话、使用人设系统等核心功能。

> ⚠️ **警告：项目正在积极开发中（WIP）**
>
> AgentStage 目前处于早期开发阶段，核心功能仍在迭代，部分特性尚未完善，可能存在 Bug 或不稳定表现。
> API 接口和数据库结构可能随时变更，**不建议用于生产环境或存储重要数据**。

> 像使用微信一样轻松地与多个 AI 角色聊天、围观它们互动。

AgentStage 是一款 Windows 桌面多智能体角色扮演聊天应用。你可以创建多个 AI 角色，与它们进行 1 对 1 私聊，也可以把多个角色拉进同一个群聊，观看它们之间的自然互动。

演示视频：https://www.bilibili.com/video/BV12JV66ZELx/

---

## 技术栈

| 层级 | 技术 |
|-----|------|
| 桌面框架 | 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 配置
```

---

## 快速开始

### 环境要求

- Windows 10 (1809+) 或 Windows 11
- [Node.js](https://nodejs.org/) ≥ 18
- [pnpm](https://pnpm.io/) ≥ 8
- [Rust](https://rustup.rs/) 最新稳定版

### 安装依赖

```bash
# 安装前端依赖
pnpm install

# Rust 依赖在首次编译时自动下载
```

### 开发模式启动

```bash
# 一键启动完整开发环境（Vite + Rust 编译 + 打开窗口）
pnpm tauri dev
```

> 首次启动会自动创建本地数据库和日志目录在项目根目录的 `data/` 文件夹下。

### 常用命令

```bash
# 仅启动前端 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
```

---

## 注意事项

1. **API Key 本地存储**：API Key 随角色配置保存在本地 SQLite 数据库中，仅在本地使用，不会上传到任何服务器
2. **LLM 调用全部走后端**：前端不直接调用任何 LLM API，所有请求通过 Tauri IPC 由 Rust 代理执行
3. **数据库迁移**：修改 `src-tauri/src/db/schema.rs` 后，需要在 `src-tauri/src/db/migration.rs` 中添加迁移脚本
4. **Windows 专用**：当前仅支持 Windows 平台（依赖 WebView2）
5. **调试日志**：生产版本默认不输出调试日志（如完整 prompt 内容、HTTP 请求详情等）。如需调试，设置环境变量 `AGENTSTAGE_DEBUG_LOG=1` 后启动程序，会在 `data/logs/backend-debug.log` 中记录详细信息

---

## 相关文档

- [功能清单与实现状态](./docs/feature_list.md)
- [产品需求文档 (PRD)](./docs/PRD.md)
- [数据库 Schema](./docs/schema.md)
- [技术栈说明](./docs/tech-stack.md)
- [Agent 快速参考](./AGENTS.md)

---

*AgentStage — 让 AI 角色在聊天中自然相遇。*

AgentStage

AgentStage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

AgentStage

AgentStage Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README