koishi-plugin-kkk 1.0.0

package/config/default_config/douyin.yaml

@@ -0,0 +1,99 @@
+# 抖音解析开关，单独开关，受「总开关」影响
+switch: true
+
+# 解析时发送的内容，可选值：'info'(视频信息)、'comment'(评论图片)、'video'(视频文件)
+sendContent:
+  - info
+  - comment
+  - video
+
+# 抖音评论数量，范围 1 ~ x 条
+numcomment: 5
+
+# 次级评论请求数量，范围1 ~ x 条，最高尽量 8 条左右，当前逻辑不仅无法判断请求的来的评论的嵌套深度，而且「subCommentDepth」会限制嵌套深度，超过深度的评论会被截断
+subCommentLimit: 5
+
+# 次级评论嵌套深度，范围1 ~ 6 层
+subCommentDepth: 3
+
+# 评论图是否显示真实评论数量，关闭则显示解析到的评论数量
+realCommentCount: false
+
+# 是否收集评论区的图片
+commentImageCollection: true
+
+# 合辑 Live 图 BGM 合并模式
+# - 'continuous': 连续模式，BGM 接续播放
+# - 'independent': 独立模式，每张图 BGM 从头开始
+liveImageMergeMode: continuous
+
+# 解析时是否直接输出文本，关闭后渲染为图片
+textMode: false
+
+# 视频画质偏好设置，'adapt' 为自动根据「maxAutoVideoSize」大小选择，其他为固定画质
+# 可选值：'adapt'、'540p'、'720p'、'1080p'、'2k'、'4k'
+videoQuality: '4k'
+
+# 视频体积上限，自动画质模式下可接受的最大视频大小（单位：MB），仅在 「videoQuality」 为 'adapt' 时生效
+maxAutoVideoSize: 50
+
+# 谁可以触发扫码登录，all为所有人，admin为管理员，master为主人，group.owner为群主，group.admin为群管理员。修改后需重启
+loginPerm: master
+
+# 视频信息返回形式：
+# - 'text'(文本模式)
+# - 'image'(图片模式)
+videoInfoMode: 'image'
+
+# 视频信息的内容，可选值：'cover'(封面)、'title'(标题)、'author'(作者)、'stats'(视频统计信息)，数组为空则不显示任何内容
+displayContent: ['cover', 'title', 'author', 'stats']
+
+# 弹幕烧录（将弹幕硬编码到视频画面中，需要重新编码视频，耗时较长）
+burnDanmaku: false
+
+# 弹幕显示区域（限制弹幕范围，避免遮挡视频主体）
+# - 0.25: 1/4 屏，仅顶部区域
+# - 0.5: 半屏，上半部分（推荐）
+# - 0.75: 3/4 屏，大部分区域
+# - 1: 全屏，铺满整个画面
+danmakuArea: 0.5
+
+# 弹幕字号
+# - 'small': 小号
+# - 'medium': 中号（推荐）
+# - 'large': 大号
+danmakuFontSize: 'medium'
+
+# 弹幕透明度（0-100，0为完全透明，100为完全不透明，推荐70）
+danmakuOpacity: 70
+
+# 横屏转竖屏模式（针对横屏视频，抖音大多是竖屏，此选项主要用于横屏视频）
+# - 'off': 关闭，保持原始比例
+# - 'standard': 智能模式，仅对宽高比 ≥1.7 的横屏视频转竖屏
+# - 'force': 强制 9:16，所有视频统一转为竖屏
+verticalMode: 'off'
+
+# 视频编码格式
+# - 'h264': 兼容性最好，支持几乎所有设备
+# - 'h265': 压缩率更高，近几年设备支持良好（默认）
+# - 'av1': 最新编码格式，压缩率最高，但编码较慢
+videoCodec: 'h265'
+
+# 抖音推送相关配置
+push:
+  # 推送开关，开启后需重启；使用「#设置抖音推送 + 抖音号」配置推送列表
+  switch: true
+  # 谁可以设置推送，all为所有人，admin为管理员，master为主人，group.owner为群主，group.admin为群管理员。修改后需重启
+  permission: master
+  # 推送定时任务的cron表达式，默认为每十分钟推送一次
+  cron: '*/10 * * * *'
+  # 推送时是否一同解析该作品
+  parsedynamic: false
+  # 分享链接二维码的类型，web为跳转到抖音网页，download为视频下载直链
+  shareType: 'web'
+  # 推送解析时视频画质偏好设置，'adapt' 为自动根据「maxAutoVideoSize」大小选择，其他为固定画质
+  # 可选值：'adapt'、'540p'、'720p'、'1080p'、'2k'、'4k'
+  pushVideoQuality: '4k'
+
+  # 推送解析时视频体积上限，自动画质模式下可接受的最大视频大小（单位：MB），仅在 「videoQuality」 为 'adapt' 时生效
+  pushMaxAutoVideoSize: 50

