使用指南
详细的功能说明与命令使用指南
解析功能
插件当前支持两类入口：自动命中分享链接，以及引用消息手动解析。
自动解析
默认情况下，插件会监听消息内容。只要平台开关开启，命中支持的链接、短链、BV 号、AV 号或 App 分享文本时，就会自动触发解析。
- 支持平台：抖音、B站、快手、小红书
- 抖音支持
douyin.com/iesdouyin.com - B站支持站内链接、
b23.tv、BV...、av... - 快手支持链接和分享口令文本
- 小红书支持
xiaohongshu.com/xhslink.com/xhslink.cn
autoParse）」，插件就只会响应明确的解析命令。手动解析
如果自动解析关闭了，或者你想处理历史消息，引用目标消息后发送：
解析
kkk解析弹幕解析 也属于引用解析命令，但它只对抖音 / B站生效，并会强制进入弹幕烧录流程。QQ 上的交互面板
在 QQ 平台，解析前会先回一条 Markdown 面板：
- 面板里列出各档画质和体积，体积超过上限的档位不显示；
- 点选画质后才真正开始下载：撤回上一条面板 →
收到请求，开始下载+ 「查询下载进度」按钮 →发送中…→ 视频； - 全过程只保留最新一条机器人消息，旧面板会被自动撤回。
番剧则先出分集表格（默认 5×4、倒序），表格下方是「上一页 / 第 x/y 页 / 下一页」。
面板按钮都是无状态的，机器人重启后点旧面板照样能用。相关开关都在配置里的「QQ 适配器」分组。
图片发送（QQ）
评论区长图默认按普通图片发送；只有超过 20MB 或**发送失败（拿不到消息 ID / 返回错误码）**时才自动切片：
先缩到 1440px 宽，再按 sliceImageHeight（默认 2000px）等分，最后用一条 markdown 把切片拼回一整张。
图集则相反：多张图合并成一条 markdown 发送，实况视频跟在后面单独发。其它平台一律按普通图片发送。
常用命令
Koishi 的指令前缀按你的配置来，默认直接写命令名即可（下面的写法不含前缀）。
| 命令 | 作用 |
|---|---|
kkk帮助 | 查看帮助菜单 |
kkk版本 / kkk更新日志 | 查看运行环境诊断卡片 / 本地更新日志 |
kkk解析统计 | 查看当前群解析统计 |
kkk全局解析统计 | 查看全局解析统计，仅主人可用 |
抖音登录 / B站登录 | 获取对应平台的 Cookie（含扫码登录） |
卡片消息 | 解析群里转发的分享卡片 |
动态推送
订阅与取消
设置抖音推送 抖音号
设置B站推送 UID- 抖音使用抖音号，不是昵称
- B站使用数字 UID
- 两条命令都是切换式：已订阅则取消，未订阅则新增
- 实际权限由“谁可以设置推送（
push.permission）”控制
推送列表
抖音推送列表
B站推送列表强制推送与维护
抖音强制推送
B站强制推送
抖音全部强制推送
B站全部强制推送
kkk设置推送机器人 BotID
测试抖音推送 https://...强制推送只处理当前群全部强制推送会模拟一次全局定时任务kkk设置推送机器人用于批量改绑定的机器人账号测试抖音推送适合调试推送图样式和链接二维码
扫码登录与权限
为了拿到更高画质、推送能力和更稳定的接口权限，建议尽早配置 Cookie。
抖音登录
B站登录loginPerm）”，修改后通常需要重新加载插件。统计与排障
kkk解析统计
kkk全局解析统计统计功能会按群、按平台记录解析次数，也会统计活跃用户和全局趋势。
kkk解析统计（群内可用）会给出这个群的平台分布、近 30 天趋势、活跃用户排行、活跃时段和内容形态；kkk全局解析统计（仅主人）在此之上还有分平台趋势、群组排行、群规模分布、群组增长和用户活跃度。
趋势、活跃时段、内容形态这几项是从新增这些统计维度之后才开始按天/按小时记录的，刚升级完的一段时间里图上会是空的或只有最近几天，属于正常现象。
如果你遇到异常，建议再结合下面几个页面一起看：