配置说明

从哪里改配置

Koishi 版提供三个入口，改的是同一份配置：

1. /kkk —— 插件自带的一体化配置面板，默认免登录，保存即写回 koishi.yml 并热重载；
2. Koishi 控制台左侧边栏的 「kkk 配置」 —— 打开的就是上面那个页面；
3. 控制台 → 插件配置 → kkk —— 表单形式，和上面共用同一份字段定义。

配置分区一览

控制台表单里分成三组：

upstream 里就是 Karin 版 config.json 的那套结构：

改完什么时候生效

在 /kkk 面板或控制台表单里保存 会写回 koishi.yml 并热重载插件，一般不用手动重启。

下面这几类改动依赖插件重新初始化，保存后如果发现“不生效”，在控制台重启一下插件即可：

• 默认解析 / 自定义优先级（videoTool / priority）
• API 服务相关（APIServer / APIServerPort）
• 谁可以触发扫码登录（loginPerm）
• 推送开关（push.switch）与推送权限（push.permission）

最常用的几组配置

1. 通用行为

• 默认解析（videoTool）：是否让插件直接以最高优先级识别链接
• 渲染图片的主题色（Theme）：自动 / 浅色 / 深色
• 分页渲染（multiPageRender）：长图内容很多时建议保持开启
• Live Photo 处理和发送方式（livePhotoMode）：只发视频、只发实况图，或两者都发
• Live Photo 静态图兼容系统（livePhotoSystem）：当前默认推荐 OPPO 兼容模式

2. 抖音 / B站解析

• 解析时发送的内容（sendContent）：决定返回视频信息、评论列表还是视频文件
• 评论解析数量（numcomment）：控制评论图长度
• 画质偏好（videoQuality）：高画质更清晰，但更依赖登录态和发送能力
• 视频信息返回形式（videoInfoMode）：图片模式更直观，文本模式更轻量
• 弹幕烧录（burnDanmaku）：会显著增加耗时，建议按需开启

抖音额外还有：

• 次级评论解析数量（subCommentLimit）
• 合辑 Live 图 BGM 合并方式（liveImageMergeMode）
• 推送图二维码的类型（push.shareType）

B站额外还有：

• 解析图文动态时的页面布局方式（imageLayout）
• 视频信息前返回的内容（displayContent）
• 解析视频动态时的画质偏好（push.pushVideoQuality）
• 视频动态的视频体积上限（push.pushMaxAutoVideoSize）

3. QQ 适配器

• 解析面板（qqPanel）：解析前先发一条带按钮的面板，让用户自己挑解析内容和画质
• 自动撤回（recallPanel）：点完按钮后撤回上一条面板，群里不会堆着一排旧面板
• 画质档体积上限（qqFileLimitMB）：默认 200，超过该体积的画质档不显示（QQ 单个视频上限 200MB，点了也发不出去）
• 番剧选集表格（bangumiPanelCols / bangumiPanelRows）：默认 5×4，一页 20 集
• 超大图自动切片（sliceImageOnDemand）：长图默认按普通图片发，超过 20MB 或发送失败时才切成一串再拼回一整张； 每片高度由 sliceImageHeight 决定（默认 2000px）
• 卡片识别密钥（ocrApiKey）：群里转发的分享卡片没有链接，插件要识别封面文字才能定位作品，留空会用公共测试密钥，容易被限流

4. 上传与下载

• 本地视频发送方式（videoSendMode）： File 协议（本地文件） 适合协议端与 Koishi 在同一机器 Base64（编码传输） 适合跨机器，但会增加流量
• 群文件上传（usegroupfile）：适合超大视频
• 压缩视频（compress）：适合发送受限环境，但会明显吃 CPU
• 下载限速（downloadThrottle）：适合经常遇到 ECONNRESET 的网络环境

5. 推送

推送真正由两部分组成：

1. 平台页里的推送设置
2. 推送列表（pushlist）里的具体订阅目标

平时推荐直接在群里用命令维护订阅：

设置抖音推送 抖音号
设置B站推送 UID

只有在批量迁移、修复群号或机器人 ID 时，才建议回头手动改配置。

手动配置只作为兜底

如果你只是日常使用，基本不需要碰配置文件。除非你正在做迁移、备份恢复或批量修订，否则直接用配置面板就够了。

配置以 koishi.yml 为准，启动时同步进数据目录下的 <dataPath>/koishi-plugin-kkk/config/config.json（默认 data/koishi-plugin-kkk/config/config.json）。