🚀 AI开发工具包模板
一个完整的、可重用的模板,用于具有本地RAG、MCP集成和可视化服务管理的AI增强开发环境。
🎯 所得
此模板提供了 生产就绪的人工智能开发生态系统 您可以在几分钟内部署到任何项目:
核心组件
- 🧠 本地RAG系统 -2600+文档语义搜索
- 🤖 MCP服务器 -AI代理集成协议
- 📁 文件管理器 -文件上传/组织
- 🎛️ 控制面板 -可视化服务管理
- ⚙️ 应用程序控制脚本 -命令行编排
主要特点
- ✅ 零外部依赖 -完全离线工作
- ✅ 项目不可知 -适应任何代码库
- ✅ AI就绪 -立即与编码助手集成
- ✅ 专业用户界面 -企业级控制接口
- ✅ 一个命令设置 -自动化部署脚本
🚀 快速开始
选项1:使用GitHub模板
# Create new repo from template
gh repo create my-ai-project --template hartou/ai-dev-toolkit-template
# Deploy to existing project
cd my-existing-project
curl -sSL https://raw.githubusercontent.com/hartou/ai-dev-toolkit-template/main/scripts/deploy.sh | bash选项2:NPM包
# Install globally
npm install -g ai-dev-toolkit
# Deploy to any project
cd my-project
ai-dev-toolkit init
ai-dev-toolkit start选项3:手动设置
# Clone template
git clone https://github.com/hartou/ai-dev-toolkit-template.git
cd ai-dev-toolkit-template
# Configure and deploy
./scripts/setup.sh
./scripts/deploy.sh /path/to/target/project📁 模板结构
ai-dev-toolkit-template/
├── 📦 core/ # Core reusable components
│ ├── rag-system/ # RAG engine + database
│ ├── mcp-server/ # Model Context Protocol server
│ ├── file-manager/ # Documentation management
│ ├── control-panel/ # Service orchestration UI
│ └── shared/ # Common utilities
├── 🔧 scripts/ # Automation and deployment
│ ├── deploy.sh # Deploy to existing project
│ ├── setup.sh # Initial configuration
│ ├── app-control.sh # Service management
│ └── templates/ # Configuration templates
├── 📋 configs/ # Default configurations
│ ├── package.template.json # NPM dependencies
│ ├── docker-compose.yml # Container deployment
│ └── .env.template # Environment variables
├── 📚 docs/ # Documentation and guides
└── 🧪 examples/ # Integration examples⚙️ 配置
项目适应
该工具包会自动适应您的项目结构:
# Auto-detect project type
./scripts/detect-project.sh
# Configure for specific frameworks
ai-dev-toolkit configure --framework react
ai-dev-toolkit configure --framework nextjs
ai-dev-toolkit configure --framework python自定义文档
# Index your project documentation
ai-dev-toolkit index --source ./docs
ai-dev-toolkit index --source ./README.md
ai-dev-toolkit index --include "*.md,*.rst,*.txt"服务端口
# Customize service ports
export RAG_PORT=4001
export MCP_PORT=4002
export FILE_MANAGER_PORT=4003
export CONTROL_PANEL_PORT=4004🎛️ 服务管理
部署后,管理您的AI开发环境:
# Start all services
./ai-control.sh start
# Individual service management
./ai-control.sh rag start
./ai-control.sh mcp start
./ai-control.sh panel start
# Web interfaces
open http://localhost:4001 # RAG Search
open http://localhost:4003 # File Manager
open http://localhost:4004 # Control Panel🔌 集成示例
VS代码集成
{
"settings": {
"ai-dev-toolkit.ragEndpoint": "http://localhost:4001",
"ai-dev-toolkit.mcpServer": "http://localhost:4002"
}
}AI助手集成
// Use the MCP server in your AI workflow
import { MCPClient } from '@modelcontextprotocol/sdk'
const mcp = new MCPClient('stdio', {
command: 'node',
args: ['./ai-dev-toolkit/mcp-server/index.js']
})CI/CD集成
# GitHub Actions
- name: Setup AI Dev Toolkit
run: |
curl -sSL https://get.ai-dev-toolkit.com | bash
ai-dev-toolkit start --headless
- name: AI-Enhanced Testing
run: |
ai-dev-toolkit query "test patterns for React components"
npm test📊 性能规格
- 🚀 设置时间:\ B[RAG System :4001]
A --> C[MCP Server :4002] A --> D[File Manager :4003] B --> E[SQLite Database] C --> E D --> F[Documentation Store] G[AI Agents] --> C H[Developers] --> A
### **数据流**
1. **文档** → 文件管理器→ RAG索引器→ SQLite数据库
1. **AI查询** → MCP服务器→ RAG发动机→ 语义搜索结果
1. **人工查询** → 网络界面→ RAG API→ 搜索结果
1. **管理** → 控制面板→ 服务脚本→ 系统状态
## 🎪 **用例**
### **个人开发者**
- 个人项目知识库
- 人工智能辅助编码环境
- 文档驱动开发
### **开发团队**
- 共享知识库
- 团队入职加速
- 协同人工智能开发
### **组织**
- 企业人工智能开发平台
- 标准化开发环境
- 知识管理系统
### **开源项目**
- 贡献者入职培训
- 文档可访问性
- AI驱动的问题解决
## 🔄 **更新策略**
保持您的工具包最新:
Update to latest version
ai-dev-toolkit update
Update specific components
ai-dev-toolkit update rag ai-dev-toolkit update mcp
Backup before updates
ai-dev-toolkit backup ai-dev-toolkit restore backup-20241109.zip
## 🎯 **路线图**
### **V2.0功能** (即将推出)
- 🔌 **插件系统** -自定义集成
- 🌐 **多语言支持** -Python、Java、Go
- 📱 **移动接口** -响应式设计
- 🔒 **认证** -多用户支持
- ☁️ **云部署** -Kubernetes清单
### **V3.0愿景**
- 🤖 **AI代码生成** -与RAG知识相结合
- 📊 **分析仪表板** -使用洞察和优化
- 🔄 **实时协作** -实时文档共享
- 🎨 **自定义主题** -品牌和个性化
## 📝 **贡献**
帮助改进工具包:
Development setup
git clone https://github.com/hartou/ai-dev-toolkit-template.git cd ai-dev-toolkit-template ./scripts/dev-setup.sh
Run tests
npm test
Submit improvements
git checkout -b feature/my-improvement git commit -m "Add awesome feature" git push origin feature/my-improvement
## 📄 **许可证**
MIT许可证-在个人和商业项目中自由使用。
## 🙋 **支持**
- 📧 **电子邮件**: support@ai-dev-toolkit.com
- 💬 **Discord 的中文翻译是“不和谐”或“纷争”。**: [AI开发工具包社区](https://discord.gg/ai-dev-toolkit)
- 🐛 **问题**:
- 📖 **文档**: [全部文件](https://docs.ai-dev-toolkit.com)
______________________________________________________________________
**在2分钟内将任何项目转换为人工智能增强的开发环境。** 🚀