koishi-plugin-sky-blessing 0.2.2

package/lib/api.d.ts

@@ -0,0 +1,27 @@
+import { Context } from 'koishi';
+import { BlessingResult, PluginConfig, ParamMapping } from './types';
+import { SkyLogger } from './logger';
+export declare class BlessingAPI {
+    private ctx;
+    private config;
+    private logger;
+    constructor(ctx: Context, // 📡 Koishi 上下文
+    config: PluginConfig);
+    /**
+     * 设置日志器实例
+     */
+    setLogger(logger: SkyLogger): void;
+    /**
+     * 🔄 根据映射配置解析参数值
+     * ⚠️ 重复的 key 只有第一个启用的生效
+     */
+    resolveParams(mappings: ParamMapping[], session: any): Record<string, string>;
+    /**
+     * 📡 调用 /blessing 端点
+     */
+    fetchBlessing(type: 'image' | 'json' | 'json_without_image', params?: Record<string, string>): Promise<BlessingResult | Buffer>;
+    /**
+     * 🔄 将 buffer 转为 base64 data URI 格式
+     */
+    toBase64Image(buffer: Buffer): string;
+}

package/lib/commands/image.d.ts

@@ -0,0 +1,5 @@
+import { Context } from 'koishi';
+import { PluginConfig } from '../types';
+import { BlessingAPI } from '../api';
+import { SkyLogger } from '../logger';
+export declare function registerImageCommand(ctx: Context, config: PluginConfig, api: BlessingAPI, logger: SkyLogger): void;

package/lib/commands/qq-markdown.d.ts

@@ -0,0 +1,5 @@
+import { Context } from 'koishi';
+import { PluginConfig } from '../types';
+import { BlessingAPI } from '../api';
+import { SkyLogger } from '../logger';
+export declare function registerQQMarkdownCommand(ctx: Context, config: PluginConfig, api: BlessingAPI, logger: SkyLogger): void;

package/lib/commands/text.d.ts

@@ -0,0 +1,5 @@
+import { Context } from 'koishi';
+import { PluginConfig } from '../types';
+import { BlessingAPI } from '../api';
+import { SkyLogger } from '../logger';
+export declare function registerTextCommand(ctx: Context, config: PluginConfig, api: BlessingAPI, logger: SkyLogger): void;

package/lib/config.d.ts

@@ -0,0 +1,3 @@
+import { Schema } from 'koishi';
+import { PluginConfig } from './types';
+export declare const ConfigSchema: Schema<PluginConfig>;

package/lib/index.d.ts

