1.4.3 • Published 6 months ago

koishi-plugin-image-save-path v1.4.3

Weekly downloads
-
License
MIT
Repository
-
Last release
6 months ago

图片保存配置项

1. 图片扩展名配置 (ImageExtension)

功能描述

ImageExtension 是一个用于定义图片保存时文件名前缀、后缀和默认扩展名的配置项。支持动态替换日期、随机数字以及 sessionconfig 中的字段。

配置项格式

  • 类型:数组(仅第一行视为有效配置)
  • 默认值
    [
      {
        prefix: "",
        suffix: "",
        extension: ".png"
      }
    ]
  • 示例

    ImageExtension: [
      {
        prefix: "prefix_${YYYY}_",
        suffix: "_${session.userId}",
        extension: ".jpg"
      }
    ]

可用占位符

占位符描述
${YYYY}当前年份,例如 2023
${MM}当前月份,补零到两位,例如 0112
${DD}当前日期,补零到两位,例如 0131
${A}一位随机数字,范围 09
${BB}两位随机数字,范围 0099
${CCC}三位随机数字,范围 000999
${session}动态提取 session 对象的字段,例如 ${session.userId}
${config}动态提取 config 对象的字段,例如 ${config.defaultImageExtension}

示例

  • 默认格式

    ImageExtension: [
      {
        prefix: "",
        suffix: "",
        extension: ".png"
      }
    ]
    • 生成文件名:2023-10-05-12-34-56-789.png
  • 包含前缀和后缀

    ImageExtension: [
      {
        prefix: "prefix_${YYYY}_",
        suffix: "_${session.userId}",
        extension: ".jpg"
      }
    ]
    • 生成文件名(假设 session.userId12345):prefix_2023_2023-10-05-12-34-56-789_12345.jpg
  • 包含配置项

    ImageExtension: [
      {
        prefix: "prefix_${config.ImageExtension[0]?.extension}_",
        suffix: "_${CCC}",
        extension: ".png"
      }
    ]
    • 生成文件名(假设 config.defaultImageExtensionpng):prefix_png_2023-10-05-12-34-56-789_123.png

2. 图片自动重命名规则 (autoRenameRules)

功能描述

autoRenameRules 是一个用于定义图片自动重命名规则的配置项。通过设置占位符,用户可以自定义生成的文件名格式。支持动态替换日期、随机数字以及 sessionconfig 中的字段。

配置项格式

  • 类型:字符串
  • 默认值${YYYY}-${MM}-${DD}-${BB}-${BB}-${BB}-${CCC}
  • 示例

    autoRenameRules: "${YYYY}-${MM}-${DD}-${BB}-${BB}-${BB}-${CCC}-${session.userId}"

可用占位符

占位符描述
${YYYY}当前年份,例如 2023
${MM}当前月份,补零到两位,例如 0112
${DD}当前日期,补零到两位,例如 0131
${A}一位随机数字,范围 09
${BB}两位随机数字,范围 0099
${CCC}三位随机数字,范围 000999
${session}动态提取 session 对象的字段,例如 ${session.userId}
${config}动态提取 config 对象的字段,例如 ${config.defaultImageExtension}

示例

  • 默认格式

    autoRenameRules: "${YYYY}-${MM}-${DD}-${BB}-${BB}-${BB}-${CCC}"
    • 生成文件名:2023-10-05-12-34-56-789.png
  • 包含用户 ID

    autoRenameRules: "${YYYY}-${MM}-${DD}-${BB}-${BB}-${BB}-${CCC}-${session.userId}"
    • 生成文件名(假设 session.userId12345):2023-10-05-12-34-56-789-12345.png
  • 包含配置项

    autoRenameRules: "${YYYY}-${MM}-${DD}-${BB}-${BB}-${BB}-${CCC}-${config.defaultImageExtension}"
    • 生成文件名(假设 config.defaultImageExtensionpng):2023-10-05-12-34-56-789-png.png

1.2.0

9 months ago

1.0.2

9 months ago

1.0.1

9 months ago

1.0.0

9 months ago

1.4.3

6 months ago

1.4.2

7 months ago

1.2.4

9 months ago

1.4.1

7 months ago

1.2.3

9 months ago

1.0.5

9 months ago

1.4.0

7 months ago

1.2.2

9 months ago

1.0.4

9 months ago

1.2.1

9 months ago

1.0.3

9 months ago

0.3.8

10 months ago

1.1.0

9 months ago

1.3.7

7 months ago

1.3.6

7 months ago

1.3.3

8 months ago

1.3.2

8 months ago

1.3.1

8 months ago

1.1.3

9 months ago

1.3.0

8 months ago

1.1.2

9 months ago

0.3.0

1 year ago

0.3.6

1 year ago

0.3.5

1 year ago

0.3.7

1 year ago

0.3.2

1 year ago

0.3.1

1 year ago

0.3.4

1 year ago

0.3.3

1 year ago

0.2.3

1 year ago

0.2.1

1 year ago

0.2.0

1 year ago

0.2.2

1 year ago

0.1.2

1 year ago

0.1.1

1 year ago

0.1.4

1 year ago

0.1.3

1 year ago

0.1.0

1 year ago

0.0.8

1 year ago

0.0.7

2 years ago

0.0.6

2 years ago

0.0.5

2 years ago

0.0.4

2 years ago

0.0.3

2 years ago

0.0.2

2 years ago

0.0.1

2 years ago