koishi-plugin-kkk 1.0.0

package/resources/vite.svg

@@ -0,0 +1,130 @@
+<svg width="48" height="46" viewBox="0 0 48 46" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M25.9456 44.9383C25.2821 45.7827 23.925 45.3131 23.925 44.2403V33.9369C23.925 32.6875 22.9126 31.6751 21.6631 31.6751H10.287C9.36714 31.6751 8.83075 30.6346 9.36713 29.8871L16.8464 19.4157C17.917 17.9185 16.8464 15.8376 15.0046 15.8376H1.23731C0.317479 15.8376 -0.218913 14.7972 0.317475 14.0497L10.0134 0.4741C10.2266 0.176825 10.5692 0.000183105 10.9332 0.000183105H39.8271C40.7469 0.000183105 41.2833 1.04065 40.7469 1.78814L33.2676 12.2595C32.197 13.7567 33.2676 15.8376 35.1094 15.8376H46.4856C47.4291 15.8376 47.959 16.9255 47.3753 17.6687L25.9478 44.9404L25.9456 44.9383Z" fill="#863BFF" style="fill:#863BFF;fill:color(display-p3 0.5252 0.2300 1.0000);fill-opacity:1;"/>
+<mask id="mask0_2002_17158" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="48" height="46">
+<path d="M25.8416 44.9381C25.1781 45.7825 23.821 45.3129 23.821 44.2401V33.9368C23.821 32.6873 22.8085 31.6749 21.5591 31.6749H10.183C9.26313 31.6749 8.72674 30.6344 9.26313 29.8869L16.7424 19.4155C17.813 17.9184 16.7424 15.8374 14.9006 15.8374H1.1333C0.213475 15.8374 -0.322917 14.797 0.213471 14.0495L9.90938 0.473917C10.1226 0.176641 10.4652 0 10.8292 0H39.7231C40.6429 0 41.1793 1.04046 40.6429 1.78796L33.1636 12.2594C32.093 13.7565 33.1636 15.8374 35.0054 15.8374H46.3816C47.3251 15.8374 47.855 16.9253 47.2713 17.6685L25.8438 44.9402L25.8416 44.9381Z" fill="black" style="fill:black;fill-opacity:1;"/>
+</mask>
+<g mask="url(#mask0_2002_17158)">
+<g filter="url(#filter0_f_2002_17158)">
+<ellipse cx="5.50802" cy="14.7043" rx="5.50802" ry="14.7043" transform="matrix(0.00324134 0.999995 0.999995 -0.00324134 -4.46924 31.5157)" fill="#EDE6FF" style="fill:#EDE6FF;fill:color(display-p3 0.9275 0.9033 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter1_f_2002_17158)">
+<ellipse cx="10.3995" cy="29.8514" rx="10.3995" ry="29.8514" transform="matrix(0.00324134 0.999995 0.999995 -0.00324134 -39.3281 7.88272)" fill="#EDE6FF" style="fill:#EDE6FF;fill:color(display-p3 0.9275 0.9033 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter2_f_2002_17158)">
+<ellipse cx="5.50802" cy="30.4868" rx="5.50802" ry="30.4868" transform="matrix(0.00324134 0.999995 0.999995 -0.00324134 -40.4673 11.3212)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter3_f_2002_17158)">
+<ellipse cx="5.50802" cy="30.5986" rx="5.50802" ry="30.5986" transform="matrix(0.00324134 0.999995 0.999995 -0.00324134 -35.8721 29.3204)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter4_f_2002_17158)">
+<ellipse cx="5.50802" cy="30.5986" rx="5.50802" ry="30.5986" transform="matrix(0.00324134 0.999995 0.999995 -0.00324134 -34.3398 30.4693)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter5_f_2002_17158)">
+<ellipse cx="14.0715" cy="22.0783" rx="14.0715" ry="22.0783" transform="matrix(0.0584509 -0.99829 -0.99829 -0.0584509 74.3486 26.8633)" fill="#EDE6FF" style="fill:#EDE6FF;fill:color(display-p3 0.9275 0.9033 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter6_f_2002_17158)">
+<ellipse cx="3.47034" cy="21.5008" rx="3.47034" ry="21.5008" transform="matrix(-0.0172986 -0.99985 -0.99985 0.0172986 75.7944 18.0627)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter7_f_2002_17158)">
+<ellipse cx="3.47034" cy="21.5008" rx="3.47034" ry="21.5008" transform="matrix(-0.0172986 -0.99985 -0.99985 0.0172986 75.7944 18.0627)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter8_f_2002_17158)">
+<ellipse cx="0.386861" cy="8.97156" rx="4.40666" ry="29.1076" transform="rotate(39.5103 0.386861 8.97156)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter9_f_2002_17158)">
+<ellipse cx="47.5226" cy="-6.09166" rx="4.40666" ry="29.1076" transform="rotate(37.8923 47.5226 -6.09166)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter10_f_2002_17158)">
+<ellipse cx="41.4121" cy="6.3335" rx="5.9715" ry="9.66515" transform="rotate(37.8923 41.4121 6.3335)" fill="#47BFFF" style="fill:#47BFFF;fill:color(display-p3 0.2799 0.7480 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter11_f_2002_17158)">
+<ellipse cx="-1.87921" cy="38.3321" rx="4.40666" ry="29.1076" transform="rotate(37.8923 -1.87921 38.3321)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter12_f_2002_17158)">
+<ellipse cx="-1.87921" cy="38.3321" rx="4.40666" ry="29.1076" transform="rotate(37.8923 -1.87921 38.3321)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter13_f_2002_17158)">
+<ellipse cx="35.6511" cy="29.9069" rx="4.40666" ry="29.1076" transform="rotate(37.8923 35.6511 29.9069)" fill="#7E14FF" style="fill:#7E14FF;fill:color(display-p3 0.4922 0.0767 1.0000);fill-opacity:1;"/>
+</g>
+<g filter="url(#filter14_f_2002_17158)">
+<ellipse cx="38.4178" cy="32.4" rx="5.9715" ry="15.2974" transform="rotate(37.8923 38.4178 32.4)" fill="#47BFFF" style="fill:#47BFFF;fill:color(display-p3 0.2799 0.7480 1.0000);fill-opacity:1;"/>
+</g>
+</g>
+<defs>
+<filter id="filter0_f_2002_17158" x="-19.7697" y="16.1493" width="60.0452" height="41.6535" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="7.65926" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter1_f_2002_17158" x="-54.613" y="-7.53303" width="90.3397" height="51.4368" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="7.65926" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter2_f_2002_17158" x="-49.6403" y="2.03032" width="79.3554" height="29.4" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter3_f_2002_17158" x="-45.0451" y="20.0292" width="79.579" height="29.4" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter4_f_2002_17158" x="-43.5129" y="21.1781" width="79.579" height="29.4" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter5_f_2002_17158" x="15.7557" y="-17.9006" width="74.7493" height="58.852" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="7.65926" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter6_f_2002_17158" x="23.5481" y="2.28368" width="61.3773" height="25.3622" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter7_f_2002_17158" x="23.5481" y="2.28368" width="61.3773" height="25.3622" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter8_f_2002_17158" x="-27.6359" y="-22.8531" width="56.0453" height="63.6493" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter9_f_2002_17158" x="20.1155" y="-38.4147" width="54.8139" height="64.646" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter10_f_2002_17158" x="24.6414" y="-11.3229" width="33.5414" height="35.3129" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter11_f_2002_17158" x="-29.2863" y="6.00905" width="54.8139" height="64.646" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter12_f_2002_17158" x="-29.2863" y="6.00905" width="54.8139" height="64.646" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter13_f_2002_17158" x="8.24395" y="-2.41615" width="54.8139" height="64.646" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+<filter id="filter14_f_2002_17158" x="18.7132" y="10.5885" width="39.4091" height="43.6229" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="4.59556" result="effect1_foregroundBlur_2002_17158"/>
+</filter>
+</defs>
+</svg>

