koishi-plugin-kkk 3.2.2 → 3.3.0-beta.2

package/scripts/smoke-panel-tabs.cjs

@@ -0,0 +1,58 @@
+/**
+ * 面板（/kkk）分类冒烟测试。
+ *
+ * 覆盖两件事：
+ *   1. 「Koishi 设置」这一组分类确实注入进了面板前端包（分类入口 / 分发 case / 4 个字段路径），
+ *      并且**没有 masters**（主人账号属于 Koishi 权限体系，面板是免登录页面，不给它开口子）；
+ *   2. 服务端（src/webui.ts）的白名单与面板字段一一对应 —— 前端能改的，服务端就认这几个；
+ *      前端塞别的东西进来，服务端会丢掉。
+ *
+ * 用法：node scripts/smoke-panel-tabs.cjs
+ */
+const fs = require('node:fs')
+const path = require('node:path')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const webAssets = path.join(pluginRoot, 'assets', 'web', 'assets')
+const BT = String.fromCharCode(96)
+
+const results = []
+const check = (name, ok, detail) => {
+  results.push({ name, ok })
+  console.log((ok ? '  ✅ ' : '  ❌ ') + name + (detail ? '  —— ' + detail : ''))
+}
+
+const bundle = fs.readdirSync(webAssets).filter((name) => /^index-.*[.]js$/.test(name))
+  .map((name) => path.join(webAssets, name))
+  .sort((a, b) => fs.statSync(b).size - fs.statSync(a).size)[0]
+const text = fs.readFileSync(bundle, 'utf8')
+const count = (needle) => text.split(needle).length - 1
+
+console.log('\n[1] 面板里多了「Koishi 设置」分类（' + path.basename(bundle) + '）')
+check('分类入口存在且只有一个', count('{key:' + BT + 'koishi' + BT) === 1, '× ' + count('{key:' + BT + 'koishi' + BT))
+check('分发 case 存在且只有一个', count('case' + BT + 'koishi' + BT) === 1, '× ' + count('case' + BT + 'koishi' + BT))
+check('组件定义存在', count('KKKNativeConfig=') === 1)
+
+console.log('\n[2] 这一组里是 4 个字段，且没有 masters')
+for (const key of ['dataPath', 'debug', 'autoParse', 'webUiAuth']) {
+  const needle = BT + 'koishi' + BT + ',' + BT + key + BT
+  check('字段路径 ' + key, count(needle) === 1, '× ' + count(needle))
+}
+check('没有 masters（面板不给主人账号开口子）', count(BT + 'koishi' + BT + ',' + BT + 'masters' + BT) === 0)
+
+console.log('\n[3] 没有把 undefined 塞进 JSX children（拼串时容易多一个逗号）')
+check('不存在 children:[, 这种空位', count('children:[,') === 0)
+
+console.log('\n[4] 服务端白名单与面板字段一一对应')
+const webui = fs.readFileSync(path.join(pluginRoot, 'src', 'webui.ts'), 'utf8')
+const match = webui.match(/const NATIVE_PANEL_KEYS = \[([^\]]*)\]/)
+const keys = match ? match[1].split(',').map((item) => item.trim().replace(/['"]/g, '')).filter(Boolean) : []
+check('找到 NATIVE_PANEL_KEYS', keys.length > 0, keys.join(', '))
+check('白名单正好是面板那 4 个字段', JSON.stringify(keys) === JSON.stringify(['dataPath', 'debug', 'autoParse', 'webUiAuth']), JSON.stringify(keys))
+check('白名单里没有 masters', !keys.includes('masters'))
+check('GET 会把这一组返回给面板', /koishi: readNativePanelOptions\(config\)/.test(webui))
+check('POST 会把这一组写回插件配置顶层', /const \{ qq, koishi: nativeGroup, \.\.\.upstream \} = normalizeLists\(body\)/.test(webui))
+
+const failed = results.filter((item) => !item.ok)
+console.log('\n=== ' + (results.length - failed.length) + '/' + results.length + ' 通过 ===')
+process.exitCode = failed.length ? 1 : 0

package/src/compat/node-karin.ts

@@ -14,6 +14,9 @@ import path from 'node:path'
 import { h } from 'koishi'
 import type { Bot, Context, Session } from 'koishi'
 
+// 版本比较复用注入器那边的实现（它处理了 -beta.1 这类预发布号的先后）
+import { isSemverGreater } from '../karin/module/utils/semver'
+
 import { logger } from './logger'
 import { COLLECTED_MESSAGE_ID, collectForward } from './forward-collect'
 import { UnconfirmedSendError, classifySendFailure, describeSendFailure, isPassiveLimitFailure } from './sendError'
@@ -963,9 +966,18 @@ export const checkPkgUpdate = async (name: string, _options?: { compare?: string
     const response = await fetch('https://registry.npmmirror.com/' + name, { signal: AbortSignal.timeout(10000) })
     if (!response.ok) return { status: 'error' as const, error: new Error('HTTP ' + response.status) }
     const meta: any = await response.json()
-    const remote = meta?.['dist-tags']?.latest
+    const tags: Record<string, string> = meta?.['dist-tags'] ?? {}
+    /**
+     * 预览版（3.3.0-beta.1 这种）**不能拿 latest 比**：本地跑 beta 时 latest 还在 3.2.2，
+     * 按老逻辑会报「有新版本 3.2.2」—— 那其实是**降级**。
+     * 所以带 - 的本地版本改看 beta 通道；beta 没有（说明预览已经并进正式版）才回退到 latest，
+     * 并且只在远端确实比本地新时才说「有更新」。
+     */
+    const isPreview = local.includes('-')
+    const remote = (isPreview ? (tags.beta || tags.latest) : tags.latest) || ''
     if (!remote) return { status: 'error' as const, error: new Error('响应缺少 dist-tags.latest') }
     if (remote === local) return { status: 'no' as const, local }
+    if (isPreview && !isSemverGreater(remote, local)) return { status: 'no' as const, local }
     return { status: 'yes' as const, local, remote }
   } catch (error) {
     return { status: 'error' as const, error: error as Error }

package/src/index.ts

@@ -129,13 +129,32 @@ export interface Config {
 /** 摊平后由「Koishi 原生设置」分组提供的字段 */
 const NATIVE_KEYS = ['masters', 'dataPath', 'debug', 'autoParse', 'webUiAuth']
 
+/**
+ * 控制台里**唯一可见**的一段文字：把用户指到 WebUI 面板去。
+ *
+ * 为什么把设置全藏了：同一份配置在控制台改一半、在面板改一半，两边都会把整份配置写回
+ * koishi.yml，很容易互相覆盖（用户实际遇到过「面板里关了、控制台一保存又回来了」）。
+ * 现在控制台不再提供编辑入口，只留这块说明。
+ *
+ * 注意：**隐藏不等于删除** —— 字段仍然在 schema 里声明着，所以在控制台里点保存
+ * 一样会把已有值带上，面板里的设置不会被清空。
+ */
+const WEBUI_GUIDE = [
+  '**所有设置都在 WebUI 配置面板里改**，地址：/kkk（打开 Koishi 控制台后，左侧边栏也有一个「**kkk 配置**」入口）。',
+  '',
+  '面板里包含：接口库 / 通用（含**错误上报**、在线播放器、合并转发）/ 抖音 / 哔哩哔哩 / 快手 / 小红书 / **QQ 适配器** / 推送列表。' +
+  '改完点右下角保存即可 —— 会写回 koishi.yml 并热重载，**不用重启**。',
+  '',
+  '**Koishi 控制台里的设置项已经全部隐藏**（值仍然保留，在这里点保存也不会把它们弄丢），免得两边各改一半、互相覆盖。',
+  '',
+  '面板里还有一组「**Koishi 设置**」（数据目录、调试日志、自动解析、面板是否要求先登录控制台）。' +
+  '只有 masters（主人账号）没有面板入口 —— 它属于 Koishi 的权限体系，而面板是免登录页面，' +
+  '需要直接改 koishi.yml 里本插件的配置段（改完重启 Koishi）。'
+].join('\n')
+
 export const Config: Schema<Config> = Schema.intersect([
   Schema.object({
-    webuiGuide: Schema.const('').description(
-      '**本插件的配置都在配置面板里改**：Koishi 控制台左侧边栏 →「**kkk 配置**」。\n\n' +
-      '（原版配置面板：接口库 / 通用 / 抖音 / 哔哩哔哩 / 快手 / 小红书 / **QQ 适配器** / 推送列表，' +
-      '改完点右下角保存即可，写回 koishi.yml 并热重载，不用重启。）'
-    ),
+    webuiGuide: Schema.const('').description(WEBUI_GUIDE),
     // 全部隐藏：控制台表单里不显示，配置统一在控制台侧边栏的「kkk 配置」面板里改
     qq: buildQqSchema(Schema).hidden().description('QQ 适配器（只对 QQ 平台生效）'),
     advanced: Schema.object({
@@ -145,7 +164,7 @@ export const Config: Schema<Config> = Schema.intersect([
     autoParse: Schema.boolean().default(true).description('群里有人发链接（或回复一条带链接的消息）就自动解析，不用打指令'),
     webUiAuth: Schema.boolean().default(true).description('配置面板 /kkk 是否要求先登录 Koishi 控制台（默认开）。装了 auth 插件的部署只有登录后才能打开面板；没装 auth 插件时本来就没有登录这一说，这里不生效'),
     }).collapse().hidden().description('Koishi 原生设置（一般不用改，已折叠）'),
-  }),
+  }).description('配置入口：请在 WebUI 面板（/kkk）里修改'),
   Schema.object({
     /**
      * 合并转发（两级开关）。
@@ -182,7 +201,7 @@ export const Config: Schema<Config> = Schema.intersect([
       xiaohongshu: Schema.boolean().default(false).description('小红书：单独打开合并转发（全局关着时生效）'),
       xiaohongshuContent: Schema.array(Schema.union(['text', 'image', 'video', 'file'])).default([])
         .description('小红书转发合并哪些内容（留空 = 用全局那份）')
-    }).description('合并转发（全局 + 各平台）'),
+    }).collapse().hidden().description('合并转发（全局 + 各平台）'),
     upstream: buildUpstreamSchema(pluginRootDir).hidden().description(
       '插件自身的配置（与 Karin 版 config.json 一致）。每项都带着上游默认值，枚举型字段是下拉框；' +
       '**与默认值不同**的项会在启动时写回 config.json，保持默认值的项不写（这样你直接改文件的内容不会被覆盖）'

package/src/karin/module/utils/CardParser.ts

@@ -18,7 +18,6 @@ import { createHash } from 'node:crypto'
 import { logger } from 'node-karin'
 
 import { tryGetRuntime } from '../../../compat/runtime'
-import { douyinFetcher } from './amagiClient'
 import { Config } from './Config'
 
 /** 卡片里挖出来的信息 */
@@ -417,55 +416,6 @@ export const searchBiliVideos = async (
   }
 }
 
-/* ------------------------------------------------------------------ *
- * 抖音搜索（直接用 amagi 的 search 端点）
- * ------------------------------------------------------------------ */
-
-export const searchDouyinWorks = async (
-  keyword: string,
-  limit = 8,
-  authors: string[] = []
-): Promise<Array<{ aweme_id: string; desc: string; author: string; score: number }>> => {
-  try {
-    // 这版接口库的抖音 fetcher 不一定有 search（实测 6.6.0 上没有），没有就干脆跳过
-    const fetcher: any = douyinFetcher as any
-    if (typeof fetcher?.search !== 'function') {
-      logger.debug('[卡片解析] 当前接口库没有抖音搜索能力，跳过')
-      return []
-    }
-    const res: any = await fetcher.search({ query: String(keyword ?? '').trim(), type: 'video', number: limit })
-    const list: any[] =
-      res?.data?.data?.aweme_list ?? res?.data?.aweme_list ?? res?.aweme_list ?? []
-    const titleKey = normalizeText(keyword)
-    const authorKeys = authors.map((item) => normalizeText(item)).filter((item) => item.length >= 2)
-    return list
-      .filter((item: any) => item?.aweme_id)
-      .map((item: any, index: number) => {
-        const desc = String(item.desc ?? '')
-        const sim = titleSimilarity(normalizeText(desc), titleKey)
-        // 作者对上一样加分：抖音搜索噪声大，光靠标题常常分不出是哪一条
-        const authorKey = normalizeText(String(item.author?.nickname ?? ''))
-        let authorScore = 0
-        for (const key of authorKeys) {
-          if (!authorKey) break
-          if (authorKey === key) { authorScore = 60; break }
-          if (authorKey.includes(key) || key.includes(authorKey)) authorScore = Math.max(authorScore, 35)
-        }
-        return {
-          aweme_id: String(item.aweme_id),
-          desc,
-          author: String(item.author?.nickname ?? ''),
-          score: Math.round(sim * 100) + authorScore - index
-        }
-      })
-      .sort((left, right) => right.score - left.score)
-      .slice(0, Math.max(1, Math.min(20, limit)))
-  } catch (error: any) {
-    logger.warn('[卡片解析] 抖音搜索异常: ' + String(error?.message ?? error))
-    return []
-  }
-}
-
 /* ------------------------------------------------------------------ *
  * 对外入口
  * ------------------------------------------------------------------ */
@@ -477,6 +427,7 @@ export const searchDouyinWorks = async (
  * 任何一步失败都返回 null（调用方据此走原来的「未找到链接」逻辑，不影响已有功能）。
  */
 export type CardCandidate = {
+  /** 卡片解析只可能落在 B站上（抖音没有卡片消息） */
   platform: 'bilibili' | 'douyin'
   id: string
   title: string
@@ -527,12 +478,7 @@ export const resolveCardToUrl = async (
     return null
   }
 
-  /** 卡片自带的 source 字段最准（实测 `source: 哔哩哔哩`），其次是 OCR 文本 */
-  const hint = String(card.source ?? '') + ' ' + card.title + ' ' + card.desc + ' ' + upName + ' ' + ocrText
-  const looksDouyin = /抖音|douyin|快手|ks\./i.test(hint)
-  const looksBili = /bilibili|哔哩|B站|UP主/i.test(hint)
-
-  // ③ 先按最可能的平台搜，命中就返回
+  // ③ B站搜一把：标题 + 作者都对上才自动继续，否则把候选交给用户挑
   const tryBili = async (): Promise<{ url?: string; candidates: CardCandidate[]; matchedAuthor?: string }> => {
     const hits = await searchBiliVideos(keyword, card.title, upNames, 8)
     const candidates = hits.slice(0, 6).map((item) => ({
@@ -547,30 +493,17 @@ export const resolveCardToUrl = async (
     }
     return { candidates }
   }
-  const tryDouyin = async (): Promise<{ url?: string; candidates: CardCandidate[] }> => {
-    const hits = await searchDouyinWorks(keyword || card.title, 8, upNames)
-    const candidates = hits.slice(0, 6).map((item) => ({
-      platform: 'douyin' as const, id: item.aweme_id, title: item.desc, author: item.author, score: item.score
-    }))
-    const best = hits[0]
-    // 抖音搜索噪声大，要求分数足够高才自动继续，否则交给用户挑
-    if (best && best.score > 40) return { url: 'https://www.douyin.com/video/' + best.aweme_id, candidates }
-    return { candidates }
-  }
-
-  const order = looksDouyin && !looksBili ? [tryDouyin, tryBili] : [tryBili, tryDouyin]
-  const candidates: CardCandidate[] = []
-  for (const attempt of order) {
-    const hit = await attempt()
-    if (hit) {
-      candidates.push(...hit.candidates)
-      if (hit.url) {
-        logger.mark('[卡片解析] 定位成功: ' + hit.url)
-        // 提示语里报「真正匹配上的那个 UP 名」，而不是卡片摘要里那个不准的
-        const matched = (hit as any).matchedAuthor || upName
-        return { url: hit.url, platform: hit.url.includes('bilibili') ? 'bilibili' : 'douyin', card, candidates, ocrText, upName: matched }
-      }
-    }
+  /**
+   * **只搜 B站**：抖音没有卡片消息这种玩法（那条「当前接口库没有抖音搜索能力」的日志就是
+   * 以前多此一举地搜抖音留下的）。卡片解析这条链路只处理 B站卡片（入口处已经按 source 过滤过），
+   * 少搜一个平台就少一次风控风险、也少几秒等待。
+   */
+  const hit = await tryBili()
+  const candidates: CardCandidate[] = hit.candidates
+  if (hit.url) {
+    logger.mark('[卡片解析] 定位成功: ' + hit.url)
+    // 提示语里报「真正匹配上的那个 UP 名」，而不是卡片摘要里那个不准的
+    return { url: hit.url, platform: 'bilibili', card, candidates, ocrText, upName: hit.matchedAuthor || upName }
   }
 
   logger.mark('[卡片解析] 没能唯一定位（标题: ' + card.title + '，UP: ' + upName + '），候选 ' + candidates.length + ' 条')

package/src/karin/module/utils/ErrorReport.ts

@@ -325,10 +325,16 @@ export const errorHelpSegments = (report: ErrorReportResult | null, platform: st
     ? '错误信息已上传，ID：' + report.id
     : '错误信息上传失败（不影响使用）'
   const ask = '可以前往 QQ 群内寻找帮助，在群内发送错误 ID 或该错误图片'
+  /**
+   * 两段之间必须**空一行**（\n\n）。
+   *
+   * markdown 里单个换行不算换行：两段会被拼成一整行，QQ 那边按一行显示时字号会被撑得很难看
+   * （用户原话「不换行大小会崩」）。纯文本那条也一样留空行，两种平台的观感才对得上。
+   */
   if (officialQq) {
     // QQ 官方机器人认 markdown：群号做成可点的加群链接
-    return [segment.markdown(head + '\n' + '可以前往 [QQ 群 ' + group + '](' + link + ') 内寻找帮助，在群内发送错误 ID 或该错误图片')]
+    return [segment.markdown(head + '\n\n' + '可以前往 [QQ 群 ' + group + '](' + link + ') 内寻找帮助，在群内发送错误 ID 或该错误图片')]
   }
   // 个人号（OneBot / NapCat）不渲染 markdown：裸链接 QQ 客户端自己会变蓝可点
-  return [segment.text(head + '\nQQ 群 ' + group + '：' + ask + '\n' + link)]
+  return [segment.text(head + '\n\nQQ 群 ' + group + '：' + ask + '\n' + link)]
 }

package/src/karin/platform/kuaishou/kuaishou.ts

@@ -7,6 +7,8 @@ import { ParseSteps, SendTasks } from '@/module/utils/ParseSteps'
 import { sendParseTip } from '@/module/utils/parseTip'
 import type { ParseWorkType } from '@/module/db'
 import { Config } from '@/module/utils/Config'
+// 注意用相对写法：@/ 别名在仓库里指向 karin/，@/player 会被解析成不存在的 karin/player
+import { applyForceOnlinePlayer } from '../../../player'
 import { kuaishouComments, type KuaishouDataResult, type KuaishouOneWorkPayload } from '@/platform/kuaishou'
 import type { ExtendedKuaishouOptionsType, KuaishouDataTypes } from '@/types'
 

package/src/karin/platform/xiaohongshu/xiaohongshu.ts

@@ -25,6 +25,8 @@ import {
   Render,
   uploadFile
 } from '@/module'
+// 注意用相对写法：@/ 别名在仓库里指向 karin/，@/player 会被解析成不存在的 karin/player
+import { applyForceOnlinePlayer } from '../../../player'
 import { ParseSteps, SendTasks } from '@/module/utils/ParseSteps'
 import type { ParseWorkType } from '@/module/db'
 import { Config } from '@/module/utils/Config'

package/src/webui.ts

@@ -30,6 +30,33 @@ import { QQ_KEYS, readQqOptions } from './qqOptions'
 const COOKIE_NAME = 'kkk_config_token'
 const TOKEN_TTL = 7 * 24 * 60 * 60 * 1000
 
+/**
+ * 面板「Koishi 设置」分类里能改的项 —— 也就是 Koishi 侧的原生选项（koishi.yml 里本插件的顶层键）。
+ *
+ * **masters 不在这里**：主人账号是 Koishi 的权限体系（谁能执行主人指令、谁收报错），
+ * 面板是免登录页面，不该给它开这个口子 —— 仍然只在 koishi.yml 里改。
+ * 控制台那边也已经全部隐藏，所以这 4 项是唯一还有图形入口的地方。
+ */
+const NATIVE_PANEL_KEYS = ['dataPath', 'debug', 'autoParse', 'webUiAuth'] as const
+type NativePanelKey = typeof NATIVE_PANEL_KEYS[number]
+
+/** 面板要显示的原生设置（只取白名单，缺的用默认值兜底） */
+const NATIVE_PANEL_DEFAULTS: Record<NativePanelKey, any> = {
+  dataPath: 'data',
+  debug: false,
+  autoParse: true,
+  webUiAuth: true
+}
+
+const readNativePanelOptions = (source: any): Record<string, any> => {
+  const out: Record<string, any> = {}
+  for (const key of NATIVE_PANEL_KEYS) {
+    const value = source?.[key]
+    out[key] = value === undefined || value === null ? NATIVE_PANEL_DEFAULTS[key] : value
+  }
+  return out
+}
+
 export interface WebUiDeps {
   ctx: Context
   config: any
@@ -345,7 +372,8 @@ export function registerWebUi ({ ctx, config, rawConfig, logger, pluginRoot }: W
     // 在 Koishi 这边它就存在 `upstream` 里，启动时同步进 config.json。
     // 另外附一份 `qq`（「QQ 适配器」分类）：面板/切片/番剧选集/卡片识别这些是 Koishi 侧才有的开关，
     // 面板里作为独立分类显示，保存时由下面的 POST 拆出来写回 koishi.yml。
-    ok(response, { ...(config?.upstream ?? {}), qq: readQqOptions(config) }, '')
+    // koishi 这一组是「Koishi 设置」分类：Koishi 侧的原生选项（masters 不在里面，见 NATIVE_PANEL_KEYS）
+    ok(response, { ...(config?.upstream ?? {}), qq: readQqOptions(config), koishi: readNativePanelOptions(config) }, '')
   })
 
   server.post('/kkk/v1/config', async (response: any) => {
@@ -357,10 +385,20 @@ export function registerWebUi ({ ctx, config, rawConfig, logger, pluginRoot }: W
       //   - `qq`（面板里的「QQ 适配器」分类）→ 写回插件自己的配置（koishi.yml）
       //   - 其余整份 → upstream（Karin 版的 config.json 形状）
       // 保存都走 scope.update → 落盘 koishi.yml → 热重载 → 启动时同步回 config.json
-      const { qq, ...upstream } = normalizeLists(body)
+      const { qq, koishi: nativeGroup, ...upstream } = normalizeLists(body)
+      // 「Koishi 设置」分类：只认白名单里的键（前端传什么都写不进来别的东西）
+      const native: Record<string, any> = {}
+      if (nativeGroup && typeof nativeGroup === 'object') {
+        for (const key of NATIVE_PANEL_KEYS) {
+          if (nativeGroup[key] === undefined) continue
+          native[key] = typeof NATIVE_PANEL_DEFAULTS[key] === 'boolean' ? !!nativeGroup[key] : String(nativeGroup[key])
+        }
+      }
       await (ctx as any).scope.update(normalize({
         ...(rawConfig ?? config),
         ...(qq && typeof qq === 'object' ? { qq: { ...readQqOptions(config), ...qq } } : {}),
+        // 注意：原生这几项是**顶层键**（dataPath / debug / autoParse / webUiAuth），不要塞进分组
+        ...native,
         upstream
       }))
       /**