package/config/default_config/kuaishou.yaml

@@ -0,0 +1,8 @@
+# 快手解析开关，单独开关，受「总开关」影响
+switch: true
+
+# 快手评论解析，发送快手作品评论图
+comment: true
+
+# 快手评论数量，范围1~30条
+numcomment: 5

package/config/default_config/pushlist.yaml

@@ -0,0 +1,37 @@
+# # 抖音推送列表
+# douyin:
+#   -
+#     # 抖音用户（可不填，执行推送时会自动填上）
+#     sec_uid:
+#     # 抖音号（必填）
+#     short_id:
+#     # 推送群号和机器人账号，多个则使用逗号隔开（必填，例子：[12345678:87654321, 11451419:88888888]，群号就是11451419，机器人账号就是88888888）
+#     group_id:
+#       - 1145141919810:8888888888
+#     # 这个博主的名字信息（可不填，执行推送时会自动填上）
+#     remark:
+#     # 推送类型（可选，默认为 [post]）
+#     # post: 作品列表
+#     # favorite: 喜欢列表
+#     # recommend: 推荐列表
+#     # live: 直播
+#     # 可以同时推送多种类型，例如：[post, favorite, live]
+#     pushTypes:
+#       - post
+
+# # B站推送列表
+# bilibili:
+#   -
+#     # B站用户（必填）
+#     host_mid:
+#     # 推送群号和机器人账号，多个则使用逗号隔开（必填，例子：[12345678:87654321, 11451419:88888888]，群号就是11451419，机器人账号就是88888888）
+#     group_id:
+#       - 1145141919810:8888888888
+#     # 这个UP主的名字信息（可不填，执行推送时会自动填上）
+#     remark:
+
+# 抖音推送列表
+douyin: []
+
+# B站推送列表
+bilibili: []

package/config/default_config/request.yaml

@@ -0,0 +1,22 @@
+# 请求超时时间，单位：毫秒
+timeout: 30000
+
+# 用户代理
+User-Agent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36'
+
+# 代理配置
+proxy:
+  # 是否启用代理
+  switch: false
+  # 代理服务器主机地址
+  host: ''
+  # 代理服务器端口
+  port: ''
+  # 代理协议类型(http/https)
+  protocol: 'http'
+  # 代理服务器认证信息
+  auth:
+    # 用户名
+    username: ''
+    # 密码
+    password: ''

package/config/default_config/upload.yaml

