菜单
Use when working with x-file-storage, FileStorageService, FileInfo, UploadPretreatment, FileRecorder, storage platform selection, file upload/delete flows, thumbnail generation, Solon file upload integration, or debugging path/platform/file-record issues in Java projects.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
辅助开发、调试和解释 jimuqu-admin 项目。只要当前仓库是 jimuqu-admin，或用户提到 Xbatis、BaseMapperPlus、QueryChain、AutoTable、Sa-Token、数据权限、文件上传、操作日志、限流、SSE、通用增删改查示例、项目新接口开发，都必须使用此技能。此技能会要求先查项目文档和现有模块，并按项目规范落地；底层 Solon API 仍需联动 solon 查证。
辅助开发、配置、调试和解释 AutoTable 自动维护数据库表结构框架。只要用户提到 AutoTable、org.dromara.autotable、@AutoTable、@AutoColumn、@PrimaryKey、@Index、@TableIndex、@AutoColumns、多数据库 dialect、自动建表/改表/建库、mode validate/create/update/none、auto-drop-column/table/index、record-sql、init-data、Flyway 脚本、Solon 插件或 Spring Boot starter 集成、事件回调/拦截器、类型映射、字段排序或没有创建表等问题，都必须使用此技能并优先查证 /Users/chengliang/code-repositories/auto-table 源码。
辅助开发、配置、调试和解释 FastExcel / cn.idev.excel Excel 读写库。只要用户提到 FastExcel、cn.idev.excel、EasyExcel、@ExcelProperty、ExcelReader、ExcelWriter、ReadListener、AnalysisEventListener、Converter、ReadCellData、WriteCellData、WriteSheet、FillConfig、FillWrapper、模板填充、Excel 导入导出、下拉框、合并单元格、大数值精度、ExcelDataConvertException，或需要根据本地 Maven sources jar 确认 API 与行为，都必须使用此技能。此技能只记录通用 FastExcel 能力，不写入某个业务项目的专属规范。
辅助开发、选择模块、调试和解释 Hutool Java 工具库。只要用户提到 Hutool、cn.hutool、hutool-all、hutool-core、StrUtil、ObjectUtil、Convert、BeanUtil、DateUtil、FileUtil、IoUtil、CollUtil、MapUtil、ReflectUtil、ReUtil、IdUtil、NumberUtil、JSONUtil、HttpRequest/HttpUtil、SecureUtil、JWTUtil、ExcelUtil、Setting、CacheUtil、CronUtil、CaptchaUtil，或需要根据 /Users/chengliang/code-repositories/hutool 源码确认 API、模块依赖、空值行为、编码/日期/Bean/JSON/HTTP/加密/Excel 用法，都必须使用此技能。此技能只记录通用 Hutool 能力，不写入某个业务项目的专属规范。
Use when working with JustAuth, social login, OAuth callback handling, provider-specific authorization flow, AuthRequest/AuthCallback/AuthResponse/AuthUser, state validation, redirectUri mismatches, provider switching, scope differences, or third-party login debugging in Java projects.
辅助开发、配置、调试和解释 Sa-Token 权限认证框架。只要用户提到 Sa-Token、cn.dev33、StpUtil、StpLogic、SaManager、SaTokenConfig、StpInterface、SaTokenDao、@SaCheckLogin/@SaCheckPermission/@SaIgnore、SaRouter、SaInterceptor、SaServletFilter、SaTokenFilter、登录认证、权限/角色认证、踢人下线、会话、Token、前后端分离、Redis 持久化、多账号体系、SSO、OAuth2、API Key、JWT、接口签名、Solon/Spring Boot/WebFlux 集成或需要根据 /Users/chengliang/code-repositories/sa-token 源码确认 API 与机制，都必须使用此技能。此技能只记录通用 Sa-Token 能力，不写入某个业务项目的专属规范。
| name | x-file-storage |
| description | Use when working with x-file-storage, FileStorageService, FileInfo, UploadPretreatment, FileRecorder, storage platform selection, file upload/delete flows, thumbnail generation, Solon file upload integration, or debugging path/platform/file-record issues in Java projects. |
你在辅助 x-file-storage（org.dromara.x-file-storage）相关开发、上传/删除、文件记录、平台配置、预处理和问题排查。本技能基于本地 Maven sources jar 与真实项目用法整理；若目标项目版本不同，先以目标项目版本为准。
本地源码来源：~/.m2/repository/org/dromara/x-file-storage/
FileStorageService、UploadPretreatment、FileInfo、回调和平台类行为，必须查本地 sources jar。UploadedFile 这类外部流通常由框架或调用方管理，不要在示例里随手关闭。按任务读取对应 reference，必要时再读源码：
references/source-map.mdreferences/upload-delete-platform.mdreferences/pretreatment-recorder-callback.mdreferences/solon-security.mdUploadedFile、File、byte[]、InputStream、URL、URI、String。fileStorageService.of(...) 创建预处理对象，按需设置原始文件名、路径、平台、对象信息和属性。upload()，拿到 FileInfo。FileInfo、url、path、平台文件名或业务关联信息。StoragePlatform、FileRecorder、切面和配置类。# 解压 sources jar
rm -rf /tmp/x-file-storage-2.3.0-core-src /tmp/x-file-storage-2.3.0-solon-src
mkdir -p /tmp/x-file-storage-2.3.0-core-src /tmp/x-file-storage-2.3.0-solon-src
unzip -q ~/.m2/repository/org/dromara/x-file-storage/x-file-storage-core/2.3.0/x-file-storage-core-2.3.0-sources.jar -d /tmp/x-file-storage-2.3.0-core-src
unzip -q ~/.m2/repository/org/dromara/x-file-storage/x-file-storage-solon/2.3.0/x-file-storage-solon-2.3.0-sources.jar -d /tmp/x-file-storage-2.3.0-solon-src
# 核心 API
grep -R "class FileStorageService\|class FileInfo\|class UploadPretreatment\|interface FileRecorder\|class FileStorageProperties" /tmp/x-file-storage-2.3.0-core-src /tmp/x-file-storage-2.3.0-solon-src
path:line。