@@ -0,0 +1,15 @@
+import { Context } from 'koishi';
+import { PluginConfig } from './types';
+import { SkyLogger } from './logger';
+export declare const name = "sky-blessing";
+export declare const usage = "\n<h1>Koishi \u63D2\u4EF6\uFF1Asky-blessing \u5149\u9047\u7948\u798F\u7B7E</h1>\n<h2>\uD83C\uDFAF \u529F\u80FD\u7B80\u4ECB</h2>\n<p>\u968F\u673A\u751F\u6210\u5149\u9047\u7948\u798F\u7B7E\u56FE\u7247\u7684 Koishi \u63D2\u4EF6\uFF0C\u652F\u6301\u4E09\u79CD\u8F93\u51FA\u6A21\u5F0F\uFF1A</p>\n<ul>\n  <li>\uD83D\uDDBC\uFE0F <b>\u5149\u9047\u62BD\u7B7E\u56FE</b> - \u4EC5\u53D1\u9001\u7948\u798F\u7B7E\u56FE\u7247</li>\n  <li>\uD83D\uDCDC <b>\u5149\u9047\u62BD\u7B7E</b> - \u53D1\u9001\u56FE\u7247 + \u6587\u5B57\u5185\u5BB9\uFF08\u8FD0\u52BF\u7B49\u7EA7\u3001\u7ED3\u7F18\u7269\u3001\u7F18\u5F69\u3001\u795D\u798F\u8BED\u7B49\uFF09</li>\n  <li>\uD83D\uDCDD <b>\u5149\u9047\u62BD\u7B7Emd</b> - \u53D1\u9001\u56FE\u7247 + Markdown\u683C\u5F0F\uFF08\uD83D\uDCA1 \u4EC5\u9650 QQ \u5E73\u53F0\u53EF\u7528\uFF09</li>\n</ul>\n\n<h2>\uD83D\uDCAC \u4EA4\u6D41\u7FA4\u7EC4</h2>\n<p><del>\uD83D\uDCAC \u63D2\u4EF6\u4F7F\u7528\u95EE\u9898 / \uD83D\uDC1B Bug\u53CD\u9988 / \uD83D\uDC68\u200D \u63D2\u4EF6\u5F00\u53D1\u4EA4\u6D41\uFF0C\u6B22\u8FCE\u52A0\u5165QQ\u7FA4\uFF1A<b>259248174</b> \uD83C\uDF89\uFF08\u8FD9\u4E2A\u7FA4G\u4E86\uFF09</del></p>\n<p>\uD83D\uDCAC \u63D2\u4EF6\u4F7F\u7528\u95EE\u9898 / \uD83D\uDC1B Bug\u53CD\u9988 / \uD83D\uDC68\u200D\uD83D\uDCBB \u63D2\u4EF6\u5F00\u53D1\u4EA4\u6D41\uFF0C\u6B22\u8FCE\u52A0\u5165\u65B0QQ\u7FA4\uFF1A<b>1085190201</b> \uD83C\uDF89</p>\n<p>\uD83D\uDCA1 \u5728\u7FA4\u91CC\u76F4\u63A5\u827E\u7279\u6211\uFF0C\u56DE\u590D\u7684\u66F4\u5FEB\u54E6~ \u2728</p>\n\n<hr>\n\n<h3 style=\"color: #e74c3c;\">\u2699\uFE0F \u524D\u7F6E\u4F9D\u8D56</h3>\n<p>\u672C\u63D2\u4EF6\u9700\u8981\u4EE5\u4E0B\u4F9D\u8D56\u624D\u80FD\u6B63\u5E38\u5DE5\u4F5C\uFF1A</p>\n<ul>\n  <li><b style=\"color: #e74c3c;\">http</b> - Koishi \u5185\u7F6E\u670D\u52A1\uFF0C\u7528\u4E8EHTTP\u8BF7\u6C42\u540E\u7AEFAPI <span style=\"color: #e74c3c;\">\u3010\u5FC5\u987B\u3011</span></li>\n</ul>\n\n<h3 style=\"color: #3498db;\">\uD83D\uDD17 \u540E\u7AEF\u670D\u52A1</h3>\n<p>\u672C\u63D2\u4EF6\u9700\u8981\u914D\u5408\u540E\u7AEF\u670D\u52A1\u4F7F\u7528\uFF0C\u8BF7\u5148\u90E8\u7F72\u540E\u7AEF\uFF1A</p>\n<ul>\n  <li><a href=\"https://github.com/VincentZyuApps/skyblessings-fastapi-pillow\">GitHub \u540E\u7AEF\u4ED3\u5E93</a></li>\n  <li><a href=\"https://gitee.com/vincent-zyu/skyblessings-fastapi-pillow\">Gitee \u540E\u7AEF\u4ED3\u5E93</a></li>\n</ul>\n<p>\u90E8\u7F72\u5B8C\u6210\u540E\uFF0C\u5728\u63D2\u4EF6\u914D\u7F6E\u4E2D\u586B\u5199 <code>backendUrl</code> \u4E3A\u540E\u7AEF\u670D\u52A1\u5730\u5740\u3002</p>\n\n<h3 style=\"color: #2ecc71;\">\uD83C\uDFAE \u547D\u4EE4\u5217\u8868</h3>\n<table border=\"1\" cellpadding=\"5\" cellspacing=\"0\">\n  <tr>\n    <th>\u547D\u4EE4</th>\n    <th>\u63CF\u8FF0</th>\n    <th>\u5E73\u53F0\u9650\u5236</th>\n  </tr>\n  <tr>\n    <td><code>\u5149\u9047\u62BD\u7B7E\u56FE</code></td>\n    <td>\u83B7\u53D6\u7948\u798F\u7B7E\u56FE\u7247</td>\n    <td>\u65E0</td>\n  </tr>\n  <tr>\n    <td><code>\u5149\u9047\u62BD\u7B7E</code></td>\n    <td>\u83B7\u53D6\u7948\u798F\u7B7E\u56FE\u7247 + \u6587\u5B57\u8BE6\u60C5</td>\n    <td>\u65E0</td>\n  </tr>\n  <tr>\n    <td><code>\u5149\u9047\u62BD\u7B7Emd</code></td>\n    <td>\u83B7\u53D6\u7948\u798F\u7B7E\u56FE\u7247 + Markdown\u683C\u5F0F</td>\n    <td>\u4EC5QQ\u5E73\u53F0</td>\n  </tr>\n</table>\n\n<h3 style=\"color: #f39c12;\">\u2699\uFE0F \u53C2\u6570\u6620\u5C04\u8BF4\u660E</h3>\n<p>\u53EF\u901A\u8FC7\u914D\u7F6E\u5C06 a~e \u4E94\u4E2A\u53C2\u6570\u952E\u6620\u5C04\u5230\u4E0D\u540C\u7684\u4F1A\u8BDD\u4FE1\u606F\uFF0C\u7528\u4E8E\u6784\u5EFA\u540E\u7AEF\u8BF7\u6C42\u7684\u79CD\u5B50\uFF1A</p>\n<ul>\n  <li>\uD83C\uDF10 <b>platform</b> - \u5E73\u53F0\u540D\u79F0\uFF08\u5982 onebot\u3001discord\uFF09</li>\n  <li>\uD83C\uDD94 <b>userid</b> - \u7528\u6237ID</li>\n  <li>\uD83D\uDCC5 <b>date</b> - \u5F53\u524D\u65E5\u671F\uFF08YYYY-MM-DD\uFF09</li>\n  <li>\uD83D\uDC64 <b>nickname</b> - \u7528\u6237\u6635\u79F0</li>\n  <li>\uD83D\uDDBC\uFE0F <b>avatar_hash</b> - \u5934\u50CFMD5\u54C8\u5E0C\u503C</li>\n</ul>\n<p>\u9ED8\u8BA4\u914D\u7F6E\uFF1Aabc \u542F\u7528\uFF0Cde \u7981\u7528\u3002\u91CD\u590D\u7684 key \u53EA\u6709\u7B2C\u4E00\u4E2A\u542F\u7528\u7684\u4F1A\u751F\u6548\u3002</p>\n\n<h3 style=\"color: #9b59b6;\">\uD83D\uDCCA \u8FD4\u56DE\u5B57\u6BB5\u8BF4\u660E</h3>\n<ul>\n  <li><b>fortune_level</b> - \u8FD0\u52BF\u7B49\u7EA7\uFF08\u5982\uFF1A\u5927\u5409\u3001\u4E2D\u5409\u3001\u5C0F\u5409\uFF09</li>\n  <li><b>dordas</b> - \u7ED3\u7F18\u7269\uFF08\u5982\uFF1A\u7ED3\u7F18\u7269\uFF1A\u9065\u9CB2\uFF09</li>\n  <li><b>dordas_color</b> - \u7F18\u5F69\uFF08\u5982\uFF1A\u7F18\u5F69\uFF1A\u68A7\u679D\u7EFF\uFF09</li>\n  <li><b>color_hex</b> - \u989C\u8272\u5341\u516D\u8FDB\u5236\u503C\uFF08\u5982\uFF1A#4fd69e\uFF09</li>\n  <li><b>blessing</b> - \u795D\u798F\u8BED</li>\n  <li><b>entry</b> - \u5B9C\u5FCC\u63D0\u793A\uFF08\u5982\uFF1A\u5FCC\uFF1A\u4E00\u610F\u5B64\u884C\uFF09</li>\n</ul>\n";
+export declare const inject: {
+    required: string[];
+};
+export declare const reusable = true;
+export declare const Config: import("schemastery")<PluginConfig>;
+export declare function apply(ctx: Context, config: PluginConfig): void;
+/**
+ * 获取全局 logger 实例
+ */
+export declare function getLogger(): SkyLogger | null;

package/lib/index.js

