koishi-plugin-bns-fortune 1.0.1

package/README.md

@@ -0,0 +1,105 @@
+# koishi-plugin-bns-fortune
+
+剑灵风格**每日好运签**。基于 Canvas 实时绘制签图，文字完全可变，天然不含原图「西普大陆」logo，并融入剑灵（Blade & Soul）水墨视觉元素。
+
+## 特性
+
+- 🎴 **每日一签**：同一用户当天结果固定，由 `日期 + 用户ID + masterKey` 哈希确定，杜绝刷屏改命。
+- 🎨 **Canvas 实时绘制**：背景模板（绸带 / 圆形印章 / 福字暗纹 / 古典金边 / 四角剑形符文）全部代码绘制，**天然无原图 logo**；文字每次叠加，100% 可变。
+- ⚔️ **剑灵水墨配色**：墨黑 / 朱砂红 / 赤金 / 米色，装饰加入剑气光线与剑形符文（可切换为传统朱金）。
+- 🖼️ **背景可替换**：填一个图片路径/URL 即可换成你自己的背景，无需改代码。
+- 📚 **40 条签文**：覆盖上上签 → 下签六个等级，签诗 + 白话解签 + 分类运势。
+- 🔤 **中文字体友好**：可指定字体目录自动注册 ttf/otf，缺失时回退系统楷体/宋体。
+
+## 截图占位
+
+> 运行 `fortune` 命令即可生成签图。示意：顶部红绸烫金标题（如「上上签」）+ 中部圆形朱红印章「灵签」+ 竖排签诗 + 横排解签 + 运势标签 + 底部日期/昵称/签号。
+
+## 安装
+
+### 1. 安装本插件
+
+在 Koishi 控制台「插件市场」搜索 `bns-fortune` 安装；或在工作区手动安装：
+
+```bash
+npm install koishi-plugin-bns-fortune
+```
+
+### 2. 必装依赖：canvas 服务
+
+本插件依赖 canvas 服务来绘图。请在 Koishi 中**额外安装并启用** [`koishi-plugin-canvas`](https://github.com/idlist/koishi-plugin-canvas)（基于 skia-canvas，性能好）：
+
+```bash
+npm install koishi-plugin-canvas
+```
+
+> ⚠️ 若未安装 canvas 服务，命令会返回错误提示，不会绘图。
+
+## 使用
+
+发送以下任一指令即可抽签：
+
+| 指令 | 别名 |
+|------|------|
+| `fortune` | `求签` / `jrrp` |
+
+机器人会返回一张当天的签图。同一用户当天再抽仍是同一签。
+
+## 配置项
+
+| 配置项 | 类型 | 默认 | 说明 |
+|--------|------|------|------|
+| `masterKey` | string | `bns-fortune-2024` | 随机密钥。**修改后所有用户的签会被重新打乱**，可用作「定期换签」。 |
+| `theme` | `ink` \| `gold-red` | `ink` | 配色主题。`ink`=剑灵·水墨，`gold-red`=传统·朱金。 |
+| `fontFamily` | string | 空 | 签图正文字体族名。需为系统字体或已注册字体；留空则回退内置楷体栈。 |
+| `fontsDir` | 目录 | 空 | 字体目录。插件启动时会自动注册其中的 `.ttf`/`.otf`。 |
+| `customBackground` | string | 空 | 自定义背景图。填本地绝对路径或 http(s) URL，留空则用代码绘制的模板。 |
+| `results` | array | null | 自定义签文库（高级），完整覆盖内置 40 签。 |
+
+### 推荐字体（可选）
+
+内置渲染已含中文字体回退栈（LXGW 霞鹜文楷 / 楷体 / 宋体 等）。若想要更统一的书法效果，推荐下载免费中文字体放入 `fontsDir`：
+
+- [LXGW WenKai 霞鹜文楷](https://github.com/lxgw/LxgwWenKai)（推荐，楷书风格，免费）
+- 思源宋体 / 思源黑体
+
+放置后在配置 `fontsDir` 填该目录路径，并把 `fontFamily` 填为字体名（如 `LXGW WenKai`）即可。
+
+### 自定义背景图
+
+1. 准备一张约 **600 × 860**（或同比例）的图片。
+2. 在 `customBackground` 填本地路径（如 `D:/imgs/bg.png`）或图片 URL。
+3. 插件会以 cover 方式铺满，并叠加边框、暗角与所有动态文字，保持风格统一。
+
+> 留空时使用代码绘制的剑灵水墨模板，无需任何素材即可使用。
+
+## 签文结构（自定义 results 时参考）
+
+```ts
+{
+  level: '上上签',            // 上上签 / 上签 / 中吉签 / 中签 / 中平签 / 下签
+  number: 1,                  // 签号
+  poem: ['第一句', '第二句', '第三句', '第四句'], // 四句签诗
+  interpretation: '白话解签文字',
+  luck: {                     // 分类运势，至少一项
+    财运: '财源广进',
+    姻缘: '天作之合',
+    修炼: '顿悟飞升',
+    健康: '百病不侵',
+  }
+}
+```
+
+等级权重（抽到概率）：上上签 < 上签 < 中吉签 < 中平签 < 下签 < 中签。
+
+## 开发
+
+```bash
+npm install      # 安装依赖
+npm run build    # 编译 src → lib
+npm run typecheck  # 仅类型检查
+```
+
+## 许可证
+
+MIT

package/lib/fortune.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 定签算法：确定性随机
+ *
+ * 同一 (日期 + 用户ID + masterKey) 永远得到同一支签，
+ * 杜绝同一用户当天刷屏改命。
+ */
+import { Fortune } from './fortunes';
+/** 格式化日期为 YYYY-MM-DD（基于本地时区） */
+export declare function formatDate(d: Date): string;
+export interface DrawResult {
+    fortune: Fortune;
+    /** 签文在该等级内的序号（用于展示"今日第 X 签"） */
+    index: number;
+    /** 用于展示的种子 */
+    seed: number;
+}
+/**
+ * 抽签
+ * @param dateStr  YYYY-MM-DD
+ * @param userId   用户 ID
+ * @param masterKey 随机密钥（可由配置提供）
+ * @param library  签文库（默认内置）
+ */
+export declare function drawFortune(dateStr: string, userId: string, masterKey: string, library?: Fortune[]): DrawResult;

package/lib/fortune.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDate = formatDate;
+exports.drawFortune = drawFortune;
+/**
+ * 定签算法：确定性随机
+ *
+ * 同一 (日期 + 用户ID + masterKey) 永远得到同一支签，
+ * 杜绝同一用户当天刷屏改命。
+ */
+const fortunes_1 = require("./fortunes");
+/** 简单字符串哈希（FNV-1a 变体），返回 32 位无符号整数 */
+function hashString(str) {
+    let hash = 2166136261;
+    for (let i = 0; i < str.length; i++) {
+        hash ^= str.charCodeAt(i);
+        hash = Math.imul(hash, 16777619);
+    }
+    // 转无符号
+    return hash >>> 0;
+}
+/** mulberry32：种子 → 确定性 PRNG，返回 [0,1) 的函数 */
+function mulberry32(seed) {
+    let a = seed >>> 0;
+    return function () {
+        a |= 0;
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** 格式化日期为 YYYY-MM-DD（基于本地时区） */
+function formatDate(d) {
+    const y = d.getFullYear();
+    const m = String(d.getMonth() + 1).padStart(2, '0');
+    const day = String(d.getDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+/**
+ * 抽签
+ * @param dateStr  YYYY-MM-DD
+ * @param userId   用户 ID
+ * @param masterKey 随机密钥（可由配置提供）
+ * @param library  签文库（默认内置）
+ */
+function drawFortune(dateStr, userId, masterKey, library = fortunes_1.FORTUNES) {
+    if (library.length === 0) {
+        throw new Error('签文库为空，无法抽签');
+    }
+    const seed = hashString(`${dateStr}|${userId}|${masterKey}`);
+    const rand = mulberry32(seed);
+    // 1. 按等级权重先定等级
+    const levelList = Object.keys(fortunes_1.LEVEL_WEIGHTS);
+    const totalWeight = levelList.reduce((s, lv) => s + fortunes_1.LEVEL_WEIGHTS[lv], 0);
+    let r = rand() * totalWeight;
+    let chosenLevel = levelList[0];
+    for (const lv of levelList) {
+        if (r < fortunes_1.LEVEL_WEIGHTS[lv]) {
+            chosenLevel = lv;
+            break;
+        }
+        r -= fortunes_1.LEVEL_WEIGHTS[lv];
+    }
+    // 2. 在该等级的签中再随机一条；若该等级无签则回退到整库随机
+    const candidates = library.filter((f) => f.level === chosenLevel);
+    const pool = candidates.length > 0 ? candidates : library;
+    const index = Math.floor(rand() * pool.length);
+    const fortune = pool[index];
+    return { fortune, index, seed };
+}

package/lib/fortunes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 内置签文库
+ *
+ * 签诗保持传统风格，视觉层由 render.ts 以剑灵水墨配色呈现。
+ * 用户可通过配置项 `results` 覆盖或扩展本库。
+ */
+export type FortuneLevel = '上上签' | '上签' | '中吉签' | '中签' | '中平签' | '下签';
+export interface Fortune {
+    /** 签等级 */
+    level: FortuneLevel;
+    /** 签号（第一签、第二签 …） */
+    number: number;
+    /** 四句签诗 */
+    poem: string[];
+    /** 白话解签 */
+    interpretation: string;
+    /** 分类运势 */
+    luck: {
+        财运?: string;
+        姻缘?: string;
+        修炼?: string;
+        健康?: string;
+        出行?: string;
+    };
+}
+export declare const FORTUNES: Fortune[];
+/** 等级权重：上上签稀有，中签居多 */
+export declare const LEVEL_WEIGHTS: Record<FortuneLevel, number>;

package/lib/fortunes.js

@@ -0,0 +1,306 @@
+"use strict";
+/**
+ * 内置签文库
+ *
+ * 签诗保持传统风格，视觉层由 render.ts 以剑灵水墨配色呈现。
+ * 用户可通过配置项 `results` 覆盖或扩展本库。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LEVEL_WEIGHTS = exports.FORTUNES = void 0;
+exports.FORTUNES = [
+    // ============================ 上上签 (5) ============================
+    {
+        level: '上上签',
+        number: 1,
+        poem: ['紫气东来瑞气生', '金鸡报晓叩天门', '一箭穿云千万里', '功名福禄此时成'],
+        interpretation: '鸿运当头，万事亨通。所求皆遂，吉无不利。',
+        luck: { 财运: '财源广进', 姻缘: '天作之合', 修炼: '顿悟飞升', 健康: '百病不侵' },
+    },
+    {
+        level: '上上签',
+        number: 9,
+        poem: ['日出扶桑万象新', '祥云瑞气满乾坤', '龙腾九霄风云会', '一举成名天下闻'],
+        interpretation: '旭日东升，前程似锦。机缘已至，放手为之。',
+        luck: { 财运: '横财入户', 姻缘: '良缘天定', 修炼: '功力大进', 出行: '一路平安' },
+    },
+    {
+        level: '上上签',
+        number: 18,
+        poem: ['春风得意马蹄疾', '一日看尽长安花', '人逢喜事精神爽', '福禄寿全到我家'],
+        interpretation: '春风得意，喜事临门。诸事顺遂，宜把握良机。',
+        luck: { 财运: '财喜双至', 姻缘: '喜结良缘', 修炼: '精进有成', 健康: '神清气爽' },
+    },
+    {
+        level: '上上签',
+        number: 27,
+        poem: ['鲲鹏展翅九万里', '翻动扶摇羊角风', '一朝风雷凌云志', '扶摇直上九重天'],
+        interpretation: '志向高远，终成大器。时机一到，一飞冲天。',
+        luck: { 财运: '一本万利', 姻缘: '终成眷属', 修炼: '破境而出', 出行: '贵人相助' },
+    },
+    {
+        level: '上上签',
+        number: 36,
+        poem: ['丹凤朝阳展彩霞', '麒麟献瑞到君家', '天降甘霖苏万物', '荣华富贵享无涯'],
+        interpretation: '祥瑞临门，福泽深厚。积善之家，必有余庆。',
+        luck: { 财运: '盆满钵满', 姻缘: '百年好合', 修炼: '福慧双修', 健康: '延年益寿' },
+    },
+    // ============================ 上签 (7) ============================
+    {
+        level: '上签',
+        number: 2,
+        poem: ['天开黄道大吉祥', '福禄寿三星照堂', '谋事在人成在天', '天随人愿喜洋洋'],
+        interpretation: '吉星高照，所谋皆成。但有诚心，必得善果。',
+        luck: { 财运: '进财顺利', 姻缘: '情投意合', 修炼: '稳步精进', 健康: '安康无恙' },
+    },
+    {
+        level: '上签',
+        number: 7,
+        poem: ['明月当空照九州', '清辉万里共悠悠', '前途自有光明处', '且向高歌一展眸'],
+        interpretation: '前程明朗，心思通透。前路虽有曲折，终见光明。',
+        luck: { 财运: '渐入佳境', 姻缘: '两情相悦', 修炼: '心境澄明', 出行: '顺风顺水' },
+    },
+    {
+        level: '上签',
+        number: 12,
+        poem: ['一帆风顺济沧溟', '百尺竿头更进层', '莫道前路多艰险', '守得云开见月明'],
+        interpretation: '虽有波折，终得顺利。坚持本心，必有收获。',
+        luck: { 财运: '稳定增长', 姻缘: '缘定三生', 修炼: '苦尽甘来', 健康: '宜调养息' },
+    },
+    {
+        level: '上签',
+        number: 19,
+        poem: ['绿柳抽枝迎早春', '燕泥新垒筑芳辰', '生机勃发无穷尽', '事事如意自随心'],
+        interpretation: '万象更新，生机盎然。宜开拓进取，把握当下。',
+        luck: { 财运: '财气渐旺', 姻缘: '红鸾星动', 修炼: '功到自然', 出行: '宜远行' },
+    },
+    {
+        level: '上签',
+        number: 24,
+        poem: ['玉树临风映彩霞', '金枝含露绽奇花', '灵芝瑞草生庭院', '积德行善福无涯'],
+        interpretation: '德行深厚，福报自来。宜广结善缘，持续积累。',
+        luck: { 财运: '积少成多', 姻缘: '琴瑟和鸣', 修炼: '功德圆满', 健康: '身心康泰' },
+    },
+    {
+        level: '上签',
+        number: 31,
+        poem: ['锦上添花富贵春', '兰因絮果总随身', '善心常存天不负', '福田广种福临门'],
+        interpretation: '善有善报，勤勉有得。莫因小失大，放眼长远。',
+        luck: { 财运: '财喜双全', 姻缘: '美满如意', 修炼: '渐入佳境', 出行: '宜会友' },
+    },
+    {
+        level: '上签',
+        number: 38,
+        poem: ['苍松翠柏立山巅', '历尽风霜志更坚', '待到春来花满树', '清香一缕入云天'],
+        interpretation: '历经磨砺，终成正果。守得初心，方得始终。',
+        luck: { 财运: '厚积薄发', 姻缘: '终成眷属', 修炼: '修成正果', 健康: '筋骨强健' },
+    },
+    // ============================ 中吉签 (8) ============================
+    {
+        level: '中吉签',
+        number: 3,
+        poem: ['半江瑟瑟半江红', '渔舟唱晚入秋风', '得鱼何必羡龙鲤', '知足常乐自从容'],
+        interpretation: '不必强求，知足常乐。安于所得，反生欢喜。',
+        luck: { 财运: '平稳有余', 姻缘: '平淡是真', 修炼: '宜守静功', 健康: '宜养心' },
+    },
+    {
+        level: '中吉签',
+        number: 8,
+        poem: ['桃李不言下自成', '春风化雨润无声', '德修于内形于外', '不求名时名自迎'],
+        interpretation: '埋头耕耘，莫问收获。待以时日，自见成效。',
+        luck: { 财运: '细水长流', 姻缘: '日久生情', 修炼: '韬光养晦', 出行: '宜近不宜远' },
+    },
+    {
+        level: '中吉签',
+        number: 11,
+        poem: ['细雨润物细无声', '春苗破土向天生', '莫嫌生长来时慢', '他日参天荫众生'],
+        interpretation: '进步虽缓，前途可观。耐住寂寞，必有厚报。',
+        luck: { 财运: '渐次增进', 姻缘: '水到渠成', 修炼: '宜打基础', 健康: '宜滋补' },
+    },
+    {
+        level: '中吉签',
+        number: 15,
+        poem: ['行到水穷坐看云', '云起时处自氤氲', '绝处逢生须淡定', '柳暗花明又一村'],
+        interpretation: '困境之中，勿失信心。转机将至，静待其变。',
+        luck: { 财运: '先抑后扬', 姻缘: '波折转好', 修炼: '瓶颈将破', 出行: '宜谨慎' },
+    },
+    {
+        level: '中吉签',
+        number: 20,
+        poem: ['秋水共长天一色', '落霞与孤鹜齐飞', '诗酒趁年华正好', '且将心事付微醺'],
+        interpretation: '及时行乐，莫负韶华。珍惜眼前，享受当下。',
+        luck: { 财运: '收支平衡', 姻缘: '随缘自在', 修炼: '宜悟道法', 出行: '宜出游' },
+    },
+    {
+        level: '中吉签',
+        number: 23,
+        poem: ['梅须逊雪三分白', '雪却输梅一段香', '尺有所短寸有长', '取长补短方为强'],
+        interpretation: '各有千秋，莫相比较。扬长避短，自得其所。',
+        luck: { 财运: '中规中矩', 姻缘: '互相欣赏', 修炼: '宜找良师', 健康: '宜调身' },
+    },
+    {
+        level: '中吉签',
+        number: 29,
+        poem: ['清泉石上流涓涓', '明月松间照清妍', '清心寡欲身自在', '不慕繁华守田园'],
+        interpretation: '淡泊明志，宁静致远。少欲知足，身心安康。',
+        luck: { 财运: '够用即可', 姻缘: '平实温暖', 修炼: '宜修清心', 健康: '心宽体健' },
+    },
+    {
+        level: '中吉签',
+        number: 33,
+        poem: ['竹杖芒鞋轻胜马', '谁怕一蓑烟雨任', '回首向来萧瑟处', '也无风雨也无晴'],
+        interpretation: '宠辱不惊，去留无意。心境豁达，处处逢春。',
+        luck: { 财运: '随遇而安', 姻缘: '看淡得失', 修炼: '宜修心性', 出行: '无碍' },
+    },
+    // ============================ 中签 (10) ============================
+    {
+        level: '中签',
+        number: 4,
+        poem: ['山重水复疑无路', '柳暗花明又一村', '凡事不可太执着', '换个方向又逢春'],
+        interpretation: '此路不通，自有别径。转变思路，豁然开朗。',
+        luck: { 财运: '需思变通', 姻缘: '宜主动些', 修炼: '宜换法门', 健康: '注意调养' },
+    },
+    {
+        level: '中签',
+        number: 6,
+        poem: ['云开雾散见青天', '峰回路转又逢源', '凡事不可心太急', '循序渐进自周全'],
+        interpretation: '急则生乱，缓则得安。按部就班，水到渠成。',
+        luck: { 财运: '稳步推进', 姻缘: '急不得成', 修炼: '忌好高骛', 出行: '宜缓行' },
+    },
+    {
+        level: '中签',
+        number: 10,
+        poem: ['舟行碧波上有风', '波浪起伏向前涌', '心中有定方不乱', '稳坐钓台自从容'],
+        interpretation: '外界波动，内心当定。沉着应对，终能渡过。',
+        luck: { 财运: '起伏不定', 姻缘: '需经考验', 修炼: '宜修定力', 健康: '注意情绪' },
+    },
+    {
+        level: '中签',
+        number: 13,
+        poem: ['欲速不达古之训', '事缓则圆莫争锋', '万事皆有其时序', '顺其自然福自生'],
+        interpretation: '欲速不达，适得其反。顺其自然，方得圆满。',
+        luck: { 财运: '忌急功近利', 姻缘: '急则生变', 修炼: '忌贪功冒进', 出行: '宜择日' },
+    },
+    {
+        level: '中签',
+        number: 16,
+        poem: ['滴水穿石非一日', '绳锯木断见功夫', '只要功夫深到底', '铁杵磨针终成器'],
+        interpretation: '贵在坚持，恒者能成。日积月累，自有回报。',
+        luck: { 财运: '靠积攒', 姻缘: '靠经营', 修炼: '靠恒心', 健康: '靠保养' },
+    },
+    {
+        level: '中签',
+        number: 21,
+        poem: ['塞翁失马焉知祸', '祸福相依本无常', '得不足喜失勿忧', '泰然处之自吉祥'],
+        interpretation: '得失无常，泰然处之。祸福相依，不必过忧。',
+        luck: { 财运: '有得有失', 姻缘: '随缘就好', 修炼: '修平常心', 出行: '平常看待' },
+    },
+    {
+        level: '中签',
+        number: 22,
+        poem: ['千里之行始足下', '万丈高楼平地起', '大事必作于细处', '勿轻小事误全局'],
+        interpretation: '重视细节，脚踏实地。勿轻小事，方能成大。',
+        luck: { 财运: '积小为大', 姻缘: '从小事起', 修炼: '从基础始', 健康: '重日常' },
+    },
+    {
+        level: '中签',
+        number: 25,
+        poem: ['清官难断家务事', '且让三分又何妨', '退一步海阔天空', '忍一时风平浪静'],
+        interpretation: '遇事忍让，退一步海阔天空。和睦为贵，计较生烦。',
+        luck: { 财运: '宜守不宜争', 姻缘: '多些包容', 修炼: '宜修忍辱', 出行: '和气生财' },
+    },
+    {
+        level: '中签',
+        number: 30,
+        poem: ['路漫漫其修远兮', '吾将上下而求索', '前途虽远终有至', '但凭坚韧与执着'],
+        interpretation: '路途虽远，坚持必至。求索不止，终有所获。',
+        luck: { 财运: '长远看好', 姻缘: '需用耐心', 修炼: '宜耐寂寞', 出行: '宜长远' },
+    },
+    {
+        level: '中签',
+        number: 35,
+        poem: ['人生不如意十之', '八九何必挂心间', '且把烦恼抛脑后', '笑看明月照长天'],
+        interpretation: '人生难免挫折，何必自苦。放下烦恼，豁达自在。',
+        luck: { 财运: '平常心待', 姻缘: '莫强求', 修炼: '宜放执念', 健康: '宜开心' },
+    },
+    // ============================ 中平签 (6) ============================
+    {
+        level: '中平签',
+        number: 5,
+        poem: ['天有不测风云起', '人有旦夕祸福临', '凡事谨慎多思量', '未雨绸缪保安宁'],
+        interpretation: '世事难料，宜多留心。未雨绸缪，方能安稳。',
+        luck: { 财运: '宜储蓄', 姻缘: '需经营', 修炼: '宜守成', 出行: '宜慎行' },
+    },
+    {
+        level: '中平签',
+        number: 14,
+        poem: ['鱼与熊掌难兼得', '有舍有得是常理', '莫为贪心失大局', '权衡利弊再决断'],
+        interpretation: '取舍之间，需明智断。贪多嚼不烂，专注方有成。',
+        luck: { 财运: '宜专注', 姻缘: '勿三心', 修炼: '宜专一', 健康: '勿过劳' },
+    },
+    {
+        level: '中平签',
+        number: 17,
+        poem: ['骄兵必败古来传', '满招损来谦受益', '得意之时莫忘形', '失意之际莫灰心'],
+        interpretation: '胜不骄，败不馁。保持谦逊，行稳致远。',
+        luck: { 财运: '忌张扬', 姻缘: '忌骄纵', 修炼: '忌自满', 健康: '忌纵欲' },
+    },
+    {
+        level: '中平签',
+        number: 26,
+        poem: ['言多必失祸从口', '祸从口出病从口', '谨言慎行是良训', '沉默是金胜千言'],
+        interpretation: '谨言慎行，少说多做。管住嘴巴，免招是非。',
+        luck: { 财运: '忌轻信', 姻缘: '多沟通', 修炼: '忌妄语', 健康: '注意饮食' },
+    },
+    {
+        level: '中平签',
+        number: 32,
+        poem: ['近朱者赤近墨黑', '交友不可不谨慎', '益友相扶前路广', '损友相误悔莫及'],
+        interpretation: '交友需慎，近朱者赤。择善而交，受益良多。',
+        luck: { 财运: '慎合伙人', 姻缘: '察人品', 修炼: '择良师', 出行: '慎结伴' },
+    },
+    {
+        level: '中平签',
+        number: 37,
+        poem: ['树欲静而风不止', '子欲养而亲不待', '珍惜眼前人与事', '莫待失去空悲切'],
+        interpretation: '珍惜当下，莫留遗憾。眼前人与事，当用心待。',
+        luck: { 财运: '惜已有', 姻缘: '惜眼前人', 修炼: '惜机缘', 健康: '惜身体' },
+    },
+    // ============================ 下签 (4) ============================
+    {
+        level: '下签',
+        number: 28,
+        poem: ['乌云压城城欲摧', '甲光向日金鳞开', '风雨飘摇时难熬', '守得云开待晴回'],
+        interpretation: '运势低迷，宜守不宜进。韬光养晦，静待转机。',
+        luck: { 财运: '忌投资', 姻缘: '宜让步', 修炼: '宜闭关', 出行: '忌远行' },
+    },
+    {
+        level: '下签',
+        number: 34,
+        poem: ['逆水行舟不进退', '用力撑篙勿松懈', '此刻艰难需挺住', '一旦松劲前功弃'],
+        interpretation: '逆水行舟，不进则退。艰难时刻，咬牙坚持。',
+        luck: { 财运: '防破财', 姻缘: '需忍让', 修炼: '忌懈怠', 健康: '忌过劳' },
+    },
+    {
+        level: '下签',
+        number: 39,
+        poem: ['前路茫茫多坎坷', '荆棘丛生步难行', '此时不宜冒然进', '退守蓄力待时机'],
+        interpretation: '前路受阻，不宜冒进。退一步想，养精蓄锐。',
+        luck: { 财运: '宜保守', 姻缘: '宜冷静', 修炼: '宜蛰伏', 出行: '宜暂缓' },
+    },
+    {
+        level: '下签',
+        number: 40,
+        poem: ['病来如山倒地摧', '病去如抽丝慢慢', '此时宜静不宜动', '调养生息待春回'],
+        interpretation: '身心疲惫，宜静养息。莫勉强为之，调养为先。',
+        luck: { 财运: '防损耗', 姻缘: '宜独处', 修炼: '宜固本', 健康: '重调养' },
+    },
+];
+/** 等级权重：上上签稀有，中签居多 */
+exports.LEVEL_WEIGHTS = {
+    上上签: 3,
+    上签: 6,
+    中吉签: 9,
+    中签: 12,
+    中平签: 7,
+    下签: 4,
+};

package/lib/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * koishi-plugin-bns-fortune
+ * 剑灵风格每日好运签 —— Canvas 绘制，每日一签，文字可变
+ */
+import { Context, Schema } from 'koishi';
+import { Fortune } from './fortunes';
+export interface Config {
+    /** 随机密钥：改它会重洗全局结果 */
+    masterKey: string;
+    /** 自定义背景图路径/URL（为空则用代码绘制模板） */
+    customBackground: string;
+    /** 字体族名（需已注册或系统自带） */
+    fontFamily: string;
+    /** 配色主题 */
+    theme: 'ink' | 'gold-red';
+    /** 字体目录（插件会尝试自动注册其中的 ttf/otf） */
+    fontsDir: string;
+    /** 自定义签文库（覆盖内置） */
+    results: Fortune[];
+}
+export declare const Config: Schema<Config>;
+export declare const name = "bns-fortune";
+export declare const reusable = true;
+export { Config as config };
+export declare function apply(ctx: Context, config: Config): void;
+declare const _default: {
+    name: string;
+    apply: typeof apply;
+    Config: Schema<Config>;
+};
+export default _default;

package/lib/index.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.config = exports.reusable = exports.name = exports.Config = void 0;
+exports.apply = apply;
+/**
+ * koishi-plugin-bns-fortune
+ * 剑灵风格每日好运签 —— Canvas 绘制，每日一签，文字可变
+ */
+const koishi_1 = require("koishi");
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+const fortunes_1 = require("./fortunes");
+const fortune_1 = require("./fortune");
+const render_1 = require("./render");
+const logger = new koishi_1.Logger('bns-fortune');
+exports.Config = koishi_1.Schema.intersect([
+    koishi_1.Schema.object({
+        masterKey: koishi_1.Schema.string()
+            .description('随机密钥。修改后所有用户的签会被重新打乱。')
+            .default('bns-fortune-2024'),
+        theme: koishi_1.Schema.union([
+            koishi_1.Schema.const('ink').description('剑灵·水墨（墨黑朱砂赤金）'),
+            koishi_1.Schema.const('gold-red').description('传统·朱金'),
+        ]).description('配色主题。').default('ink'),
+        fontFamily: koishi_1.Schema.string()
+            .description('签图正文字体族名。需为系统字体或已注册字体，否则回退楷体。')
+            .default(''),
+        fontsDir: koishi_1.Schema.path({
+            filters: ['directory'],
+            allowCreate: true,
+        }).description('字体目录。插件启动时会把其中的 ttf/otf 自动注册，便于中文字体渲染。留空则不注册。')
+            .default(''),
+        customBackground: koishi_1.Schema.string()
+            .description('自定义背景图。可填本地图片绝对路径或 http(s) URL。留空则使用代码绘制的剑灵水墨模板。')
+            .default(''),
+        results: koishi_1.Schema.array(koishi_1.Schema.object({
+            level: koishi_1.Schema.union([
+                koishi_1.Schema.const('上上签'), koishi_1.Schema.const('上签'), koishi_1.Schema.const('中吉签'),
+                koishi_1.Schema.const('中签'), koishi_1.Schema.const('中平签'), koishi_1.Schema.const('下签'),
+            ]).description('签等级。'),
+            number: koishi_1.Schema.number().description('签号。'),
+            poem: koishi_1.Schema.array(koishi_1.Schema.string()).description('四句签诗。'),
+            interpretation: koishi_1.Schema.string().description('白话解签。'),
+            luck: koishi_1.Schema.object({
+                财运: koishi_1.Schema.string(),
+                姻缘: koishi_1.Schema.string(),
+                修炼: koishi_1.Schema.string(),
+                健康: koishi_1.Schema.string(),
+                出行: koishi_1.Schema.string(),
+            }).description('分类运势。'),
+        }).description('签文对象')).description('自定义签文库（高级）。全覆盖内置 40 签，留空则用内置库。')
+            .default([]),
+    }),
+]);
+exports.config = exports.Config;
+exports.name = 'bns-fortune';
+exports.reusable = true;
+/**
+ * 获取 canvas 服务。
+ * koishi-plugin-canvas（基于 skia-canvas）会注入 ctx.canvas。
+ */
+function getCanvas(ctx) {
+    // koishi-plugin-canvas 注入的服务挂载在 ctx.canvas
+    const canvas = ctx.canvas;
+    if (!canvas) {
+        throw new Error('未检测到 canvas 服务。请在 Koishi 中安装并启用 "koishi-plugin-canvas" 插件，本插件依赖它来绘制签图。');
+    }
+    return canvas;
+}
+/** 注册字体目录下的 ttf/otf（若提供） */
+function tryRegisterFonts(dir) {
+    if (!dir)
+        return;
+    const abs = (0, node_path_1.resolve)(dir);
+    if (!(0, node_fs_1.existsSync)(abs)) {
+        logger.warn('字体目录不存在，跳过注册：%s', abs);
+        return;
+    }
+    let files = [];
+    try {
+        files = (0, node_fs_1.readdirSync)(abs);
+    }
+    catch (e) {
+        logger.warn('读取字体目录失败：%o', e);
+        return;
+    }
+    // skia-canvas 提供 Fontlibrary.use；node-canvas 提供 registerFont。
+    // 两者都尝试，命中其一即可。
+    for (const f of files) {
+        const lower = f.toLowerCase();
+        if (!lower.endsWith('.ttf') && !lower.endsWith('.otf'))
+            continue;
+        const full = (0, node_path_1.resolve)(abs, f);
+        const family = f.replace(/\.(ttf|otf)$/i, '');
+        try {
+            // skia-canvas
+            const skia = globalThis.FontLibrary;
+            if (skia?.use) {
+                skia.use(family, [full]);
+                continue;
+            }
+        }
+        catch { /* ignore */ }
+        try {
+            // node-canvas
+            const nodeCanvas = require('canvas');
+            if (typeof nodeCanvas.registerFont === 'function') {
+                nodeCanvas.registerFont(full, { family });
+            }
+        }
+        catch { /* ignore */ }
+    }
+}
+function apply(ctx, config) {
+    // 启动时注册字体（失败不阻断）
+    try {
+        tryRegisterFonts(config.fontsDir);
+    }
+    catch (e) {
+        logger.warn('字体注册异常：%o', e);
+    }
+    const library = Array.isArray(config.results) && config.results.length > 0
+        ? config.results
+        : fortunes_1.FORTUNES;
+    const theme = render_1.THEMES[config.theme] ?? render_1.THEMES.ink;
+    let renderer;
+    function getRenderer() {
+        if (!renderer)
+            renderer = new render_1.FortuneRenderer(getCanvas(ctx));
+        return renderer;
+    }
+    // 每日每用户渲染缓存：key = `${date}|${userId}`
+    const renderCache = new Map();
+    // 每天换日时清理
+    ctx.setInterval(() => renderCache.clear(), 60 * 60 * 1000);
+    const cmd = ctx
+        .command('fortune', '剑灵每日好运签')
+        .alias('求签')
+        .alias('jrrp')
+        .action(async ({ session }) => {
+        if (!session?.userId)
+            return '无法识别用户。';
+        const date = (0, fortune_1.formatDate)(new Date());
+        const cacheKey = `${date}|${session.userId}`;
+        // 命中缓存
+        const cached = renderCache.get(cacheKey);
+        if (cached)
+            return koishi_1.h.image(cached, 'image/png');
+        try {
+            const { fortune } = (0, fortune_1.drawFortune)(date, session.userId, config.masterKey, library);
+            const png = await getRenderer().render({
+                fortune,
+                date,
+                nickname: session.username || session.author?.nickname,
+                fontFamily: config.fontFamily,
+                theme,
+                customBackground: config.customBackground || undefined,
+            });
+            renderCache.set(cacheKey, png);
+            return koishi_1.h.image(png, 'image/png');
+        }
+        catch (e) {
+            logger.warn('抽签/渲染失败：%o', e);
+            return '抽签失败：' + (e instanceof Error ? e.message : String(e));
+        }
+    });
+    ctx.on('dispose', () => cmd.dispose());
+}
+exports.default = { name: exports.name, apply, Config: exports.Config };

package/lib/render.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 渲染：背景模板（Canvas 重绘）+ 动态文字叠加
+ *
+ * 设计思路：
+ * - 背景（绸带/印章框/福字暗纹/边框）由代码绘制，按 主题+尺寸 缓存复用，
+ *   支持 customBackground 配置项替换为外部图片。
+ * - 动态文字（签等级/签诗/解签/运势/日期/昵称/签号）每次叠加在背景之上。
+ * - 配色用剑灵水墨风（墨黑 / 朱砂红 / 赤金 / 米色），装饰加入剑气、符文元素。
+ */
+import { Fortune } from './fortunes';
+export interface CanvasLike {
+    width: number;
+    height: number;
+    getContext(type: '2d'): CanvasRenderingContext2D;
+    /** 兼容 skia-canvas / node-canvas：不传参数时两者都默认返回 PNG Buffer */
+    toBuffer(format?: string, config?: unknown): Buffer;
+}
+export interface ImageLike {
+    width: number;
+    height: number;
+}
+export interface CanvasService {
+    createCanvas(width: number, height: number): CanvasLike;
+    loadImage(source: string | Buffer): Promise<ImageLike>;
+}
+export interface Theme {
+    /** 主题名 */
+    name: string;
+    /** 米色底（中心） */
+    bg: string;
+    /** 边缘渐变深色 */
+    bgDark: string;
+    /** 主文字色（水墨黑） */
+    ink: string;
+    /** 朱砂红（绸带、印章、解签） */
+    red: string;
+    /** 赤金（描边、标题、装饰） */
+    gold: string;
+    /** 暗金（福字暗纹） */
+    goldDim: string;
+    /** 卷轴内衬底色（半透明） */
+    scroll: string;
+}
+export declare const THEMES: Record<string, Theme>;
+export declare const W = 600;
+export declare const H = 860;
+export interface RenderInput {
+    fortune: Fortune;
+    /** YYYY-MM-DD */
+    date: string;
+    /** 用户昵称 */
+    nickname?: string;
+    /** 字体族（需已注册或为系统字体） */
+    fontFamily: string;
+    /** 主题 */
+    theme: Theme;
+    /** 自定义背景图路径/URL；为空则用代码绘制 */
+    customBackground?: string;
+}
+export declare class FortuneRenderer {
+    private canvas;
+    /** 背景缓存：key = `${themeName}|${customBg ?? 'builtin'}` */
+    private bgCache;
+    /** 自定义背景图缓存：key = url */
+    private imageCache;
+    /** 缓存条数上限 */
+    private static MAX_CACHE;
+    constructor(canvas: CanvasService);
+    private evict;
+    /** 字体声明字符串，含中文回退 */
+    private fontStack;
+    /** 获取（或绘制并缓存）背景画布 */
+    private getBackground;
+    /** 渲染整张签图，返回 PNG Buffer */
+    render(input: RenderInput): Promise<Buffer>;
+}

package/lib/render.js

@@ -0,0 +1,438 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FortuneRenderer = exports.H = exports.W = exports.THEMES = void 0;
+exports.THEMES = {
+    /** 剑灵·水墨：墨黑朱砂赤金 */
+    ink: {
+        name: '剑灵·水墨',
+        bg: '#f3e9d2',
+        bgDark: '#d9c79a',
+        ink: '#1c1a17',
+        red: '#8e1a1a',
+        gold: '#c9a24b',
+        goldDim: '#b89a5c',
+        scroll: 'rgba(253,247,232,0.55)',
+    },
+    /** 传统·朱金：朱红描金 */
+    'gold-red': {
+        name: '传统·朱金',
+        bg: '#fdf3df',
+        bgDark: '#e8c98c',
+        ink: '#3a1d1d',
+        red: '#c0392b',
+        gold: '#d4af37',
+        goldDim: '#caa84a',
+        scroll: 'rgba(255,250,235,0.6)',
+    },
+};
+/* ------------------------------------------------------------------ */
+/* 画布尺寸                                                            */
+/* ------------------------------------------------------------------ */
+exports.W = 600;
+exports.H = 860;
+class FortuneRenderer {
+    constructor(canvas) {
+        this.canvas = canvas;
+        /** 背景缓存：key = `${themeName}|${customBg ?? 'builtin'}` */
+        this.bgCache = new Map();
+        /** 自定义背景图缓存：key = url */
+        this.imageCache = new Map();
+    }
+    evict(map) {
+        while (map.size > FortuneRenderer.MAX_CACHE) {
+            const first = map.keys().next().value;
+            map.delete(first);
+        }
+    }
+    /** 字体声明字符串，含中文回退 */
+    fontStack(family) {
+        const f = family && family.trim();
+        const main = f ? `"${f}",` : '';
+        return `${main}"LXGW WenKai","KaiTi","STKaiti","楷体","Microsoft YaHei","微软雅黑","SimSun","宋体",serif`;
+    }
+    /** 获取（或绘制并缓存）背景画布 */
+    async getBackground(theme, customBg) {
+        const key = `${theme.name}|${customBg ?? 'builtin'}`;
+        const cached = this.bgCache.get(key);
+        if (cached)
+            return cached;
+        let bg;
+        if (customBg) {
+            // 自定义背景：加载图片并缩放绘制到画布
+            let img = this.imageCache.get(customBg);
+            if (!img) {
+                img = await this.canvas.loadImage(customBg);
+                this.imageCache.set(customBg, img);
+                this.evict(this.imageCache);
+            }
+            bg = this.canvas.createCanvas(exports.W, exports.H);
+            const ctx = bg.getContext('2d');
+            // 先填底色，避免透明
+            ctx.fillStyle = theme.bg;
+            ctx.fillRect(0, 0, exports.W, exports.H);
+            // 等比铺满（cover）
+            const scale = Math.max(exports.W / img.width, exports.H / img.height);
+            const dw = img.width * scale;
+            const dh = img.height * scale;
+            ctx.drawImage(img, (exports.W - dw) / 2, (exports.H - dh) / 2, dw, dh);
+            // 仍叠加边框与暗角，保持风格统一
+            drawVignette(ctx, exports.W, exports.H, theme);
+            drawBorder(ctx, exports.W, exports.H, theme);
+        }
+        else {
+            bg = this.canvas.createCanvas(exports.W, exports.H);
+            const ctx = bg.getContext('2d');
+            drawBackground(ctx, exports.W, exports.H, theme);
+        }
+        this.bgCache.set(key, bg);
+        this.evict(this.bgCache);
+        return bg;
+    }
+    /** 渲染整张签图，返回 PNG Buffer */
+    async render(input) {
+        const { fortune, date, nickname, fontFamily, theme, customBackground } = input;
+        const bg = await this.getBackground(theme, customBackground);
+        const canvas = this.canvas.createCanvas(exports.W, exports.H);
+        const ctx = canvas.getContext('2d');
+        ctx.drawImage(bg, 0, 0);
+        // 2. 顶部绸带 + 签等级标题（动态）
+        drawRibbon(ctx, exports.W / 2, 78, theme);
+        drawLevelTitle(ctx, exports.W / 2, 86, fortune.level, this.fontStack(fontFamily), theme);
+        // 3. 圆形印章装饰（固定文字「灵签」，剑灵符文感）
+        drawSeal(ctx, exports.W / 2, 178, 52, theme);
+        // 4. 签诗竖排（主体）
+        drawPoemVertical(ctx, exports.W / 2, 286, fortune.poem, this.fontStack(fontFamily), theme);
+        // 5. 解签（横排）
+        drawInterpretation(ctx, exports.W / 2, 566, fortune.interpretation, this.fontStack(fontFamily), theme);
+        // 6. 运势小标签
+        drawLuckTags(ctx, exports.W / 2, 638, fortune.luck, this.fontStack(fontFamily), theme);
+        // 7. 底部：日期 / 昵称 / 签号
+        drawFooter(ctx, exports.W, exports.H, date, nickname, fortune.number, this.fontStack(fontFamily), theme);
+        // 不传参数：skia-canvas 与 node-canvas 均默认返回 PNG，兼容性最好
+        return canvas.toBuffer();
+    }
+}
+exports.FortuneRenderer = FortuneRenderer;
+/** 缓存条数上限 */
+FortuneRenderer.MAX_CACHE = 12;
+/* ================================================================== */
+/* 背景绘制                                                            */
+/* ================================================================== */
+function drawBackground(ctx, w, h, theme) {
+    // 1. 米色径向渐变底
+    const grad = ctx.createRadialGradient(w / 2, h * 0.42, 60, w / 2, h * 0.5, h * 0.75);
+    grad.addColorStop(0, theme.bg);
+    grad.addColorStop(1, theme.bgDark);
+    ctx.fillStyle = grad;
+    ctx.fillRect(0, 0, w, h);
+    // 2. 福字暗纹（平铺）
+    drawFuPattern(ctx, w, h, theme);
+    // 3. 暗角
+    drawVignette(ctx, w, h, theme);
+    // 4. 双层金边框 + 四角符文
+    drawBorder(ctx, w, h, theme);
+}
+/** 福字暗纹：稀疏平铺的半透明「福」字 */
+function drawFuPattern(ctx, w, h, theme) {
+    ctx.save();
+    ctx.fillStyle = theme.goldDim;
+    ctx.globalAlpha = 0.08;
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'middle';
+    ctx.font = `64px ${fontBase()}`;
+    const step = 150;
+    for (let y = step / 2; y < h; y += step) {
+        for (let x = step / 2; x < w; x += step) {
+            // 错位排列
+            const offset = (Math.floor(y / step) % 2) * (step / 2);
+            ctx.fillText('福', x + offset, y);
+        }
+    }
+    ctx.restore();
+}
+/** 暗角：四角加深 */
+function drawVignette(ctx, w, h, theme) {
+    ctx.save();
+    const g = ctx.createRadialGradient(w / 2, h / 2, h * 0.3, w / 2, h / 2, h * 0.75);
+    g.addColorStop(0, 'rgba(0,0,0,0)');
+    g.addColorStop(1, 'rgba(60,40,20,0.28)');
+    ctx.fillStyle = g;
+    ctx.fillRect(0, 0, w, h);
+    ctx.restore();
+}
+/** 双层金边框 + 四角剑形符文 */
+function drawBorder(ctx, w, h, theme) {
+    ctx.save();
+    // 外粗金线
+    ctx.strokeStyle = theme.gold;
+    ctx.lineWidth = 3;
+    ctx.strokeRect(22, 22, w - 44, h - 44);
+    // 内细朱线
+    ctx.strokeStyle = theme.red;
+    ctx.lineWidth = 1;
+    ctx.strokeRect(30, 30, w - 60, h - 60);
+    // 四角剑形符文装饰
+    const corners = [
+        [30, 30], [w - 30, 30], [30, h - 30], [w - 30, h - 30],
+    ];
+    ctx.fillStyle = theme.gold;
+    ctx.globalAlpha = 0.85;
+    for (const [cx, cy] of corners)
+        drawCornerSigil(ctx, cx, cy, theme);
+    ctx.restore();
+}
+/** 四角小符文：六芒剑纹 */
+function drawCornerSigil(ctx, cx, cy, theme) {
+    ctx.save();
+    ctx.translate(cx, cy);
+    ctx.strokeStyle = theme.gold;
+    ctx.lineWidth = 1.2;
+    ctx.beginPath();
+    // 一个小菱形 + 中心点，象征剑锋符文
+    const r = 7;
+    ctx.moveTo(0, -r);
+    ctx.lineTo(r, 0);
+    ctx.lineTo(0, r);
+    ctx.lineTo(-r, 0);
+    ctx.closePath();
+    ctx.stroke();
+    ctx.fillStyle = theme.red;
+    ctx.beginPath();
+    ctx.arc(0, 0, 1.6, 0, Math.PI * 2);
+    ctx.fill();
+    ctx.restore();
+}
+/* ================================================================== */
+/* 动态元素绘制                                                        */
+/* ================================================================== */
+/** 顶部红色绸带（含两端剑形流苏） */
+function drawRibbon(ctx, cx, cy, theme) {
+    const w = 380;
+    const hh = 64;
+    const x0 = cx - w / 2;
+    ctx.save();
+    // 绸带主体（带下凹弧线）
+    ctx.fillStyle = theme.red;
+    ctx.beginPath();
+    ctx.moveTo(x0 - 18, cy - hh / 2);
+    ctx.lineTo(x0 + w + 18, cy - hh / 2);
+    ctx.quadraticCurveTo(x0 + w + 30, cy, x0 + w + 18, cy + hh / 2);
+    ctx.lineTo(x0 - 18, cy + hh / 2);
+    ctx.quadraticCurveTo(x0 - 30, cy, x0 - 18, cy - hh / 2);
+    ctx.closePath();
+    ctx.fill();
+    // 金色描边
+    ctx.strokeStyle = theme.gold;
+    ctx.lineWidth = 2;
+    ctx.stroke();
+    // 两端剑形流苏
+    drawSwordTassel(ctx, x0 - 18, cy, -1, theme);
+    drawSwordTassel(ctx, x0 + w + 18, cy, 1, theme);
+    // 绸带高光
+    ctx.fillStyle = 'rgba(255,255,255,0.12)';
+    ctx.fillRect(x0 - 6, cy - hh / 2 + 4, w + 12, 8);
+    ctx.restore();
+}
+/** 剑形流苏：绸带末端的小剑形装饰 */
+function drawSwordTassel(ctx, x, y, dir, theme) {
+    ctx.save();
+    ctx.translate(x, y);
+    ctx.scale(dir, 1);
+    ctx.fillStyle = theme.gold;
+    // 剑身
+    ctx.beginPath();
+    ctx.moveTo(0, -3);
+    ctx.lineTo(22, -3);
+    ctx.lineTo(28, 0);
+    ctx.lineTo(22, 3);
+    ctx.lineTo(0, 3);
+    ctx.closePath();
+    ctx.fill();
+    // 流苏穗
+    ctx.strokeStyle = theme.gold;
+    ctx.lineWidth = 1.5;
+    ctx.beginPath();
+    ctx.moveTo(28, 0);
+    ctx.lineTo(40, 0);
+    ctx.stroke();
+    ctx.restore();
+}
+/** 绸带上的签等级标题 */
+function drawLevelTitle(ctx, cx, cy, level, font, theme) {
+    ctx.save();
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'middle';
+    ctx.font = `bold 34px ${font}`;
+    // 金色描边 + 米黄填充，呈现烫金感
+    ctx.lineWidth = 5;
+    ctx.strokeStyle = theme.red;
+    ctx.strokeText(level, cx, cy);
+    ctx.lineWidth = 2;
+    ctx.strokeStyle = theme.gold;
+    ctx.strokeText(level, cx, cy);
+    ctx.fillStyle = '#fff4cf';
+    ctx.fillText(level, cx, cy);
+    ctx.restore();
+}
+/** 圆形印章：固定篆书感「灵签」+ 剑气光线 */
+function drawSeal(ctx, cx, cy, r, theme) {
+    ctx.save();
+    // 外圈剑气光线
+    ctx.strokeStyle = theme.gold;
+    ctx.globalAlpha = 0.5;
+    ctx.lineWidth = 1;
+    for (let i = 0; i < 24; i++) {
+        const a = (i / 24) * Math.PI * 2;
+        ctx.beginPath();
+        ctx.moveTo(cx + Math.cos(a) * (r + 6), cy + Math.sin(a) * (r + 6));
+        ctx.lineTo(cx + Math.cos(a) * (r + 12), cy + Math.sin(a) * (r + 12));
+        ctx.stroke();
+    }
+    ctx.globalAlpha = 1;
+    // 外圆（朱红）
+    ctx.strokeStyle = theme.red;
+    ctx.lineWidth = 3;
+    ctx.beginPath();
+    ctx.arc(cx, cy, r, 0, Math.PI * 2);
+    ctx.stroke();
+    // 内圆（金）
+    ctx.strokeStyle = theme.gold;
+    ctx.lineWidth = 1.5;
+    ctx.beginPath();
+    ctx.arc(cx, cy, r - 6, 0, Math.PI * 2);
+    ctx.stroke();
+    // 中心文字「灵签」竖排
+    ctx.fillStyle = theme.red;
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'middle';
+    ctx.font = `bold 22px ${fontBase()}`;
+    ctx.fillText('灵', cx, cy - 13);
+    ctx.fillText('签', cx, cy + 13);
+    ctx.restore();
+}
+/** 签诗竖排（右起，每列 7 字） */
+function drawPoemVertical(ctx, cx, startY, poem, font, theme) {
+    ctx.save();
+    ctx.fillStyle = theme.ink;
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'middle';
+    const fontSize = 31;
+    const lineGap = 40; // 字间距
+    const colGap = 60; // 列间距
+    ctx.font = `${fontSize}px ${font}`;
+    // 右起：第 0 句最右
+    const cols = poem.length;
+    const firstColX = cx + ((cols - 1) / 2) * colGap;
+    poem.forEach((line, i) => {
+        const x = firstColX - i * colGap;
+        for (let j = 0; j < line.length; j++) {
+            ctx.fillText(line[j], x, startY + j * lineGap);
+        }
+    });
+    ctx.restore();
+}
+/** 解签（横排，居中，自动换行） */
+function drawInterpretation(ctx, cx, cy, text, font, theme) {
+    ctx.save();
+    ctx.fillStyle = theme.red;
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'middle';
+    ctx.font = `20px ${font}`;
+    const maxWidth = 460;
+    const lines = wrapText(ctx, `解曰：${text}`, maxWidth);
+    const lineHeight = 28;
+    const startY = cy - ((lines.length - 1) * lineHeight) / 2;
+    lines.forEach((ln, i) => ctx.fillText(ln, cx, startY + i * lineHeight));
+    ctx.restore();
+}
+/** 运势小标签（横排） */
+function drawLuckTags(ctx, cx, cy, luck, font, theme) {
+    const entries = Object.entries(luck);
+    if (entries.length === 0)
+        return;
+    ctx.save();
+    ctx.textAlign = 'center';
+    ctx.textBaseline = 'middle';
+    ctx.font = `16px ${font}`;
+    const tagW = 150;
+    const tagH = 44;
+    const gap = 14;
+    const totalW = entries.length * tagW + (entries.length - 1) * gap;
+    const startX = cx - totalW / 2;
+    entries.forEach(([key, val], i) => {
+        const x = startX + i * (tagW + gap);
+        // 标签底
+        roundRect(ctx, x, cy - tagH / 2, tagW, tagH, 8);
+        ctx.fillStyle = theme.scroll;
+        ctx.fill();
+        ctx.strokeStyle = theme.gold;
+        ctx.lineWidth = 1.2;
+        ctx.stroke();
+        // 分类名（金）
+        ctx.fillStyle = theme.gold;
+        ctx.font = `bold 15px ${font}`;
+        ctx.fillText(key, x + tagW * 0.24, cy);
+        // 内容（墨）
+        ctx.fillStyle = theme.ink;
+        ctx.font = `15px ${font}`;
+        // 内容可能较长，截断
+        const maxLen = 5;
+        const shown = val.length > maxLen ? val.slice(0, maxLen) + '…' : val;
+        ctx.fillText(shown, x + tagW * 0.66, cy);
+    });
+    ctx.restore();
+}
+/** 底部：日期 / 昵称 / 签号 */
+function drawFooter(ctx, w, h, date, nickname, number, font, theme) {
+    ctx.save();
+    ctx.fillStyle = theme.gold;
+    ctx.textBaseline = 'middle';
+    ctx.font = `18px ${font}`;
+    // 左：日期
+    ctx.textAlign = 'left';
+    ctx.fillText(date, 56, h - 50);
+    // 右：昵称
+    ctx.textAlign = 'right';
+    ctx.fillText(nickname ? `${nickname} 求得` : '', w - 56, h - 50);
+    // 中：签号
+    ctx.textAlign = 'center';
+    ctx.fillStyle = theme.red;
+    ctx.font = `bold 20px ${font}`;
+    ctx.fillText(`第 ${number} 签`, w / 2, h - 50);
+    ctx.restore();
+}
+/* ================================================================== */
+/* 工具函数                                                            */
+/* ================================================================== */
+/** 基础中文字体栈（用于装饰固定文字） */
+function fontBase() {
+    return `"LXGW WenKai","KaiTi","STKaiti","楷体","SimSun","宋体",serif`;
+}
+/** 中文/英文混排自动换行 */
+function wrapText(ctx, text, maxWidth) {
+    const lines = [];
+    let current = '';
+    for (const ch of text) {
+        const test = current + ch;
+        if (ctx.measureText(test).width > maxWidth && current) {
+            lines.push(current);
+            current = ch;
+        }
+        else {
+            current = test;
+        }
+    }
+    if (current)
+        lines.push(current);
+    return lines;
+}
+/** 圆角矩形路径 */
+function roundRect(ctx, x, y, w, h, r) {
+    ctx.beginPath();
+    ctx.moveTo(x + r, y);
+    ctx.arcTo(x + w, y, x + w, y + h, r);
+    ctx.arcTo(x + w, y + h, x, y + h, r);
+    ctx.arcTo(x, y + h, x, y, r);
+    ctx.arcTo(x, y, x + w, y, r);
+    ctx.closePath();
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "koishi-plugin-bns-fortune",
+  "description": "剑灵风格每日好运签：每日一签，Canvas 绘制签图，文字可变，支持自定义背景与主题。",
+  "version": "1.0.1",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "koishi": {
+    "description": {
+      "zh": "剑灵好运签（每日一签）"
+    },
+    "manifest": {
+      "services": [
+        "canvas"
+      ]
+    }
+  },
+  "keywords": [
+    "chatbot",
+    "koishi",
+    "plugin",
+    "fortune",
+    "签",
+    "好运签",
+    "剑灵",
+    "canvas"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "rimraf lib",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "koishi": "^4.15.0",
+    "koishi-plugin-canvas": "^0.2.2",
+    "canvas": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "canvas": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "koishi": "^4.15.0",
+    "koishi-plugin-canvas": "^0.2.2",
+    "rimraf": "^5.0.0",
+    "typescript": "^5.4.0"
+  }
+}