@@ -0,0 +1,50 @@
+# 本地视频发送方式，可选值：file / base64
+# file: 使用 file 协议发送本地视频（需 Karin 与协议端在同一系统）
+# base64: 转换为 base64 后发送（传输数据量增大约 30%，不在同一网络环境可能导致额外带宽成本，适合 karin 和协议端不在同一网络环境）
+videoSendMode: file
+
+# 视频上传拦截，开启后会根据解析的视频文件大小判断是否需要上传
+usefilelimit: false
+
+# 视频拦截阈值（填数字），视频文件大于该数值则不会上传 单位: MB，「视频文件上传限制」开启后才会生效
+filelimit: 20
+
+# 压缩视频，开启后会将视频文件压缩后再上传，适合上传大文件
+compress: false
+
+# 触发视频压缩的阈值，单位：MB。当文件大小超过该值时，才会压缩视频，「压缩视频」开启后才会生效
+compresstrigger: 80
+
+# 压缩后的值，若视频文件大小大于「触发视频压缩的阈值」的值，则会进行压缩至该值（±5%），「压缩视频」开启后才会生效
+compressvalue: 30
+
+# 使用文件上传，开启后会将视频文件上传到群文件中，私聊也行
+# 与「videoSendMode: base64」互斥（群文件上传仅支持 file 协议）
+usegroupfile: false
+
+# 群文件上传阈值，当文件大小超过该值时将使用群文件上传，单位：MB，「使用群文件上传」开启后才会生效
+groupfilevalue: 100
+
+# 网络图片发送方式，可选值：url / file / base64
+# url: 直接传递 HTTP 链接给上游下载（可能因上游网络问题导致下载超时）
+# file: 下载到本地使用 file 协议发送（需 Karin 与协议端在同一系统）
+# base64: 下载后转换为 base64 发送（传输数据量增大约 30%，不在同一网络环境可能导致额外带宽成本）
+imageSendMode: url
+
+# 下载限速开关，开启后会限制下载速度，避免触发服务器风控导致连接被重置（ECONNRESET）
+# 如果你的网络带宽很大且下载时经常报错"连接被重置"，建议开启此选项
+downloadThrottle: false
+
+# 下载速度限制，单位：MB/s，建议设置为 5-20 之间
+# 设置过高可能触发服务器风控，设置过低会影响下载体验
+# 仅在「下载限速开关」开启后生效
+downloadMaxSpeed: 10
+
+# 断流自动降速，当检测到连接被重置（ECONNRESET）时自动降低下载速度
+# 每次断流后速度会降低到当前的 60%，直到达到最低速度
+# 仅在「下载限速开关」开启后生效
+downloadAutoReduce: true
+
+# 最低下载速度，单位：MB/s，自动降速时不会低于此值
+# 仅在「下载限速开关」和「断流自动降速」都开启后生效
+downloadMinSpeed: 1

package/config/default_config/xiaohongshu.yaml

@@ -0,0 +1,23 @@
+# 小红书解析开关，单独开关，受「总开关」影响
+switch: true
+
+# 解析时发送的内容，可选值：'info'(笔记、视频信息)、'comment'(评论图片)、'image'(笔记图片)、'video'(视频文件)
+sendContent:
+  - 'info'
+  - 'comment'
+  - 'image'
+  - 'video'
+
+# 小红书评论数量（预留）
+numcomment: 10
+
+# 视频画质偏好设置，'adapt' 为自动根据「maxAutoVideoSize」大小选择，其他为固定画质
+#  - '540p': 540P 标清
+#  - '720p': 720P 高清
+#  - '1080p': 1080P 超清
+#  - '2k': 2K 超高清
+#  - '4k': 4K 超高清
+videoQuality: '4k'
+
+# 视频体积上限，自动画质模式下可接受的最大视频大小（单位：MB），仅在 「videoQuality」 为 'adapt' 时生效
+maxAutoVideoSize: 50

package/dist/index.js