@@ -0,0 +1,499 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name2 in all)
+    __defProp(target, name2, { get: all[name2], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Config: () => Config,
+  apply: () => apply,
+  getLogger: () => getLogger,
+  inject: () => inject,
+  name: () => name,
+  reusable: () => reusable,
+  usage: () => usage
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/config.ts
+var import_koishi = require("koishi");
+var PARAM_KEY_OPTIONS = ["a", "b", "c", "d", "e"];
+var PARAM_VALUE_LABELS = [
+  { label: "🌐 平台 (platform)", value: "platform" },
+  { label: "🆔 用户ID (userid)", value: "userid" },
+  { label: "📅 日期 (date)", value: "date" },
+  { label: "👤 昵称 (nickname)", value: "nickname" },
+  { label: "🖼️ 头像哈希 (avatar_hash)", value: "avatar_hash" }
+];
+var DEFAULT_MAPPINGS = [
+  { enabled: true, key: "a", value: "platform" },
+  { enabled: true, key: "b", value: "userid" },
+  { enabled: true, key: "c", value: "date" },
+  { enabled: false, key: "d", value: "nickname" },
+  { enabled: false, key: "e", value: "avatar_hash" }
+];
+var LOG_LEVEL_OPTIONS = ["silent", "error", "warn", "info", "debug"];
+var ConfigSchema = import_koishi.Schema.intersect([
+  // 🔧 命令名称设置
+  import_koishi.Schema.object({
+    commandNames: import_koishi.Schema.object({
+      image: import_koishi.Schema.string().default("光遇抽签图").description("🖼️ 仅发送图片的命令名称"),
+      text: import_koishi.Schema.string().default("光遇抽签").description("📜 发送图片 + 文字内容的命令名称"),
+      qqMarkdown: import_koishi.Schema.string().default("光遇抽签md").description("📝 发送图片 + Markdown 格式的命令名称（💡 仅限 QQ 平台可用）")
+    }).description("⚙️ 命令名称设置")
+  }).description("⚙️ 命令设置"),
+  // 🌐 后端连接设置
+  import_koishi.Schema.object({
+    backendUrl: import_koishi.Schema.string().default("http://127.0.0.1:51205").description("🔗 后端服务地址\n\n💡 可以去这里部署后端: `https://gitee.com/vincent-zyu/skyblessings-fastapi-pillow`"),
+    sendBase64: import_koishi.Schema.boolean().default(false).description("🖼️ 是否将图片 Base64 编码后发送（关闭则发送 URL 链接）"),
+    enableQuote: import_koishi.Schema.boolean().default(true).description("💬 开启后，本插件发送的所有消息都会引用（回复）触发指令的消息"),
+    qqMarkdownSendImage: import_koishi.Schema.boolean().default(true).description("🖼️ 「光遇抽签md」命令是否同时发送图片（关闭则仅发送 Markdown 文本）")
+  }).description("🌐 后端设置"),
+  // 📊 参数映射表设置
+  import_koishi.Schema.object({
+    paramMappings: import_koishi.Schema.array(import_koishi.Schema.object({
+      enabled: import_koishi.Schema.boolean().default(true).description("✅ 是否启用此行"),
+      key: import_koishi.Schema.union(PARAM_KEY_OPTIONS).role("radio").description("🔑 参数键名（a ~ e 五选一）"),
+      value: import_koishi.Schema.union(PARAM_VALUE_LABELS.map((o) => o.value)).role("radio").description("📦 参数值来源字段")
+    })).role("table").default(DEFAULT_MAPPINGS).description("📋 参数映射表：将 a~e 映射到平台/用户ID/日期等。\n\n⚠️ 重复的 key 只有第一个启用的会生效哦，未启用的行会被自动忽略~")
+  }).description("📊 参数映射设置"),
+  // 🔧 调试设置
+  import_koishi.Schema.object({
+    logLevel: import_koishi.Schema.union(LOG_LEVEL_OPTIONS).role("radio").default("info").description("🔊 插件日志级别：silent（静默）/ error（仅错误）/ warn（警告+错误）/ info（常规信息）/ debug（详细调试）")
+  }).description("🔧 调试设置")
+]);
+
+// src/types.ts
+var USAGE = `
+<h1>Koishi 插件：sky-blessing 光遇祈福签</h1>
+<h2>🎯 功能简介</h2>
+<p>随机生成光遇祈福签图片的 Koishi 插件，支持三种输出模式：</p>
+<ul>
+  <li>🖼️ <b>光遇抽签图</b> - 仅发送祈福签图片</li>
+  <li>📜 <b>光遇抽签</b> - 发送图片 + 文字内容（运势等级、结缘物、缘彩、祝福语等）</li>
+  <li>📝 <b>光遇抽签md</b> - 发送图片 + Markdown格式（💡 仅限 QQ 平台可用）</li>
+</ul>
+
+<h2>💬 交流群组</h2>
+<p><del>💬 插件使用问题 / 🐛 Bug反馈 / 👨‍ 插件开发交流，欢迎加入QQ群：<b>259248174</b> 🎉（这个群G了）</del></p>
+<p>💬 插件使用问题 / 🐛 Bug反馈 / 👨‍💻 插件开发交流，欢迎加入新QQ群：<b>1085190201</b> 🎉</p>
+<p>💡 在群里直接艾特我，回复的更快哦~ ✨</p>
+
+<hr>
+
+<h3 style="color: #e74c3c;">⚙️ 前置依赖</h3>
+<p>本插件需要以下依赖才能正常工作：</p>
+<ul>
+  <li><b style="color: #e74c3c;">http</b> - Koishi 内置服务，用于HTTP请求后端API <span style="color: #e74c3c;">【必须】</span></li>
+</ul>
+
+<h3 style="color: #3498db;">🔗 后端服务</h3>
+<p>本插件需要配合后端服务使用，请先部署后端：</p>
+<ul>
+  <li><a href="https://github.com/VincentZyuApps/skyblessings-fastapi-pillow">GitHub 后端仓库</a></li>
+  <li><a href="https://gitee.com/vincent-zyu/skyblessings-fastapi-pillow">Gitee 后端仓库</a></li>
+</ul>
+<p>部署完成后，在插件配置中填写 <code>backendUrl</code> 为后端服务地址。</p>
+
+<h3 style="color: #2ecc71;">🎮 命令列表</h3>
+<table border="1" cellpadding="5" cellspacing="0">
+  <tr>
+    <th>命令</th>
+    <th>描述</th>
+    <th>平台限制</th>
+  </tr>
+  <tr>
+    <td><code>光遇抽签图</code></td>
+    <td>获取祈福签图片</td>
+    <td>无</td>
+  </tr>
+  <tr>
+    <td><code>光遇抽签</code></td>
+    <td>获取祈福签图片 + 文字详情</td>
+    <td>无</td>
+  </tr>
+  <tr>
+    <td><code>光遇抽签md</code></td>
+    <td>获取祈福签图片 + Markdown格式</td>
+    <td>仅QQ平台</td>
+  </tr>
+</table>
+
+<h3 style="color: #f39c12;">⚙️ 参数映射说明</h3>
+<p>可通过配置将 a~e 五个参数键映射到不同的会话信息，用于构建后端请求的种子：</p>
+<ul>
+  <li>🌐 <b>platform</b> - 平台名称（如 onebot、discord）</li>
+  <li>🆔 <b>userid</b> - 用户ID</li>
+  <li>📅 <b>date</b> - 当前日期（YYYY-MM-DD）</li>
+  <li>👤 <b>nickname</b> - 用户昵称</li>
+  <li>🖼️ <b>avatar_hash</b> - 头像MD5哈希值</li>
+</ul>
+<p>默认配置：abc 启用，de 禁用。重复的 key 只有第一个启用的会生效。</p>
+
+<h3 style="color: #9b59b6;">📊 返回字段说明</h3>
+<ul>
+  <li><b>fortune_level</b> - 运势等级（如：大吉、中吉、小吉）</li>
+  <li><b>dordas</b> - 结缘物（如：结缘物：遥鲲）</li>
+  <li><b>dordas_color</b> - 缘彩（如：缘彩：梧枝绿）</li>
+  <li><b>color_hex</b> - 颜色十六进制值（如：#4fd69e）</li>
+  <li><b>blessing</b> - 祝福语</li>
+  <li><b>entry</b> - 宜忌提示（如：忌：一意孤行）</li>
+</ul>
+`;
+
+// src/logger.ts
+var LOG_LEVELS = {
+  silent: 0,
+  error: 1,
+  warn: 2,
+  info: 3,
+  debug: 4
+};
+var SkyLogger = class {
+  constructor(ctx, config) {
+    this.ctx = ctx;
+    this.level = LOG_LEVELS[config.logLevel] ?? LOG_LEVELS.info;
+  }
+  static {
+    __name(this, "SkyLogger");
+  }
+  level;
+  /**
+   * 更新日志级别
+   */
+  setLevel(level) {
+    this.level = LOG_LEVELS[level] ?? LOG_LEVELS.info;
+  }
+  /**
+   * 🔇 静默级别 - 不输出任何日志
+   */
+  silent(_message, ..._args) {
+  }
+  /**
+   * ❌ 错误级别
+   */
+  error(message, ...args) {
+    if (this.level >= LOG_LEVELS.error) {
+      this.ctx.logger.error(message, ...args);
+    }
+  }
+  /**
+   * ⚠️ 警告级别
+   */
+  warn(message, ...args) {
+    if (this.level >= LOG_LEVELS.warn) {
+      this.ctx.logger.warn(message, ...args);
+    }
+  }
+  /**
+   * ℹ️ 信息级别
+   */
+  info(message, ...args) {
+    if (this.level >= LOG_LEVELS.info) {
+      this.ctx.logger.info(message, ...args);
+    }
+  }
+  /**
+   * 🐛 调试级别
+   */
+  debug(message, ...args) {
+    if (this.level >= LOG_LEVELS.debug) {
+      this.ctx.logger.info(`[DEBUG] ${message}`, ...args);
+    }
+  }
+};
+function createLogger(ctx, config) {
+  return new SkyLogger(ctx, config);
+}
+__name(createLogger, "createLogger");
+
+// src/api.ts
+var crypto = __toESM(require("crypto"));
+var BlessingAPI = class {
+  constructor(ctx, config) {
+    this.ctx = ctx;
+    this.config = config;
+    this.logger = null;
+  }
+  static {
+    __name(this, "BlessingAPI");
+  }
+  logger;
+  /**
+   * 设置日志器实例
+   */
+  setLogger(logger) {
+    this.logger = logger;
+  }
+  /**
+   * 🔄 根据映射配置解析参数值
+   * ⚠️ 重复的 key 只有第一个启用的生效
+   */
+  resolveParams(mappings, session) {
+    const params = {};
+    const seenKeys = /* @__PURE__ */ new Set();
+    this.logger.info(`[BlessingAPI] 🔍 resolveParams: ${mappings.length} 条映射, session.platform=${session.platform}, userId=${session.userId}`);
+    for (const mapping of mappings) {
+      if (!mapping.enabled || seenKeys.has(mapping.key)) {
+        this.logger.info(`[BlessingAPI] ⏭️ 跳过 key=${mapping.key} (enabled=${mapping.enabled}, seen=${seenKeys.has(mapping.key)})`);
+        continue;
+      }
+      seenKeys.add(mapping.key);
+      switch (mapping.value) {
+        case "platform":
+          params[mapping.key] = session.platform ?? "";
+          this.logger.info(`[BlessingAPI] 🌐 ${mapping.key}=platform -> "${params[mapping.key]}"`);
+          break;
+        case "userid":
+          params[mapping.key] = String(session.userId ?? "");
+          this.logger.info(`[BlessingAPI] 🆔 ${mapping.key}=userid -> "${params[mapping.key]}"`);
+          break;
+        case "date":
+          params[mapping.key] = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+          this.logger.info(`[BlessingAPI] 📅 ${mapping.key}=date -> "${params[mapping.key]}"`);
+          break;
+        case "nickname":
+          params[mapping.key] = session.username ?? "";
+          this.logger.info(`[BlessingAPI] 👤 ${mapping.key}=nickname -> "${params[mapping.key]}"`);
+          break;
+        case "avatar_hash":
+          params[mapping.key] = session.avatar ? crypto.createHash("md5").update(session.avatar).digest("hex") : "";
+          this.logger.info(`[BlessingAPI] 🖼️ ${mapping.key}=avatar_hash -> "${params[mapping.key].substring(0, 8)}..."`);
+          break;
+      }
+    }
+    this.logger.info(`[BlessingAPI] ✅ 最终参数: ${JSON.stringify(params)}`);
+    return params;
+  }
+  /**
+   * 📡 调用 /blessing 端点
+   */
+  async fetchBlessing(type, params = {}) {
+    const url = `${this.config.backendUrl}/blessing`;
+    this.logger.info(`[BlessingAPI] 🚀 fetchBlessing type=${type} url=${url}`);
+    if (type === "image") {
+      const response = await this.ctx.http.get(url, {
+        responseType: "arraybuffer",
+        params: { type, ...params }
+      });
+      const buf = Buffer.from(response);
+      this.logger.info(`[BlessingAPI] 🖼️ 图片响应: ${buf.length} bytes`);
+      return buf;
+    }
+    const data = await this.ctx.http.get(url, {
+      params: { type, ...params }
+    });
+    this.logger.info(`[BlessingAPI] 📄 JSON响应: fortune_level=${data.fortune_level}`);
+    return data;
+  }
+  /**
+   * 🔄 将 buffer 转为 base64 data URI 格式
+   */
+  toBase64Image(buffer) {
+    return `data:image/png;base64,${buffer.toString("base64")}`;
+  }
+};
+
+// src/commands/image.ts
+var import_koishi2 = require("koishi");
+function registerImageCommand(ctx, config, api, logger) {
+  ctx.command(config.commandNames.image).action(async ({ session }) => {
+    logger.info(`[光遇抽签图] 🎯 命令触发, userId=${session.userId}, platform=${session.platform}`);
+    logger.info(`[光遇抽签图] ⚙️ 配置: backendUrl=${config.backendUrl}, sendBase64=${config.sendBase64}`);
+    logger.info(`[光遇抽签图] 📋 paramMappings: ${JSON.stringify(config.paramMappings)}`);
+    try {
+      const params = api.resolveParams(config.paramMappings, session);
+      logger.info(`[光遇抽签图] ✅ 解析参数: ${JSON.stringify(params)}`);
+      const imageBuffer = await api.fetchBlessing("image", params);
+      logger.info(`[光遇抽签图] 🖼️ 图片接收成功, 大小=${imageBuffer.length} bytes`);
+      let message;
+      if (config.sendBase64) {
+        message = (0, import_koishi2.h)("image", { url: api.toBase64Image(imageBuffer) });
+      } else {
+        const url = `${config.backendUrl}/blessing?type=image&${new URLSearchParams(params)}`;
+        logger.info(`[光遇抽签图] 🔗 图片URL: ${url}`);
+        message = import_koishi2.h.image(url);
+      }
+      logger.info(`[光遇抽签图] 📤 发送消息中...`);
+      const quotePart = config.enableQuote ? import_koishi2.h.quote(session.messageId) : "";
+      await session.send(`${quotePart}${message}`);
+      logger.info(`[光遇抽签图] ✅ 发送成功`);
+    } catch (error) {
+      logger.error(`[光遇抽签图] ❌ 错误: ${error?.message || error}`);
+      logger.error(`[光遇抽签图] 📚 堆栈: ${error?.stack}`);
+      const quotePart = config.enableQuote ? import_koishi2.h.quote(session.messageId) : "";
+      await session.send(`${quotePart}图片获取失败了呢~`);
+    }
+  });
+}
+__name(registerImageCommand, "registerImageCommand");
+
+// src/commands/text.ts
+var import_koishi3 = require("koishi");
+function registerTextCommand(ctx, config, api, logger) {
+  ctx.command(config.commandNames.text).action(async ({ session }) => {
+    logger.info(`[光遇抽签] 🎯 命令触发, userId=${session.userId}, platform=${session.platform}`);
+    logger.info(`[光遇抽签] ⚙️ 配置: backendUrl=${config.backendUrl}, sendBase64=${config.sendBase64}`);
+    try {
+      const params = api.resolveParams(config.paramMappings, session);
+      logger.info(`[光遇抽签] ✅ 解析参数: ${JSON.stringify(params)}`);
+      const result = await api.fetchBlessing("json", params);
+      logger.info(`[光遇抽签] 📄 JSON结果: fortune_level=${result.fortune_level}, dordas=${result.dordas}`);
+      const textParts = [
+        `🎋 ${result.fortune_level}`,
+        result.dordas,
+        `${result.dordas_color}`,
+        `「${result.blessing}」`,
+        `${result.entry}`
+      ];
+      let imageSegment;
+      if (config.sendBase64 && result.image_base64) {
+        logger.info(`[光遇抽签] 🖼️ 使用 JSON 中的 base64 图片`);
+        imageSegment = (0, import_koishi3.h)("image", {
+          url: `data:image/png;base64,${result.image_base64}`
+        });
+      } else {
+        logger.info(`[光遇抽签] 📡 单独请求图片`);
+        const imageBuffer = await api.fetchBlessing("image", params);
+        imageSegment = (0, import_koishi3.h)("image", { url: api.toBase64Image(imageBuffer) });
+      }
+      logger.info(`[光遇抽签] 📤 发送消息中...`);
+      const quotePart = config.enableQuote ? import_koishi3.h.quote(session.messageId) : "";
+      await session.send(`${quotePart}${imageSegment}
+${textParts.join("\n")}`);
+      logger.info(`[光遇抽签] ✅ 发送成功`);
+    } catch (error) {
+      logger.error(`[光遇抽签] ❌ 错误: ${error?.message || error}`);
+      logger.error(`[光遇抽签] 📚 堆栈: ${error?.stack}`);
+      const quotePart = config.enableQuote ? import_koishi3.h.quote(session.messageId) : "";
+      await session.send(`${quotePart}抽签失败了呢~`);
+    }
+  });
+}
+__name(registerTextCommand, "registerTextCommand");
+
+// src/commands/qq-markdown.ts
+var import_koishi4 = require("koishi");
+function registerQQMarkdownCommand(ctx, config, api, logger) {
+  ctx.command(config.commandNames.qqMarkdown).action(async ({ session }) => {
+    logger.info(`[光遇抽签md] 🎯 命令触发, platform=${session.platform}`);
+    if (session.platform !== "qq") {
+      logger.warn(`[光遇抽签md] ⛔ 平台拒绝: platform=${session.platform} (非QQ)`);
+      const quotePart = config.enableQuote ? import_koishi4.h.quote(session.messageId) : "";
+      await session.send(`${quotePart}此命令仅在QQ官方bot平台可用哦~`);
+      return;
+    }
+    try {
+      const params = api.resolveParams(config.paramMappings, session);
+      logger.info(`[光遇抽签md] ✅ 解析参数: ${JSON.stringify(params)}`);
+      const result = await api.fetchBlessing("json", params);
+      logger.info(`[光遇抽签md] 📄 JSON结果: fortune_level=${result.fortune_level}`);
+      const extractLabelAndValue = /* @__PURE__ */ __name((text) => {
+        const idx = text.indexOf("：");
+        if (idx === -1) return ["", text];
+        return [text.substring(0, idx), text.substring(idx + 1)];
+      }, "extractLabelAndValue");
+      const [dordasLabel, dordasValue] = extractLabelAndValue(result.dordas);
+      const [colorLabel, colorValue] = extractLabelAndValue(result.dordas_color);
+      const [entryLabel, entryValue] = extractLabelAndValue(result.entry);
+      const markdownContent = `# 🎋 ${result.fortune_level}
+
+**${dordasLabel}**：${dordasValue}
+**${colorLabel}**：${colorValue}
+**🎨 色值**：\`${result.color_hex}\`
+
+> ${result.blessing}
+
+**${entryLabel}**：${entryValue}`;
+      logger.info(`[光遇抽签md] 📄 Markdown内容: ${markdownContent}`);
+      let imageSegment;
+      if (config.sendBase64 && result.image_base64) {
+        imageSegment = (0, import_koishi4.h)("image", {
+          url: `data:image/png;base64,${result.image_base64}`
+        });
+      } else {
+        const imageBuffer = await api.fetchBlessing("image", params);
+        imageSegment = (0, import_koishi4.h)("image", { url: api.toBase64Image(imageBuffer) });
+      }
+      logger.info(`[光遇抽签md] 📤 发送图片中...`);
+      const quotePart = config.enableQuote ? import_koishi4.h.quote(session.messageId) : "";
+      await session.send(`${quotePart}${imageSegment}`);
+      logger.info(`[光遇抽签md] 📤 发送Markdown中...`);
+      await session.bot.internal.sendMessage(session.channelId, {
+        msg_id: session.messageId,
+        msg_type: 2,
+        markdown: {
+          content: markdownContent
+        }
+      });
+      logger.info(`[光遇抽签md] ✅ 发送成功`);
+    } catch (error) {
+      logger.error(`[光遇抽签md] ❌ 错误: ${error?.message || error}`);
+      logger.error(`[光遇抽签md] 📚 堆栈: ${error?.stack}`);
+      const quotePart = config.enableQuote ? import_koishi4.h.quote(session.messageId) : "";
+      await session.send(`${quotePart}抽签失败了呢~`);
+    }
+  });
+}
+__name(registerQQMarkdownCommand, "registerQQMarkdownCommand");
+
+// src/index.ts
+var name = "sky-blessing";
+var usage = USAGE;
+var inject = {
+  required: ["http"]
+};
+var reusable = true;
+var Config = ConfigSchema;
+var globalLogger = null;
+function apply(ctx, config) {
+  globalLogger = createLogger(ctx, config);
+  globalLogger.info("[sky-blessing] 🚀 插件加载中...");
+  globalLogger.debug(`[sky-blessing] ⚙️ 完整配置: ${JSON.stringify(config, null, 2)}`);
+  const api = new BlessingAPI(ctx, config);
+  api.setLogger(globalLogger);
+  registerImageCommand(ctx, config, api, globalLogger);
+  registerTextCommand(ctx, config, api, globalLogger);
+  registerQQMarkdownCommand(ctx, config, api, globalLogger);
+  globalLogger.info("[sky-blessing] ✅ 光遇抽签插件已加载");
+}
+__name(apply, "apply");
+function getLogger() {
+  return globalLogger;
+}
+__name(getLogger, "getLogger");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Config,
+  apply,
+  getLogger,
+  inject,
+  name,
+  reusable,
+  usage
+});

