koishi-plugin-image-selecter

功能特性

🎲 随机发图

• 根据文件夹别名随机发送图片或视频
• 支持多别名系统（用 - 分割）
• 支持别名重名时随机选择文件夹
• 自动识别图片和视频格式

📁 用户存图

• 支持多种存图方式：直接传图、回复消息、交互式输入
• 自定义文件名模板
• 支持多种图片和视频格式
• 基于 MIME 类型的智能文件扩展名检测

🔧 高度可配置

• 自定义存图指令名称
• 灵活的文件名模板系统
• 可配置的超时时间
• 调试模式支持

文件名模板变量

文件名模板支持以下变量：

| 变量 | 说明 | 示例 | |------|------|------| | ${userId} | 用户ID（QQ号） | 123456789 | | ${username} | 用户名 | 张三 | | ${timestamp} | 时间戳 | 1640995200001 | | ${date} | 日期（YYYY-MM-DD） | 2024-01-01 | | ${time} | 时间（HH-MM-SS） | 14-30-25 | | ${index} | 文件序号（从1开始） | 1, 2, 3 | | ${ext} | 文件扩展名 | .jpg, .png, .mp4 | | ${guildId} | 群组ID | 987654321 | | ${channelId} | 频道ID | 111222333 |

文件名模板示例

${userId}-${timestamp}-${index}${ext}
→ 123456789-1640995200001-1.jpg

${nickname}_${date}_${time}${ext}
→ 张三_2024-01-01_14-30-25.png

${guildId}_${userId}_${index}${ext}
→ 987654321_123456789_1.gif

文件结构

推荐的目录结构

项目根目录/
├── images/                    # 图片库目录（imagePath 配置）
│   ├── 角色1-别名1-别名2/      # 文件夹名用 - 分割别名
│   │   ├── image1.jpg
│   │   ├── image2.png
│   │   └── video1.mp4
│   ├── 角色2-萌妹-可爱/
│   │   ├── cute1.gif
│   │   └── cute2.webp
│   ├── 风景-自然-山水/
│   │   ├── nature1.jpg
│   │   └── nature2.png
│   └── 动物-猫咪-喵星人/
│       ├── cat1.jpg
│       ├── cat2.gif
│       └── cat_video.mp4
└── temp/                      # 临时存储目录（tempPath 配置）
    ├── 123456789-1640995200001-1.jpg
    ├── 123456789-1640995200002-2.png
    └── 987654321-1640995200003-1.mp4

别名系统说明

文件夹名称使用 - 分割多个别名，用户输入任意一个别名都能匹配到该文件夹：

文件夹名: 角色1-别名1-别名2
用户输入: 角色1  ✅ 匹配
用户输入: 别名1  ✅ 匹配  
用户输入: 别名2  ✅ 匹配
用户输入: 其他   ❌ 不匹配

别名重名处理

当多个文件夹包含相同别名时，系统会：

1. 收集所有匹配的文件夹
2. 随机选择其中一个文件夹
3. 从选定文件夹中随机选择文件
4. 输出警告日志提醒管理员

文件夹:
├── 敌意-你好-你好啊/
└── 敌意-第一-帝一/

用户输入: 敌意
→ 系统随机选择其中一个文件夹
→ 输出警告: "检测到别名重名: 输入'敌意'匹配到2个文件夹"

使用方法

存图功能

1. 直接传图

存图 [图片1] [图片2] [图片3]

2. 回复消息存图

用户A: [发送图片]
用户B: 存图  # 回复用户A的消息

3. 交互式存图

用户: 存图
机器人: 请发送图片或视频
用户: [发送图片]
机器人: 已保存 1 个文件到临时文件夹

发图功能

直接发送别名即可触发随机发图：

用户: 角色1
机器人: [发送随机图片]

用户: 萌妹
机器人: [发送随机图片]

用户: 猫咪
机器人: [发送随机图片或视频]

支持的文件格式

图片格式

• JPEG/JPG
• PNG
• GIF
• WebP
• BMP
• TIFF

视频格式

• MP4
• MOV
• AVI

调试模式

启用 debugMode 后，插件会输出详细的调试信息：

[INFO] 收到消息: { userId: '123456789', content: '角色1' }
[INFO] 匹配到的文件夹: ['角色1-别名1-别名2']
[INFO] 随机选择文件夹: 角色1-别名1-别名2
[INFO] 找到媒体文件数量: 5
[INFO] 随机选择文件: image1.jpg
[WARN] 检测到别名重名: 输入"敌意"匹配到2个文件夹: 敌意-你好-你好啊, 敌意-第一-帝一

注意事项

1. 文件夹命名：使用 - 分割别名，避免使用特殊字符
2. 路径配置：确保 imagePath 和 tempPath 目录存在且有读写权限
3. 别名重名：注意查看警告日志，及时调整重名的别名
4. 文件格式：确保图片和视频文件格式正确
5. 存储空间：定期清理临时文件夹，避免占用过多存储空间

许可证

MIT License