@@ -0,0 +1 @@
+import{defineComponent as l,ref as u,onMounted as d,onUnmounted as p,h as f}from"vue";const h="kkk-console",r=64,k=28;function v(s){s.page({name:"kkk 配置",path:"/kkk-config",desc:"解析 / 面板 / 画质 / 图片切片等设置，改完直接生效",authority:4,icon:"activity:plugin",component:l({setup(){const n=u({}),t=()=>{const o=document.querySelector("nav.layout-activity"),i=document.querySelector("footer.layout-status"),c=o&&Math.round(o.getBoundingClientRect().right)||r,a=(i?Math.round(i.getBoundingClientRect().height):k)+8;n.value={position:"fixed",left:c+"px",top:"0px",width:"calc(100vw - "+c+"px)",height:"calc(100vh - "+a+"px)",border:"0",display:"block",background:"#fff",zIndex:"1"}};let e=null;return d(()=>{t(),e=setInterval(t,1e3),window.addEventListener("resize",t)}),p(()=>{e&&clearInterval(e),window.removeEventListener("resize",t)}),()=>f("iframe",{src:"/kkk",style:n.value})}})})}export{v as apply,h as name};

package/lib/compat/axios.js

@@ -0,0 +1,23 @@
+"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);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** `node-karin/axios` 的兼容实现：直接复用 axios */
+const axios_1 = __importDefault(require("axios"));
+__exportStar(require("axios"), exports);
+exports.default = axios_1.default;

package/lib/compat/cron.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cronMatcher = cronMatcher;
+exports.startScheduler = startScheduler;
+function parseField(field, min, max) {
+    if (field === '*' || field === '?')
+        return () => true;
+    const matchers = [];
+    for (const part of field.split(',')) {
+        const stepMatch = part.match(/^(\*|\d+(?:-\d+)?)\/(\d+)$/);
+        if (stepMatch) {
+            const step = Number(stepMatch[2]);
+            const [start, end] = stepMatch[1] === '*' ? [min, max] : stepMatch[1].split('-').map(Number);
+            matchers.push((value) => value >= start && value <= (end ?? start) && (value - start) % step === 0);
+            continue;
+        }
+        const rangeMatch = part.match(/^(\d+)-(\d+)$/);
+        if (rangeMatch) {
+            const start = Number(rangeMatch[1]);
+            const end = Number(rangeMatch[2]);
+            matchers.push((value) => value >= start && value <= end);
+            continue;
+        }
+        const num = Number(part);
+        if (!Number.isNaN(num))
+            matchers.push((value) => value === num);
+    }
+    if (!matchers.length)
+        return () => true;
+    return (value) => matchers.some((matcher) => matcher(value));
+}
+function cronMatcher(expression) {
+    const fields = expression.trim().split(/\s+/);
+    if (fields.length < 5)
+        return () => false;
+    const [minute, hour, day, month, week] = fields;
+    const matchMinute = parseField(minute, 0, 59);
+    const matchHour = parseField(hour, 0, 23);
+    const matchDay = parseField(day, 1, 31);
+    const matchMonth = parseField(month, 1, 12);
+    const matchWeek = parseField(week, 0, 6);
+    return (date) => matchMinute(date.getMinutes())
+        && matchHour(date.getHours())
+        && matchDay(date.getDate())
+        && matchMonth(date.getMonth() + 1)
+        && matchWeek(date.getDay());
+}
+function startScheduler(ctx, logger, tasks) {
+    if (!tasks.length)
+        return;
+    const entries = tasks.map((task) => ({ task, match: cronMatcher(task.cron), running: false, lastKey: '' }));
+    for (const entry of entries) {
+        logger.info('注册定时任务 %s（%s）', entry.task.name, entry.task.cron);
+    }
+    const tick = async () => {
+        const now = new Date();
+        const key = now.toISOString().slice(0, 16);
+        for (const entry of entries) {
+            if (entry.lastKey === key)
+                continue;
+            if (!entry.match(now))
+                continue;
+            entry.lastKey = key;
+            if (entry.running) {
+                logger.warn('任务 %s 上一轮尚未结束，跳过本次触发', entry.task.name);
+                continue;
+            }
+            entry.running = true;
+            Promise.resolve()
+                .then(() => entry.task.handler())
+                .catch((error) => logger.error('任务 %s 执行失败: %s', entry.task.name, error?.stack ?? error))
+                .finally(() => { entry.running = false; });
+        }
+    };
+    ctx.setInterval(tick, 30 * 1000);
+    void tick();
+}

