koishi-plugin-kkk 1.0.0

package/lib/ktr/utils/avatarProxy.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * ktr 开发面板预览用的头像代理约定。
+ *
+ * 头像 CDN（尤其 `q*.qlogo.cn`）不返回 `Access-Control-Allow-Origin`，
+ * 浏览器里直接 fetch 会被同源策略拦掉，面板预览的二维码就嵌不上头像。
+ * 生产渲染走 Node SSR（服务端 fetch，无同源策略），不受影响也不需要这个代理。
+ *
+ * 代理端点由 `karin.template.ts` 的 avatarProxyPlugin 挂在 ktr dev 服务器上，仅 serve 态存在。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toProxiedAvatarUrl = exports.isProxyableAvatarUrl = exports.AVATAR_PROXY_PATH = void 0;
+/** 代理端点路径，dev 服务器与模板侧共用这一处定义。 */
+exports.AVATAR_PROXY_PATH = '/__kkk/avatar-proxy';
+/**
+ * 允许转发的头像 CDN 域名。
+ *
+ * 白名单是为了不让 dev 服务器变成任意地址的开放转发；
+ * 其它适配器的头像域名如果也缺 CORS 头，在这里补一条即可（不在名单内的走直连）。
+ */
+const ALLOWED_AVATAR_HOSTS = [/(?:^|\.)qlogo\.cn$/i, /(?:^|\.)qpic\.cn$/i, /(?:^|\.)hdslb\.com$/i];
+/**
+ * 判断某个头像 URL 是否允许经代理转发
+ * @param url - 头像地址
+ * @returns 命中白名单且是 http(s) 时为 true
+ */
+const isProxyableAvatarUrl = (url) => {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:')
+            return false;
+        return ALLOWED_AVATAR_HOSTS.some((pattern) => pattern.test(parsed.hostname));
+    }
+    catch {
+        return false;
+    }
+};
+exports.isProxyableAvatarUrl = isProxyableAvatarUrl;
+/**
+ * 把头像地址改写成同源代理地址
+ * @param url - 原始头像地址
+ * @returns 代理端点地址
+ */
+const toProxiedAvatarUrl = (url) => `${exports.AVATAR_PROXY_PATH}?url=${encodeURIComponent(url)}`;
+exports.toProxiedAvatarUrl = toProxiedAvatarUrl;

package/lib/ktr/utils/cn.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cn = cn;
+const clsx_1 = __importDefault(require("clsx"));
+const tailwind_merge_1 = require("tailwind-merge");
+function cn(...inputs) {
+    return (0, tailwind_merge_1.twMerge)((0, clsx_1.default)(inputs));
+}

package/lib/ktr/utils/theme.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDark = void 0;
+/**
+ * 判断当前渲染是否为深色主题。
+ * 唯一事实来源是 `ctx.theme.mode`：生产渲染由 core 显式传入（'light' | 'dark'），
+ * 开发面板由「模板主题」弹窗下发；未设置时按浅色处理（框架不发明默认主题）。
+ * @param ctx ktr 注入的运行时上下文。
+ * @returns 深色主题返回 true。
+ */
+const isDark = (ctx) => ctx.theme?.mode === 'dark';
+exports.isDark = isDark;

package/lib/qqFields.json

@@ -0,0 +1,75 @@
+[
+    {
+        "key": "qqPanel",
+        "group": "解析面板",
+        "type": "boolean",
+        "default": true,
+        "label": "链接解析面板",
+        "description": "QQ 里收到链接时先回一条带按钮的面板，让用户自己挑解析内容和画质，点一下才开始下载。关掉就直接按默认配置解析。"
+    },
+    {
+        "key": "recallPanel",
+        "group": "解析面板",
+        "type": "boolean",
+        "default": true,
+        "label": "自动撤回面板",
+        "description": "用户在面板上点完按钮后，自动把上一条面板消息撤回，群里不会堆着一排旧面板。"
+    },
+    {
+        "key": "qqFileLimitMB",
+        "group": "解析面板",
+        "type": "number",
+        "default": 200,
+        "min": 1,
+        "max": 2000,
+        "label": "画质档体积上限（MB）",
+        "description": "面板里体积超过这个值的画质档直接不显示。QQ 单个视频上限 200MB，选了也发不出去，所以默认 200。"
+    },
+    {
+        "key": "bangumiPanelCols",
+        "group": "番剧选集面板",
+        "type": "number",
+        "default": 5,
+        "min": 1,
+        "max": 10,
+        "label": "表格列数",
+        "description": "番剧分集面板每行放几个集数，默认 5。"
+    },
+    {
+        "key": "bangumiPanelRows",
+        "group": "番剧选集面板",
+        "type": "number",
+        "default": 4,
+        "min": 1,
+        "max": 10,
+        "label": "表格行数",
+        "description": "番剧分集面板每页几行（含表头那一行），默认 4 行。列数 × 行数就是每页的集数。"
+    },
+    {
+        "key": "sliceImageOnDemand",
+        "group": "图片发送",
+        "type": "boolean",
+        "default": true,
+        "label": "超大图片自动切片",
+        "description": "长图（评论区那种）默认按普通图片发；只有超过 20MB 或者发送失败（拿不到消息 ID）时才自动切成几片，再用一条 markdown 拼回一整张。关掉就一律按普通图片发。"
+    },
+    {
+        "key": "sliceImageHeight",
+        "group": "图片发送",
+        "type": "number",
+        "default": 2000,
+        "min": 500,
+        "max": 4000,
+        "label": "切片高度（像素）",
+        "description": "切片时每片的高度，默认 2000。越大片数越少、字越小；越小越清晰、片数越多。"
+    },
+    {
+        "key": "ocrApiKey",
+        "group": "卡片识别",
+        "type": "string",
+        "default": "",
+        "label": "卡片文字识别密钥",
+        "secret": true,
+        "description": "群里转发过来的分享卡片没有链接，只能靠截图识别出标题和作者再去搜索。填自己的免费密钥更稳定：https://ocr.space/ocrapi 。留空会用公共测试密钥，容易被限流。"
+    }
+]

