koishi-plugin-kkk 1.0.0

package/src/qqOptions.ts

@@ -0,0 +1,64 @@
+/**
+ * QQ 适配器专属设置。
+ *
+ * 这些项只在 QQ 平台生效（面板、切片、番剧选集表格、卡片 OCR），
+ * 定义集中在 \`qqFields.json\` —— 两边共用同一份：
+ *   1. Koishi 控制台的插件配置表单（\`qq\` 折叠组，见 \`src/index.ts\`）；
+ *   2. WebUI（\`/kkk\` 的「QQ 适配器」分类，见 \`scripts/patch-webui.mjs\`）。
+ * 改一处两边同步，不会出现「WebUI 有、控制台没有」。
+ */
+import type { Schema } from 'koishi'
+
+import fields from './qqFields.json'
+
+export interface QqField {
+  key: string
+  group: string
+  type: 'boolean' | 'number' | 'string'
+  default: any
+  label: string
+  description: string
+  min?: number
+  max?: number
+  secret?: boolean
+}
+
+export const QQ_FIELDS = fields as QqField[]
+
+/** 表单里 QQ 分组的字段名 */
+export const QQ_KEYS = QQ_FIELDS.map((field) => field.key)
+
+/** 缺省值表 */
+export const QQ_DEFAULTS: Record<string, any> = Object.fromEntries(QQ_FIELDS.map((field) => [field.key, field.default]))
+
+/**
+ * 读当前值：优先读新的 \`config.qq.*\`，其次兼容早期写在顶层的同名字段，最后回退默认值。
+ */
+export function readQqOptions (config: any): Record<string, any> {
+  const group = config?.qq ?? {}
+  const result: Record<string, any> = {}
+  for (const field of QQ_FIELDS) {
+    const value = group[field.key] ?? config?.[field.key]
+    result[field.key] = value === undefined || value === null ? field.default : value
+  }
+  return result
+}
+
+/**
+ * 生成控制台表单里的 QQ 分组。
+ *
+ * \`Schema.intersect\` 里的分组名会被 \`apply\` 摊平回顶层（见 \`src/index.ts\`），
+ * 插件内部照旧读 \`config.qqPanel\` 这种扁平字段。
+ */
+export function buildQqSchema (Schema: Schema): Schema<any> {
+  const shape: Record<string, any> = {}
+  for (const field of QQ_FIELDS) {
+    const base = field.type === 'boolean'
+      ? Schema.boolean()
+      : field.type === 'number'
+        ? Schema.number()
+        : Schema.string()
+    shape[field.key] = base.default(field.default).description(field.description)
+  }
+  return Schema.object(shape)
+}

package/src/richtext/index.ts

@@ -0,0 +1,9 @@
+/**
+ * \`@kkk/richtext\` 的移植入口（覆盖上游 packages/richtext 的全部导出）。
+ *
+ * core 侧只用 parse + types（生成可序列化节点），模板侧用 react（把节点渲染成 React）。
+ * 两边都在这里导出，与上游 \`src/index.ts\` 一致。
+ */
+export * from './parse'
+export * from './types'
+export * from './react'

package/src/richtext/parse/index.ts

