AI 工具及使用经验分享平台 —— 离线部署,仅需 MySQL 8.0+ 与 JDK 17,简洁安全,专为企业内部网络管控环境打造。

CodingHub 是一个支持离线部署的 AI 工具发现与经验分享网站。项目仅依赖 MySQL 8.0+ 和 JDK 17,无需 Redis、Elasticsearch 等额外中间件,部署极简。特别适用于网络管控严格的企事业单位——所有服务在局域网内运行,数据不外泄,安全可控。

将截图文件放入 docs/screenshot.png 即可显示。

CodingHub 预览

CodingHub/
├── backend/ # Java Spring Boot 后端
│ └── src/main/java/com/iaihub/toolbox/
│ ├── controller/ # REST API 控制器
│ ├── service/ # 业务逻辑层
│ ├── repository/ # 数据访问层 (JPA)
│ ├── model/ # 实体类
│ ├── dto/ # 数据传输对象
│ ├── config/ # 配置类 (Security, JWT, Upload)
│ ├── exception/ # 异常处理
│ └── util/ # 工具类
├── frontend/ # Vue 3 + TypeScript 前端
│ └── src/
│ ├── components/ # Vue 组件
│ ├── pages/ # 页面
│ ├── services/ # API 调用
│ ├── stores/ # 状态管理
│ ├── router/ # 路由配置
│ └── types/ # TypeScript 类型定义
├── codinghub/ # MCP Server 配置
├── docs/ # 详细文档
├── design-system/ # 设计系统
├── harness/ # Agent 基础设施
├── scripts/ # 脚本工具
├── specs/ # 功能规格说明
└── Makefile # 快速命令

CodingHub 内置 MCP (Model Context Protocol) Server,允许任意支持 MCP 的智能体(如 CodeBuddy、Claude Desktop、Cursor 等)直接对接本网站。

在智能体的 MCP 配置中添加 CodingHub Server 即可实现:

• 工具发现: 智能体自动拉取 CodingHub 中收录的 AI 工具列表
• 经验检索: 智能体查询工具使用经验、最佳实践
• 一次配置,自动同步: 网站内容更新后,智能体自动获取最新数据

{
 "mcpServers": {
 "CodingHub-mcp": {
 "type": "sse",
 "url": "http://127.0.0.1:8082/sse",
 "description": "CodingHub MCP Server",
 "disabled": false
 }
 }
}

• Java 17+
• Node.js 18+
• MySQL 8.x
• npm

# 初始化数据库 + 安装依赖 + 启动服务
.\setup-windows.ps1
# 启动全部服务
.\run-windows.ps1
# 停止全部服务
.\stop-windows.ps1

# 初始化数据库
make db
# 安装前端依赖
make install
# 启动后端 (8082)
make backend
# 启动前端 (5173)
make frontend
# 同时启动后端+前端
make run
# 停止所有服务
make stop

• user: id, email, password, username, created_at, updated_at, last_login_at
• category: id, name, icon, sort_order, created_at
• tool: id, name, version, category_id, content, uploader_id, status, view_count, like_count, comment_count, score, created_at, updated_at
• tool_file: id, tool_id, original_name, stored_path, file_size, content_type, status, created_at

本项目采用 Cyberpunk Glassmorphism 双主题设计:

详细设计规范请参阅 design-system/CodingHub/MASTER.md。

CodingHub 专为离线环境设计:

1. 打包依赖: 后端使用 Gradle 将所有依赖打包为 Fat JAR
2. 前端构建: 前端构建为静态资源,由后端直接托管
3. 数据库迁移: Flyway 自动执行 SQL 迁移,无需手动建表
4. 无需外网: 所有资源内嵌,启动后即可通过局域网访问

1. 禁止循环依赖: controller → service → repository → model 单向依赖
2. XSS 防护: 所有用户输入通过 XssSanitizer.sanitize() 过滤
3. JWT 认证: 需要认证的接口在 Header 携带 Authorization: Bearer <token>
4. 禁止 null 返回: 方法不返回 null,抛异常或返回 Optional
5. 禁止循环调用: 禁止在循环中请求数据库或调用接口

1. 禁止私自提交: 需求开发过程中不得私自提交代码
2. 提交信息遵循 Conventional Commits 格式
3. 单次提交不超过 1000 行更改

• 架构详情 - 详细架构说明
• Agent 导航地图 - AI 代理快速参考
• 环境配置 - 运行时环境变量

最后更新: 2026年06月10日