package/lib/logger.d.ts

@@ -0,0 +1,47 @@
+import { Context } from 'koishi';
+import { PluginConfig } from './types';
+declare const LOG_LEVELS: {
+    readonly silent: 0;
+    readonly error: 1;
+    readonly warn: 2;
+    readonly info: 3;
+    readonly debug: 4;
+};
+type LogLevel = keyof typeof LOG_LEVELS;
+/**
+ * 📝 自定义 Logger 类，支持按级别过滤日志
+ */
+export declare class SkyLogger {
+    private ctx;
+    private level;
+    constructor(ctx: Context, config: PluginConfig);
+    /**
+     * 更新日志级别
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * 🔇 静默级别 - 不输出任何日志
+     */
+    silent(_message?: any, ..._args: any[]): void;
+    /**
+     * ❌ 错误级别
+     */
+    error(message: any, ...args: any[]): void;
+    /**
+     * ⚠️ 警告级别
+     */
+    warn(message: any, ...args: any[]): void;
+    /**
+     * ℹ️ 信息级别
+     */
+    info(message: any, ...args: any[]): void;
+    /**
+     * 🐛 调试级别
+     */
+    debug(message: any, ...args: any[]): void;
+}
+/**
+ * 🏭 Logger 工厂函数
+ */
+export declare function createLogger(ctx: Context, config: PluginConfig): SkyLogger;
+export {};