package/lib/compat/esm.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.importEsm = importEsm;
+/**
+ * 真实动态 import 的逃生舱。
+ *
+ * tsc 在 `module: commonjs` 下会把 `await import('x')` 降级成 `Promise.resolve().then(() => require('x'))`，
+ * 于是 ESM-only 的依赖（例如 `@ikenxuan/qrcode` 的 exports 没有 require 条件）依旧加载不了。
+ * 这里用 `new Function` 包一层，绕开编译期改写，运行时由 Node 走真正的 ESM 加载。
+ */
+function importEsm(specifier) {
+    const importer = new Function('specifier', 'return import(specifier)');
+    return importer(specifier);
+}
+exports.default = importEsm;

package/lib/compat/express.js

@@ -0,0 +1,23 @@
+"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);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/** `node-karin/express` 的兼容实现：复用 express */
+const express_1 = __importDefault(require("express"));
+__exportStar(require("express"), exports);
+exports.default = express_1.default;

package/lib/compat/heroui.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Button = exports.Chip = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const join = (...parts) => parts.filter(Boolean).join(' ');
+/** 对应 HeroUI 的 Chip（标签/徽章） */
+const Chip = ({ size = 'md', color, variant, className, style, children, ...rest }) => ((0, jsx_runtime_1.jsx)("span", { className: join('inline-flex items-center justify-center rounded-full leading-none', className), style: style, "data-color": color, "data-variant": variant, "data-size": size, ...rest, children: children }));
+exports.Chip = Chip;
+/** 对应 HeroUI 的 Button（静态海报里就是一块按钮样式的容器） */
+const Button = ({ size = 'md', color, variant, className, style, children, ...rest }) => ((0, jsx_runtime_1.jsx)("span", { className: join('inline-flex items-center justify-center gap-2 rounded-xl font-medium', className), style: style, "data-color": color, "data-variant": variant, "data-size": size, ...rest, children: children }));
+exports.Button = Button;
+exports.default = { Chip: exports.Chip, Button: exports.Button };

