# MyTeam
**Repository Path**: andershsueh/my-team
## Basic Information
- **Project Name**: MyTeam
- **Description**: 这是一个可以指挥团队工作的AI- Agent, 以及界面.
- **Primary Language**: TypeScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-03
- **Last Updated**: 2025-12-05
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# SynapseTeam - AI驱动的虚拟软件开发团队
**革命性的AI协作平台 - 让编程变得像对话一样简单**
[🚀 快速开始](#-快速开始) • [📋 功能特性](#-功能特性) • [🎯 核心价值](#-核心价值) • [🛠️ 技术架构](#️-技术架构) • [📖 文档](#-文档)
---
## 🎯 项目概述
**SynapseTeam** 是一款创新的跨平台桌面GUI应用，利用AI代理技术模拟完整的软件开发团队（10个专业角色），通过自然语言交互实现从需求分析到项目部署的全流程自动化。
### ⚡ 核心目标
- **减少80%传统开发手动干预时间**
- **提供直观无需说明书的用户体验**
- **支持本地优先，隐私安全的AI协作**
- **跨平台独立运行**（Windows/macOS）
### ⚠️ 重要说明
**此应用必须是独立运行的桌面应用，绝不是浏览器应用！不能采用前端+后端分离架构！**
---
## 🚀 快速开始
### 系统要求
- **操作系统**: Windows 10+ 或 macOS 10.15+
- **内存**: 最低 8GB RAM
- **处理器**: 最低 4核 CPU
- **存储**: 至少 2GB 可用空间
### 安装运行
#### 开发模式
```bash
# 克隆项目
git clone https://gitee.com/andershsueh/my-team.git
cd synapseteam
# 进入MVP目录
cd project-src/mvp
# 安装依赖
npm install
# 开发模式启动（推荐）
npm run dev
# 生产模式启动
npm start
# 构建macOS应用
npm run build-mac
```
#### 生产版本
- **Windows**: 下载 `.exe` 安装包
- **macOS**: 下载 `.dmg` 安装包
---
## 📋 功能特性
### 🎨 智能用户界面
- **Material Design 3** 现代化界面设计
- **VS Code风格布局** - 熟悉的开发环境体验
- **响应式设计** - 适配13-27英寸屏幕
- **深浅色主题** - 自动检测或手动切换
- **实时状态栏** - 项目状态、AI员工状态、系统监控
### 👥 AI虚拟团队（10个专业角色）
| 角色 | 职责 | 专业领域 |
|------|------|----------|
| 👔 **项目经理** | 任务协调、进度管理 | 项目管理、团队协作 |
| 📋 **软件产品经理** | 需求分析、产品设计 | 产品规划、用户研究 |
| 💼 **商业产品经理** | 商业模式、市场分析 | 商业策略、竞品分析 |
| 🏗️ **系统架构师** | 技术架构、设计决策 | 系统设计、技术选型 |
| 🎨 **界面设计师** | UI/UX设计、原型制作 | 视觉设计、交互设计 |
| 💻 **前端开发工程师** | 用户界面实现 | React/Vue、响应式设计 |
| ⚙️ **后端开发工程师** | 服务端逻辑开发 | Node.js/Python、API设计 |
| 🗄️ **数据库工程师** | 数据存储、优化 | SQL/NoSQL、性能调优 |
| 🧪 **系统测试员** | 质量保证、测试 | 自动化测试、质量监控 |
| 🔧 **版本管理员** | 代码管理、部署 | Git、CI/CD、DevOps |
| 🤖 **AI开发工程师** | AI模型集成、优化 | 机器学习、模型调优 |
### 🔄 智能协作流程
1. **需求输入** → 用户通过聊天与项目经理对话
2. **任务解析** → 项目经理将需求转化为结构化任务
3. **智能分配** → 根据依赖关系分配给相应角色
4. **并行执行** → 最多5个角色同时工作
5. **进度跟踪** → 实时甘特图显示任务进度
6. **结果输出** → 自动生成代码、文档和部署文件
### 🤖 AI集成特性
- **本地AI模型支持** - 集成Ollama，支持Gemma3:4b等本地模型
- **实时聊天交互** - 与AI角色进行自然语言对话
- **智能任务解析** - AI自动解析需求并生成JSON格式任务
- **任务管理系统** - 支持任务创建、分配、执行和状态跟踪
- **并行执行引擎** - 最多5个角色同时工作，支持依赖管理
- **甘特图可视化** - 实时显示任务进度和项目时间线
- **文件上传支持** - 支持PNG、JSON等文件格式上传
- **沙盒安全操作** - 所有文件操作限制在用户指定沙盒内
### 🛡️ 安全与隐私
- **沙盒文件操作** - 所有操作限制在用户指定文件夹
- **本地优先** - 支持本地AI模型，数据不出本地
- **完整审计** - 所有操作记录日志
- **GDPR合规** - 隐私保护设计
---
## 🎯 核心价值
### 对于不同用户群体
#### 👨💻 独立开发者
- **快速原型** - 从想法到可运行代码只需几分钟
- **全栈开发** - 无需精通所有技术栈
- **项目模板** - 生成完整的项目结构和文档
#### 🚀 初创创始人
- **MVP验证** - 快速构建最小可行产品
- **技术决策** - AI辅助技术选型
- **成本控制** - 减少初期开发成本
#### 🎓 学生/学习者
- **学习工具** - 观察完整开发流程
- **实践项目** - 从零开始构建真实项目
- **技能提升** - 理解团队协作模式
#### 👔 非技术经理
- **需求表达** - 用自然语言描述需求
- **进度监控** - 实时了解项目进展
- **结果验证** - 快速验证交付质量
---
## 🛠️ 技术架构
### 整体架构
```
用户交互层 (Electron + HTML5/CSS3/JavaScript)
↓
AI代理协调层 (Node.js + 自定义AI调用)
↓
模型集成层 (本地Ollama + 远程API)
↓
文件系统层 (沙盒化fs操作)
```
### 技术栈选择
#### GUI框架
- **Electron** - 成熟生态，VS Code同源，便于fork
- **Tauri** - 轻量级Rust+WebView，性能更优
#### 前端技术
- **HTML5/CSS3/JavaScript** - 原生Web技术，轻量高效
- **Material Design 3** - 现代化UI设计系统
- **Electron渲染进程** - 安全的IPC通信
#### 后端技术
- **Node.js** - 高性能JavaScript运行时
- **Electron主进程** - 嵌入式后端服务
- **JSON配置** - 轻量级本地数据存储
#### AI模型支持
- **本地模型**: Ollama + Gemma3:4b等
- **远程模型**: OpenAI GPT-4o、xAI Grok-3等
- **混合使用**: 每个角色可配置不同模型
- **实时交互**: 支持自然语言对话和任务解析
### 性能优化
- **并行处理** - 最多5个AI角色同时工作
- **响应时间** - 本地模型<5秒，远程<10秒
- **资源控制** - CPU使用率<50%，内存优化
- **安全机制** - 沙盒文件操作，本地优先架构
---
## 📖 文档
### 📁 项目目录结构
```
my-team/
├── 📋 documents/ # 项目文档目录
│ ├── Requirements_Specification.md # 🎯 需求规格文档（最重要）
│ ├── PRD.md # 产品需求文档
│ ├── ui_design.md # UI/UX设计文档
│ ├── Technical_Design_Document.md # 技术设计文档
│ ├── Project_Plan.md # 项目计划
│ ├── Test_Plan.md # 测试计划
│ ├── Automated_Testing_Strategy.md # 自动化测试策略
│ └── Original_requirement.md # 原始需求
├── 👥 employees/ # AI角色定义目录
│ ├── 项目经理.md
│ ├── 软件产品经理.md
│ ├── 系统架构师.md
│ ├── 前端开发工程师.md
│ ├── 后端开发工程师.md
│ ├── 数据库工程师.md
│ ├── 系统测试员.md
│ ├── 界面设计师.md
│ ├── 版本管理员.md
│ └── AI开发工程师.md
├── 🏗️ project-src/ # 项目源码目录
│ └── mvp/ # MVP版本
│ ├── index.html # 主界面
│ ├── main.js # Electron主进程
│ ├── preload.js # 预加载脚本
│ ├── renderer.js # 渲染进程脚本
│ ├── styles.css # 样式文件
│ ├── app-config.json # 应用配置
│ ├── package.json # 项目配置
│ └── README.md # MVP说明
├── 🎨 prototype/ # 原型设计目录
│ ├── index.html # 交互原型
│ ├── scripts/ # 原型脚本
│ └── styles/ # 样式文件
├── 📝 issues/ # 问题跟踪目录
└── 📄 readme.md # 项目说明文档
```
### 📋 核心文档说明
| 文档 | 重要性 | 描述 |
|------|--------|------|
| **Requirements_Specification.md** | 🎯 **最重要** | 详细需求规格，所有开发必须严格遵循 |
| **PRD.md** | 🔥 **核心** | 产品需求文档，定义产品愿景和功能 |
| **ui_design.md** | 🎨 **设计** | UI/UX设计规范，界面实现标准 |
| **Technical_Design_Document.md** | 🏗️ **架构** | 技术架构设计，系统实现指南 |
| **Project_Plan.md** | 📊 **计划** | 项目计划和里程碑 |
| **Original_requirement.md** | 💡 **创意** | 原始创意需求，项目起源 |
### 👥 AI角色定义
```
employees/
├── 👔 项目经理.md
├── 📋 软件产品经理.md
├── 💼 商业产品经理.md
├── 🏗️ 系统架构师.md
├── 🎨 界面设计师.md
├── 💻 前端开发工程师.md
├── ⚙️ 后端开发工程师.md
├── 🗄️ 数据库工程师.md
├── 🧪 系统测试员.md
├── 🔧 版本管理员.md
└── 🤖 AI开发工程师.md
```
### 🎯 开发指南
#### 必须遵循的文档
1. **Requirements_Specification.md** - 所有开发必须严格遵循此需求规格
2. **PRD.md** - 产品愿景和功能定义
3. **ui_design.md** - UI设计规范和原型
#### 开发流程
1. **需求理解** - 深入学习需求规格文档
2. **原型实现** - 参考UI设计文档
3. **核心开发** - 实现AI代理协调系统
4. **测试优化** - 性能和安全测试
---
## 🎉 开发状态
### ✅ 已完成功能
- [x] **基础GUI窗口** - Electron应用成功运行
- [x] **跨平台架构** - macOS验证通过，支持Windows
- [x] **构建系统** - electron-builder配置完整
- [x] **开发环境** - 支持热重载和调试工具
- [x] **UI布局实现** - Material Design 3三窗格布局
- [x] **AI角色导航** - 10个专业AI角色选择器
- [x] **功能模块** - 标签页形式的工作区展示
- [x] **系统菜单** - 主菜单功能框架
- [x] **状态栏** - 实时显示项目状态、AI员工状态、系统监控
- [x] **项目文档** - 完整的需求规格和技术设计文档
- [x] **AI角色定义** - 10个专业角色的详细定义文档
- [x] **后端功能** - 配置管理、AI集成、沙盒操作、任务管理
- [x] **数据库** - SQLite本地存储，聊天历史和任务数据
- [x] **AI集成** - Ollama本地模型支持，Gemma3:4b
- [x] **输出渲染** - Monaco编辑器代码高亮和文件预览
- [x] **系统菜单** - 完整的文件菜单和项目管理功能
### 🔄 开发中功能
- [x] **系统菜单功能** - 新建项目、打开文件夹等 ✅
- [x] **项目管理** - 新建、打开、保存、关闭项目 ✅
- [x] **AI角色集成** - 5个核心AI角色功能 ✅
- [x] **本地AI模型** - Ollama + Gemma3:4b集成 ✅
- [x] **沙盒文件操作** - 安全的文件读写 ✅
- [x] **任务调度系统** - 智能任务分配和执行 ✅
- [ ] **甘特图** - 实时项目进度可视化
- [x] **聊天界面** - 与项目经理的自然语言交互 ✅
- [x] **文件预览** - 代码高亮、图像预览等功能 ✅
### 📋 计划功能
- [ ] **完整10个AI角色** - 所有角色功能完整
- [ ] **远程AI模型** - OpenAI、xAI等API集成
- [ ] **并行执行优化** - 多线程性能优化
- [ ] **进度干预** - 实时任务暂停和调整
- [ ] **插件系统** - 自定义角色和工具
- [ ] **语音输入** - 语音交互支持
- [ ] **一键部署** - 导出到GitHub/Vercel
---
## 🚀 使用示例
### 基础工作流程
1. **启动应用**
```bash
npm run dev
```
2. **配置项目**
- 选择沙盒文件夹
- 配置AI模型（本地/远程）
- 加载AI角色定义
3. **输入需求**
```
用户: "构建一个React待办事项应用，使用SQLite数据库"
```
4. **AI团队协作**
- 项目经理解析需求，生成任务计划
- 系统架构师设计技术架构
- 前端工程师实现React组件
- 后端工程师开发API
- 数据库工程师设计数据模型
- 测试工程师编写测试用例
5. **查看结果**
- 实时甘特图显示进度
- 中间面板展示代码和设计
- 聊天界面进行迭代讨论
### 典型使用场景
#### 🚀 初创公司MVP开发
```
用户: "我想做一个在线教育平台，支持视频课程、作业提交和进度跟踪"
```
**AI团队响应:**
- 项目经理制定开发计划
- 产品经理分析用户需求
- 架构师设计系统架构
- 前端工程师实现用户界面
- 后端工程师开发API服务
- 数据库工程师设计数据模型
- 测试工程师确保质量
#### 🎓 学习项目实践
```
用户: "帮我创建一个简单的博客系统，学习全栈开发"
```
**AI团队响应:**
- 生成完整的项目结构
- 提供详细的代码注释
- 创建学习文档和教程
- 实现基础功能演示
#### 💼 企业内部工具
```
用户: "需要一个员工考勤管理系统，支持打卡、请假申请和报表统计"
```
**AI团队响应:**
- 分析业务需求
- 设计用户权限系统
- 实现数据可视化
- 生成部署文档
---
## 🤝 贡献指南
### 开发环境设置
1. Fork项目仓库
2. 克隆到本地
3. 安装依赖：`npm install`
4. 启动开发服务器：`npm run dev`
### 代码规范
- 遵循TypeScript规范
- 使用Material Design 3组件
- 添加适当的注释和文档
- 编写单元测试
### 提交规范
- 使用语义化提交信息
- 每个提交专注于单一功能
- 包含测试用例
### 开发流程
1. **需求理解** - 深入学习 `documents/Requirements_Specification.md`
2. **设计实现** - 参考 `documents/ui_design.md` 和 `documents/Technical_Design_Document.md`
3. **代码开发** - 遵循项目架构和技术栈
4. **测试验证** - 确保功能符合需求规格
5. **文档更新** - 及时更新相关文档
### 重要提醒
- **所有开发必须严格遵循 `documents/Requirements_Specification.md`**
- **UI实现必须符合 `documents/ui_design.md` 规范**
- **技术实现必须遵循 `documents/Technical_Design_Document.md`**
- **项目必须是独立桌面应用，不能是浏览器应用**
### ⚠️ 关键约束
1. **独立运行**：绝对不能是浏览器应用，必须是独立的桌面软件
2. **隐私优先**：所有文件操作限制在用户指定沙盒内
3. **性能要求**：最低8GB RAM，4核CPU，响应时间<5秒
4. **安全性**：100%沙盒限制，完整操作审计
5. **跨平台**：支持Windows (.exe) 和 macOS (.dmg)
6. **AI协作**：10个专业AI角色，最多5个并行执行
7. **用户体验**：无需说明书，上手<5分钟
---
## 📄 许可证
本项目采用 [MIT License](LICENSE) 开源许可证。
---
## 🆘 支持与反馈
### 问题报告
- 使用GitHub Issues报告问题
- 提供详细的错误信息和复现步骤
- 包含系统环境信息
### 功能建议
- 通过GitHub Discussions提出建议
- 描述使用场景和预期效果
- 参与社区讨论
### 联系方式
- **项目主页**: [GitHub Repository](https://github.com/your-org/synapseteam)
- **文档**: [项目文档](./documents/)
- **问题反馈**: [GitHub Issues](https://github.com/your-org/synapseteam/issues)
- **AI角色定义**: [员工角色文档](./employees/)
### 项目资源
- **需求规格**: [Requirements_Specification.md](./documents/Requirements_Specification.md) - 🎯 **最重要的文档**
- **产品需求**: [PRD.md](./documents/PRD.md)
- **UI设计**: [ui_design.md](./documents/ui_design.md)
- **技术设计**: [Technical_Design_Document.md](./documents/Technical_Design_Document.md)
- **项目计划**: [Project_Plan.md](./documents/Project_Plan.md)
---
## 🧭 快速导航
### 🚀 开始使用
- [快速开始](#-快速开始) - 安装和运行指南
- [使用示例](#-使用示例) - 典型工作流程和场景
### 📚 文档资源
- [Requirements_Specification.md](./documents/Requirements_Specification.md) - 🎯 **需求规格文档**
- [PRD.md](./documents/PRD.md) - 产品需求文档
- [ui_design.md](./documents/ui_design.md) - UI设计规范
- [Technical_Design_Document.md](./documents/Technical_Design_Document.md) - 技术架构
### 👥 AI角色
- [项目经理](./employees/项目经理.md) - 任务协调和进度管理
- [前端开发工程师](./employees/前端开发工程师.md) - 用户界面实现
- [后端开发工程师](./employees/后端开发工程师.md) - 服务端逻辑开发
- [系统架构师](./employees/系统架构师.md) - 技术架构设计
- [更多角色...](./employees/)
### 🛠️ 开发资源
- [项目计划](./documents/Project_Plan.md) - 开发里程碑
- [测试计划](./documents/Test_Plan.md) - 质量保证
- [MVP源码](./project-src/mvp/) - 当前开发版本
---
**🎉 让我们一起构建这个革命性的AI协作平台！**
[⭐ Star this project](https://github.com/your-org/synapseteam) • [🐛 Report issues](https://github.com/your-org/synapseteam/issues) • [💬 Join discussions](https://github.com/your-org/synapseteam/discussions)