koishi-plugin-gitee-is 0.0.1

package/lib/index.d.ts

@@ -0,0 +1,24 @@
+import { Context, Schema } from 'koishi';
+declare module 'koishi' {
+    interface Tables {
+        gitee_is_repo_binding: GiteeRepoBinding;
+    }
+}
+export interface GiteeRepoBinding {
+    id: number;
+    channelId: string;
+    owner: string;
+    repo: string;
+    lastCheckTime: Date;
+    isPrivate: boolean;
+}
+export interface Config {
+    giteeToken: string;
+    pollInterval: number;
+    debug: boolean;
+    maxIssuesPerMessage: number;
+}
+export declare const name = "gitee-is";
+export declare const using: readonly ["database", "http"];
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -0,0 +1,377 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Config: () => Config,
+  apply: () => apply,
+  name: () => name,
+  using: () => using
+});
+module.exports = __toCommonJS(src_exports);
+var import_koishi = require("koishi");
+var import_date_fns = require("date-fns");
+var name = "gitee-is";
+var using = ["database", "http"];
+var Config = import_koishi.Schema.object({
+  giteeToken: import_koishi.Schema.string().description("Gitee 私人访问令牌（https://gitee.com/profile/personal_access_tokens）").required(),
+  pollInterval: import_koishi.Schema.number().description("Issues 轮询间隔（秒）").default(60).min(30),
+  debug: import_koishi.Schema.boolean().description("是否开启调试日志").default(false),
+  maxIssuesPerMessage: import_koishi.Schema.number().description("单次推送最大 Issues 数量").default(5).min(1).max(10)
+});
+var GITEE_API_BASE = "https://gitee.com/api/v5";
+var logger = new import_koishi.Logger("gitee-is");
+function apply(ctx, config) {
+  if (config.debug) {
+    logger.level = import_koishi.Logger.DEBUG;
+  }
+  ctx.model.extend("gitee_is_repo_binding", {
+    id: {
+      type: "unsigned",
+      length: 4,
+      nullable: false
+    },
+    channelId: {
+      type: "string",
+      length: 128,
+      // 增加长度以容纳各种 ID 格式
+      nullable: false
+    },
+    owner: {
+      type: "string",
+      length: 64,
+      nullable: false
+    },
+    repo: {
+      type: "string",
+      length: 64,
+      nullable: false
+    },
+    lastCheckTime: {
+      type: "timestamp",
+      nullable: false,
+      initial: /* @__PURE__ */ new Date(0)
+    },
+    isPrivate: {
+      type: "boolean",
+      nullable: false,
+      initial: false
+    }
+  }, {
+    primary: "id",
+    autoInc: true,
+    unique: [["channelId", "owner", "repo"]]
+  });
+  function getChannelId(session) {
+    if (session.guildId) {
+      return {
+        channelId: `${session.platform}:${session.guildId}`,
+        isPrivate: false
+      };
+    } else {
+      return {
+        channelId: `${session.platform}:private:${session.userId}`,
+        isPrivate: true
+      };
+    }
+  }
+  __name(getChannelId, "getChannelId");
+  function parseChannelId(channelId) {
+    const parts = channelId.split(":");
+    if (parts.length === 3 && parts[1] === "private") {
+      return {
+        platform: parts[0],
+        targetId: parts[2],
+        isPrivate: true
+      };
+    } else if (parts.length >= 2) {
+      return {
+        platform: parts[0],
+        targetId: parts.slice(1).join(":"),
+        isPrivate: false
+      };
+    }
+    throw new Error(`Invalid channelId format: ${channelId}`);
+  }
+  __name(parseChannelId, "parseChannelId");
+  async function giteeRequest(endpoint, params) {
+    const url = `${GITEE_API_BASE}${endpoint}`;
+    try {
+      const data = await ctx.http.get(url, {
+        params: {
+          ...params,
+          access_token: config.giteeToken
+        },
+        timeout: 15e3
+      });
+      return data;
+    } catch (error) {
+      logger.error(`Gitee API 请求失败: ${endpoint}`, error);
+      throw error;
+    }
+  }
+  __name(giteeRequest, "giteeRequest");
+  const baseCommand = ctx.command("giteeis", "Gitee Issues 监控管理").usage("支持群聊和私聊使用，仓库格式为「所有者/仓库名」（如 koishijs/koishi） ");
+  baseCommand.subcommand(".add <repo:string>", "添加要监控的 Gitee 仓库").usage("添加要监控的 Gitee 仓库，格式：所有者/仓库名\n在群聊中使用则绑定到当前群，私聊中使用则绑定到当前私聊会话").example("giteeis.add koishijs/koishi").action(async ({ session }, repo) => {
+    if (!session) return "❌ 会话不存在";
+    const { channelId, isPrivate } = getChannelId(session);
+    const sceneType = isPrivate ? "私聊" : "群聊";
+    if (!repo || !repo.includes("/")) {
+      return "❌ 仓库格式错误！正确格式：所有者/仓库名（例如：koishijs/koishi）";
+    }
+    const [owner, repoName] = repo.split("/");
+    if (!owner || !repoName) {
+      return "❌ 仓库格式错误！所有者或仓库名不能为空。";
+    }
+    try {
+      await giteeRequest(`/repos/${owner}/${repoName}`);
+    } catch (error) {
+      const status = error?.response?.status;
+      if (status === 404) {
+        return `❌ 仓库 ${owner}/${repoName} 不存在！`;
+      } else if (status === 403) {
+        return `❌ 没有权限访问仓库 ${owner}/${repoName}，请检查 Token 是否有权限访问该仓库。`;
+      }
+      return `❌ 验证仓库失败：${error.message || "未知错误"}`;
+    }
+    const existing = await ctx.database.get("gitee_is_repo_binding", {
+      channelId,
+      owner,
+      repo: repoName
+    });
+    if (existing.length > 0) {
+      return `ℹ️ 该${sceneType}已绑定仓库 ${owner}/${repoName}，无需重复添加！`;
+    }
+    await ctx.database.create("gitee_is_repo_binding", {
+      channelId,
+      owner,
+      repo: repoName,
+      lastCheckTime: /* @__PURE__ */ new Date(),
+      isPrivate
+    });
+    return `✅ 成功在${sceneType}中绑定仓库 ${owner}/${repoName}！
+已开始监控其 Issues 动态，新 Issue 或更新将自动推送至此${sceneType}。`;
+  });
+  baseCommand.subcommand(".remove <repo:string>", "删除已绑定的 Gitee 仓库").usage("删除当前群聊或私聊中已绑定的 Gitee 仓库监控").example("giteeis.remove koishijs/koishi").action(async ({ session }, repo) => {
+    if (!session) return "❌ 会话不存在";
+    const { channelId, isPrivate } = getChannelId(session);
+    const sceneType = isPrivate ? "私聊" : "群聊";
+    if (!repo || !repo.includes("/")) {
+      return "❌ 仓库格式错误！正确格式：所有者/仓库名";
+    }
+    const [owner, repoName] = repo.split("/");
+    const result = await ctx.database.remove("gitee_is_repo_binding", {
+      channelId,
+      owner,
+      repo: repoName
+    });
+    const deletedCount = typeof result === "number" ? result : result.matchedCount || 0;
+    if (deletedCount > 0) {
+      return `✅ 成功删除${sceneType}中绑定的仓库 ${owner}/${repoName}！`;
+    } else {
+      return `ℹ️ 当前${sceneType}未绑定仓库 ${owner}/${repoName}，无需删除！`;
+    }
+  });
+  baseCommand.subcommand(".list", "查看当前会话已绑定的所有 Gitee 仓库").usage("查看当前群聊或私聊中已绑定的所有 Gitee 仓库列表").action(async ({ session }) => {
+    if (!session) return "❌ 会话不存在";
+    const { channelId, isPrivate } = getChannelId(session);
+    const sceneType = isPrivate ? "私聊" : "群聊";
+    const bindings = await ctx.database.get("gitee_is_repo_binding", { channelId });
+    if (bindings.length === 0) {
+      return `ℹ️ 当前${sceneType}暂未绑定任何 Gitee 仓库！
+使用 giteeis.add <所有者/仓库名> 添加监控。`;
+    }
+    const repoList = bindings.map((b) => {
+      const lastCheck = (0, import_date_fns.format)(b.lastCheckTime, "yyyy-MM-dd HH:mm:ss");
+      return `• ${b.owner}/${b.repo} (上次检查: ${lastCheck})`;
+    }).join("\n");
+    return `📋 当前${sceneType}已绑定 ${bindings.length} 个 Gitee 仓库：
+${repoList}`;
+  });
+  baseCommand.subcommand(".issues <repo:string>", "查看指定仓库的所有 Open 状态 Issues").usage("查看指定仓库当前 Open 状态的 Issues 列表（无需绑定即可查询）").example("giteeis.issues koishijs/koishi").action(async ({ session }, repo) => {
+    if (!repo || !repo.includes("/")) {
+      return "❌ 仓库格式错误！正确格式：所有者/仓库名";
+    }
+    const [owner, repoName] = repo.split("/");
+    try {
+      const issues = await giteeRequest(`/repos/${owner}/${repoName}/issues`, {
+        state: "open",
+        per_page: 20,
+        sort: "created",
+        direction: "desc"
+      });
+      if (!Array.isArray(issues) || issues.length === 0) {
+        return `ℹ️ 仓库 ${owner}/${repoName} 暂无 Open 状态的 Issues！`;
+      }
+      const issuesList = issues.map((issue) => {
+        const number = issue?.number || "未知";
+        const title = issue?.title || "无标题";
+        const author = issue?.user?.login || "未知作者";
+        const createTime = issue?.created_at ? (0, import_date_fns.format)(new Date(issue.created_at), "yyyy-MM-dd HH:mm") : "未知时间";
+        const url = issue?.html_url || "无链接";
+        const labels = issue?.labels?.map((l) => l.name).join(", ") || "无标签";
+        return `【#${number}】${title}
+作者：${author} | 标签：${labels}
+创建时间：${createTime}
+链接：${url}`;
+      }).join("\n\n");
+      return `📄 仓库 ${owner}/${repoName} 的 Open Issues（共 ${issues.length} 条）：
+
+${issuesList}`;
+    } catch (error) {
+      logger.error(`获取 Issues 失败: ${owner}/${repoName}`, error);
+      return `❌ 获取 Issues 失败！${error.message || "请检查仓库名是否正确或网络连接。"}`;
+    }
+  });
+  baseCommand.subcommand(".check", "手动触发一次 Issues 检查（调试用）").usage("立即执行一次 Issues 更新检查，不受轮询间隔限制").action(async ({ session }) => {
+    pollIssues().catch((err) => logger.error("手动检查失败", err));
+    return "🔍 已触发 Issues 检查，请留意后续消息推送。";
+  });
+  async function pollIssues() {
+    logger.debug("开始轮询检查 Gitee Issues 更新");
+    try {
+      const allBindings = await ctx.database.get("gitee_is_repo_binding", {});
+      if (allBindings.length === 0) {
+        logger.debug("暂无绑定的仓库，跳过本轮轮询");
+        return;
+      }
+      logger.debug(`开始检查 ${allBindings.length} 个绑定的仓库`);
+      for (const binding of allBindings) {
+        if (!binding?.channelId || !binding?.owner || !binding?.repo) {
+          logger.warn("无效的仓库绑定数据，跳过：", binding);
+          continue;
+        }
+        const { channelId, owner, repo, lastCheckTime, isPrivate } = binding;
+        try {
+          const { platform, targetId } = parseChannelId(channelId);
+          const issues = await giteeRequest(`/repos/${owner}/${repo}/issues`, {
+            state: "all",
+            sort: "updated",
+            direction: "desc",
+            per_page: 50,
+            since: lastCheckTime.toISOString()
+          });
+          if (!Array.isArray(issues) || issues.length === 0) {
+            logger.debug(`仓库 ${owner}/${repo} 无更新`);
+            continue;
+          }
+          const lastCheck = new Date(lastCheckTime).getTime();
+          const updatedIssues = issues.filter((issue) => {
+            const updateTime = new Date(issue?.updated_at).getTime();
+            return !isNaN(updateTime) && updateTime > lastCheck;
+          });
+          if (updatedIssues.length === 0) {
+            logger.debug(`仓库 ${owner}/${repo} 无有效更新`);
+            continue;
+          }
+          logger.info(`仓库 ${owner}/${repo} 发现 ${updatedIssues.length} 个更新的 Issues`);
+          const issuesToPush = updatedIssues.slice(0, config.maxIssuesPerMessage);
+          const remainingCount = updatedIssues.length - issuesToPush.length;
+          const pushMessages = issuesToPush.map((issue) => {
+            const issueUpdateTime = new Date(issue?.updated_at).getTime();
+            const issueCreateTime = new Date(issue?.created_at).getTime();
+            let type = "🔄 内容更新";
+            if (issueCreateTime > lastCheck) {
+              type = "🆕 新创建";
+            } else if (issue?.comments > 0) {
+              type = "💬 评论更新";
+            }
+            const number = issue?.number || "未知";
+            const title = issue?.title || "无标题";
+            const author = issue?.user?.login || "未知作者";
+            const updateTime = issue?.updated_at ? (0, import_date_fns.format)(new Date(issue.updated_at), "yyyy-MM-dd HH:mm") : "未知时间";
+            const state = issue?.state === "open" ? "🟢 Open" : "🔴 Closed";
+            const url = issue?.html_url || "无链接";
+            return `${type} Issue【#${number}】${title}
+状态：${state} | 仓库：${owner}/${repo}
+作者：${author} | 更新时间：${updateTime}
+链接：${url}`;
+          }).join("\n\n");
+          const message = remainingCount > 0 ? `${pushMessages}
+
+...还有 ${remainingCount} 条更新未显示` : pushMessages;
+          const bot = ctx.bots.find((b) => b.platform === platform);
+          if (!bot) {
+            logger.error(`未找到 ${platform} 平台的 Bot，无法推送到 ${channelId}`);
+            continue;
+          }
+          if (!bot.online) {
+            logger.warn(`Bot ${bot.selfId} (${platform}) 当前离线，跳过推送`);
+            continue;
+          }
+          if (isPrivate) {
+            await bot.sendPrivateMessage(targetId, message);
+          } else {
+            await bot.sendMessage(targetId, message);
+          }
+          logger.debug(`成功推送 ${issuesToPush.length} 条 Issues 更新到 ${channelId}`);
+        } catch (error) {
+          logger.error(`检查仓库 ${owner}/${repo} Issues 失败：`, error.message);
+          if (Math.random() < 0.2) {
+            try {
+              const { platform, targetId, isPrivate: isPrivate2 } = parseChannelId(channelId);
+              const bot = ctx.bots.find((b) => b.platform === platform && b.online);
+              if (bot) {
+                const errorMsg = `⚠️ 监控仓库 ${owner}/${repo} 时出错：${error.message?.substring(0, 100) || "未知错误"}`;
+                if (isPrivate2) {
+                  await bot.sendPrivateMessage(targetId, errorMsg);
+                } else {
+                  await bot.sendMessage(targetId, errorMsg);
+                }
+              }
+            } catch (err) {
+              logger.error("推送错误提示失败：", err);
+            }
+          }
+          continue;
+        } finally {
+          try {
+            await ctx.database.set(
+              "gitee_is_repo_binding",
+              { id: binding.id },
+              { lastCheckTime: /* @__PURE__ */ new Date() }
+            );
+          } catch (err) {
+            logger.error("更新最后检查时间失败：", err);
+          }
+        }
+      }
+    } catch (error) {
+      logger.error("轮询过程发生错误：", error.message);
+    }
+  }
+  __name(pollIssues, "pollIssues");
+  const pollTimer = ctx.setInterval(pollIssues, config.pollInterval * 1e3);
+  const initialTimer = ctx.setTimeout(() => {
+    pollIssues().catch((err) => logger.error("初始检查失败", err));
+  }, 5e3);
+  ctx.on("dispose", () => {
+    logger.info("Gitee Issues 插件已卸载，清理定时任务");
+    initialTimer();
+  });
+}
+__name(apply, "apply");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Config,
+  apply,
+  name,
+  using
+});

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "koishi-plugin-gitee-is",
+  "description": "gitee-issues",
+  "version": "0.0.1",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "src"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "gitee",
+    "koishi",
+    "plugin"
+  ],
+    "koishi": {
+    "description": {
+      "zh": "实时推送 * 非自己 * 的gitee issues的插件，支持自定义仓库和推送内容，包括评论等，适合需要监控gitee项目动态的用户使用。"
+    }
+  },
+  "peerDependencies": {
+    "koishi": "^4.18.7"
+  },
+  "dependencies": {
+    "date-fns": "^4.1.0"
+  }
+}