@@ -0,0 +1,271 @@
+import type {
+  RichTextBlockquoteNode,
+  RichTextCodeBlockNode,
+  RichTextDocument,
+  RichTextEmojiNode,
+  RichTextHashtagNode,
+  RichTextHeadingNode,
+  RichTextImageNode,
+  RichTextLineBreakNode,
+  RichTextLinkCardNode,
+  RichTextListItemNode,
+  RichTextListNode,
+  RichTextMentionNode,
+  RichTextNode,
+  RichTextParagraphNode,
+  RichTextSearchKeywordNode,
+  RichTextTextNode,
+  RichTextTopicNode,
+  RichTextAtNode,
+  RichTextLotteryNode,
+  RichTextWebLinkNode,
+  RichTextOpusLinkNode,
+  RichTextVoteNode,
+  RichTextViewPictureNode,
+  RichTextHorizontalRuleNode,
+  RichTextInlineStyle
+} from '../types'
+
+/** 创建普通文本节点。 */
+export const createTextNode = (text: string, style?: RichTextInlineStyle): RichTextTextNode => ({
+  type: 'text',
+  text,
+  style
+})
+
+/** 创建行内表情节点。 */
+export const createEmojiNode = (
+  name: string,
+  src: string,
+  options: {
+    scale?: number
+  } = {}
+): RichTextEmojiNode => ({
+  type: 'emoji',
+  name,
+  src,
+  scale: options.scale
+})
+
+/** 创建 @ 用户节点。 */
+export const createMentionNode = (text: string, userId?: string): RichTextMentionNode => ({
+  type: 'mention',
+  text,
+  userId
+})
+
+/** 创建搜索词高亮节点。 */
+export const createSearchKeywordNode = (text: string, queryId?: string): RichTextSearchKeywordNode => ({
+  type: 'searchKeyword',
+  text,
+  queryId
+})
+
+/** 创建换行节点。 */
+export const createLineBreakNode = (): RichTextLineBreakNode => ({
+  type: 'lineBreak'
+})
+
+/** 创建话题节点。 */
+export const createTopicNode = (text: string): RichTextTopicNode => ({
+  type: 'topic',
+  text
+})
+
+/** 创建 @ 用户节点。 */
+export const createAtNode = (text: string, userId?: string): RichTextAtNode => ({
+  type: 'at',
+  text,
+  userId
+})
+
+/** 创建抽奖节点。 */
+export const createLotteryNode = (text: string): RichTextLotteryNode => ({
+  type: 'lottery',
+  text
+})
+
+/** 创建网页链接节点。 */
+export const createWebLinkNode = (text: string, jumpUrl: string): RichTextWebLinkNode => ({
+  type: 'webLink',
+  text,
+  jumpUrl
+})
+
+/** 创建站内图文链接节点。 */
+export const createOpusLinkNode = (text: string, url: string): RichTextOpusLinkNode => ({
+  type: 'opusLink',
+  text,
+  url
+})
+
+/** 创建投票节点。 */
+export const createVoteNode = (text: string): RichTextVoteNode => ({
+  type: 'vote',
+  text
+})
+
+/** 创建查看图片节点。 */
+export const createViewPictureNode = (text: string): RichTextViewPictureNode => ({
+  type: 'viewPicture',
+  text
+})
+
+/** 创建标题节点。 */
+export const createHeadingNode = (level: 1 | 2 | 3 | 4 | 5 | 6, nodes: RichTextNode[]): RichTextHeadingNode => ({
+  type: 'heading',
+  level,
+  nodes
+})
+
+/** 创建段落节点。 */
+export const createParagraphNode = (nodes: RichTextNode[]): RichTextParagraphNode => ({
+  type: 'paragraph',
+  nodes
+})
+
+/** 创建图片节点。 */
+export const createImageNode = (src: string, alt?: string, caption?: string): RichTextImageNode => ({
+  type: 'image',
+  src,
+  alt,
+  caption
+})
+
+/** 创建水平分隔线节点。 */
+export const createHorizontalRuleNode = (): RichTextHorizontalRuleNode => ({
+  type: 'horizontalRule'
+})
+
+/** 创建引用块节点。 */
+export const createBlockquoteNode = (nodes: RichTextNode[]): RichTextBlockquoteNode => ({
+  type: 'blockquote',
+  nodes
+})
+
+/** 创建列表节点。 */
+export const createListNode = (ordered: boolean, items: RichTextListItemNode[]): RichTextListNode => ({
+  type: 'list',
+  ordered,
+  items
+})
+
+/** 创建列表项节点。 */
+export const createListItemNode = (nodes: RichTextNode[]): RichTextListItemNode => ({
+  type: 'listItem',
+  nodes
+})
+
+/** 创建代码块节点。 */
+export const createCodeBlockNode = (content: string, language?: string): RichTextCodeBlockNode => ({
+  type: 'codeBlock',
+  content,
+  language
+})
+
+/** 创建链接卡片节点。 */
+export const createLinkCardNode = (
+  title: string,
+  url: string,
+  options: { cardType?: string; meta?: Record<string, any> } = {}
+): RichTextLinkCardNode => ({
+  type: 'linkCard',
+  title,
+  url,
+  cardType: options.cardType,
+  meta: options.meta
+})
+
+/**
+ * 创建 hashtag 节点。
+ *
+ * 纯文本高亮，不带任何图标。适用于抖音等平台的 #话题# 展示。
+ */
+export const createHashtagNode = (text: string): RichTextHashtagNode => ({
+  type: 'hashtag',
+  text
+})
+
+/**
+ * 合并相邻文本节点并丢弃空文本节点。
+ *
+ * 这样 core 可以按匹配过程简单 push 节点，最后统一整理，避免前端拿到碎片过多的数据。
+ */
+export const normalizeRichTextNodes = (nodes: RichTextNode[]): RichTextNode[] => {
+  const normalized: RichTextNode[] = []
+
+  for (const node of nodes) {
+    if (node.type === 'text') {
+      if (node.text.length === 0) {
+        continue
+      }
+
+      const previousNode = normalized[normalized.length - 1]
+      if (previousNode?.type === 'text') {
+        previousNode.text += node.text
+        continue
+      }
+    }
+
+    normalized.push(node)
+  }
+
+  return normalized
+}
+
+/**
+ * 从富文本文档中提取纯文本内容。
+ *
+ * 遍历所有节点，收集包含 text 字段的文本内容。
+ * lineBreak 节点映射为空格（不参与长度计数），图片节点被忽略。
+ */
+export const extractRichTextPlainText = (document: RichTextDocument): string => {
+  const extractFromNode = (node: RichTextNode): string => {
+    switch (node.type) {
+      case 'text':
+      case 'mention':
+      case 'searchKeyword':
+      case 'topic':
+      case 'at':
+      case 'lottery':
+      case 'webLink':
+      case 'opusLink':
+      case 'vote':
+      case 'viewPicture':
+      case 'hashtag':
+      case 'emoji':
+        return 'text' in node ? ((node as any).text ?? '') : ((node as any).name ?? '')
+      case 'heading':
+      case 'paragraph':
+      case 'blockquote':
+      case 'listItem':
+        return node.nodes.map(extractFromNode).join('')
+      case 'list':
+        return node.items.map(extractFromNode).join('')
+      case 'lineBreak':
+      case 'horizontalRule':
+        return ''
+      case 'image':
+        return ''
+      case 'codeBlock':
+        return node.content
+      case 'linkCard':
+        return node.title
+      default:
+        return ''
+    }
+  }
+
+  return document.nodes.map(extractFromNode).join('')
+}
+
+/**
+ * 创建富文本文档。
+ *
+ * 这里不会生成任何 HTML，只返回可序列化 JSON，适合作为 core 到 template 的数据边界。
+ */
+export const createRichTextDocument = (nodes: RichTextNode[], options: { platform?: string } = {}): RichTextDocument => ({
+  version: 1,
+  platform: options.platform,
+  nodes: normalizeRichTextNodes(nodes)
+})

package/src/richtext/react/cn.ts

@@ -0,0 +1,6 @@
+import clsx, { type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}