koishi-plugin-cfmrmod 1.0.4 → 1.0.5

package/README.md

@@ -13,14 +13,42 @@ Koishi 插件：搜索 CurseForge / Modrinth / MCMod，并渲染图片卡片。
 - `cnmc.mod/.data/.pack/.tutorial/.author/.user <关键词>`
 - `cf.help` / `mr.help` / `cnmc.help`
 
+#### 更新通知（notify）
+- `notify.add <platform> <projectId>` 添加订阅
+- `notify.remove <platform> <projectId>` 删除订阅
+- `notify.list` 列出订阅
+- `notify.enable <onoff>` 启用/禁用本群通知
+- `notify.check [arg] [-b]` 手动检查更新（arg 为序号或 projectId；-b 强制发送最新卡片）
+- `notify.helpme` 查看完整参数说明
+
+参数说明：
+- `<platform>`：平台代码，`mr`=Modrinth，`cf`=CurseForge
+- `<projectId>`：平台项目 ID（不是名称）
+- `<onoff>`：`on/off` 或 `true/false`
+- `[arg]`：`notify.check` 的参数，可填订阅序号或 `projectId`
+- `-b`：强制发送最新卡片（忽略是否更新）
+
 列表交互：输入序号查看，`n` 下一页，`p` 上一页，`q` 退出。
 
 ### 配置要点
+#### 通用
 - `prefixes`: 设置 `cf` / `mr` / `cnmc` 指令前缀
-- `fontPath`: 中文字体路径
 - `timeouts`: 搜索会话超时（毫秒）
 - `debug`: 调试日志开关
 
+#### 更新通知（notify）
+- `notify.enabled`: 是否开启更新通知
+- `notify.interval`: 全局轮询间隔（毫秒）
+- `notify.adminAuthority`: 权限等级（1=全部，2=管理员+群主，3=仅群主）
+- `notify.stateFile`: 状态文件路径（JSON）
+- `notify.groups`: 通知群组列表
+	- `channelId`: 群/频道 ID
+	- `enabled`: 是否启用本群通知
+	- `subs`: 订阅列表
+		- `platform`: `mr` 或 `cf`
+		- `projectId`: 项目 ID
+		- `interval`: 单独轮询间隔（毫秒），<=0 禁用
+
 ## 项目特点
 - 支持 CurseForge / Modrinth / MCMod 多平台搜索
 - 结果以图片卡片形式展示

package/dist/notify.js

@@ -472,17 +472,17 @@ function apply(ctx, config, options) {
         const tick = Math.max(60 * 1000, Number(config.interval) || 30 * 60 * 1000);
         ctx.setInterval(() => checkOnce().catch(() => null), tick);
     }
