【Code with SOLO】用 SOLO 从零搭建全栈 AI 工具聚合平台 — AI-Tools-Hub

遇见Lex · 2026 年4 月 17 日 12:05

【Code with SOLO】用 SOLO 从零搭建全栈 AI 工具聚合平台 — AI-Tools-Hub

① 摘要

面向 AI 从业者和开发者，在「发现和选择 AI 工具」场景下提供一站式聚合搜索与智能推荐平台。通过 TRAE SOLO 完成从需求分析、架构设计、前后端开发到 Docker 部署的全流程，最终产出一个包含 Elasticsearch 全文搜索、LLM 智能推荐、多源数据采集、赛博朋克 UI 的完整全栈应用。项目已开源，架构可复用于任意资源聚合场景。

② 背景

我是一名全栈开发者，日常工作中需要频繁接触各种 AI 工具 — MCP Server、AI Agent 框架、Prompt 模板、RAG 工具、AI 编程助手……但这些工具散落在 GitHub、Gitee、各大社区，没有一个统一的入口来发现和比较。

痛点：

AI 工具生态爆发式增长，找不到合适的工具
搜索结果质量差，缺乏分类和评价体系
现有导航站功能简陋，没有智能推荐能力
想要一个既能聚合数据、又能智能推荐的完整平台

目标： 用 SOLO 从零搭建一个全栈 AI 工具聚合平台，具备专业级搜索、LLM 驱动推荐、精美 UI 和一键部署能力。

③ 实践过程

第一步：需求分析与架构设计

首先让 SOLO 帮我梳理需求和技术选型：

Prompt 示例：

我要搭建一个 AI 工具聚合平台，需要支持：全文搜索、智能推荐、数据采集、用户系统、分类浏览、排行榜。请帮我设计技术架构，要求前后端分离，支持 Docker 部署，UI 要有科技感。

SOLO 给出了完整的技术选型方案：

前端：Next.js 14 + TypeScript + Tailwind CSS + shadcn/ui
后端：Python FastAPI + SQLAlchemy (Async)
搜索：Elasticsearch 8 + IK 中文分词
缓存：Redis 7
数据库：PostgreSQL 16
LLM：多 Provider 支持（SiliconCloud / Gemini / Groq / 千帆 / DeepSeek）
部署：Docker Compose 一键编排

第二步：项目初始化与数据库设计

让 SOLO 初始化项目结构，并设计数据库模型：

Prompt 示例：

帮我初始化前后端项目，设计数据库表结构。需要包含：技能表（支持多平台、多标签、评分、收藏量）、分类表（支持多级分类）、用户表、收藏表、评价表、搜索日志表、采集任务表。同时预留商业化字段（会员等级、付费标记、开发者账户）。

SOLO 生成了：

完整的 9 张表 SQL DDL（含索引、约束、种子数据）
SQLAlchemy 2.0 Async ORM 模型
Pydantic Schema 数据校验模型
Alembic 数据库迁移配置

第三步：后端 API 开发

分模块让 SOLO 开发后端 API：

3.1 认证模块

实现 JWT 认证系统，包含注册、登录、Token 刷新、密码修改。密码使用 bcrypt 加密。

3.2 搜索模块

实现 Elasticsearch 全文搜索，支持标题(x3)、描述(x2)、详情、标签多字段搜索，IK 中文分词，关键词高亮。ES 不可用时降级到 PostgreSQL LIKE 搜索。

3.3 LLM 智能推荐

实现 LLM 智能推荐服务，支持 5 个 Provider（SiliconCloud、Gemini、Groq、百度千帆、DeepSeek）通过环境变量切换。流程：用户自然语言查询 → LLM 意图分析 → 搜索 → 返回推荐结果+理由。失败时降级为关键词搜索。

3.4 数据采集模块

实现数据采集模块，支持 GitHub 和 Gitee 两个平台。使用工厂模式设计，通过配置切换采集源。支持快速采集和全量采集。

SOLO 完整实现了：

10 个 API 路由模块（auth / skills / search / recommend / categories / crawl / ranking / favorites / reviews / admin）
完善的容错降级机制（ES→PG、LLM→关键词、Redis→跳过限流）
API 限流中间件（搜索 30/min、采集 10/min）
全局异常处理器

第四步：前端开发

4.1 首页与布局

设计赛博朋克风格的首页，包含：Canvas 神经网络粒子动画背景、毛玻璃效果导航栏、跑马灯搜索框（带打字机效果 placeholder）、分类网格、热门技能卡片、数字滚动统计。

SOLO 实现了令人惊艳的 UI 效果：