package/lib/qqOptions.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QQ_DEFAULTS = exports.QQ_KEYS = exports.QQ_FIELDS = void 0;
+exports.readQqOptions = readQqOptions;
+exports.buildQqSchema = buildQqSchema;
+const qqFields_json_1 = __importDefault(require("./qqFields.json"));
+exports.QQ_FIELDS = qqFields_json_1.default;
+/** 表单里 QQ 分组的字段名 */
+exports.QQ_KEYS = exports.QQ_FIELDS.map((field) => field.key);
+/** 缺省值表 */
+exports.QQ_DEFAULTS = Object.fromEntries(exports.QQ_FIELDS.map((field) => [field.key, field.default]));
+/**
+ * 读当前值：优先读新的 \`config.qq.*\`，其次兼容早期写在顶层的同名字段，最后回退默认值。
+ */
+function readQqOptions(config) {
+    const group = config?.qq ?? {};
+    const result = {};
+    for (const field of exports.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\` 这种扁平字段。
+ */
+function buildQqSchema(Schema) {
+    const shape = {};
+    for (const field of exports.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/lib/richtext/index.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * \`@kkk/richtext\` 的移植入口（覆盖上游 packages/richtext 的全部导出）。
+ *
+ * core 侧只用 parse + types（生成可序列化节点），模板侧用 react（把节点渲染成 React）。
+ * 两边都在这里导出，与上游 \`src/index.ts\` 一致。
+ */
+__exportStar(require("./parse"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./react"), exports);

package/lib/richtext/parse/index.js

@@ -0,0 +1,232 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRichTextDocument = exports.extractRichTextPlainText = exports.normalizeRichTextNodes = exports.createHashtagNode = exports.createLinkCardNode = exports.createCodeBlockNode = exports.createListItemNode = exports.createListNode = exports.createBlockquoteNode = exports.createHorizontalRuleNode = exports.createImageNode = exports.createParagraphNode = exports.createHeadingNode = exports.createViewPictureNode = exports.createVoteNode = exports.createOpusLinkNode = exports.createWebLinkNode = exports.createLotteryNode = exports.createAtNode = exports.createTopicNode = exports.createLineBreakNode = exports.createSearchKeywordNode = exports.createMentionNode = exports.createEmojiNode = exports.createTextNode = void 0;
+/** 创建普通文本节点。 */
+const createTextNode = (text, style) => ({
+    type: 'text',
+    text,
+    style
+});
+exports.createTextNode = createTextNode;
+/** 创建行内表情节点。 */
+const createEmojiNode = (name, src, options = {}) => ({
+    type: 'emoji',
+    name,
+    src,
+    scale: options.scale
+});
+exports.createEmojiNode = createEmojiNode;
+/** 创建 @ 用户节点。 */
+const createMentionNode = (text, userId) => ({
+    type: 'mention',
+    text,
+    userId
+});
+exports.createMentionNode = createMentionNode;
+/** 创建搜索词高亮节点。 */
+const createSearchKeywordNode = (text, queryId) => ({
+    type: 'searchKeyword',
+    text,
+    queryId
+});
+exports.createSearchKeywordNode = createSearchKeywordNode;
+/** 创建换行节点。 */
+const createLineBreakNode = () => ({
+    type: 'lineBreak'
+});
+exports.createLineBreakNode = createLineBreakNode;
+/** 创建话题节点。 */
+const createTopicNode = (text) => ({
+    type: 'topic',
+    text
+});
+exports.createTopicNode = createTopicNode;
+/** 创建 @ 用户节点。 */
+const createAtNode = (text, userId) => ({
+    type: 'at',
+    text,
+    userId
+});
+exports.createAtNode = createAtNode;
+/** 创建抽奖节点。 */
+const createLotteryNode = (text) => ({
+    type: 'lottery',
+    text
+});
+exports.createLotteryNode = createLotteryNode;
+/** 创建网页链接节点。 */
+const createWebLinkNode = (text, jumpUrl) => ({
+    type: 'webLink',
+    text,
+    jumpUrl
+});
+exports.createWebLinkNode = createWebLinkNode;
+/** 创建站内图文链接节点。 */
+const createOpusLinkNode = (text, url) => ({
+    type: 'opusLink',
+    text,
+    url
+});
+exports.createOpusLinkNode = createOpusLinkNode;
+/** 创建投票节点。 */
+const createVoteNode = (text) => ({
+    type: 'vote',
+    text
+});
+exports.createVoteNode = createVoteNode;
+/** 创建查看图片节点。 */
+const createViewPictureNode = (text) => ({
+    type: 'viewPicture',
+    text
+});
+exports.createViewPictureNode = createViewPictureNode;
+/** 创建标题节点。 */
+const createHeadingNode = (level, nodes) => ({
+    type: 'heading',
+    level,
+    nodes
+});
+exports.createHeadingNode = createHeadingNode;
+/** 创建段落节点。 */
+const createParagraphNode = (nodes) => ({
+    type: 'paragraph',
+    nodes
+});
+exports.createParagraphNode = createParagraphNode;
+/** 创建图片节点。 */
+const createImageNode = (src, alt, caption) => ({
+    type: 'image',
+    src,
+    alt,
+    caption
+});
+exports.createImageNode = createImageNode;
+/** 创建水平分隔线节点。 */
+const createHorizontalRuleNode = () => ({
+    type: 'horizontalRule'
+});
+exports.createHorizontalRuleNode = createHorizontalRuleNode;
+/** 创建引用块节点。 */
+const createBlockquoteNode = (nodes) => ({
+    type: 'blockquote',
+    nodes
+});
+exports.createBlockquoteNode = createBlockquoteNode;
+/** 创建列表节点。 */
+const createListNode = (ordered, items) => ({
+    type: 'list',
+    ordered,
+    items
+});
+exports.createListNode = createListNode;
+/** 创建列表项节点。 */
+const createListItemNode = (nodes) => ({
+    type: 'listItem',
+    nodes
+});
+exports.createListItemNode = createListItemNode;
+/** 创建代码块节点。 */
+const createCodeBlockNode = (content, language) => ({
+    type: 'codeBlock',
+    content,
+    language
+});
+exports.createCodeBlockNode = createCodeBlockNode;
+/** 创建链接卡片节点。 */
+const createLinkCardNode = (title, url, options = {}) => ({
+    type: 'linkCard',
+    title,
+    url,
+    cardType: options.cardType,
+    meta: options.meta
+});
+exports.createLinkCardNode = createLinkCardNode;
+/**
+ * 创建 hashtag 节点。
+ *
+ * 纯文本高亮，不带任何图标。适用于抖音等平台的 #话题# 展示。
+ */
+const createHashtagNode = (text) => ({
+    type: 'hashtag',
+    text
+});
+exports.createHashtagNode = createHashtagNode;
+/**
+ * 合并相邻文本节点并丢弃空文本节点。
+ *
+ * 这样 core 可以按匹配过程简单 push 节点，最后统一整理，避免前端拿到碎片过多的数据。
+ */
+const normalizeRichTextNodes = (nodes) => {
+    const normalized = [];
+    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;
+};
+exports.normalizeRichTextNodes = normalizeRichTextNodes;
+/**
+ * 从富文本文档中提取纯文本内容。
+ *
+ * 遍历所有节点，收集包含 text 字段的文本内容。
+ * lineBreak 节点映射为空格（不参与长度计数），图片节点被忽略。
+ */
+const extractRichTextPlainText = (document) => {
+    const extractFromNode = (node) => {
+        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.text ?? '') : (node.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('');
+};
+exports.extractRichTextPlainText = extractRichTextPlainText;
+/**
+ * 创建富文本文档。
+ *
+ * 这里不会生成任何 HTML，只返回可序列化 JSON，适合作为 core 到 template 的数据边界。
+ */
+const createRichTextDocument = (nodes, options = {}) => ({
+    version: 1,
+    platform: options.platform,
+    nodes: (0, exports.normalizeRichTextNodes)(nodes)
+});
+exports.createRichTextDocument = createRichTextDocument;

package/lib/richtext/react/cn.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cn = cn;
+const clsx_1 = __importDefault(require("clsx"));
+const tailwind_merge_1 = require("tailwind-merge");
+function cn(...inputs) {
+    return (0, tailwind_merge_1.twMerge)((0, clsx_1.default)(inputs));
+}