koishi-plugin-rolecard 1.0.0 → 1.1.1

package/lib/config.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 插件配置 Schema 定义。
+ *
+ * `types.ts` 中的 `Config` 接口是运行时配置的类型契约，
+ * 本文件则提供对应的 Koishi Schema 声明（默认值、校验、UI 描述），
+ * 二者共同构成配置层。后续提升配置复杂度与通用度时，集中在此维护。
+ */
+import { Schema } from 'koishi';
+import type { Config as ConfigType } from './types';
+export declare const Config: Schema<ConfigType>;

package/lib/config.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * 插件配置 Schema 定义。
+ *
+ * `types.ts` 中的 `Config` 接口是运行时配置的类型契约，
+ * 本文件则提供对应的 Koishi Schema 声明（默认值、校验、UI 描述），
+ * 二者共同构成配置层。后续提升配置复杂度与通用度时，集中在此维护。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = void 0;
+const koishi_1 = require("koishi");
+exports.Config = koishi_1.Schema.object({
+    rolecard: koishi_1.Schema.string()
+        .default('')
+        .description('要加载的角色卡 ID（留空则自动加载第一个找到的角色卡）。例如：belikov'),
+    cooldown: koishi_1.Schema.number()
+        .default(60)
+        .min(0)
+        .description('冷却时间（秒），同一频道内两次触发的最小间隔，防止刷屏'),
+    cooldownWhitelist: koishi_1.Schema.array(koishi_1.Schema.string())
+        .default([])
+        .description('冷却白名单：填入用户 ID，这些用户的消息不受冷却限制'),
+    disabledTags: koishi_1.Schema.array(koishi_1.Schema.string())
+        .default([])
+        .description('禁用的触发标签（留空表示全部启用）。例如填入 emotional 可关闭「情绪」类触发'),
+    enableRandom: koishi_1.Schema.boolean()
+        .default(true)
+        .description('启用全部消息概率随机触发（神预言效果）'),
+    randomProbability: koishi_1.Schema.number()
+        .default(3)
+        .min(0)
+        .max(100)
+        .description('随机触发概率（0-100，3 表示 3%）'),
+    enableImage: koishi_1.Schema.boolean().default(true).description('启用角色卡插图'),
+    imageWithMessage: koishi_1.Schema.boolean()
+        .default(true)
+        .description('将图片与文字一起发送（关闭则图片作为单独消息发送）'),
+    imageProbability: koishi_1.Schema.number()
+        .default(100)
+        .min(0)
+        .max(100)
+        .description('附带图片的概率（0-100，100 表示每次触发都发图）'),
+    respondIn: koishi_1.Schema.union([
+        koishi_1.Schema.const('group').description('仅群聊'),
+        koishi_1.Schema.const('private').description('仅私聊'),
+        koishi_1.Schema.const('both').description('群聊与私聊'),
+    ])
+        .default('group')
+        .description('响应范围'),
+});

package/lib/index.d.ts

@@ -3,18 +3,19 @@
  *
  * 架构概览：
  *
- * - `types.ts`   共享类型契约（角色卡内容 + 运行时配置）
- * - `loader.ts`  角色卡加载器（扫描并解析 rolecards/ 目录）
+ * - `types.ts`   共享类型契约（角色卡内容 + 运行时配置接口）
+ * - `config.ts`  配置 Schema 声明（默认值、校验、UI 描述）
+ * - `loader.ts`  角色卡加载器（扫描并解析 assets/ 目录）
  * - `core.ts`    核心引擎（通用台词引擎，与具体角色解耦）
- * - `index.ts`   本文件，组装三者并对接 Koishi 生命周期
+ * - `index.ts`   本文件，组装以上模块并对接 Koishi 生命周期
  *
- * 角色卡是纯数据资源，存放在 `rolecards/<id>/` 下。用户通过 Config.rolecard
+ * 角色卡是纯数据资源，存放在 `assets/<id>/` 下。用户通过 Config.rolecard
  * 选择要激活的角色卡。新增角色卡只需添加数据目录，无需改动任何源码。
  */
 import type { Context } from 'koishi';
