koishi-plugin-image-save-path 使用说明 📦

1️⃣ 交互保存（默认路径，无需指定路径）

将 Interaction_mode 配置项选择到 3。

保存图片 图片名称

行为说明：

• 插件会自动保存图片到默认路径，并以指定的图片名称保存。
• 如果未设置默认路径，插件会提示错误：没有设置默认保存路径。

2️⃣ 交互保存（指定路径）

将 Interaction_mode 配置项选择到 1。

保存图片 图片名称 表情包

行为说明：

• 插件会检查 savePaths 中是否存在路径备注为 表情包 的配置。
• 如果匹配成功，图片将保存到对应路径。
• 如果匹配失败，插件会提示用户重新输入路径备注。

3️⃣ 回复交互保存

回复一条图片消息，并发送：保存图片 图片名称

行为说明：

• 插件会提取回复消息中的图片，并保存为指定文件名。
• 默认保存到第一个路径或用户指定路径。

4️⃣ 批量保存图片

保存图片 批量保存 -e png

行为说明：

• 插件会自动处理多张图片，避免文件重名冲突。
• 若未启用 checkDuplicate，仅允许保存一张图片。

5️⃣ 中间件监听保存

{
"groupListmapping": 
    [    
        {
        "groupList": "123456",
        "enable": true,
        "defaultsavepath": "E:\\Images\\GroupChat",
        "count": 3
        }
    ]
}

行为说明：

• 自动保存指定群聊/频道中的图片消息。
• 支持自定义保存路径与触发条件。

🔧 高级功能

1️⃣ 图片自动命名

插件会根据当前时间生成安全的文件名：

YYYY-MM-DD-HH-MM.png

2️⃣ 重名检查

当启用 checkDuplicate 时，插件会自动为重名文件生成唯一文件名：

图片名称(1).png
图片名称(2).png

3️⃣ 自定义路径映射

{
    "savePaths": [
        { "name": "默认路径", "path": "E:\\Images\\Default" },
        { "name": "表情包", "path": "E:\\Images\\Memes" }
    ]
}

4️⃣ 配合中间件监听群聊/频道

实时保存符合条件的图片消息到指定路径。

⚙️ 配置项说明

Interaction_mode

选择交互模式，支持五种模式：

其他配置项

defaultImageExtension

说明：图片保存的默认后缀格式，例如 png 或 jpg。

默认值： png

savePaths

说明：配置路径映射，便于用户选择存储路径。

{
    "savePaths": [
        { "name": "默认路径", "path": "E:\\Images\\Default" },
        { "name": "表情包", "path": "E:\\Images\\Memes" }
    ]
}

checkDuplicate

说明：启用时，会为重名文件生成唯一名称。

默认值： false