koishi-plugin-kkk 1.0.0

package/lib/compat/sqlite3.js

@@ -0,0 +1,117 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Database = exports.sqlite3 = void 0;
+/**
+ * `node-karin/sqlite3` 的兼容实现：基于 Node 内置的 node:sqlite。
+ *
+ * 原插件按 node-sqlite3 的回调风格调用：`db.run(sql, params, cb)`、
+ * `db.get/all(sql, params, cb)`，回调里还有 `this.lastID` / `this.changes`，这里逐条对齐。
+ */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_sqlite_1 = require("node:sqlite");
+class CompatDatabase {
+    db;
+    filename;
+    constructor(filename, callback) {
+        this.filename = filename;
+        try {
+            node_fs_1.default.mkdirSync(node_path_1.default.dirname(filename), { recursive: true });
+            // node:sqlite 默认开启外键校验（enableForeignKeyConstraints: true），
+            // 而 node-sqlite3 默认关闭；上游表结构的外键（GroupUserSubscriptions.groupId → Groups.id）
+            // 在开启校验时会直接报 "foreign key mismatch"，因此这里显式关掉，与 Karin 版行为一致。
+            this.db = new node_sqlite_1.DatabaseSync(filename, { enableForeignKeyConstraints: false });
+            this.db.exec('PRAGMA journal_mode = WAL');
+            callback?.(null);
+        }
+        catch (error) {
+            callback?.(error);
+            throw error;
+        }
+    }
+    normalize(params) {
+        return (params ?? []).map((item) => {
+            if (item === undefined)
+                return null;
+            if (typeof item === 'boolean')
+                return item ? 1 : 0;
+            return item;
+        });
+    }
+    run(sql, params, callback) {
+        const cb = typeof params === 'function' ? params : callback;
+        const args = Array.isArray(params) ? params : [];
+        try {
+            const stmt = this.db.prepare(sql);
+            const result = stmt.run(...this.normalize(args));
+            const ctx = { lastID: Number(result.lastInsertRowid ?? 0), changes: Number(result.changes ?? 0) };
+            cb?.call(ctx, null);
+            return ctx;
+        }
+        catch (error) {
+            cb?.call({ lastID: 0, changes: 0 }, error);
+            return { lastID: 0, changes: 0 };
+        }
+    }
+    get(sql, params, callback) {
+        const cb = typeof params === 'function' ? params : callback;
+        const args = Array.isArray(params) ? params : [];
+        try {
+            const row = this.db.prepare(sql).get(...this.normalize(args));
+            cb?.(null, row);
+            return row;
+        }
+        catch (error) {
+            cb?.(error);
+            return undefined;
+        }
+    }
+    all(sql, params, callback) {
+        const cb = typeof params === 'function' ? params : callback;
+        const args = Array.isArray(params) ? params : [];
+        try {
+            const rows = this.db.prepare(sql).all(...this.normalize(args));
+            cb?.(null, rows);
+            return rows;
+        }
+        catch (error) {
+            cb?.(error);
+            return [];
+        }
+    }
+    exec(sql, callback) {
+        try {
+            this.db.exec(sql);
+            callback?.(null);
+        }
+        catch (error) {
+            callback?.(error);
+        }
+    }
+    close(callback) {
+        try {
+            this.db.close();
+            callback?.(null);
+        }
+        catch (error) {
+            callback?.(error);
+        }
+    }
+    serialize(callback) {
+        callback?.();
+    }
+    get path() {
+        return this.filename;
+    }
+}
+exports.sqlite3 = {
+    Database: CompatDatabase,
+    verbose() {
+        return exports.sqlite3;
+    }
+};
+exports.default = exports.sqlite3;
+exports.Database = CompatDatabase;

package/lib/compat/start.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.start = void 0;
+/** `node-karin/start` 的兼容实现：Koishi 下由宿主进程负责启动，这里不做任何事 */
+const start = async () => undefined;
+exports.start = start;
+exports.default = exports.start;