-import { Schema } from 'koishi';
+import { Config } from './config';
 import type { Config as ConfigType } from './types';
 export declare const name = "rolecard";
-export declare const usage = "\n<div style=\"border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);\">\n  <h2 style=\"margin-top: 0; color: #4a6ee0;\">\uD83C\uDFAD \u89D2\u8272\u5361\u63D2\u4EF6 \u00B7 Rolecard</h2>\n  <p>\u6570\u636E\u9A71\u52A8\u7684\u89D2\u8272\u53F0\u8BCD\u5F15\u64CE\u3002\u6838\u5FC3\u903B\u8F91\u4E0E\u89D2\u8272\u5361\u5185\u5BB9\u5B8C\u5168\u89E3\u8026\u2014\u2014\u89D2\u8272\u5361\u662F\u7EAF\u6570\u636E\u8D44\u6E90\uFF08\u53F0\u8BCD\u5E93 + \u89E6\u53D1\u8BCD + \u63D2\u56FE\uFF09\uFF0C\u5F15\u64CE\u6839\u636E\u6570\u636E\u81EA\u52A8\u9A71\u52A8\u5BF9\u8BDD\u3002</p>\n  <ul>\n    <li>\u5728 <code>rolecards/</code> \u76EE\u5F55\u4E0B\u653E\u7F6E\u89D2\u8272\u5361\uFF0C\u6BCF\u4E2A\u89D2\u8272\u5361\u4E00\u4E2A\u5B50\u76EE\u5F55</li>\n    <li>\u901A\u8FC7\u914D\u7F6E\u9879 <code>rolecard</code> \u9009\u62E9\u8981\u52A0\u8F7D\u7684\u89D2\u8272\u5361 ID</li>\n    <li>\u652F\u6301\u5173\u952E\u8BCD\u89E6\u53D1\uFF08\u6309\u4F18\u5148\u7EA7\uFF09\u4E0E\u6982\u7387\u968F\u673A\u89E6\u53D1</li>\n    <li>\u51B7\u5374\u9632\u5237\u5C4F\u3001\u63D2\u56FE\u53D1\u9001\u3001\u54CD\u5E94\u8303\u56F4\u5747\u53EF\u914D\u7F6E</li>\n  </ul>\n</div>\n";
-export declare const Config: Schema<ConfigType>;
+export declare const usage = "\n<div style=\"border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);\">\n  <h2 style=\"margin-top: 0; color: #4a6ee0;\">\uD83C\uDFAD \u89D2\u8272\u5361\u63D2\u4EF6 \u00B7 Rolecard</h2>\n  <p>\u6570\u636E\u9A71\u52A8\u7684\u89D2\u8272\u53F0\u8BCD\u5F15\u64CE\u3002\u6838\u5FC3\u903B\u8F91\u4E0E\u89D2\u8272\u5361\u5185\u5BB9\u5B8C\u5168\u89E3\u8026\u2014\u2014\u89D2\u8272\u5361\u662F\u7EAF\u6570\u636E\u8D44\u6E90\uFF08\u53F0\u8BCD\u5E93 + \u89E6\u53D1\u8BCD + \u63D2\u56FE\uFF09\uFF0C\u5F15\u64CE\u6839\u636E\u6570\u636E\u81EA\u52A8\u9A71\u52A8\u5BF9\u8BDD\u3002</p>\n  <ul>\n    <li>\u5728 <code>assets/</code> \u76EE\u5F55\u4E0B\u653E\u7F6E\u89D2\u8272\u5361\uFF0C\u6BCF\u4E2A\u89D2\u8272\u5361\u4E00\u4E2A\u5B50\u76EE\u5F55</li>\n    <li>\u901A\u8FC7\u914D\u7F6E\u9879 <code>rolecard</code> \u9009\u62E9\u8981\u52A0\u8F7D\u7684\u89D2\u8272\u5361 ID</li>\n    <li>\u652F\u6301\u5173\u952E\u8BCD\u89E6\u53D1\uFF08\u6309\u4F18\u5148\u7EA7\uFF09\u4E0E\u6982\u7387\u968F\u673A\u89E6\u53D1</li>\n    <li>\u51B7\u5374\u9632\u5237\u5C4F\u3001\u63D2\u56FE\u53D1\u9001\u3001\u54CD\u5E94\u8303\u56F4\u5747\u53EF\u914D\u7F6E</li>\n  </ul>\n</div>\n\n<div style=\"border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);\">\n  <h2 style=\"margin-top: 0; color: #4a6ee0;\">\uD83D\uDCAC \u4EA4\u6D41\u4E0E\u53CD\u9988</h2>\n  <p>\uD83C\uDF1F \u559C\u6B22\u8FD9\u4E2A\u63D2\u4EF6\uFF1F\u6B22\u8FCE\u52A0\u5165 QQ \u7FA4 <a href=\"https://qm.qq.com/q/WngX4RQoca\" style=\"color:#4a6ee0;text-decoration:none;\"><strong>1071284605</strong></a>\u3010\u6653\u57FA\u5730\u63D2\u4EF6\u5DE5\u574A\u3011\u8FDB\u884C\u4EA4\u6D41</p>\n  <p>\uD83D\uDC1B \u9047\u5230\u95EE\u9898\uFF1F\u6B22\u8FCE\u5728\u7FA4\u5185\u53CD\u9988\uFF0C\u6216\u70B9\u51FB <a href=\"https://qm.qq.com/q/WngX4RQoca\" style=\"color:#4a6ee0;text-decoration:none;\">\u6B64\u94FE\u63A5</a> \u52A0\u5165\u7FA4\u804A</p>\n</div>\n";
+export { Config };
 export declare function apply(ctx: Context, config: ConfigType): void;