package/scripts/build.mjs

@@ -0,0 +1,129 @@
+/**
+ * 构建脚本。
+ *
+ * 做两件事：
+ * 1. 程序化调用 tsc（不派生 esbuild 等子进程），把 src 编译成 CJS 到 lib/；
+ * 2. 把编译产物里保留的路径别名改写成相对路径 —— tsc 不会重写 import 说明符：
+ *    - @/xxx            → karin 源码目录
+ *    - @kkk/richtext    → 内置 richtext
+ *    - node-karin[/sub] → 兼容层实现（这样产物自带兼容层，不依赖 node_modules 里的转发包）
+ */
+import { readFileSync, writeFileSync, mkdirSync, existsSync, rmSync } from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import ts from 'typescript'
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const configPath = path.join(root, 'tsconfig.build.json')
+const outDir = path.join(root, 'lib')
+
+const configFile = ts.readConfigFile(configPath, (file) => readFileSync(file, 'utf8'))
+if (configFile.error) {
+  console.error(ts.flattenDiagnosticMessageText(configFile.error.messageText, '\n'))
+  process.exit(1)
+}
+const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, root)
+const options = { ...parsed.options, noCheck: true, incremental: false }
+
+if (existsSync(outDir)) rmSync(outDir, { recursive: true, force: true })
+
+const program = ts.createProgram(parsed.fileNames, options)
+const emitResult = program.emit()
+
+const diagnostics = ts.getPreEmitDiagnostics(program).filter((item) => item.category === ts.DiagnosticCategory.Error)
+if (diagnostics.length) {
+  for (const diagnostic of diagnostics.slice(0, 20)) {
+    const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, '\n')
+    const file = diagnostic.file ? path.relative(root, diagnostic.file.fileName) : ''
+    const pos = diagnostic.file && diagnostic.start !== undefined
+      ? diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start)
+      : null
+    console.error(file + (pos ? ':' + (pos.line + 1) + ':' + (pos.character + 1) : '') + ' ' + message)
+  }
+}
+
+if (emitResult.emitSkipped) {
+  console.error('构建失败：emit skipped')
+  process.exit(1)
+}
+
+/** 顺序敏感：子路径必须排在 node-karin 之前 */
+const ALIASES = [
+  { prefix: 'node-karin/root', target: 'compat/root', exact: true },
+  { prefix: 'node-karin/sqlite3', target: 'compat/sqlite3', exact: true },
+  { prefix: 'node-karin/axios', target: 'compat/axios', exact: true },
+  { prefix: 'node-karin/yaml', target: 'compat/yaml', exact: true },
+  { prefix: 'node-karin/express', target: 'compat/express', exact: true },
+  { prefix: 'node-karin/lodash', target: 'compat/lodash', exact: true },
+  { prefix: 'node-karin/start', target: 'compat/start', exact: true },
+  { prefix: 'node-karin', target: 'compat/node-karin', exact: true },
+  { prefix: '@kkk/richtext', target: 'richtext', exact: false },
+  // 上游模板里的 @template/* 别名指向 ktr 模板目录（@template/template/xxx = ktr/template/xxx）
+  { prefix: '@template/', target: 'ktr', exact: false },
+  { prefix: '@karinjs/template-react', target: 'compat/template-react', exact: true },
+  { prefix: '@heroui/react', target: 'compat/heroui', exact: true },
+  // 这个包自己打包有问题（type:module + require 指向 .js），require 它就抛
+  // 「exports is not defined in ES module scope」，会让所有卡片模板加载失败 → 接到 lucide 上
+  { prefix: '@phosphor-icons/react', target: 'compat/phosphor-icons', exact: true },
+  { prefix: '@/', target: 'karin', exact: false }
+]
+
+const rewriteAliases = (dir) => {
+  let count = 0
+  for (const entry of ts.sys.readDirectory(dir, ['.js'])) {
+    const source = readFileSync(entry, 'utf8')
+    if (!ALIASES.some((alias) => source.includes(alias.prefix))) continue
+    let replaced = source
+    for (const alias of ALIASES) {
+      const targetPath = path.join(outDir, alias.target)
+      const relative = path.relative(path.dirname(entry), alias.exact ? targetPath + '.js' : targetPath).replace(/\\/g, '/')
+      const prefix = relative.startsWith('.') ? relative : './' + relative
+      const staticPattern = /(require\()(?:"([^"]*)"|'([^']*)')(\))/g
+      const dynamicPattern = /(import\()(?:"([^"]*)"|'([^']*)')(\))/g
+      const replace = (match, lead, dq, sq, tail) => {
+        const value = dq !== undefined ? dq : sq
+        if (!value) return match
+        const matches = alias.exact ? value === alias.prefix : value.startsWith(alias.prefix)
+        if (!matches) return match
+        const rest = alias.exact ? '' : value.slice(alias.prefix.length)
+        const built = prefix + (rest ? (rest.startsWith('/') ? rest : '/' + rest) : '')
+        const quote = dq !== undefined ? '"' : "'"
+        return lead + quote + built + quote + tail
+      }
+      replaced = replaced.replace(staticPattern, replace).replace(dynamicPattern, replace)
+    }
+    if (replaced !== source) {
+      writeFileSync(entry, replaced)
+      count++
+    }
+  }
+  return count
+}
+
+/** 兜底检查：CJS 产物里残留 import.meta 会让 Node 把该文件当 ESM（exports is not defined） */
+const checkImportMeta = (dir) => {
+  const offenders = []
+  for (const entry of ts.sys.readDirectory(dir, ['.js'])) {
+    const source = readFileSync(entry, 'utf8')
+    if (!source.includes('import.meta')) continue
+    // 只认代码里的 import.meta（注释里提到不算）
+    const inCode = source.split(/\r?\n/).some((line) => {
+      const trimmed = line.trim()
+      if (!trimmed.includes('import.meta')) return false
+      return !(trimmed.startsWith('*') || trimmed.startsWith('//') || trimmed.startsWith('/*'))
+    })
+    if (inCode) offenders.push(path.relative(root, entry))
+  }
+  return offenders
+}
+
+mkdirSync(outDir, { recursive: true })
+const rewritten = rewriteAliases(outDir)
+const offenders = checkImportMeta(outDir)
+if (offenders.length) {
+  console.error('构建失败：以下产物残留 import.meta，CJS 下会被 Node 当成 ESM：')
+  for (const item of offenders) console.error('  - ' + item)
+  process.exit(1)
+}
+console.log('构建完成：输出到 ' + path.relative(root, outDir) + '，重写别名文件 ' + rewritten + ' 个')

