| name | web-manage-fullstack |
| description | 东神脚手架全栈业务二次开发工作流。用于在 Spring Boot 3 + Vue 3 前后端分离项目中开发新的业务模块。涵盖：(1) 数据库设计与字典/通用查询 SQL 生成，(2) 后端 Domain/Mapper/Service/Controller 全套代码生成，(3) 前端后台管理页面(Element Plus)开发，(4) 前端前台用户页面(液态玻璃 Liquid Glass UI)开发，(5) 路由与权限配置，(6) 业务图片批量抓取与 img_url 填充。触发场景：用户要求新增业务模块、CRUD 功能、全栈开发、业务图片下载、img_url 填充等。 |
东神脚手架全栈业务开发 Skill
快速概览：7 步开发流程
业务图片抓取工具
当业务表有 img_url 字段且需要预填充图片时，使用 uv 运行项目自带的图片爬取脚本。
基本用法
uv run .windsurf/skills/web-manage-fullstack/scripts/fetch_images.py -k "猫咪" -n 5 -p . -t sys_pet
uv run .windsurf/skills/web-manage-fullstack/scripts/fetch_images.py -k "laptop" -n 3 -p . -t sys_product
uv run .windsurf/skills/web-manage-fullstack/scripts/fetch_images.py -k "课程" -n 4 -p . -t sys_course
uv run .windsurf/skills/web-manage-fullstack/scripts/fetch_images.py -k "宠物猫" -n 5 -p . -t sys_pet
uv run .windsurf/skills/web-manage-fullstack/scripts/fetch_images.py -k "宠物狗" -n 5 -p . -t sys_pet --id-start 6
uv run .windsurf/skills/web-manage-fullstack/scripts/fetch_images.py -k "动物" -n 6 -p . --source pexels --api-key YOUR_KEY
脚本功能
- 搜索图片: 支持 Bing (默认，无需 API Key)、Pexels (需 API Key)、Unsplash
- 自动检测: 扫描项目根目录下的
*_ui/src/assets/img 目录，适配任意业务前缀
- 双路径保存:
- 前端:
{xxx}_ui/src/assets/img/{keyword}_{n}.jpg (自动检测)
- 后端:
{project_root}/files/{keyword}_{n}.jpg
- SQL 生成: 输出
img_url 格式为 http://localhost:{port}/common/files/{filename}
- 可选 UPDATE SQL: 使用
--table 参数指定表名，自动生成 UPDATE ... SET img_url = ...
参数说明
| 参数 | 必须 | 默认值 | 说明 |
|---|
-k, --keyword | ✅ | - | 搜索关键词 |
-n, --count | ❌ | 5 | 下载数量 |
-p, --project-root | ✅ | - | 项目根目录 |
--img-dir | ❌ | 自动检测 | 直接指定前端图片目录 (跳过自动检测) |
--files-dir | ❌ | {root}/files | 直接指定后端文件目录 |
--backend-port | ❌ | 8088 | 后端端口 |
--source | ❌ | bing | 图片来源 (bing/pexels/unsplash) |
--api-key | ❌ | - | Pexels API Key |
-t, --table | ❌ | - | 目标表名 (生成 SQL) |
--id-start | ❌ | 1 | SQL id 起始值 |
--filename-prefix | ❌ | keyword | 文件名前缀 |
img_url 存储规范
- 数据库存储格式:
http://localhost:8088/common/files/{filename}.jpg
- 后端文件服务路径:
{project_root}/files/{filename}
- 上传接口:
POST /common/files/upload → 返回完整 URL
- 访问接口:
GET /common/files/{flag} → 直接预览
自检清单
数据库
后端
后台管理前端
前台用户前端