package/lib/compat/lodash.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * \`node-karin/lodash\` 的兼容实现。
+ *
+ * 上游只有一个模板用到它，且只用了 \`camelCase\` / \`upperFirst\` 两个纯函数，
+ * 因此这里不引入 lodash 全量依赖，直接实现同语义的小函数（并保留 lodash 的默认导出形态）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.camelCase = camelCase;
+exports.upperFirst = upperFirst;
+/** lodash 的 camelCase：\`'QQ Bot' -> 'qqBot'\` */
+function camelCase(input) {
+    const words = String(input ?? '')
+        .replace(/['\u2019]/g, '')
+        .replace(/([a-z\d])([A-Z])/g, '$1 $2')
+        .replace(/[^a-zA-Z0-9]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+    return words
+        .map((word, index) => {
+        const lower = word.toLowerCase();
+        return index === 0 ? lower : lower.charAt(0).toUpperCase() + lower.slice(1);
+    })
+        .join('');
+}
+/** lodash 的 upperFirst：只把首字母大写 */
+function upperFirst(input) {
+    const text = String(input ?? '');
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+const lodash = { camelCase, upperFirst };
+exports.default = lodash;

package/lib/compat/logger.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.setLogger = setLogger;
+/** karin `logger` 的 Koishi 兼容实现：保留 mark/彩色包装等调用习惯 */
+const node_util_1 = require("node:util");
+const runtime_1 = require("./runtime");
+let koishiLogger = null;
+function setLogger(logger) {
+    koishiLogger = logger;
+}
+function getLogger() {
+    if (koishiLogger)
+        return koishiLogger;
+    const runtime = (0, runtime_1.tryGetRuntime)();
+    if (!runtime)
+        return null;
+    koishiLogger = runtime.ctx.logger('kkk');
+    return koishiLogger;
+}
+const safeFormat = (args) => {
+    try {
+        return (0, node_util_1.format)(...args);
+    }
+    catch {
+        return args.map((item) => (typeof item === 'string' ? item : String(item))).join(' ');
+    }
+};
+const wrap = (code) => (input) => `\u001b[${code}m${input}\u001b[0m`;
+const chalkFn = new Proxy(function () { }, {
+    get(_target, prop) {
+        if (prop === 'rgb')
+            return (r, g, b) => (input) => `\u001b[38;2;${r};${g};${b}m${input}\u001b[0m`;
+        if (prop === 'hex')
+            return (_hex) => (input) => String(input);
+        if (prop === 'bold')
+            return wrap(1);
+        return wrap(36);
+    },
+    apply(_target, _this, args) {
+        return String(args[0] ?? '');
+    }
+});
+/** karin 的 logger.runContext 会捕获一段代码里产生的日志，错误处理海报要读这段日志 */
+const captureStack = [];
+/** Karin 的日志级别是 4 字母缩写，错误诊断海报按这个格式解析 */
+const KARIN_LEVEL = {
+    debug: 'DEBU',
+    trace: 'TRAC',
+    info: 'INFO',
+    mark: 'MARK',
+    warn: 'WARN',
+    error: 'ERRO',
+    fatal: 'FATA'
+};
+const stamp = () => {
+    const now = new Date();
+    const pad = (value, size = 2) => String(value).padStart(size, '0');
+    return pad(now.getHours()) + ':' + pad(now.getMinutes()) + ':' + pad(now.getSeconds()) + '.' + pad(now.getMilliseconds(), 3);
+};
+const emit = (level, args) => {
+    const logger = getLogger();
+    const message = safeFormat(args);
+    const capture = captureStack[captureStack.length - 1];
+    if (capture)
+        capture.push('[' + stamp() + '][' + (KARIN_LEVEL[level] ?? 'INFO') + '] ' + message);
+    if (!logger) {
+        // 兼容层未初始化时退化到 stdout，避免丢日志
+        // eslint-disable-next-line no-console
+        console[level === 'debug' ? 'log' : level]('[kkk] ' + message);
+        return;
+    }
+    // 插件配置里打开 debug 时，把 karin 的 debug 日志提升为 info，避免被 Koishi 默认日志级别吞掉
+    const effective = level === 'debug' && (0, runtime_1.tryGetRuntime)()?.config?.debug ? 'info' : level;
+    if (effective === 'debug') {
+        logger.debug(message);
+        return;
+    }
+    logger[effective](message);
+};
+exports.logger = {
+    debug: (...args) => emit('debug', args),
+    trace: (...args) => emit('debug', args),
+    info: (...args) => emit('info', args),
+    mark: (...args) => emit('info', args),
+    warn: (...args) => emit('warn', args),
+    error: (...args) => emit('error', args),
+    fatal: (...args) => emit('error', args),
+    /**
+     * 移植代码用法：`const ctx = logger.runContext(fn); await ctx.run(); ctx.logs()`
+     */
+    runContext: (fn) => {
+        const buffer = [];
+        return {
+            run: async () => {
+                captureStack.push(buffer);
+                try {
+                    return await fn();
+                }
+                finally {
+                    captureStack.pop();
+                }
+            },
+            // Karin 的 logs() 返回字符串数组：['[12:00:00.000][INFO] xxx', ...]
+            logs: () => [...buffer]
+        };
+    },
+    green: wrap(32),
+    yellow: wrap(33),
+    blue: wrap(34),
+    red: wrap(31),
+    cyan: wrap(36),
+    violet: wrap(35),
+    chalk: chalkFn,
+    /** karin 的 logger 支持自定义前缀创建 */
+    createLogger: () => exports.logger
+};
+exports.default = exports.logger;