package/lib/index.js

@@ -4,19 +4,21 @@
  *
  * 架构概览：
  *
- * - `types.ts`   共享类型契约（角色卡内容 + 运行时配置）
- * - `loader.ts`  角色卡加载器（扫描并解析 rolecards/ 目录）
+ * - `types.ts`   共享类型契约（角色卡内容 + 运行时配置接口）
+ * - `config.ts`  配置 Schema 声明（默认值、校验、UI 描述）
+ * - `loader.ts`  角色卡加载器（扫描并解析 assets/ 目录）
  * - `core.ts`    核心引擎（通用台词引擎，与具体角色解耦）
- * - `index.ts`   本文件，组装三者并对接 Koishi 生命周期
+ * - `index.ts`   本文件，组装以上模块并对接 Koishi 生命周期
  *
- * 角色卡是纯数据资源，存放在 `rolecards/<id>/` 下。用户通过 Config.rolecard
+ * 角色卡是纯数据资源，存放在 `assets/<id>/` 下。用户通过 Config.rolecard
  * 选择要激活的角色卡。新增角色卡只需添加数据目录，无需改动任何源码。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Config = exports.usage = exports.name = void 0;
 exports.apply = apply;
 const node_path_1 = require("node:path");
-const koishi_1 = require("koishi");
+const config_1 = require("./config");
+Object.defineProperty(exports, "Config", { enumerable: true, get: function () { return config_1.Config; } });
 const core_1 = require("./core");
 const loader_1 = require("./loader");
 exports.name = 'rolecard';
