xiaoyuge886-aigc

AIGC 智能 Agent 平台是一个强大的 AI 应用框架，通过集成 Claude AI 模型和丰富的技能生态系统，为用户提供智能化、场景化的 AI 解决方案。平台采用前后端分离架构，支持多租户、会话管理、技能扩展等企业级特性。

• 🤖 Claude AI 深度集成 – 基于最新的 Claude API，支持 Sonnet、Opus、Haiku 等多种模型
• 🧠 技能星系（Skill Galaxy） – 可视化技能生态，以脑图形式展示和管理 AI 能力
• 🎨 场景化智能匹配 – 根据用户需求自动匹配最合适的 AI 场景，提供精准服务
• 🔌 丰富的技能插件 – 内置 15+ 专业技能，涵盖数据分析、代码开发、文档管理等多个领域
• ⚙️ 自定义场景配置 – 管理员可灵活配置 AI 行为、工具权限、系统提示词等
• 👥 多用户会话管理 – 支持多用户、多会话，提供完整的对话历史和反馈机制

观看完整的功能演示视频：

📺 点击观看完整演示视频

平台的核心创新是技能星系可视化系统，以交互式脑图形式展示 AI 的能力矩阵：

• data-analysis – 数据清洗、统计分析、洞察生成
• echarts_chart – ECharts 图表生成专家
• smart_query_analyzer – 智能问数分析，自动生成 SQL

• agent-sql-pro – SQL 查询优化与数据库设计专家
• frontend-design – UI/UX 设计转前端代码
• pptx – PowerPoint 演示文稿生成与编辑

• water_network_beijing – 北京水网系统专业分析
• water_industry_researcher – 水利行业深度研究
• scientific-critical-thinking – 科研严谨性评估

• meta_agent – 综合智能代理，自主决策与反思
• x_agent_skill – 跨域分析助手，商业智能专家
• joyagent_skill – SOP 驱动的智能分析助手
• todo-master – 专业的任务规划与管理
• planning_first – 强制先规划后执行的思考框架

• minio_uploader – MinIO 文件上传工具
• whodb – 多数据库操作（PostgreSQL、MySQL、MongoDB 等）
• docs-management – Claude 官方文档管理与解析

平台支持自定义场景（Custom Scenarios），让 AI 能够适应不同的业务需求：

通过 ScenarioMatcher 实现：

1. 智能分析 – 使用 Claude 模型分析用户意图
2. 自动匹配 – 从可用场景中选择最合适的
3. 上下文注入 – 自动加载场景专属的配置和提示词

每个场景可以独立配置：

• 🎯 系统提示词 – 定义 AI 的角色和行为准则
• 🔧 工具权限 – 控制可用的工具和技能
• ⚙️ 模型参数 – 选择使用的 Claude 模型（Sonnet/Opus/Haiku）
• 🎨 UI 主题 – 自定义前端展示样式
• 📊 数据源 – 关联特定的数据库或知识库

平台内置多个常用场景：

frontend/aigc-frontend/
├── components/
│   ├── ChatInterface.tsx          # 主聊天界面
│   ├── SkillGalaxy.tsx            # 技能星系可视化
│   ├── ScenarioSelector.tsx       # 场景选择器
│   ├── AdminDashboard.tsx         # 管理员控制台
│   ├── ScenarioEditor.tsx         # 场景编辑器
│   └── SessionHistory.tsx         # 会话历史
├── services/
│   └── api.ts                     # API 客户端
└── App.tsx                        # 应用入口

核心技术栈：

• React 18 + TypeScript
• Vite 构建工具
• TailwindCSS 样式框架
• Zustand 状态管理
• React Query 数据请求

backend/
├── api/v1/
│   ├── endpoints.py               # API 路由
│   ├── platform.py               # 场景配置 API
│   └── auth.py                   # 用户认证
├── services/
│   ├── agent_service.py          # Agent 核心服务
│   ├── scenario_matcher.py       # 场景匹配引擎
│   ├── scenario_provider.py      # 场景数据提供
│   ├── configuration_manager.py  # 配置管理
│   └── database.py               # 数据库服务
├── models/
│   ├── platform.py               # 场景模型
│   └── database.py               # 数据模型
└── main.py                       # 应用入口

