Metadata-Version: 2.4
Name: devmate
Version: 2.1.0
Summary: 程序员终端瑞士军刀 + AI 原生平台——替代 5 个独立工具，一个 CLI 搞定
Author-email: DevMate Team <devmate@example.com>
License: MIT
Keywords: cli,developer-tools,terminal,productivity
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development
Classifier: Topic :: Utilities
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: click>=8.1
Requires-Dist: rich>=13.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: sqlalchemy>=2.0
Requires-Dist: alembic>=1.13
Requires-Dist: cryptography>=42.0
Requires-Dist: httpx>=0.27
Requires-Dist: psutil>=5.9
Provides-Extra: web
Requires-Dist: fastapi>=0.110; extra == "web"
Requires-Dist: uvicorn[standard]>=0.29; extra == "web"
Requires-Dist: jinja2>=3.1; extra == "web"
Requires-Dist: python-multipart>=0.0.9; extra == "web"
Requires-Dist: python-jose[cryptography]>=3.3; extra == "web"
Requires-Dist: passlib[bcrypt]>=1.7; extra == "web"
Requires-Dist: starlette<0.50; extra == "web"
Provides-Extra: tui
Requires-Dist: textual>=1.0; extra == "tui"
Provides-Extra: ai
Requires-Dist: chromadb>=0.5; extra == "ai"
Requires-Dist: tiktoken>=0.7; extra == "ai"
Requires-Dist: sentence-transformers>=2.2; extra == "ai"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: ruff>=0.5; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Provides-Extra: all
Requires-Dist: devmate[web]; extra == "all"
Requires-Dist: devmate[tui]; extra == "all"
Requires-Dist: devmate[ai]; extra == "all"
Requires-Dist: devmate[dev]; extra == "all"

# 🏗️ DevMate

> **程序员终端瑞士军刀 + AI 原生平台——替代 5 个独立工具，一个 CLI 搞定**

[![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
[![Tests](https://img.shields.io/badge/tests-200%2B%20passed-brightgreen)]()

DevMate 是一个 **CLI + TUI + Web 三模架构** 的程序员全能工坊。装一个 devmate，少装 Postman + TablePlus + htop + 正则工具 + 文件管理器 + AI Agent。

---

## ✨ 核心亮点

| 能力 | 说明 |
|------|------|
| 🤖 **AI Agent** | ReAct 循环 + 11 个内置工具，自然语言指挥终端干活 |
| 🗺 **自然语言 → 工作流** | 说"检查服务器磁盘并汇总"，自动编排多步工作流并执行 |
| 📚 **RAG 知识库** | ChromaDB 向量检索，笔记/文档语义搜索（4 种嵌入模型可选） |
| 🔍 **AI 代码审查** | 读源码 + 知识库上下文，输出 Bug/安全/性能/风格建议 |
| 💬 **个人知识问答** | "上个月怎么修的内存泄漏" → 基于你的笔记直接给答案 |
| 🧩 **插件市场** | 搜索/安装/发布/评分插件，生态可扩展 |
| 🌐 **三端同源** | CLI / TUI / Web 共享同一套命令实现 |

## 🚀 快速开始

```bash
# 安装
pip install "devmate[all]"

# 首次运行（交互式引导）
devmate

# 试试这些命令
devmate tk organize ~/Downloads --dry-run     # 整理文件（预览模式）
devmate db connect sqlite:///test.db          # 连接数据库
devmate api get https://httpbin.org/get       # 发送 HTTP 请求
devmate ai add default --provider openai --key sk-xxx   # 配置 AI 模型
```

## 🤖 AI 场景演示

```bash
# ① 自然语言 → 工作流自动编排
devmate agent flow "检查所有服务器磁盘并汇总"

# ② AI 代码审查
devmate agent review ./src

# ③ 个人知识问答（基于 RAG 知识库）
devmate agent ask "上个月怎么修的内存泄漏"
```

## 📦 模块一览（16 个）

| 模块 | CLI 入口 | 功能 | 状态 |
|------|---------|------|------|
| **toolkit** | `devmate tk` | 文件整理、目录大小排行、缓存清理 | ✅ |
| **apidev** | `devmate api` | HTTP 客户端、Mock Server、请求历史 | ✅ |
| **dbadmin** | `devmate db` | SQL 编辑器、表浏览器、保存的查询 | ✅ |
| **apihub** | `devmate ai` | AI 模型统一接入、智能路由、成本追踪 | ✅ |
| **agent** | `devmate agent` | ReAct 循环、11 工具、三大 AI 场景 | ✅ |
| **workflow** | `devmate wf` | 多步工作流编排引擎 | ✅ |
| **knowledge** | `devmate knowledge` | RAG 向量知识库 | ✅ |
| **plugin** | `devmate plugin` | 插件市场、评分、发布 | ✅ |
| vault | `devmate vault` | 加密密钥管理器 | ✅ |
| audit | `devmate audit` | 审计日志 | ✅ |
| sshman | `devmate ssh` | SSH 连接管理 | ✅ |
| gitflow | `devmate git` | Git 工作流增强 | ✅ |
| regexlab | `devmate re` | 正则表达式实验室 | ✅ |
| notekeeper | `devmate note` | 个人笔记 | ✅ |
| monitor | `devmate top` | 系统监控 | ✅ |
| reporter | `devmate report` | 报告生成 | ✅ |

## 🖥 Web 面板

```bash
devmate web --port 8600
# 打开 http://127.0.0.1:8600 （默认 admin/devmate）
```

包含：仪表盘、Agent 引擎（三大场景可视化）、RAG 知识库、工作流编排、AI 配置、插件市场、用量统计。

## 📥 安装方式

```bash
pip install devmate              # 最小安装（CLI 核心）
pip install "devmate[dev]"       # 开发安装（测试 + 代码检查）
pip install "devmate[ai]"        # AI 功能（ChromaDB + 嵌入模型）
pip install "devmate[all]"       # 完整安装
```

## 🔧 开发

```bash
git clone https://github.com/CXuanPro/DevMate.git
cd DevMate
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

devmate --help                   # 验证
pytest                           # 运行测试（200+）
ruff check src/ tests/           # 代码检查
```

## 📐 架构

```
┌─────────┐  ┌─────────┐  ┌─────────┐
│  CLI    │  │  TUI    │  │  Web    │   ← 用户入口层
└────┬────┘  └────┬────┘  └────┬────┘
     └────────────┼────────────┘
                  ▼
         路由 / 调度层（事件总线）
                  ▼
       ┌───────────────────┐
       │   Agent Harness    │  ← LLM + 工具 + RAG + 工作流
       │  + 16 个业务模块   │
       └───────────────────┘
                  ▼
         安全基建（vault / audit）
```

## 🗺 路线图

- ✅ **Phase 1 (v0.x)** — CLI 瑞士军刀：16 模块
- ✅ **Phase 2 (v1.x)** — AI 原生平台：Agent + RAG + 工作流 + 场景
- ✅ **Phase 3 (v2.x)** — 生态市场：插件市场 + 评分 + 说明
- ⬜ **Phase 4 (v3.0)** — 开放平台：远程市场 / 配置云同步 / 团队审计 / SSO
- ⬜ **Phase 5 (v4.0+)** — 开发者终端 OS

## 📄 License

MIT