NeuralBackground：Canvas 绘制 40 个节点随机运动、连线、脉冲，响应鼠标交互
Glass Morphism：全局毛玻璃效果
Holographic Shimmer：卡片悬停全息渐变边框
跑马灯搜索框：流动渐变边框动画
打字机效果：placeholder 循环切换搜索词
数字滚动：IntersectionObserver 触发计数器动画

4.2 搜索页

实现搜索结果页，支持关键词高亮、分类/标签/排序多维筛选、列表/网格视图切换、分页。

4.3 工具详情页

实现工具详情页，展示技能完整信息、安装指南（Markdown 渲染）、用户评价（星级+评论）、相关推荐。

4.4 其他页面

实现排行榜页（热门/评分/最新/趋势）、收藏页、个人中心、登录注册、管理后台（采集任务管理）。

4.5 深色/浅色主题

实现深色和浅色双主题切换，使用 CSS 变量实现无缝切换。

第五步：Docker 部署

编写 Docker Compose 编排文件，包含 6 个服务：PostgreSQL、Elasticsearch（含 IK 分词）、Redis、FastAPI 后端、Next.js 前端、Nginx 反向代理。同时提供仅基础设施的 docker-compose.infra.yml 用于本地开发。

SOLO 生成了：

docker-compose.yml：全量服务一键启动
docker-compose.infra.yml：仅 PG + ES + Redis
各服务 Dockerfile
Nginx 配置（前端 + API 反向代理）
后端启动时自动执行数据库迁移和 ES 索引同步

踩坑记录

Elasticsearch IK 分词插件：官方镜像不包含 IK 插件，需要自定义 Dockerfile 安装。SOLO 帮我写了自定义 ES Dockerfile，基于官方镜像安装 analysis-ik 插件。
Next.js standalone 模式：Docker 部署需要使用 standalone 输出模式，SOLO 正确配置了 next.config.js。
Async SQLAlchemy：SQLAlchemy 2.0 的 async 模式和 1.x 差异较大，SOLO 准确使用了新的 async API。
LLM Provider 适配：5 个 LLM 厂商的 API 格式各不相同，SOLO 设计了统一的接口适配层，通过工厂模式切换。

④ 成果展示

项目地址

GitHub 仓库： GitHub - lex-pace/Ai-Tools-Hub · GitHub

核心功能演示

首页 — 赛博朋克风格

智能搜索

LLM 智能推荐
未实现

工具详情

排行榜

管理后台 — 数据采集

深色/浅色主题

移动端适配

技术指标

指标	数据
前端页面	11 个
后端 API 端点	30+
数据库表	9 张
LLM Provider	5 个
Docker 服务	6 个
UI 组件	20+
分类体系	8 一级 + 24 二级

⑤ 效果与总结

提效数据

环节	传统方式	使用 SOLO
架构设计	2-3 小时	15 分钟
数据库设计	1-2 小时	10 分钟
后端 API 开发	3-5 天	1 天
前端页面开发	3-5 天	1 天
Docker 部署配置	半天	30 分钟
总计	1-2 周	2-3 天

SOLO 在流程中的角色

SOLO 贯穿了整个开发流程：

需求分析阶段：帮助梳理功能需求、输出技术选型方案
架构设计阶段：设计系统架构、数据库模型、API 接口规范
编码实现阶段：逐模块生成前后端代码，包括复杂的 Canvas 动画、ES 搜索、LLM 适配等
调试优化阶段：解决 ES IK 分词、Async SQLAlchemy、Docker 部署等技术难题
文档编写阶段：生成 README、API 文档、部署指南

可复用方法论

分模块迭代：将大项目拆分为独立模块，逐个让 SOLO 实现，每次聚焦一个清晰的目标
提供充分上下文：在 Prompt 中明确技术栈、接口规范、数据结构，减少返工
利用 SOLO 的多工具能力：文件读写、命令执行、代码搜索，让 SOLO 自主完成完整开发循环
容错设计前置：在设计阶段就考虑降级方案（ES→PG、LLM→关键词），SOLO 能准确实现

项目扩展价值

AI-Tools-Hub 不仅是一个 AI 工具导航站，更是一个通用的资源聚合应用框架。基于本项目的架构，可以轻松扩展为：

开源项目导航站
技术资讯聚合平台
数字产品商城（已预留商业化模型）
学习资源平台
开发者工具箱
企业内部知识库

核心可复用能力包括：多源数据采集框架、ES 全文搜索、LLM 智能推荐、分类/标签/评价体系、用户系统、Docker 一键部署、精美 UI 主题。

标签：Code with SOLO

本项目使用 TRAE SOLO 从零完成全部开发，包括架构设计、前后端编码、UI 实现、Docker 部署配置。项目已开源，欢迎 Star