package/scripts/check-schema.cjs

@@ -0,0 +1,55 @@
+/**
+ * 检查动态生成的配置 Schema：枚举字段解析成了哪些下拉选项、有没有漏掉默认值。
+ *
+ * 用法：node scripts/check-schema.cjs [--all]
+ *   --all  连没有解析出枚举的字段一起打印
+ */
+const path = require('node:path')
+
+const pluginRoot = path.resolve(__dirname, '..')
+const { parseConfigMeta, buildUpstreamSchema } = require(path.join(pluginRoot, 'lib/schema.js'))
+const defaults = require(path.join(pluginRoot, 'config/default_config/config.json'))
+
+const meta = parseConfigMeta(pluginRoot)
+
+/** 按配置结构走一遍，取出每个字段的默认值 */
+const walk = (value, fieldPath, visit) => {
+  if (Array.isArray(value)) {
+    visit(fieldPath, value)
+    const sample = value.find((item) => item !== null && item !== undefined)
+    if (sample !== undefined) walk(sample, fieldPath + '[]', visit)
+    return
+  }
+  if (value && typeof value === 'object') {
+    visit(fieldPath, value)
+    for (const [key, item] of Object.entries(value)) walk(item, fieldPath + '.' + key, visit)
+    return
+  }
+  visit(fieldPath, value)
+}
+
+const rows = []
+for (const [key, value] of Object.entries(defaults)) {
+  walk(value, key, (fieldPath, sample) => rows.push({ fieldPath, sample }))
+}
+
+const showAll = process.argv.includes('--all')
+let withEnum = 0
+let leaf = 0
+for (const row of rows) {
+  const info = meta[row.fieldPath] ?? meta['#' + row.fieldPath.split('.').pop().replace(/\[\]$/, '')]
+  const options = info && info.options
+  if (!options) {
+    if (showAll) console.log('  · ' + row.fieldPath + '  = ' + JSON.stringify(row.sample))
+    continue
+  }
+  withEnum += 1
+  console.log('▸ ' + row.fieldPath + '  （默认 ' + JSON.stringify(row.sample) + '）')
+  for (const option of options) {
+    console.log('    - ' + JSON.stringify(option.value) + (option.label ? '  ' + option.label : ''))
+  }
+}
+for (const row of rows) if (!Array.isArray(row.sample) && (!row.sample || typeof row.sample !== 'object')) leaf += 1
+
+console.log('\n字段总数 ' + rows.length + '（叶子 ' + leaf + '），解析出下拉的 ' + withEnum + ' 个')
+console.log('Schema 顶层键：' + Object.keys(buildUpstreamSchema(pluginRoot).dict ?? {}).join(', '))

