配置文件参考

此页解释常用配置结构，而不是要求手动填写所有字段。优先使用应用表单或 CLI 生成配置；修改文件前退出应用并备份。

数据分区

顶层字段	用途
picBed	当前上传器、当前配置、第二图床与代理
uploader	各上传器的 configList 与 defaultId
buildIn	压缩、水印、命名与独立处理
settings	桌面偏好、HTTP 服务、同步与第二图床开关
picgoPlugins	插件启用状态

字段区分大小写：JSON 为 buildIn；CLI 配置模块为 buildin。WebDAV 使用 webpath，部分其他图床使用 webPath，请按对应上传器字段填写。

最小本地图床示例

下面是有效 JSON；路径只是示例，在自己的机器上替换后使用。

{
  "picBed": {
    "uploader": "local",
    "current": "local",
    "local": {
      "path": "/absolute/path/images"
    }
  },
  "buildIn": {
    "rename": {
      "enable": true,
      "format": "{Y}{m}{d}-{ulid}"
    }
  }
}

命名配置

uploader.<id>.configList 保存该图床所有配置，defaultId 指向默认配置的 _id。每套配置包含 _configName 及创建、更新时间等元数据。

界面或 config use 会维护选中配置。不要只修改 picBed.uploader，却保留另一套不匹配的配置。

图片处理示例

{
  "buildIn": {
    "compress": {
      "quality": 80,
      "isConvert": true,
      "convertFormat": "webp",
      "isReSize": true,
      "reSizeWidth": 1600,
      "reSizeHeight": 0,
      "skipReSizeOfSmallImg": true,
      "isRemoveExif": true,
      "qualityMap": {
        "github": 90
      }
    }
  }
}

这些只是处理设置，不含图床连接信息。qualityMap 等 Map 是按图床 ID 索引的对象，不是数组。buildIn.list 保存按配置 _id 的独立处理项；具体优先级见图片处理。

HTTP 与第二图床

字段路径	含义
settings.server.enable / host / port	桌面上传 API
settings.serverKey	远程上传密钥
settings.enableSecondUploader	启用第二图床
settings.secondPicBedMode	桌面版 backup / separate；Core shared / separate
picBed.secondUploader	第二图床 ID
picBed.secondUploaderConfig	第二图床命名配置

上传器连接字段见存储服务。完整开发类型见 Core 类型定义，桌面专属字段以桌面实现为准。

安全分享配置

分享结构时，将 Token、密钥、密码、私钥、同步凭据与含签名的链接替换为明显占位符。不要把自己的完整配置粘贴到公共问题反馈中。