# agent-workspac

**Repository Path**: ooooinfo/agent-workspac

## Basic Information

- **Project Name**: agent-workspac
- **Description**: No description available
- **Primary Language**: Rust
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-23
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Workspace

一个基于 `Tauri + React + TypeScript + Rust` 的多智能体协作桌面应用。  
支持团队模板、`@成员` 协作、分阶段任务拆解、运行状态追踪与调试日志，适合本地 AI 团队开发场景。

## 主要功能

- **团队模板与会话管理**：从模板快速创建会话，支持模板编辑和成员配置。
- **团队通知与 @提及**：支持 `@all`、`@coordinator`、`@具体成员`，可做任务派发和点对点协作。
- **分阶段拆解模式**：先由 Coordinator 生成任务清单，再手动确认“应用并分配”。
- **事件流状态管理**：后端标准事件流（`message_id + run_id`）驱动前端状态，减少状态不一致。
- **运行调试日志**：可查看 received/running/completed/failed 过程和耗时，便于排障。
- **模型与工作目录配置**：支持成员模型设置、会话工作目录与成员目录分配。
- **中英文切换**：核心协作区域支持中文/英文文案切换。

## 技术栈

- **前端**：React + TypeScript + Vite
- **桌面容器**：Tauri v2
- **后端**：Rust（Tauri Commands）
- **数据库**：SQLite（本地）

## 本地开发

### 1) 安装依赖

```bash
npm install
```

### 2) 启动开发模式

```bash
npm run tauri dev
```

启动后会同时运行：
- 前端开发服务器（默认 `http://localhost:1420`）
- Tauri Rust 后端（自动监听 `src-tauri` 变更）

### 3) 构建

```bash
npm run build
```

## 协作流程（推荐）

1. 选择模板创建会话，确认成员模型和工作目录。
2. 在“团队通知”中使用 `@coordinator` 发起复杂任务。
3. Coordinator 先输出任务清单（分阶段模式）。
4. 点击“应用任务清单并分配”，让成员进入执行。
5. 在状态流与调试日志中观察每个成员进度和失败原因。

## 常见问题

- **看不到任务拆分**：检查是否启用了分阶段模式，以及 Coordinator 是否超时。
- **成员报 API Key 错误**：检查该成员所用模型对应的服务商密钥。
- **状态不一致**：当前使用后端事件流为主（`message_id + run_id`），建议优先看“运行调试日志”。

## 推荐 IDE

- [VS Code](https://code.visualstudio.com/)
- [Tauri 插件](https://marketplace.visualstudio.com/items?itemName=tauri-apps.tauri-vscode)
- [rust-analyzer](https://marketplace.visualstudio.com/items?itemName=rust-lang.rust-analyzer)