核心技术栈：

• FastAPI Web 框架
• SQLAlchemy ORM
• Claude Agent SDK
• SQLite / PostgreSQL 数据库
• Pydantic 数据验证

• Python 3.11+
• Node.js 18+
• Docker & Docker Compose（可选）

# 1. 克隆项目
git clone https://github.com/your-org/aigc-platform.git
cd aigc-platform

# 2. 安装后端依赖
cd backend
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# 3. 配置环境变量
cp .env.example .env
# 编辑 .env，填写 ANTHROPIC_API_KEY

# 4. 启动后端服务
cd backend
python main.py

# 5. 安装前端依赖（新终端）
cd frontend/aigc-frontend
npm install

# 6. 启动前端服务
npm run dev

访问 http://localhost:5173 开始使用

# 使用一键部署脚本
cd deploy
cp .env.example .env
# 编辑 .env 文件
./deploy.sh dev

详细部署指南请参考 部署文档

// 在聊天界面中启用技能
import { SkillGalaxy } from './components/SkillGalaxy';

<SkillGalaxy
  onSkillSelect={(skill) => console.log('选中技能:', skill)}
  activeSkills={['data-analysis', 'echarts_chart']}
/>

通过管理员控制台创建场景：

# backend/services/scenario_provider.py
scenario = {
    "name": "金融分析助手",
    "description": "专注于金融数据分析和投资建议",
    "system_prompt": "你是一位专业的金融分析师...",
    "model": "sonnet",
    "tools": ["data-analysis", "echarts_chart"],
    "max_turns": 30,
    "permission_mode": "autoConfirm"
}

# 创建会话
curl -X POST http://localhost:8000/api/v1/session/create \
  -H "Content-Type: application/json" \
  -d '{"scenario_id": 1}'

# 发送消息
curl -X POST http://localhost:8000/api/v1/session/query \
  -H "Content-Type: application/json" \
  -d '{
    "session_id": "xxx",
    "prompt": "分析2024年A股市场趋势",
    "enable_skills": ["data-analysis", "echarts_chart"]
  }'

• 📊 智能数据分析 – 快速生成数据报告和可视化图表
• 💻 代码开发助手 – 代码生成、重构、调试和文档编写
• 📝 文档自动生成 – 技术文档、API 文档、用户手册
• 🎨 UI/UX 设计 – 设计稿转前端代码、样式生成

• 💰 金融行业 – 市场分析、风险评估、投资建议
• 🏥 医疗健康 – 医疗文献分析、诊断辅助
• 🏭 制造业 – 生产数据分析、质量检测
• 🌾 农业 – 农业数据分析、种植建议

技能定义在 .claude/skills/ 目录下，每个技能包含：

.claude/skills/your-skill/
├── skill.md           # 技能说明文档
├── guidance.py        # 执行逻辑
└── tests/            # 测试用例

详细开发指南请参考 技能开发文档

欢迎贡献代码！请遵循以下流程：

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

• 代码风格：遵循 PEP 8 (Python) 和 ESLint (TypeScript)
• 提交信息：使用 Conventional Commits 规范
• 测试要求：新功能需要包含单元测试
• 文档更新：更新相关文档和示例

• 部署指南 – Docker 部署详细说明
• API 文档 – Swagger UI 自动生成
• 开发文档 – 架构设计和开发指南
• 技能开发教程 – 如何开发自定义技能
• 故障排查 – 常见问题解决
• 黄金走势报告设计示例 – Apple 设计风格的报告生成示例

本项目采用 MIT 协议开源。详见 LICENSE 文件。

• Anthropic – Claude AI 模型
• FastAPI – 现代化的 Web 框架
• React – 用户界面库
• Vite – 下一代前端构建工具