MineNasAI/README.md

MineNASAI

基于 NAS 的智能个人 AI 助理，支持企业微信/飞书通讯，集成 Claude 编程能力。

特性

• 多渠道通讯: 企业微信、飞书接入
• 智能路由: 自动识别任务复杂度，选择最优处理方式
• 双界面模式:
  • 通讯工具：日常交互、简单任务
  • Web TUI：深度编程、复杂项目
• 安全隔离: Python 沙箱执行、权限分级
• 可扩展: 支持 MCP Server 插件

快速开始

环境要求

• Python 3.11+
• Redis (可选，用于任务队列)
• SSH 服务 (Web TUI 需要)

安装

# 克隆项目
git clone https://github.com/minenasai/minenasai.git
cd minenasai

# 创建虚拟环境
python -m venv .venv
source .venv/bin/activate  # Linux/macOS
# .venv\Scripts\activate  # Windows

# 安装依赖
pip install -e ".[dev]"

# 安装 pre-commit 钩子
pre-commit install

配置

# 复制环境变量模板
cp .env.example .env

# 编辑 .env 文件，填入 API Key 等配置
# ANTHROPIC_API_KEY=sk-ant-xxxxx

# 初始化配置文件
minenasai config --init

运行

# 启动 Gateway 服务
minenasai server --port 8000

# 启动 Web TUI 服务（另一个终端）
minenasai webtui --port 8080

项目结构

minenasai/
├── src/minenasai/
│   ├── core/           # 核心模块（配置、日志）
│   ├── gateway/        # Gateway 服务
│   │   ├── protocol/   # 消息协议
│   │   └── channels/   # 通讯渠道（企业微信、飞书）
│   ├── agent/          # Agent 运行时
│   │   └── tools/      # 内置工具
│   └── webtui/         # Web TUI 界面
│       └── static/     # 前端静态文件
├── tests/              # 测试用例
├── config/             # 配置文件模板
└── docs/               # 文档

架构概述

┌─────────────────────────────────────────────────────────────┐
│                    通讯接入层 (Channels)                      │
│      企业微信Bot          飞书Bot          Web UI            │
└────────────────────────────┬────────────────────────────────┘
                             │
┌────────────────────────────┴────────────────────────────────┐
│                   Gateway 服务 (FastAPI)                     │
│              WebSocket协议 / 消息队列 / 权限验证              │
└────────────────────────────┬────────────────────────────────┘
                             │
┌────────────────────────────┴────────────────────────────────┐
│                   智能路由层 (SmartRouter)                    │
│              任务复杂度评估 / 单/多Agent决策                  │
└────────────────────────────┬────────────────────────────────┘
                             │
         ┌───────────────────┼───────────────────┐
         ↓                   ↓                   ↓
   ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
   │ 快速执行通道 │     │ Anthropic   │     │  Web TUI    │
   │ Python沙箱  │     │    API      │     │ SSH+Claude  │
   └─────────────┘     └─────────────┘     └─────────────┘

开发

代码规范

# 格式化代码
ruff format src tests

# 检查代码
ruff check src tests

# 类型检查
mypy src

测试

# 运行测试
pytest

# 带覆盖率
pytest --cov=minenasai

配置说明

配置文件位置: ~/.config/minenasai/config.json5

主要配置项:

配置项	说明	默认值
gateway.port	Gateway 端口	8000
webtui.port	Web TUI 端口	8080
agents.default_model	默认模型	claude-sonnet-4-20250514
router.mode	路由模式	agent

许可证

MIT License