# dao-iflow

**Repository Path**: starvv_w/dao-iflow

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-17
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DevAssist - iFlow开发助手

一个跑在本地、通过飞书聊天控制的智能开发助手，支持 AI 驱动的多 Agent 协作。

## 功能特性

- **随时随地**: 手机就能查看开发状态，无需打开电脑
- **即时反馈**: 任务执行进度实时推送
- **任务排队**: 多个请求自动排队，不冲突不丢失
- **AI 驱动**: 支持 iFlow SDK 模式，AI 思考、客户端执行
- **多 Agent**: 规则引擎 Agent（无大模型）+ SDK Agent（AI 驱动）
- **三层记忆**: 短期/中期/长期记忆，智能上下文管理

## 架构

```
飞书客户端 (WebSocket)
       │
       ▼
┌─────────────────────┐
│   DevAssist 服务     │
├─────────────────────┤
│ 飞书客户端 (lark)    │  ← 消息收发、卡片构建
│ 任务队列 (Queue)     │  ← 异步任务调度
│ 任务路由 (Router)    │  ← 意图识别、任务分发
│ 多Agent框架(Agents)  │  ← ReAct模式协作
│ 会话管理 (Session)   │  ← 三层记忆架构
│ 定时调度 (Scheduler) │  ← 定时任务管理
└─────────────────────┘
       │
       ▼
  iFlow 服务
   (SDK/CLI)
```

## iFlow 模式

| 模式 | 说明 | 依赖 |
|------|------|------|
| **SDK** (推荐) | AI 服务端思考，客户端执行工具 | `iflow-sdk` |
| CLI | 通过 CLI 进程通信 | `iflow-cli` |
| Agent | 规则引擎，无需大模型 | 无外部依赖 |

### SDK 模式优势

- 真正的 Think-Act-Observe 循环
- 工具执行可审计、可控
- 支持流式输出
- 无子进程开销

## 快速开始

### 1. 安装依赖

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

### 2. 配置环境变量

```bash
cp .env.example .env
# 编辑 .env 填入飞书应用凭证
```

配置项说明：

```bash
# 飞书应用配置
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret

# iFlow 模式 (sdk/cli/auto)
IFLOW_MODE=auto

# 是否自动批准工具调用
IFLOW_AUTO_APPROVE=true
```

### 3. 启动服务

```bash
python -m devassist.main
```

## 项目结构

```
devassist/
├── agents/         # 多 Agent 框架
│   ├── base.py         # Agent 基类 (ReAct 模式)
│   ├── orchestrator.py # 主控 Agent
│   ├── specialized.py  # 专业 Agent
│   ├── sdk_agent.py    # SDK Agent (AI 驱动)
│   └── rules.py        # 规则引擎
├── config/         # 配置管理
├── core/           # 核心业务逻辑
│   ├── devassist.py    # 主服务
│   ├── session.py      # 会话管理
│   ├── memory.py       # 三层记忆
│   ├── scheduler.py    # 定时任务
│   └── router.py       # 任务路由
├── feishu/         # 飞书集成
├── iflow/          # iFlow 集成
│   ├── client.py       # CLI 客户端
│   └── sdk_client.py   # SDK 客户端
├── queue/          # 任务队列
├── handlers/       # 命令处理器
└── utils/          # 工具函数
```

## 使用示例

在飞书中发送消息：

- `帮我写一个工具函数` - AI 编写代码
- `查看 main.py 文件` - 读取文件
- `运行测试` - 执行 pytest
- `git 状态` - 查看 Git 状态
- `服务状态` - 查看运行状态
- `30分钟后提醒我检查构建` - 创建定时任务
- `记住 这是一个重要配置` - 长期记忆

## 文档

详细文档请参阅 `docs/` 目录。

## 开发

### 运行测试

```bash
pytest tests/
```

### 代码检查

```bash
flake8 devassist/
mypy devassist/
```

## License

MIT