package/scripts/deploy.mjs

@@ -0,0 +1,78 @@
+/**
+ * 把插件「以运行时最小集」部署到工作区的 node_modules 里。
+ *
+ * 只复制运行需要的文件（package.json / lib / config / resources / CHANGELOG.md / LICENSE），
+ * 不带 src、scripts、测试数据。依赖不复制（那会多出 400+ MB），而是在副本里建一个
+ * node_modules junction 指回开发目录的依赖，Node 的模块解析照常生效。
+ *
+ * 用法：
+ *   node scripts/deploy.mjs                        # 部署到 <工作区>/node_modules/koishi-plugin-kkk
+ *   node scripts/deploy.mjs --with-deps            # 连依赖一起复制（自包含，可整体拷走，约 450 MB）
+ *   node scripts/deploy.mjs --target <dir>         # 指定目标目录
+ */
+import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, rmSync, statSync, symlinkSync } from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const argv = process.argv.slice(2)
+const withDeps = argv.includes('--with-deps')
+const targetIndex = argv.indexOf('--target')
+const target = targetIndex >= 0
+  ? path.resolve(argv[targetIndex + 1])
+  : path.resolve(root, '..', '..', 'node_modules', 'koishi-plugin-kkk')
+
+/** 运行时需要的文件/目录 */
+// assets：配置页模板（assets/webui.html）；
+// client：控制台入口（ctx.console.addEntry 会去这个目录找 index.js）
+const ENTRIES = ['package.json', 'lib', 'config', 'resources', 'assets', 'client', 'CHANGELOG.md', 'LICENSE', 'dist']
+
+if (!existsSync(path.join(root, 'lib', 'index.js'))) {
+  console.error('还没有构建产物，请先执行：node scripts/build.mjs')
+  process.exit(1)
+}
+
+// 清掉旧的部署（可能是 junction、目录或文件）
+if (existsSync(target) || lstatSync(target, { throwIfNoEntry: false })) {
+  rmSync(target, { recursive: true, force: true })
+}
+mkdirSync(target, { recursive: true })
+
+let copied = 0
+let bytes = 0
+for (const entry of ENTRIES) {
+  const from = path.join(root, entry)
+  if (!existsSync(from)) continue
+  const to = path.join(target, entry)
+  cpSync(from, to, { recursive: true })
+  const size = statSync(from).isDirectory()
+    ? readdirSync(from, { recursive: true }).reduce((sum, item) => {
+      const file = path.join(from, item)
+      return sum + (statSync(file).isFile() ? statSync(file).size : 0)
+    }, 0)
+    : statSync(from).size
+  bytes += size
+  copied++
+  console.log('  复制 ' + entry + '（' + (size / 1024 / 1024).toFixed(2) + ' MB）')
+}
+
+if (withDeps) {
+  const from = path.join(root, 'node_modules')
+  if (existsSync(from)) {
+    console.log('  复制 node_modules（依赖，比较慢）…')
+    cpSync(from, path.join(target, 'node_modules'), { recursive: true })
+  }
+} else {
+  // 依赖不复制，用 junction 指回开发目录；Node 解析依赖时会正常走到这里
+  const deps = path.join(root, 'node_modules')
+  if (existsSync(deps)) {
+    symlinkSync(deps, path.join(target, 'node_modules'), 'junction')
+    console.log('  依赖：junction → ' + deps)
+  } else {
+    console.warn('  警告：开发目录没有 node_modules，副本运行时会缺依赖')
+  }
+}
+
+console.log('\n部署完成 → ' + target)
+console.log('  文件 ' + copied + ' 项，约 ' + (bytes / 1024 / 1024).toFixed(2) + ' MB' + (withDeps ? '（另有依赖副本）' : '，依赖走 junction'))
+console.log('  宿主重启（koishi start）后生效')