@@ -25,59 +27,26 @@ exports.usage = `
   <h2 style="margin-top: 0; color: #4a6ee0;">🎭 角色卡插件 · Rolecard</h2>
   <p>数据驱动的角色台词引擎。核心逻辑与角色卡内容完全解耦——角色卡是纯数据资源（台词库 + 触发词 + 插图），引擎根据数据自动驱动对话。</p>
   <ul>
-    <li>在 <code>rolecards/</code> 目录下放置角色卡，每个角色卡一个子目录</li>
+    <li>在 <code>assets/</code> 目录下放置角色卡，每个角色卡一个子目录</li>
     <li>通过配置项 <code>rolecard</code> 选择要加载的角色卡 ID</li>
     <li>支持关键词触发（按优先级）与概率随机触发</li>
     <li>冷却防刷屏、插图发送、响应范围均可配置</li>
   </ul>
 </div>
+
+<div style="border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);">
+  <h2 style="margin-top: 0; color: #4a6ee0;">💬 交流与反馈</h2>
+  <p>🌟 喜欢这个插件？欢迎加入 QQ 群 <a href="https://qm.qq.com/q/WngX4RQoca" style="color:#4a6ee0;text-decoration:none;"><strong>1071284605</strong></a>【晓基地插件工坊】进行交流</p>
+  <p>🐛 遇到问题？欢迎在群内反馈，或点击 <a href="https://qm.qq.com/q/WngX4RQoca" style="color:#4a6ee0;text-decoration:none;">此链接</a> 加入群聊</p>
+</div>
 `;
-exports.Config = koishi_1.Schema.object({
-    rolecard: koishi_1.Schema.string()
-        .default('')
-        .description('要加载的角色卡 ID（留空则自动加载第一个找到的角色卡）。例如：belikov'),
-    cooldown: koishi_1.Schema.number()
-        .default(60)
-        .min(0)
-        .description('冷却时间（秒），同一频道内两次触发的最小间隔，防止刷屏'),
-    cooldownWhitelist: koishi_1.Schema.array(koishi_1.Schema.string())
-        .default([])
-        .description('冷却白名单：填入用户 ID，这些用户的消息不受冷却限制'),
-    disabledTags: koishi_1.Schema.array(koishi_1.Schema.string())
-        .default([])
-        .description('禁用的触发标签（留空表示全部启用）。例如填入 emotional 可关闭「情绪」类触发'),
-    enableRandom: koishi_1.Schema.boolean()
-        .default(true)
-        .description('启用全部消息概率随机触发（神预言效果）'),
-    randomProbability: koishi_1.Schema.number()
-        .default(3)
-        .min(0)
-        .max(100)
-        .description('随机触发概率（0-100，3 表示 3%）'),
-    enableImage: koishi_1.Schema.boolean().default(true).description('启用角色卡插图'),
-    imageWithMessage: koishi_1.Schema.boolean()
-        .default(true)
-        .description('将图片与文字一起发送（关闭则图片作为单独消息发送）'),
-    imageProbability: koishi_1.Schema.number()
-        .default(100)
-        .min(0)
-        .max(100)
-        .description('附带图片的概率（0-100，100 表示每次触发都发图）'),
-    respondIn: koishi_1.Schema.union([
-        koishi_1.Schema.const('group').description('仅群聊'),
-        koishi_1.Schema.const('private').description('仅私聊'),
-        koishi_1.Schema.const('both').description('群聊与私聊'),
-    ])
-        .default('group')
-        .description('响应范围'),
-});
 function apply(ctx, config) {
     const logger = ctx.logger('rolecard');
-    // 角色卡目录位于插件包根目录下的 rolecards/
-    const rolecardsDir = (0, node_path_1.resolve)(__dirname, '..', 'rolecards');
-    const rolecards = (0, loader_1.loadRolecards)(rolecardsDir);
+    // 角色卡目录位于插件包根目录下的 assets/
+    const assetsDir = (0, node_path_1.resolve)(__dirname, '..', 'assets');
+    const rolecards = (0, loader_1.loadRolecards)(assetsDir);
     if (rolecards.length === 0) {
-        logger.warn('未找到任何角色卡，请检查 rolecards 目录');
+        logger.warn('未找到任何角色卡，请检查 assets 目录');
         return;
     }
     const availableIds = rolecards.map((r) => r.manifest.id).join(', ');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-rolecard",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "contributors": [
     "Oppenheymu <oppenheymu@gmail.com>"
   ],
@@ -16,7 +16,7 @@
   },
   "files": [
     "lib",
-    "rolecards"
+    "assets"
   ],
   "license": "MIT",
   "publishConfig": {