-    ctx.command('notify.add <platform> <projectId> [channelId]', '添加更新订阅')
-        .action(async ({ session }, platform, projectId, channelId) => {
+    ctx.command('notify.add <platform> <projectId>', '添加更新订阅')
+        .action(async ({ session }, platform, projectId) => {
         if (!platform || !projectId)
             return '参数不足。';
         const platformKey = normalizePlatform(platform);
         if (!platformKey)
             return '平台参数错误，请使用 mr 或 cf。';
-        const targetChannel = channelId || session.channelId;
+        const targetChannel = session.channelId;
         if (!targetChannel)
             return '只能在群聊使用或指定 channelId。';
-        if (!await requireManage(session, channelId))
+        if (!await requireManage(session))
             return '权限不足。';
         const pid = String(projectId).trim();
         if (!pid)
@@ -497,17 +497,17 @@ function apply(ctx, config, options) {
         group.subs = list;
         return `已添加订阅：${platformKey}:${pid}`;
     });
-    ctx.command('notify.remove <platform> <projectId> [channelId]', '删除更新订阅')
-        .action(async ({ session }, platform, projectId, channelId) => {
+    ctx.command('notify.remove <platform> <projectId>', '删除更新订阅')
+        .action(async ({ session }, platform, projectId) => {
         if (!platform || !projectId)
             return '参数不足。';
         const platformKey = normalizePlatform(platform);
         if (!platformKey)
             return '平台参数错误，请使用 mr 或 cf。';
-        const targetChannel = channelId || session.channelId;
+        const targetChannel = session.channelId;
         if (!targetChannel)
             return '只能在群聊使用或指定 channelId。';
-        if (!await requireManage(session, channelId))
+        if (!await requireManage(session))
             return '权限不足。';
         const pid = String(projectId).trim();
         if (!pid)
@@ -521,12 +521,12 @@ function apply(ctx, config, options) {
             return '未找到订阅。';
         return `已删除订阅：${platformKey}:${pid}`;
     });
-    ctx.command('notify.list [channelId]', '列出订阅')
-        .action(async ({ session }, channelId) => {
-        const targetChannel = channelId || session.channelId;
+    ctx.command('notify.list', '列出订阅')
+        .action(async ({ session }) => {
+        const targetChannel = session.channelId;
         if (!targetChannel)
             return '只能在群聊使用或指定 channelId。';
-        if (!await requireManage(session, channelId))
+        if (!await requireManage(session))
             return '权限不足。';
         const group = getGroup(targetChannel);
         if (!group)
@@ -544,12 +544,12 @@ function apply(ctx, config, options) {
         });
         return [`本群通知：${status}`, ...lines].join('\n');
     });
-    ctx.command('notify.enable <onoff> [channelId]', '启用/禁用本群通知')
-        .action(async ({ session }, onoff, channelId) => {
-        const targetChannel = channelId || session.channelId;
+    ctx.command('notify.enable <onoff>', '启用/禁用本群通知')
+        .action(async ({ session }, onoff) => {
+        const targetChannel = session.channelId;
         if (!targetChannel)
             return '只能在群聊使用或指定 channelId。';
-        if (!await requireManage(session, channelId))
+        if (!await requireManage(session))
             return '权限不足。';
         const flag = parseOnOff(onoff);
         if (flag === null)
@@ -558,21 +558,20 @@ function apply(ctx, config, options) {
         group.enabled = flag;
         return flag ? '已启用本群通知。' : '已禁用本群通知。';
     });
-    ctx.command('notify.help', '查看通知系统帮助')
+    ctx.command('notify.helpme', '查看通知系统帮助')
         .action(() => {
         return [
             'notify 使用说明：',
-            '1) notify.add <platform> <projectId> [channelId]  添加订阅',
-            '2) notify.remove <platform> <projectId> [channelId] 删除订阅',
-            '3) notify.list [channelId]  列出订阅',
-            '4) notify.enable <onoff> [channelId] 启用/禁用',
+            '1) notify.add ［platform］ ［projectId］  添加订阅',
+            '2) notify.remove ［platform］ ［projectId］ 删除订阅',
+            '3) notify.list  列出订阅',
+            '4) notify.enable ［onoff］ 启用/禁用',
             '5) notify.check [arg] [-b] 手动检查更新（arg 为序号或 projectId）',
             '平台：mr=Modrinth，cf=CurseForge',
             '参数说明：',
-            '- <platform>：平台代码，填写 mr 或 cf',
-            '- <projectId>：平台项目ID（Modrinth/CurseForge 的项目ID，不是名称）',
-            '- [channelId]：可选，目标频道ID，格式 platform:channelId（如 onebot:123456）',
-            '- <onoff>：启用开关，填写 on/off 或 true/false',
+            '- ［platform］：平台代码，填写 mr 或 cf',
+            '- ［projectId］：平台项目ID（Modrinth/CurseForge 的项目ID，不是名称）',
+            '- ［onoff］：启用开关，填写 on/off 或 true/false',
             '- [arg]：notify.check 的参数，可填订阅序号或 projectId',
             '- -b：强制发送最新卡片（忽略是否更新）',
         ].join('\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-cfmrmod",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Koishi 插件：搜索 CurseForge/Modrinth/MCMod 并渲染图片卡片",
   "main": "dist/index.js",
   "files": [