package/scripts/make-demo-placeholders.mjs

@@ -0,0 +1,112 @@
+/**
+ * 生成 README 里演示图的占位图。
+ *
+ * 真图放进去之前先铺一张写着「这里该放什么」的占位，README 就不会是一片裂图。
+ *
+ * 用法：
+ *   node scripts/make-demo-placeholders.mjs          # 只补缺失的（已有的图不会被覆盖）
+ *   node scripts/make-demo-placeholders.mjs --force  # 全部重画成占位
+ *
+ * 换真图：把截图按文件名覆盖到 docs/images/ 即可（建议 1440×810，16:9）。
+ */
+import fs from 'node:fs'
+import path from 'node:path'
+import { createRequire } from 'node:module'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const require = createRequire(import.meta.url)
+const here = path.dirname(fileURLToPath(import.meta.url))
+const pluginRoot = path.resolve(here, '..')
+const outDir = path.join(pluginRoot, 'docs', 'images')
+const force = process.argv.includes('--force')
+
+/** 文件名 → [这张图该拍什么, 怎么拍] */
+export const SHOTS = [
+  ['01-qq-panel', 'QQ 交互面板：解析完成的卡片 + 清晰度 / 视频 / 弹幕 / 大小 表格 + 一排按钮', '群里发链接后机器人回的第一条消息'],
+  ['02-bilibili-info', 'B站视频信息卡（封面、UP 主、数据栏、热门弹幕）', '解析一个 B站视频后的卡片'],
+  ['03-comment-card', '评论区长图：超过 20MB 或发送失败时自动切片，再用一条 markdown 拼回一整张', '评论区卡片的完整长图'],
+  ['04-douyin-gallery', '抖音图集：多张图合成一条 markdown 发送，实况视频跟在后面', '解析抖音图集后的消息'],
+  ['05-xiaohongshu-note', '小红书笔记卡片 + 评论区', '解析小红书笔记后的面板'],
+  ['06-download-progress', '下载进度提示：正在获取下载链接 / 正在合并音轨 / 发送中…', '点完画质按钮后的进度消息'],
+  ['07-webui-qq-tab', '配置面板 /kkk 的「QQ 适配器」分类（控制台里的「kkk 配置」页就是它）', '浏览器打开 /kkk 并切到 QQ 适配器标签'],
+  ['08-console-entry', 'Koishi 控制台：侧边栏入口 + 插件配置里的「QQ 适配器」与折叠的「Koishi 原生设置」', '控制台插件配置页'],
+  ['09-error-card', '错误诊断卡片：框架版本 / 插件版本 / 适配器，以及 QQ 群号与仓库地址', '触发一次报错的卡片'],
+]
+
+const BROWSERS = [
+  'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
+  'C:/Program Files/Microsoft/Edge/Application/msedge.exe',
+  'C:/Program Files/Google/Chrome/Application/chrome.exe',
+  'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
+  '/usr/bin/google-chrome',
+  '/usr/bin/chromium',
+]
+
+const STYLE = [
+  'html, body { margin: 0; width: 1440px; height: 810px; }',
+  'body { display: flex; align-items: center; justify-content: center;',
+  '       font-family: "Microsoft YaHei", "PingFang SC", sans-serif; background: #f5f6f8; }',
+  '.card { width: 1220px; height: 610px; border-radius: 24px; background: #fff;',
+  '        border: 3px dashed #c3c8d2; display: flex; flex-direction: column;',
+  '        align-items: center; justify-content: center; gap: 26px; }',
+  '.badge { font-size: 22px; letter-spacing: 2px; color: #8b93a3; }',
+  '.title { font-size: 44px; font-weight: 700; color: #2b3240; }',
+  '.note { font-size: 25px; line-height: 1.6; max-width: 980px; text-align: center; color: #5c6474; }',
+  '.file { font-size: 23px; color: #1f6feb; background: #eef4ff; padding: 10px 20px; border-radius: 10px; }',
+].join(String.fromCharCode(10))
+
+const buildHtml = (index, name, title, note) => [
+  '<!doctype html>',
+  '<html lang="zh"><head><meta charset="utf-8"><style>',
+  STYLE,
+  '</style></head><body>',
+  '  <div class="card">',
+  '    <div class="badge">演示图占位 · ' + String(index + 1).padStart(2, '0') + '</div>',
+  '    <div class="title">' + title + '</div>',
+  '    <div class="note">' + note + '</div>',
+  '    <div class="file">docs/images/' + name + '.png</div>',
+  '  </div>',
+  '</body></html>',
+].join(String.fromCharCode(10))
+
+async function loadPuppeteer () {
+  for (const cand of [path.join(pluginRoot, 'node_modules', 'puppeteer-core'), 'D:/devkoishi/node_modules/puppeteer-core', 'puppeteer-core']) {
+    try { return await import(pathToFileURL(require.resolve(cand)).href) } catch { /* 试下一个 */ }
+  }
+  return null
+}
+
+async function main () {
+  fs.mkdirSync(outDir, { recursive: true })
+  const mod = await loadPuppeteer()
+  if (!mod) { console.error('没找到 puppeteer-core，无法生成占位图'); process.exit(1) }
+  const puppeteer = mod.default ?? mod
+  const executablePath = BROWSERS.find((p) => fs.existsSync(p))
+  if (!executablePath) { console.error('没找到 Edge / Chrome，无法生成占位图'); process.exit(1) }
+
+  const targets = SHOTS.filter(([name]) => force || !fs.existsSync(path.join(outDir, name + '.png')))
+  if (!targets.length) console.log('[kkk] 占位图都在，无需生成（要重画加 --force）')
+  else {
+    const browser = await puppeteer.launch({ executablePath, headless: 'new', args: ['--no-sandbox'] })
+    const page = await browser.newPage()
+    await page.setViewport({ width: 1440, height: 810 })
+    for (const [name, title, note] of targets) {
+      const index = SHOTS.findIndex(([n]) => n === name)
+      await page.setContent(buildHtml(index, name, title, note), { waitUntil: 'load' })
+      await page.screenshot({ path: path.join(outDir, name + '.png') })
+      console.log('[kkk] 生成占位图 docs/images/' + name + '.png')
+    }
+    await browser.close()
+  }
+
+  const list = ['# 演示图清单', '',
+    '这里放 README 用到的演示图，**把截图按文件名覆盖进来就行**（建议 1440×810，16:9，单张 < 1MB）。',
+    '', '缺图时可以重新生成占位：`node scripts/make-demo-placeholders.mjs`（已存在的图不会被覆盖）。',
+    '', '| 文件 | 该拍什么 | 怎么拍 |', '| --- | --- | --- |']
+  for (const [name, title, note] of SHOTS) list.push('| `' + name + '.png` | ' + title + ' | ' + note + ' |')
+  list.push('')
+  fs.writeFileSync(path.join(outDir, 'README.md'), list.join(String.fromCharCode(10)))
+  console.log('[kkk] 清单已更新 docs/images/README.md')
+}
+
+main().catch((error) => { console.error(error); process.exit(1) })

