3.3 KiB
3.3 KiB
MineNASAI 开发步骤文档
生成日期: 2025-02-04 更新日期: 2025-02-04 项目: MineNASAI - 基于NAS的智能个人AI助理 技术方案: Web TUI集成（方案C）
Phase 0: 项目初始化 (2-3天)
0.1 项目结构创建
- 创建根目录和基础结构
- 初始化Python项目（pyproject.toml）
- 配置依赖管理（poetry/pip）
- 设置Git仓库
0.2 开发环境配置
- Python虚拟环境
- 代码格式化工具（black/ruff）
- 类型检查（mypy）
- 测试框架（pytest）
0.3 基础配置
- 配置文件模板（config.json5）
- 日志系统初始化
- 环境变量管理（.env）
Phase 1: Gateway + 通讯接入 (14-21天)
1.1 FastAPI基础服务
- FastAPI项目搭建
- WebSocket服务器
- 基础路由和健康检查
1.2 企业微信/飞书接入
- Webhook接收器
- 消息解析和验证
- 消息发送封装
1.3 智能路由
- 启发式规则实现（基于PoC）
- 任务复杂度评估
- 路由决策逻辑
1.4 Redis + Celery
- Redis连接配置
- Celery任务队列
- 异步任务处理
Phase 2: Agent运行时 (10-14天)
2.1 Anthropic API集成
- anthropic SDK集成
- 对话管理
- 流式响应处理
2.2 基础工具实现
- 文件读写工具
- 命令执行工具（安全封装）
- Python沙箱工具
2.3 会话管理
- SQLite数据库设计
- 会话CRUD
- 消息历史存储（JSONL）
Phase 3: Web TUI集成 (7-10天)
3.1 Web终端前端
- xterm.js集成
- Web界面设计（HTML/CSS）
- 前端JavaScript逻辑
3.2 WebSocket终端通信
- WebSocket服务器（终端I/O）
- 双向数据传输
- 终端尺寸自适应
3.3 SSH连接管理
- paramiko集成
- SSH连接池
- localhost SSH配置
3.4 用户认证
- Token/Session认证
- 权限验证
- 会话管理
3.5 消息通知链接
- 生成Web TUI访问链接
- 通讯工具发送提示
- 任务上下文传递
Phase 4: 高级特性 (10-14天)
4.1 定时任务
- Cron任务调度
- 定时任务配置
- 任务执行监控
4.2 权限控制
- 工具危险级别定义
- 确认机制
- 审计日志
4.3 (可选) MCP扩展
- MCP Server加载框架
- 基础MCP集成测试
4.4 (可选) RAG知识库
- Qdrant集成
- 向量化和检索
- 知识库管理
Phase 5: 生产就绪 (7-10天)
5.1 错误处理与监控
- 完善错误处理
- 日志优化
- 监控告警
5.2 性能优化
- 并发优化
- 缓存策略
- 资源限制
5.3 Docker部署
- Dockerfile编写
- docker-compose配置
- 部署文档
5.4 测试与文档
- 集成测试
- 用户文档
- 运维文档
总时间估算
总计: 52-81天
技术栈总结
| 组件 | 技术选择 |
|---|---|
| 后端 | FastAPI + Anthropic SDK |
| 通讯 | 企业微信API + 飞书API |
| 消息队列 | Redis + Celery |
| Web终端 | xterm.js + WebSocket |
| SSH | paramiko (Python) |
| 存储 | SQLite + JSONL |
| 部署 | Docker |
当真正开始开发时，每个Phase会展开详细的子任务和验收标准