package/readme.md

@@ -0,0 +1,5 @@
+# koishi-plugin-gitee-is
+
+[![npm](https://img.shields.io/npm/v/koishi-plugin-gitee-is?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-gitee-is)
+
+gitee-issues

package/src/index.ts

@@ -0,0 +1,495 @@
+import { Context, Schema, Logger, Session } from 'koishi'
+import { format } from 'date-fns'
+
+// ====================== 1. 类型扩展（官方规范写法） ======================
+declare module 'koishi' {
+  interface Tables {
+    gitee_is_repo_binding: GiteeRepoBinding
+  }
+}
+
+// ====================== 2. 核心类型定义 ======================
+export interface GiteeRepoBinding {
+  id: number                // 自增主键
+  channelId: string         // 频道/会话ID（platform:guildId 或 platform:userId）
+  owner: string             // Gitee 仓库所有者
+  repo: string              // Gitee 仓库名称
+  lastCheckTime: Date       // 最后检查时间
+  isPrivate: boolean        // 是否为私聊绑定（true=私聊，false=群聊）
+}
+
+export interface Config {
+  giteeToken: string        // Gitee 私人访问令牌
+  pollInterval: number      // 轮询间隔（秒，默认 60，最小 30）
+  debug: boolean            // 是否开启调试日志
+  maxIssuesPerMessage: number // 单次推送最大 Issues 数量
+}
+
+// ====================== 3. 插件元信息 & 配置校验 ======================
+export const name = 'gitee-is'
+export const using = ['database', 'http'] as const
+
+export const Config: Schema<Config> = Schema.object({
+  giteeToken: Schema.string()
+    .description('Gitee 私人访问令牌（https://gitee.com/profile/personal_access_tokens）')
+    .required(),
+  pollInterval: Schema.number()
+    .description('Issues 轮询间隔（秒）')
+    .default(60)
+    .min(30),
+  debug: Schema.boolean()
+    .description('是否开启调试日志')
+    .default(false),
+  maxIssuesPerMessage: Schema.number()
+    .description('单次推送最大 Issues 数量')
+    .default(5)
+    .min(1)
+    .max(10),
+})
+
+// ====================== 4. 常量定义 ======================
+const GITEE_API_BASE = 'https://gitee.com/api/v5'
+const logger = new Logger('gitee-is')
+
+// ====================== 5. 插件核心逻辑 ======================
+export function apply(ctx: Context, config: Config) {
+  if (config.debug) {
+    logger.level = Logger.DEBUG
+  }
+  
+  // --------------------- 5.2 数据库模型定义 ---------------------
+  ctx.model.extend('gitee_is_repo_binding', {
+    id: {
+      type: 'unsigned',
+      length: 4,
+      nullable: false,
+    },
+    channelId: {
+      type: 'string',
+      length: 128,  // 增加长度以容纳各种 ID 格式
+      nullable: false,
+    },
+    owner: {
+      type: 'string',
+      length: 64,
+      nullable: false,
+    },
+    repo: {
+      type: 'string',
+      length: 64,
+      nullable: false,
+    },
+    lastCheckTime: {
+      type: 'timestamp',
+      nullable: false,
+      initial: new Date(0),
+    },
+    isPrivate: {
+      type: 'boolean',
+      nullable: false,
+      initial: false,
+    },
+  }, {
+    primary: 'id',
+    autoInc: true,
+    unique: [['channelId', 'owner', 'repo']],
+  })
+
+  // --------------------- 5.3 辅助函数：获取当前会话ID ---------------------
+  /**
+   * 获取当前会话的唯一标识
+   * 群聊: platform:guildId
+   * 私聊: platform:userId (private:userId)
+   */
+  function getChannelId(session: Session): { channelId: string; isPrivate: boolean } {
+    if (session.guildId) {
+      // 群聊场景
+      return {
+        channelId: `${session.platform}:${session.guildId}`,
+        isPrivate: false
+      }
+    } else {
+      // 私聊场景
+      return {
+        channelId: `${session.platform}:private:${session.userId}`,
+        isPrivate: true
+      }
+    }
+  }
+
+  /**
+   * 解析 channelId 获取 platform 和实际 ID
+   */
+  function parseChannelId(channelId: string): { platform: string; targetId: string; isPrivate: boolean } {
+    const parts = channelId.split(':')
+    
+    if (parts.length === 3 && parts[1] === 'private') {
+      // 私聊格式: platform:private:userId
+      return {
+        platform: parts[0],
+        targetId: parts[2],
+        isPrivate: true
+      }
+    } else if (parts.length >= 2) {
+      // 群聊格式: platform:guildId (guildId 可能包含冒号，取剩余部分)
+      return {
+        platform: parts[0],
+        targetId: parts.slice(1).join(':'),
+        isPrivate: false
+      }
+    }
+    
+    throw new Error(`Invalid channelId format: ${channelId}`)
+  }
+
+  // --------------------- 5.4 Gitee API 请求封装 ---------------------
+  async function giteeRequest<T>(endpoint: string, params?: Record<string, any>): Promise<T> {
+    const url = `${GITEE_API_BASE}${endpoint}`
+    try {
+      const data = await ctx.http.get(url, {
+        params: {
+          ...params,
+          access_token: config.giteeToken,
+        },
+        timeout: 15000,
+      })
+      return data as T
+    } catch (error) {
+      logger.error(`Gitee API 请求失败: ${endpoint}`, error)
+      throw error
+    }
+  }
+
+  // --------------------- 5.5 指令注册 ---------------------
+  const baseCommand = ctx.command('giteeis', 'Gitee Issues 监控管理')
+    .usage('支持群聊和私聊使用，仓库格式为「所有者/仓库名」（如 koishijs/koishi） ')
+
+  // 子指令 1：添加仓库
+  baseCommand.subcommand('.add <repo:string>', '添加要监控的 Gitee 仓库')
+    .usage('添加要监控的 Gitee 仓库，格式：所有者/仓库名\n在群聊中使用则绑定到当前群，私聊中使用则绑定到当前私聊会话')
+    .example('giteeis.add koishijs/koishi')
+    .action(async ({ session }, repo) => {
+      if (!session) return '❌ 会话不存在'
+
+      const { channelId, isPrivate } = getChannelId(session)
+      const sceneType = isPrivate ? '私聊' : '群聊'
+
+      if (!repo || !repo.includes('/')) {
+        return '❌ 仓库格式错误！正确格式：所有者/仓库名（例如：koishijs/koishi）'
+      }
+
+      const [owner, repoName] = repo.split('/')
+      if (!owner || !repoName) {
+        return '❌ 仓库格式错误！所有者或仓库名不能为空。'
+      }
+
+      // 验证仓库是否存在且可访问
+      try {
+        await giteeRequest(`/repos/${owner}/${repoName}`)
+      } catch (error: any) {
+        const status = error?.response?.status
+        if (status === 404) {
+          return `❌ 仓库 ${owner}/${repoName} 不存在！`
+        } else if (status === 403) {
+          return `❌ 没有权限访问仓库 ${owner}/${repoName}，请检查 Token 是否有权限访问该仓库。`
+        }
+        return `❌ 验证仓库失败：${error.message || '未知错误'}`
+      }
+
+      // 检查是否已绑定
+      const existing = await ctx.database.get('gitee_is_repo_binding', { 
+        channelId, 
+        owner, 
+        repo: repoName 
+      })
+
+      if (existing.length > 0) {
+        return `ℹ️ 该${sceneType}已绑定仓库 ${owner}/${repoName}，无需重复添加！`
+      }
+
+      // 创建绑定记录
+      await ctx.database.create('gitee_is_repo_binding', {
+        channelId,
+        owner,
+        repo: repoName,
+        lastCheckTime: new Date(),
+        isPrivate,
+      })
+
+      return `✅ 成功在${sceneType}中绑定仓库 ${owner}/${repoName}！\n已开始监控其 Issues 动态，新 Issue 或更新将自动推送至此${sceneType}。`
+    })
+
+  // 子指令 2：删除仓库
+  baseCommand.subcommand('.remove <repo:string>', '删除已绑定的 Gitee 仓库')
+    .usage('删除当前群聊或私聊中已绑定的 Gitee 仓库监控')
+    .example('giteeis.remove koishijs/koishi')
+    .action(async ({ session }, repo) => {
+      if (!session) return '❌ 会话不存在'
+
+      const { channelId, isPrivate } = getChannelId(session)
+      const sceneType = isPrivate ? '私聊' : '群聊'
+
+      if (!repo || !repo.includes('/')) {
+        return '❌ 仓库格式错误！正确格式：所有者/仓库名'
+      }
+
+      const [owner, repoName] = repo.split('/')
+
+      const result = await ctx.database.remove('gitee_is_repo_binding', { 
+        channelId, 
+        owner, 
+        repo: repoName 
+      })
+
+      // 兼容不同数据库驱动的返回值（number 或 WriteResult）
+      const deletedCount = typeof result === 'number' ? result : (result as any).matchedCount || 0
+
+      if (deletedCount > 0) {
+        return `✅ 成功删除${sceneType}中绑定的仓库 ${owner}/${repoName}！`
+      } else {
+        return `ℹ️ 当前${sceneType}未绑定仓库 ${owner}/${repoName}，无需删除！`
+      }
+    })
+
+  // 子指令 3：查看当前绑定的仓库
+  baseCommand.subcommand('.list', '查看当前会话已绑定的所有 Gitee 仓库')
+    .usage('查看当前群聊或私聊中已绑定的所有 Gitee 仓库列表')
+    .action(async ({ session }) => {
+      if (!session) return '❌ 会话不存在'
+
+      const { channelId, isPrivate } = getChannelId(session)
+      const sceneType = isPrivate ? '私聊' : '群聊'
+
+      const bindings = await ctx.database.get('gitee_is_repo_binding', { channelId })
+
+      if (bindings.length === 0) {
+        return `ℹ️ 当前${sceneType}暂未绑定任何 Gitee 仓库！\n使用 giteeis.add <所有者/仓库名> 添加监控。`
+      }
+
+      const repoList = bindings.map(b => {
+        const lastCheck = format(b.lastCheckTime, 'yyyy-MM-dd HH:mm:ss')
+        return `• ${b.owner}/${b.repo} (上次检查: ${lastCheck})`
+      }).join('\n')
+      
+      return `📋 当前${sceneType}已绑定 ${bindings.length} 个 Gitee 仓库：\n${repoList}`
+    })
+
+  // 子指令 4：查看仓库的 Open Issues
+  baseCommand.subcommand('.issues <repo:string>', '查看指定仓库的所有 Open 状态 Issues')
+    .usage('查看指定仓库当前 Open 状态的 Issues 列表（无需绑定即可查询）')
+    .example('giteeis.issues koishijs/koishi')
+    .action(async ({ session }, repo) => {
+      if (!repo || !repo.includes('/')) {
+        return '❌ 仓库格式错误！正确格式：所有者/仓库名'
+      }
+
+      const [owner, repoName] = repo.split('/')
+
+      try {
+        const issues = await giteeRequest<any[]>(`/repos/${owner}/${repoName}/issues`, {
+          state: 'open',
+          per_page: 20,
+          sort: 'created',
+          direction: 'desc',
+        })
+
+        if (!Array.isArray(issues) || issues.length === 0) {
+          return `ℹ️ 仓库 ${owner}/${repoName} 暂无 Open 状态的 Issues！`
+        }
+
+        const issuesList = issues.map((issue: any) => {
+          const number = issue?.number || '未知'
+          const title = issue?.title || '无标题'
+          const author = issue?.user?.login || '未知作者'
+          const createTime = issue?.created_at 
+            ? format(new Date(issue.created_at), 'yyyy-MM-dd HH:mm') 
+            : '未知时间'
+          const url = issue?.html_url || '无链接'
+          const labels = issue?.labels?.map((l: any) => l.name).join(', ') || '无标签'
+          
+          return `【#${number}】${title}\n` +
+            `作者：${author} | 标签：${labels}\n` +
+            `创建时间：${createTime}\n` +
+            `链接：${url}`
+        }).join('\n\n')
+
+        return `📄 仓库 ${owner}/${repoName} 的 Open Issues（共 ${issues.length} 条）：\n\n${issuesList}`
+      } catch (error: any) {
+        logger.error(`获取 Issues 失败: ${owner}/${repoName}`, error)
+        return `❌ 获取 Issues 失败！${error.message || '请检查仓库名是否正确或网络连接。'}`
+      }
+    })
+
+  // 子指令 5：手动触发检查
+  baseCommand.subcommand('.check', '手动触发一次 Issues 检查（调试用）')
+    .usage('立即执行一次 Issues 更新检查，不受轮询间隔限制')
+    .action(async ({ session }) => {
+      // 立即执行一次轮询
+      pollIssues().catch(err => logger.error('手动检查失败', err))
+      return '🔍 已触发 Issues 检查，请留意后续消息推送。'
+    })
+
+  // --------------------- 5.6 定时轮询逻辑 ---------------------
+  async function pollIssues() {
+    logger.debug('开始轮询检查 Gitee Issues 更新')
+
+    try {
+      const allBindings = await ctx.database.get('gitee_is_repo_binding', {})
+
+      if (allBindings.length === 0) {
+        logger.debug('暂无绑定的仓库，跳过本轮轮询')
+        return
+      }
+
+      logger.debug(`开始检查 ${allBindings.length} 个绑定的仓库`)
+
+      for (const binding of allBindings) {
+        if (!binding?.channelId || !binding?.owner || !binding?.repo) {
+          logger.warn('无效的仓库绑定数据，跳过：', binding)
+          continue
+        }
+
+        const { channelId, owner, repo, lastCheckTime, isPrivate } = binding
+        
+        try {
+          // 解析 channelId
+          const { platform, targetId } = parseChannelId(channelId)
+
+          // 获取该仓库的 Issues
+          const issues = await giteeRequest<any[]>(`/repos/${owner}/${repo}/issues`, {
+            state: 'all',
+            sort: 'updated',
+            direction: 'desc',
+            per_page: 50,
+            since: lastCheckTime.toISOString(),
+          })
+
+          if (!Array.isArray(issues) || issues.length === 0) {
+            logger.debug(`仓库 ${owner}/${repo} 无更新`)
+            continue
+          }
+
+          // 过滤出在上次检查之后有更新的 Issues
+          const lastCheck = new Date(lastCheckTime).getTime()
+          const updatedIssues = issues.filter((issue: any) => {
+            const updateTime = new Date(issue?.updated_at).getTime()
+            return !isNaN(updateTime) && updateTime > lastCheck
+          })
+
+          if (updatedIssues.length === 0) {
+            logger.debug(`仓库 ${owner}/${repo} 无有效更新`)
+            continue
+          }
+
+          logger.info(`仓库 ${owner}/${repo} 发现 ${updatedIssues.length} 个更新的 Issues`)
+
+          // 限制单次推送数量
+          const issuesToPush = updatedIssues.slice(0, config.maxIssuesPerMessage)
+          const remainingCount = updatedIssues.length - issuesToPush.length
+
+          const pushMessages = issuesToPush.map((issue: any) => {
+            const issueUpdateTime = new Date(issue?.updated_at).getTime()
+            const issueCreateTime = new Date(issue?.created_at).getTime()
+            
+            // 判断更新类型
+            let type = '🔄 内容更新'
+            if (issueCreateTime > lastCheck) {
+              type = '🆕 新创建'
+            } else if (issue?.comments > 0) {
+              type = '💬 评论更新'
+            }
+
+            const number = issue?.number || '未知'
+            const title = issue?.title || '无标题'
+            const author = issue?.user?.login || '未知作者'
+            const updateTime = issue?.updated_at 
+              ? format(new Date(issue.updated_at), 'yyyy-MM-dd HH:mm') 
+              : '未知时间'
+            const state = issue?.state === 'open' ? '🟢 Open' : '🔴 Closed'
+            const url = issue?.html_url || '无链接'
+
+            return `${type} Issue【#${number}】${title}\n` +
+              `状态：${state} | 仓库：${owner}/${repo}\n` +
+              `作者：${author} | 更新时间：${updateTime}\n` +
+              `链接：${url}`
+          }).join('\n\n')
+
+          const message = remainingCount > 0 
+            ? `${pushMessages}\n\n...还有 ${remainingCount} 条更新未显示`
+            : pushMessages
+
+          // 获取对应平台的 Bot 并发送消息
+          const bot = ctx.bots.find(b => b.platform === platform)
+          if (!bot) {
+            logger.error(`未找到 ${platform} 平台的 Bot，无法推送到 ${channelId}`)
+            continue
+          }
+
+          if (!bot.online) {
+            logger.warn(`Bot ${bot.selfId} (${platform}) 当前离线，跳过推送`)
+            continue
+          }
+
+          // 根据私聊/群聊选择不同的发送方法
+          if (isPrivate) {
+            // 私聊：使用 sendPrivateMessage
+            await bot.sendPrivateMessage(targetId, message)
+          } else {
+            // 群聊：使用 sendMessage
+            await bot.sendMessage(targetId, message)
+          }
+          
+          logger.debug(`成功推送 ${issuesToPush.length} 条 Issues 更新到 ${channelId}`)
+
+        } catch (error: any) {
+          logger.error(`检查仓库 ${owner}/${repo} Issues 失败：`, error.message)
+          
+          // 错误提示（限流）
+          if (Math.random() < 0.2) {
+            try {
+              const { platform, targetId, isPrivate } = parseChannelId(channelId)
+              const bot = ctx.bots.find(b => b.platform === platform && b.online)
+              if (bot) {
+                const errorMsg = `⚠️ 监控仓库 ${owner}/${repo} 时出错：${error.message?.substring(0, 100) || '未知错误'}`
+                if (isPrivate) {
+                  await bot.sendPrivateMessage(targetId, errorMsg)
+                } else {
+                  await bot.sendMessage(targetId, errorMsg)
+                }
+              }
+            } catch (err) {
+              logger.error('推送错误提示失败：', err)
+            }
+          }
+          continue
+        } finally {
+          // 更新最后检查时间
+          try {
+            await ctx.database.set('gitee_is_repo_binding', 
+              { id: binding.id },
+              { lastCheckTime: new Date() }
+            )
+          } catch (err) {
+            logger.error('更新最后检查时间失败：', err)
+          }
+        }
+      }
+    } catch (error: any) {
+      logger.error('轮询过程发生错误：', error.message)
+    }
+  }
+
+  // --------------------- 5.7 定时任务配置 ---------------------
+  const pollTimer = ctx.setInterval(pollIssues, config.pollInterval * 1000)
+
+  // 启动时延迟执行一次检查
+  const initialTimer = ctx.setTimeout(() => {
+    pollIssues().catch(err => logger.error('初始检查失败', err))
+  }, 5000)
+
+  // --------------------- 5.8 插件卸载清理 ---------------------
+  ctx.on('dispose', () => {
+    logger.info('Gitee Issues 插件已卸载，清理定时任务')
+    initialTimer()
+  })
+}