package/scripts/patch-deps.mjs

@@ -0,0 +1,46 @@
+/**
+ * 依赖修补脚本（Koishi 迁移补充）。
+ *
+ * 有些依赖的打包对 CJS 消费方是坏的，而我们的插件是 CJS 产物（tsc 直出，无打包器）：
+ *
+ * 1. \`@phosphor-icons/react\`：package.json 声明 "type": "module"，却把 require 条件指向
+ *    \`dist/index.cjs.js\`（.js 扩展名 → Node 按 ESM 解析 → 文件里却是 CJS 语法，
+ *    直接报 "exports is not defined in ES module scope"）。
+ *    修法：把该文件复制成 \`.cjs\`，并把 package.json 里 require 条件改指过去。
+ *
+ * 用法（安装依赖后执行一次）：node scripts/patch-deps.mjs
+ * 幂等：已修补过会跳过。
+ */
+import { copyFileSync, existsSync, readFileSync, writeFileSync } from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const modules = path.join(root, 'node_modules')
+
+let patched = 0
+
+/** 把 CJS 实现复制成 .cjs 并改写 package.json 里的 require 条件 */
+function patchPhosphorIcons () {
+  const dir = path.join(modules, '@phosphor-icons', 'react')
+  const pkgPath = path.join(dir, 'package.json')
+  if (!existsSync(pkgPath)) return
+  const raw = readFileSync(pkgPath, 'utf8')
+  if (raw.includes('./dist/index.cjs"')) {
+    console.log('已修补：@phosphor-icons/react')
+    return
+  }
+  const source = path.join(dir, 'dist', 'index.cjs.js')
+  if (!existsSync(source)) {
+    console.warn('跳过：@phosphor-icons/react 缺少 dist/index.cjs.js')
+    return
+  }
+  copyFileSync(source, path.join(dir, 'dist', 'index.cjs'))
+  writeFileSync(pkgPath, raw.split('./dist/index.cjs.js').join('./dist/index.cjs'))
+  console.log('已修补：@phosphor-icons/react（require → dist/index.cjs）')
+  patched++
+}
+
+patchPhosphorIcons()
+
+console.log(patched ? '依赖修补完成：' + patched + ' 个包' : '依赖修补完成：无需改动')