# longT

**Repository Path**: cc123hh/long-t

## Basic Information

- **Project Name**: longT
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-18
- **Last Updated**: 2026-02-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepSeek 多 Agent 协作系统

## 项目简介

这是一个基于 DeepSeek API 的多 Agent 协作系统，模拟真实软件开发团队的工作流程。

### 🌟 核心特性

- **三个角色分工**：设计者 → 编码者 → 测试者
- **工具调用支持**：Agent 可以实际创建文件、执行命令、运行测试
- **成本追踪**：实时统计 API 调用成本
- **进度可视化**：实时显示开发进度
- **历史记录**：完整的操作历史追溯
- **中断恢复**：支持编码者遇到问题时回询设计者

### 角色分工

| 角色 | 职责 | 可用工具 |
|------|------|----------|
| **设计者 (Designer)** | 系统架构设计、API 接口设计、UI 界面设计 | analyze_project_structure, get_system_info, execute_bash_command |
| **编码者 (Coder)** | 根据设计编写代码、修复 Bug | create_file, read_file, execute_bash_command, search_in_files |
| **测试者 (Tester)** | 测试代码功能、发现问题反馈 | read_file, execute_bash_command, analyze_project_structure, search_in_files |

### 工作流程

```
设计者 → 编码者 → 测试者 → (如有问题) → 编码者 → 测试者 → ...
                  ↑
                  └── (遇到设计问题) → 设计者
```

## 项目结构

```
deepseek_agents/
├── config.py              # 配置文件
├── memory.py              # 记忆系统
├── deepseek_client.py     # API 客户端（支持工具调用）
├── agents.py              # 三个 Agent 角色
├── tools.py               # 工具函数集合
├── enhanced.py            # 成本追踪和进度可视化
├── main.py                # 主程序
├── run.sh                 # 启动脚本
├── requirements.txt       # 依赖
├── .env.example          # 环境变量示例
├── README.md             # 本文件
└── memory/               # 运行时生成
    ├── handoff.json      # 当前交接状态
    ├── context.json      # 完整上下文
    ├── costs.json        # 成本统计
    ├── progress.json     # 进度信息
    ├── report.md         # 项目报告
    └── history/          # 历史记录
        └── *.json        # 历史记录文件
```

## 快速开始

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

### 2. 配置 API Key

```bash
cp .env.example .env
# 编辑 .env 文件，填入你的 DeepSeek API Key
```

### 3. 运行程序

使用启动脚本（推荐）：
```bash
./run.sh
```

或直接运行：
```bash
python main.py
```

## 可用工具

### 文件操作
- `create_file`: 创建文件并写入内容
- `read_file`: 读取文件内容

### 系统操作
- `execute_bash_command`: 执行 Bash 命令
- `get_system_info`: 获取系统信息

### 项目分析
- `analyze_project_structure`: 分析项目结构
- `search_in_files`: 在文件中搜索

### 其他
- `calculate`: 计算数学表达式

## 使用示例

运行程序后，输入项目需求：

```
请输入项目需求（例如：开发一个用户管理系统）：
> 开发一个待办事项应用，包含添加、删除、标记完成功能
```

系统将自动执行：
1. 🎨 设计者设计 API 和 UI
2. 💻 编码者编写代码并创建文件
3. 🧪 测试者运行测试
4. 如有问题，返回修复

## 配置说明

在 `config.py` 中可以调整：

```python
MAX_ITERATIONS = 20  # 最大迭代次数（防止无限循环）
MODEL = "deepseek-chat"  # 或 "deepseek-reasoner"
```

## 输出文件

运行后会在 `memory/` 目录生成：

- `handoff.json`: 当前任务状态
- `context.json`: 完整上下文
- `costs.json`: API 调用成本统计
- `progress.json`: 进度信息
- `report.md`: 项目开发报告
- `history/`: 所有历史记录

## 注意事项

- 请确保已设置 DeepSeek API Key
- 注意 API 调用次数限制
- 可调整 `MAX_ITERATIONS` 防止无限循环
- 工具调用会增加 API 调用次数和成本

## 成本估算

DeepSeek API 定价（2024）：

| 模型 | Input | Output |
|------|-------|--------|
| deepseek-chat | $0.14/M | $0.28/M |
| deepseek-reasoner | $0.55/M | $2.19/M |

系统会在运行结束后显示详细的成本统计。

## License

MIT