package/lib/types.d.ts

@@ -0,0 +1,29 @@
+export declare const USAGE = "\n<h1>Koishi \u63D2\u4EF6\uFF1Asky-blessing \u5149\u9047\u7948\u798F\u7B7E</h1>\n<h2>\uD83C\uDFAF \u529F\u80FD\u7B80\u4ECB</h2>\n<p>\u968F\u673A\u751F\u6210\u5149\u9047\u7948\u798F\u7B7E\u56FE\u7247\u7684 Koishi \u63D2\u4EF6\uFF0C\u652F\u6301\u4E09\u79CD\u8F93\u51FA\u6A21\u5F0F\uFF1A</p>\n<ul>\n  <li>\uD83D\uDDBC\uFE0F <b>\u5149\u9047\u62BD\u7B7E\u56FE</b> - \u4EC5\u53D1\u9001\u7948\u798F\u7B7E\u56FE\u7247</li>\n  <li>\uD83D\uDCDC <b>\u5149\u9047\u62BD\u7B7E</b> - \u53D1\u9001\u56FE\u7247 + \u6587\u5B57\u5185\u5BB9\uFF08\u8FD0\u52BF\u7B49\u7EA7\u3001\u7ED3\u7F18\u7269\u3001\u7F18\u5F69\u3001\u795D\u798F\u8BED\u7B49\uFF09</li>\n  <li>\uD83D\uDCDD <b>\u5149\u9047\u62BD\u7B7Emd</b> - \u53D1\u9001\u56FE\u7247 + Markdown\u683C\u5F0F\uFF08\uD83D\uDCA1 \u4EC5\u9650 QQ \u5E73\u53F0\u53EF\u7528\uFF09</li>\n</ul>\n\n<h2>\uD83D\uDCAC \u4EA4\u6D41\u7FA4\u7EC4</h2>\n<p><del>\uD83D\uDCAC \u63D2\u4EF6\u4F7F\u7528\u95EE\u9898 / \uD83D\uDC1B Bug\u53CD\u9988 / \uD83D\uDC68\u200D \u63D2\u4EF6\u5F00\u53D1\u4EA4\u6D41\uFF0C\u6B22\u8FCE\u52A0\u5165QQ\u7FA4\uFF1A<b>259248174</b> \uD83C\uDF89\uFF08\u8FD9\u4E2A\u7FA4G\u4E86\uFF09</del></p>\n<p>\uD83D\uDCAC \u63D2\u4EF6\u4F7F\u7528\u95EE\u9898 / \uD83D\uDC1B Bug\u53CD\u9988 / \uD83D\uDC68\u200D\uD83D\uDCBB \u63D2\u4EF6\u5F00\u53D1\u4EA4\u6D41\uFF0C\u6B22\u8FCE\u52A0\u5165\u65B0QQ\u7FA4\uFF1A<b>1085190201</b> \uD83C\uDF89</p>\n<p>\uD83D\uDCA1 \u5728\u7FA4\u91CC\u76F4\u63A5\u827E\u7279\u6211\uFF0C\u56DE\u590D\u7684\u66F4\u5FEB\u54E6~ \u2728</p>\n\n<hr>\n\n<h3 style=\"color: #e74c3c;\">\u2699\uFE0F \u524D\u7F6E\u4F9D\u8D56</h3>\n<p>\u672C\u63D2\u4EF6\u9700\u8981\u4EE5\u4E0B\u4F9D\u8D56\u624D\u80FD\u6B63\u5E38\u5DE5\u4F5C\uFF1A</p>\n<ul>\n  <li><b style=\"color: #e74c3c;\">http</b> - Koishi \u5185\u7F6E\u670D\u52A1\uFF0C\u7528\u4E8EHTTP\u8BF7\u6C42\u540E\u7AEFAPI <span style=\"color: #e74c3c;\">\u3010\u5FC5\u987B\u3011</span></li>\n</ul>\n\n<h3 style=\"color: #3498db;\">\uD83D\uDD17 \u540E\u7AEF\u670D\u52A1</h3>\n<p>\u672C\u63D2\u4EF6\u9700\u8981\u914D\u5408\u540E\u7AEF\u670D\u52A1\u4F7F\u7528\uFF0C\u8BF7\u5148\u90E8\u7F72\u540E\u7AEF\uFF1A</p>\n<ul>\n  <li><a href=\"https://github.com/VincentZyuApps/skyblessings-fastapi-pillow\">GitHub \u540E\u7AEF\u4ED3\u5E93</a></li>\n  <li><a href=\"https://gitee.com/vincent-zyu/skyblessings-fastapi-pillow\">Gitee \u540E\u7AEF\u4ED3\u5E93</a></li>\n</ul>\n<p>\u90E8\u7F72\u5B8C\u6210\u540E\uFF0C\u5728\u63D2\u4EF6\u914D\u7F6E\u4E2D\u586B\u5199 <code>backendUrl</code> \u4E3A\u540E\u7AEF\u670D\u52A1\u5730\u5740\u3002</p>\n\n<h3 style=\"color: #2ecc71;\">\uD83C\uDFAE \u547D\u4EE4\u5217\u8868</h3>\n<table border=\"1\" cellpadding=\"5\" cellspacing=\"0\">\n  <tr>\n    <th>\u547D\u4EE4</th>\n    <th>\u63CF\u8FF0</th>\n    <th>\u5E73\u53F0\u9650\u5236</th>\n  </tr>\n  <tr>\n    <td><code>\u5149\u9047\u62BD\u7B7E\u56FE</code></td>\n    <td>\u83B7\u53D6\u7948\u798F\u7B7E\u56FE\u7247</td>\n    <td>\u65E0</td>\n  </tr>\n  <tr>\n    <td><code>\u5149\u9047\u62BD\u7B7E</code></td>\n    <td>\u83B7\u53D6\u7948\u798F\u7B7E\u56FE\u7247 + \u6587\u5B57\u8BE6\u60C5</td>\n    <td>\u65E0</td>\n  </tr>\n  <tr>\n    <td><code>\u5149\u9047\u62BD\u7B7Emd</code></td>\n    <td>\u83B7\u53D6\u7948\u798F\u7B7E\u56FE\u7247 + Markdown\u683C\u5F0F</td>\n    <td>\u4EC5QQ\u5E73\u53F0</td>\n  </tr>\n</table>\n\n<h3 style=\"color: #f39c12;\">\u2699\uFE0F \u53C2\u6570\u6620\u5C04\u8BF4\u660E</h3>\n<p>\u53EF\u901A\u8FC7\u914D\u7F6E\u5C06 a~e \u4E94\u4E2A\u53C2\u6570\u952E\u6620\u5C04\u5230\u4E0D\u540C\u7684\u4F1A\u8BDD\u4FE1\u606F\uFF0C\u7528\u4E8E\u6784\u5EFA\u540E\u7AEF\u8BF7\u6C42\u7684\u79CD\u5B50\uFF1A</p>\n<ul>\n  <li>\uD83C\uDF10 <b>platform</b> - \u5E73\u53F0\u540D\u79F0\uFF08\u5982 onebot\u3001discord\uFF09</li>\n  <li>\uD83C\uDD94 <b>userid</b> - \u7528\u6237ID</li>\n  <li>\uD83D\uDCC5 <b>date</b> - \u5F53\u524D\u65E5\u671F\uFF08YYYY-MM-DD\uFF09</li>\n  <li>\uD83D\uDC64 <b>nickname</b> - \u7528\u6237\u6635\u79F0</li>\n  <li>\uD83D\uDDBC\uFE0F <b>avatar_hash</b> - \u5934\u50CFMD5\u54C8\u5E0C\u503C</li>\n</ul>\n<p>\u9ED8\u8BA4\u914D\u7F6E\uFF1Aabc \u542F\u7528\uFF0Cde \u7981\u7528\u3002\u91CD\u590D\u7684 key \u53EA\u6709\u7B2C\u4E00\u4E2A\u542F\u7528\u7684\u4F1A\u751F\u6548\u3002</p>\n\n<h3 style=\"color: #9b59b6;\">\uD83D\uDCCA \u8FD4\u56DE\u5B57\u6BB5\u8BF4\u660E</h3>\n<ul>\n  <li><b>fortune_level</b> - \u8FD0\u52BF\u7B49\u7EA7\uFF08\u5982\uFF1A\u5927\u5409\u3001\u4E2D\u5409\u3001\u5C0F\u5409\uFF09</li>\n  <li><b>dordas</b> - \u7ED3\u7F18\u7269\uFF08\u5982\uFF1A\u7ED3\u7F18\u7269\uFF1A\u9065\u9CB2\uFF09</li>\n  <li><b>dordas_color</b> - \u7F18\u5F69\uFF08\u5982\uFF1A\u7F18\u5F69\uFF1A\u68A7\u679D\u7EFF\uFF09</li>\n  <li><b>color_hex</b> - \u989C\u8272\u5341\u516D\u8FDB\u5236\u503C\uFF08\u5982\uFF1A#4fd69e\uFF09</li>\n  <li><b>blessing</b> - \u795D\u798F\u8BED</li>\n  <li><b>entry</b> - \u5B9C\u5FCC\u63D0\u793A\uFF08\u5982\uFF1A\u5FCC\uFF1A\u4E00\u610F\u5B64\u884C\uFF09</li>\n</ul>\n";
+export interface BlessingResult {
+    fortune_level: string;
+    background_id: string;
+    dordas: string;
+    blessing: string;
+    entry: string;
+    dordas_color: string;
+    color_hex: string;
+    image_base64?: string;
+}
+export interface ParamMapping {
+    enabled: boolean;
+    key: 'a' | 'b' | 'c' | 'd' | 'e';
+    value: 'platform' | 'userid' | 'date' | 'nickname' | 'avatar_hash';
+}
+export interface PluginConfig {
+    commandNames: {
+        image: string;
+        text: string;
+        qqMarkdown: string;
+    };
+    backendUrl: string;
+    sendBase64: boolean;
+    enableQuote: boolean;
+    qqMarkdownSendImage: boolean;
+    logLevel: 'silent' | 'error' | 'warn' | 'info' | 'debug';
+    paramMappings: ParamMapping[];
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "koishi-plugin-sky-blessing",
+  "description": "光遇抽签，对接后端",
+  "version": "0.2.2",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "dist"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "chatbot",
+    "koishi",
+    "plugin"
+  ],
+  "peerDependencies": {
+    "koishi": "^4.18.7"
+  }
+}

