企业官网建设流程全解析

## QiDi Agent：开源的多AI编程工具统一编排平台（v1.2.0）

> **让多个AI编程工具协同工作，隐私模式下代码永不离开本地**

---

## 📌 目录

1. [项目简介](#一项目简介)
2. [核心特性](#二核心特性)
3. [隐私模式原理](#三隐私模式原理)
4. [快速安装与使用](#四快速安装与使用)
5. [命令行指令大全](#五命令行指令大全)
6. [Web管理界面](#六web管理界面)
7. [支持的工具与模型](#七支持的工具与模型)
8. [适用场景](#八适用场景)
9. [开源许可](#九开源许可)
10. [项目地址](#十项目地址)

---

## 一、项目简介

**QiDi Agent**（启迪智能体）是一个开源的多AI编程工具统一编排与协作平台。它能自动扫描并管理你电脑上已安装的各类AI编程工具，根据任务类型智能拆分、分派给不同工具并行执行，最终将结果合并输出。

> 当前版本 **v1.2.0**，MIT 开源协议，免费商用。

### 解决了什么问题？

- **工具分散**：Claude Code、Qoder、OpenClaw、Trae CN 等各有优劣，切换繁琐
- **重复工作**：同一个需求在多个工具间反复提交
- **隐私顾虑**：代码完整交给云端AI，商业机密无保障
- **成本问题**：高质量模型按量计费，大量任务成本高

---

## 二、核心特性

### 🔒 隐私模式

将你的原始需求在本地（Ollama）拆解为纯技术指令，每个云端AI工具只拿到一个独立的函数签名，无法推断整体项目。任务拆分、质检、合并全流程在本地完成。

| 保护层级 | 说明 |
|---------|------|
| 源码碎片化 | 每个工具只拿到自己的模块接口，看不到完整代码 |
| 意图隔离 | 本地Ollama理解需求，云端只收到无业务上下文的纯技术指令 |

### ✨ 高质量模式

使用多个免费或低价云端模型（DeepSeek、GLM、Groq 等）并行实现代码，通过AI质检+智能合并，产出质量接近 Claude Opus / GPT-4 的水平。

### 💬 先聊后执行（v1.1.0+）

WebUI 支持对话式交互：先通过自然语言与 Agent 沟通需求，确认理解无误后再点击执行。

### 🖥️ 终端 TUI 界面（v1.2.0+）

基于 React/Ink 构建的交互式终端界面，支持命令补全、历史记录、多行输入、实时进度显示。

### 🧠 上下文记忆（v1.1.0+）

24K token 上下文预算，超出自动截断；前端 localStorage + 后端文件双层持久化，刷新不丢失。

---

## 三、隐私模式原理

```
┌─ 你的电脑 ─────────────────────────────────┐
│ │
│ 原始需求：「写一个电商系统」 │
│ │ │
│ ▼ │
│ 本地 Ollama 拆分 │
│ ┌──────┼──────────┬──────────┐ │
│ ▼ ▼ ▼ ▼ │
│ 订单 支付 库存 物流 │
│ (接口) (接口) (接口) (接口) │
└──────┬──────┴──────────┴──────────┘ │
│ 发送到不同的云端 AI 工具 │
┌──────▼─────────────────────────────────────┐ │
│ 云端工具（每个只看到一个独立函数签名） │ │
│ Claude Code → orderService.js │ │
│ Qoder → paymentService.js │ │
│ Trae CN → inventoryService.js │ │
└──────┬─────────────────────────────────────┘ │
│ 返回各模块代码 │
┌──────▼─────────────────────────────────────┐ │
│ 本地质检 + 合并 → 完整项目 │ │
│ 代码从未整体离开过本地 │ │
└─────────────────────────────────────────────┘ │
```

**关键点**：云端工具看到的只是一个孤立的函数签名，没有任何业务上下文。即使某个云端工具被审计或泄露，也只暴露一个函数的实现，无法推断整体项目。

---

## 四、快速安装与使用

### 环境要求

- Node.js >= 16
- （隐私模式）Ollama + 本地模型（推荐 `qwen2.5:7b`）

### 安装

```bash
# 全局安装
npm install -g qidi-agent

# 或直接使用 npx（无需安装）
npx qidi --help
```

### 基本使用

```bash
# 1. 扫描本机已安装的AI编程工具
npx qidi scan --connect --save

# 2. 启动 Web 管理界面
npx qidi web -p 3000

# 3. 终端交互模式（v1.2.0 TUI）
npx qidi interactive

# 4. 直接执行任务
npx qidi run -t "用 Python 写一个 Web 服务器" --mode privacy
npx qidi run -t "贪吃蛇游戏" --mode quality
```

### Web 界面展示

启动后访问 `http://localhost:3000`，功能面板包括：

- **Dashboard**：系统状态概览
- **编程控制台**：模式选择 + 任务输入 + 实时日志
- **工具管理**：扫描、连接、启用/禁用 AI 工具
- **模型管理**：配置 API Key、模型参数
- **文件管理**：树形目录浏览 + 代码编辑器 + 行号支持
- **报告中心**：执行报告查看与对比

---

## 五、命令行指令大全

### 交互模式（interactive / i）

```bash
npx qidi interactive -m privacy -p ollama
npx qidi i -m quality -p openai -w ./myproject
```

| 选项 | 说明 | 默认值 |
|------|------|--------|
| `-m, --mode` | 执行模式：`privacy` / `quality` | `privacy` |
| `-p, --provider` | 模型提供商：`ollama` / `openai` / `anthropic` | ollama |
| `-w, --workspace` | 工作目录 | `./workspace` |

### 完整命令列表

| 命令 | 作用 |
|------|------|
| `scan` | 扫描并连接本机 AI 编程工具 |
| `tools` | 查看已接入的工具 |
| `status` | 查看当前模式和连接状态 |
| `mode privacy/quality` | 切换执行模式 |
| `provider ollama/openai` | 切换默认模型提供商 |
| `<任务>` / `run <任务>` | 执行编程任务 |
| `tasks` | 查看最近任务历史 |
| `reports` | 查看报告列表 |
| `report <id>` | 查看指定报告详情 |
| `context` / `ctx` | 查看上下文记忆 |
| `ls [dir]` | 列出工作目录文件 |
| `view <path>` | 查看文件内容（带行号） |
| `pwd` | 显示当前目录 |
| `history` | 查看命令历史 |
| `reset` | 重置上下文记忆 |
| `clear` / `cls` | 清屏 |
| `help` / `h` / `?` | 显示帮助 |
| `exit` / `quit` / `q` | 退出 |

### 其他命令

```bash
# 工具管理
npx qidi connect --auto
npx qidi connect -t claude-code
npx qidi agents --enable openai

# 配置与日志
npx qidi config --show
npx qidi config --level debug
npx qidi logs --clean

# 报告
npx qidi reports -c 30
npx qidi report exp_xxxxx
```

---

## 六、Web管理界面

运行 `npx qidi web -p 3000` 后，浏览器访问 `http://localhost:3000`。

### 主要功能

| 页面 | 功能 |
|------|------|
| Dashboard | 系统状态、任务统计、工具连接状态 |
| Agent 控制台 | 对话式任务输入 + 模式选择 + 路由配置 + 实时进度 |
| 工具管理 | 扫描/连接/启用/禁用 各AI工具 |
| 模型管理 | 配置 Ollama/OpenAI/Anthropic/DeepSeek 等模型参数 |
| 文件管理 | 树形目录 + 在线编辑器 + 文件上传/下载 |
| 报告中心 | 历史报告检索、详情查看、对比分析 |

### 上下文记忆（v1.1.0+）

- **24K token 预算**：超出自动截断最早对话，预留 ~8K 给模型回复
- **双层持久化**：前端 localStorage + 后端 JSON 文件，页面刷新不丢失
- **会话管理**：支持列出、加载、删除历史会话

---

## 七、支持的工具与模型

### 已适配的 AI 编程工具（8个）

| 工具 | 来源 |
|------|------|
| Claude Code | Anthropic |
| Open Code | 开源 |
| OpenClaw | 开源 |
| Qoder | 开源 |
| Hermes Agent | 开源 |
| AtomCode | 开源 |
| Mimo Code | 开源 |
| Trae CN | 字节跳动 |

### 已支持的 LLM 提供商（6个）

| 提供商 | 用途 | 是否需要 API Key |
|--------|------|----------------|
| Ollama | 本地模型（隐私模式核心） | 否 |
| OpenAI | 任务拆分/质检 | GPT 额度 |
| Anthropic | 任务拆分/质检 | Claude 额度 |
| DeepSeek | 高质量模式 | 免费额度 |
| Groq | 高质量模式 | 免费额度 |
| 智谱 GLM | 高质量模式 | 免费额度 |

### 7种任务派发模式

| 模式 | 说明 | 适用场景 |
|------|------|---------|
| `parallel` | 所有工具并行执行 | 简单任务，追求速度 |
| `sequential` | 上一个结果传给下一个 | 有依赖关系的任务 |
| `select` | 各写各的，选最优结果 | 算法题、方案对比 |
| `cascade` | 层层递进逐步深化 | 复杂项目迭代 |
| `merge` | 全部产出合并成一份 | 需要综合多方案 |
| `privacy` | 本地拆分，云端各写碎片 | **敏感项目** |
| `quality` | 多个廉价模型协同 | **预算有限** |

---

## 八、适用场景

- **企业内部项目**：代码和商业逻辑绝对不能外泄，隐私模式为首选
- **个人开源项目**：多工具并行，加速开发效率
- **竞对敏感项目**：不让任何第三方知道你在开发什么
- **学习/实验**：对比不同 AI 工具的编程能力，探索最佳实践
- **预算有限**：使用免费模型 + 高质量模式，低成本产出接近付费模型的效果

---

## 九、开源许可

QiDi Agent 采用 **MIT 许可证**：

- ✅ 免费商用
- ✅ 修改代码
- ✅ 闭源发布
- ✅ 做成产品

唯一要求：保留版权声明。

---

## 十、项目地址

- **GitHub**：https://github.com/qidiai/QiDi-Agent
- **Gitee**：https://gitee.com/xuchangming/qidi-agent

---

*如果对你有帮助，欢迎 Star 支持！使用中遇到问题请在评论区留言或提 Issue。*