package/lib/compat/syncConfig.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncUpstreamToKoishi = syncUpstreamToKoishi;
+exports.deepMerge = deepMerge;
+/**
+ * 把「插件自己写进 config.json 的配置」反向同步到 Koishi 侧配置（koishi.yml）。
+ *
+ * kkk 有两套配置：
+ *   - Koishi 控制台改的 `upstream` 字段 → 启动时由 configBridge 合并进
+ *     `<数据目录>/koishi-plugin-kkk/config/config.json`（单向）
+ *   - 插件运行时读写的是 config.json 本身
+ *
+ * 所以扫码登录这类「插件主动写入」的值（例如 B站 Cookie）在控制台里永远看不到，
+ * 必须回写一次 koishi.yml，控制台表单才会显示真实取值。
+ */
+const logger_1 = require("./logger");
+const runtime_1 = require("./runtime");
+const isPlainObject = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+/** 深合并：纯对象递归，其余（含数组）整体替换 */
+function deepMerge(target, patch) {
+    const result = { ...target };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === undefined)
+            continue;
+        if (isPlainObject(value) && isPlainObject(result[key])) {
+            result[key] = deepMerge(result[key], value);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * 把一段配置合并进插件在 koishi.yml 里的 `upstream` 字段。
+ * @param patch 要同步的内容，例如 `{ amagi: { cookies: { bilibili: 'SESSDATA=...' } } }`
+ * @returns 是否同步成功（没有 scope / 写失败时返回 false，调用方降级即可）
+ */
+/** 日志本身也可能不可用（例如兼容层还没绑定 ctx），这里绝不能因为它再抛一次 */
+const warn = (message) => {
+    try {
+        logger_1.logger.warn(message);
+    }
+    catch {
+        /* 忽略：同步失败本身不应该影响登录流程 */
+    }
+};
+async function syncUpstreamToKoishi(patch) {
+    try {
+        const ctx = (0, runtime_1.tryGetRuntime)()?.ctx;
+        const scope = ctx?.scope;
+        if (!scope || typeof scope.update !== 'function') {
+            warn('[kkk] 当前环境不支持回写控制台配置（ctx.scope.update 不存在）');
+            return false;
+        }
+        const current = isPlainObject(scope.config) ? scope.config : {};
+        const upstream = deepMerge(isPlainObject(current.upstream) ? current.upstream : {}, patch);
+        await scope.update({ ...current, upstream });
+        return true;
+    }
+    catch (error) {
+        warn('[kkk] 回写控制台配置失败: ' + (error?.message ?? error));
+        return false;
+    }
+}

package/lib/compat/template-react.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * `@karinjs/template-react` 的最小兼容实现（Koishi 迁移补充）。
+ *
+ * 上游模板通过 ktr 约定注册：`export default defineTemplate({ name, description, component, validate })`，
+ * 由 ktr 的构建产物（SSR 外壳）负责按路由装配与渲染。
+ * 这里不需要 ktr 的构建管线，只要把注册对象原样返回，渲染由 `module/utils/Render` 直接做 React SSR。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HtmlWrapper = void 0;
+exports.defineTemplate = defineTemplate;
+exports.resolveTemplateStyle = resolveTemplateStyle;
+/** 模板注册：原样返回即可 */
+function defineTemplate(options) {
+    return options;
+}
+/** ktr 里负责拼 HTML 外壳的类，这里仅保留类型占位（预览工具用到） */
+class HtmlWrapper {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    loadInlineCss(_path) { return ''; }
+}
+exports.HtmlWrapper = HtmlWrapper;
+/** ktr 里解析模板样式的辅助函数 */
+function resolveTemplateStyle(options) {
+    return String(options?.cssPath ?? '');
+}
+exports.default = { defineTemplate, HtmlWrapper, resolveTemplateStyle };

package/lib/compat/text.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * 消息文本归一化（QQ 平台分享卡片）。
+ *
+ * QQ 官方适配器（koishi-plugin-adapter-qq-crack，platform=\`qqguild\`）解码消息时是
+ * \`message.elements = [h.text(data.content)]\` —— 不做卡片解析，把原始内容整段当文本塞进来。
+ * 于是分享卡片/小程序消息在插件眼里是这样一串：
+ *
+ * \`\`\`text
+ * {"app":"com.tencent.structmsg","meta":{"detail_1":{"qqdocurl":"https:\\/\\/v.douyin.com\\/xxxx\\/"}}}
+ * \`\`\`
+ *
+ * 注意 URL 里的斜杠是 **JSON 转义过的** \`\\/\`，直接拿 \`https?:\\/\\/\` 去匹配当然匹配不到；
+ * 这正是「QQ 卡片解析不了」的原因。这里做两件事：
+ *   1. 还原 JSON 转义（\`\\/\` → \`/\`、\`\\u0026\` → \`&\`、\`\\"\` → \`"\`）；
+ *   2. 把从卡片里挖出来的 URL **追加到文本末尾**，让各平台解析命令的正则能照常命中 ——
+ *      命令本身仍按前缀匹配，不受影响。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractUrls = extractUrls;
+exports.unescapeJsonText = unescapeJsonText;
+exports.normalizeMessageText = normalizeMessageText;
+/** 从任意文本里收集 http(s) 链接（会先还原 JSON 转义） */
+function extractUrls(input) {
+    if (!input || !input.includes('http'))
+        return [];
+    const unescaped = unescapeJsonText(input);
+    const matched = unescaped.match(/https?:\/\/[^\s"'<>\\\]\[}{]+/gi) ?? [];
+    const result = [];
+    for (const raw of matched) {
+        // 去掉 JSON 里常见的尾随符号
+        const url = raw.replace(/[),.;:'"]+$/, '');
+        if (!result.includes(url))
+            result.push(url);
+    }
+    return result;
+}
+/** 还原 JSON 字符串里的转义（只处理会影响 URL 识别的几种） */
+function unescapeJsonText(input) {
+    if (!input || !input.includes('\\'))
+        return input;
+    return input
+        .replace(/\\u002[fF]/g, '/')
+        .replace(/\\\//g, '/')
+        .replace(/\\"/g, '"')
+        .replace(/\\u0026/gi, '&');
+}
+/**
+ * 归一化一段消息文本：卡片消息会额外附带「从中提取出的链接」。
+ * 普通文本原样返回（不改变已有行为）。
+ */
+function normalizeMessageText(content) {
+    const text = (content ?? '').trim();
+    if (!text)
+        return '';
+    // 纯文本、里面没有 JSON 转义/花括号时不必处理
+    if (!text.includes('\\') && !text.includes('{'))
+        return text;
+    const urls = extractUrls(text);
+    if (!urls.length)
+        return unescapeJsonText(text);
+    const missing = urls.filter((url) => !text.includes(url));
+    return missing.length ? text + ' ' + missing.join(' ') : text;
+}
+exports.default = normalizeMessageText;

package/lib/compat/yaml.js

@@ -0,0 +1,13 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringify = exports.parse = void 0;
+/** `node-karin/yaml` 的兼容实现：复用工作区已有的 js-yaml */
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const parse = (text) => js_yaml_1.default.load(text);
+exports.parse = parse;
+const stringify = (value) => js_yaml_1.default.dump(value);
+exports.stringify = stringify;
+exports.default = { parse: exports.parse, stringify: exports.stringify };

package/lib/configBridge.js

@@ -0,0 +1,91 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyUpstreamOverrides = applyUpstreamOverrides;
+/**
+ * 控制台表单 → 插件 config.json 的落地。
+ *
+ * 用户在 Koishi 控制台改的是 koishi.yml 里的 \`upstream\` 字段，插件真正读取的却是
+ * \`<数据目录>/koishi-plugin-kkk/config/config.json\`（上游 Config 服务的路径）。
+ * 因此 apply 阶段、**在加载上游 apps 之前**把表单里显式填过的值深合并进那个文件：
+ *   - 空数组 / 空对象算没填（Koishi 会给 Schema.array()/object() 补空值）；
+ *   - **与上游默认值相同的也算没填**：Schema 现在带 default()（控制台里能看到真实取值），
+ *     Koishi 会把整份默认值一并填进配置对象，若照单全收，用户直接改 config.json 的内容
+ *     会在下次启动时被表单里的默认值覆盖；
+ *   - 数组整体覆盖（pushlist 这类结构化数据按整块替换更可预期）。
+ *
+ * 代价：在控制台里把某项**改回默认值**不会写回 config.json（与默认值相同 = 视为没动过）。
+ * 真要强制改回去，用插件自带面板 /kkk 或直接编辑那个文件。
+ */
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const runtime_1 = require("./compat/runtime");
+const isPlainObject = (value) => !!value && typeof value === 'object' && !Array.isArray(value);
+/**
+ * 把控制台里的上游配置合并进 config.json。
+ * @param overrides 控制台里 \`upstream\` 字段的内容
+ */
+function applyUpstreamOverrides(overrides) {
+    const runtime = (0, runtime_1.getRuntime)();
+    const file = node_path_1.default.resolve(runtime.dataRoot, runtime_1.PLUGIN_DIR_NAME, 'config', 'config.json');
+    const defaultFile = node_path_1.default.resolve(runtime.pluginRoot, 'config', 'default_config', 'config.json');
+    /** 上游默认配置：用来把「控制台里的默认值」和「用户真的改过」区分开 */
+    let defaults = {};
+    try {
+        if (node_fs_1.default.existsSync(defaultFile))
+            defaults = JSON.parse(node_fs_1.default.readFileSync(defaultFile, 'utf8'));
+    }
+    catch {
+        defaults = {};
+    }
+    let current = {};
+    try {
+        if (node_fs_1.default.existsSync(file))
+            current = JSON.parse(node_fs_1.default.readFileSync(file, 'utf8'));
+        else
+            current = defaults;
+    }
+    catch {
+        current = {};
+    }
+    if (!isPlainObject(overrides))
+        return { changed: [], file };
+    const changed = [];
+    /**
+     * 「没填」的判定：undefined 之外，**空数组/空对象也算没填**。
+     * 原因是 Koishi 解析配置时会给 Schema.array()/Schema.object() 补上空值，
+     * 于是控制台里没碰过的 sendContent / pushlist 会以 `[]` 的形式传进来；
+     * 若照单全收就会把用户在 config.json 里配好的内容清空。
+     * 代价：想「清空某个列表」请用 /kkk 面板或直接改文件（已在 usage / README 说明）。
+     */
+    const isEmptyContainer = (value) => Array.isArray(value) ? value.length === 0 : isPlainObject(value) && Object.keys(value).length === 0;
+    const merge = (target, source, baseline, prefix) => {
+        for (const [key, value] of Object.entries(source)) {
+            if (value === undefined || isEmptyContainer(value))
+                continue;
+            const base = isPlainObject(baseline) ? baseline[key] : undefined;
+            if (isPlainObject(value)) {
+                if (!isPlainObject(target[key]))
+                    target[key] = {};
+                merge(target[key], value, isPlainObject(base) ? base : {}, prefix + key + '.');
+                continue;
+            }
+            // 与上游默认值相同 → 控制台里没动过这一项，不写回（否则会盖掉用户手改的文件）
+            if (base !== undefined && JSON.stringify(base) === JSON.stringify(value))
+                continue;
+            if (JSON.stringify(target[key]) === JSON.stringify(value))
+                continue;
+            target[key] = value;
+            changed.push(prefix + key);
+        }
+    };
+    merge(current, overrides, defaults, '');
+    if (changed.length) {
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(file), { recursive: true });
+        node_fs_1.default.writeFileSync(file, JSON.stringify(current, null, 2), 'utf8');
+    }
+    return { changed, file };
+}
+exports.default = applyUpstreamOverrides;