package/readme.md

@@ -0,0 +1,91 @@
+![sky-blessing](https://socialify.git.ci/VincentZyuApps/sky-blessing/image?description=1&font=Bitter&forks=1&issues=1&language=1&logo=https%3A%2F%2Fupload.wikimedia.org%2Fwikipedia%2Fcommons%2Ff%2Ff3%2FKoishi.js_Logo.png&name=1&owner=1&pattern=Plus&stargazers=1&theme=Auto)
+
+# koishi-plugin-sky-blessing
+
+[![npm](https://img.shields.io/npm/v/koishi-plugin-sky-blessing?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-sky-blessing)
+[![npm-download](https://img.shields.io/npm/dm/koishi-plugin-sky-blessing?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-sky-blessing)
+[![GitHub](https://img.shields.io/badge/GitHub-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/VincentZyuApps/sky-blessing)
+[![Gitee](https://img.shields.io/badge/Gitee-C71D23?style=for-the-badge&logo=gitee&logoColor=white)](https://gitee.com/vincent-zyu/sky-blessing)
+
+<p><del>💬 插件使用问题 / 🐛 Bug反馈 / 👨‍💻 插件开发交流，欢迎加入QQ群：<b>259248174</b>   🎉（这个群G了）</del></p> 
+<p>💬 插件使用问题 / 🐛 Bug反馈 / 👨‍💻 插件开发交流，欢迎加入新QQ群：<b>1085190201</b> 🎉</p>
+<p>💡 在群里直接艾特我，回复的更快哦~ ✨</p>
+
+##  后端服务
+
+本插件需要配合后端服务使用：
+
+- [![GitHub Backend](https://img.shields.io/badge/GitHub_Backend-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/VincentZyuApps/skyblessings-fastapi-pillow)
+- [![Gitee Backend](https://img.shields.io/badge/Gitee_Backend-C71D23?style=for-the-badge&logo=gitee&logoColor=white)](https://gitee.com/vincent-zyu/skyblessings-fastapi-pillow)
+
+> 💡 请先部署后端服务，然后在插件配置中填写 `backendUrl`
+
+## 🎯 功能特性
+
+- 🖼️ **光遇抽签图** - 仅发送祈福签图片
+- 📜 **光遇抽签** - 发送图片 + 文字内容（运势等级、结缘物、缘彩、祝福语等）
+- 📝 **光遇抽签md** - 发送图片 + Markdown格式（💡 仅限 QQ 平台可用）
+
+## ⚙️ 配置说明
+
+### 命令名称设置
+- `光遇抽签图` - 仅发送图片的命令名
+- `光遇抽签` - 发送图片+文字的命令名  
+- `光遇抽签md` - 发送图片+Markdown的命令名（仅QQ）
+
+### 后端设置
+- `backendUrl` - 后端服务地址（默认: `http://127.0.0.1:51205`）
+- `sendBase64` - 是否将图片 Base64 编码后发送
+- `enableQuote` - 开启后，所有消息都会引用回复触发指令的消息
+
+### 参数映射设置
+可配置 a~e 五个参数键的值来源：
+- 🌐 平台 (platform)
+- 🆔 用户ID (userid)
+- 📅 日期 (date)
+- 👤 昵称 (nickname)
+- 🖼️ 头像哈希 (avatar_hash)
+
+默认配置：abc 启用，de 禁用
+
+## 📸 效果预览
+
+### 光遇抽签图
+![image-only](doc/image-only.png)
+
+### 光遇抽签
+![image-with-text](doc/image-with-text.png)
+
+### 光遇抽签md（QQ原生Markdown）
+![qq-markdown](doc/qq-markdown.png)
+
+## 🔧 安装方式
+
+### 通过 Koishi 市场安装
+在 Koishi 控制台搜索 `sky-blessing` 并安装
+
+### 手动安装
+```bash
+cd /path/to/your/koishi/project
+npm install koishi-plugin-sky-blessing
+yarn add koishi-plugin-sky-blessing
+```
+
+## 🚀 快速开始
+
+1. 部署后端服务（参考后端仓库 README）
+2. 在 Koishi 控制台安装本插件
+3. 配置 `backendUrl` 为后端服务地址
+4. 根据需要调整参数映射配置
+5. 使用命令测试：
+   - `光遇抽签图` - 获取图片
+   - `光遇抽签` - 获取图片+文字
+   - `光遇抽签md` - 获取图片+Markdown（QQ专用）
+
+## 📋 API 说明
+
+后端提供 `/blessing` 接口：
+- `type=image` - 返回 PNG 图片
+- `type=json` - 返回 JSON（含 base64 图片）
+- `type=json_without_image` - 返回 JSON（不含图片）
+- `a/b/c/d/e` - 可选种子参数，相同组合返回相同结果