## QiDi Agent:开源的多AI编程工具统一编排平台(v1.2.0)> **让多个AI编程工具协同工作,隐私模式下代码永不离开本地** ## 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.0WebUI 支持对话式交互先通过自然语言与 Agent 沟通需求确认理解无误后再点击执行。### ️ 终端 TUI 界面v1.2.0基于 React/Ink 构建的交互式终端界面支持命令补全、历史记录、多行输入、实时进度显示。### 上下文记忆v1.1.024K 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 TUInpx qidi interactive# 4. 直接执行任务npx qidi run -t 用 Python 写一个 Web 服务器 --mode privacynpx qidi run -t 贪吃蛇游戏 --mode quality### Web 界面展示启动后访问 http://localhost:3000功能面板包括- **Dashboard**系统状态概览- **编程控制台**模式选择 任务输入 实时日志- **工具管理**扫描、连接、启用/禁用 AI 工具- **模型管理**配置 API Key、模型参数- **文件管理**树形目录浏览 代码编辑器 行号支持- **报告中心**执行报告查看与对比---## 五、命令行指令大全### 交互模式interactive / ibashnpx qidi interactive -m privacy -p ollamanpx 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 --autonpx qidi connect -t claude-codenpx qidi agents --enable openai# 配置与日志npx qidi config --shownpx qidi config --level debugnpx qidi logs --clean# 报告npx qidi reports -c 30npx 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。*