koishi-plugin-github-webhook-pusher 0.0.1

package/lib/message.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 消息构建器
+ * 需求: 5.3, 5.4, 5.5
+ */
+import { Element } from 'koishi';
+import { ParsedEvent } from './types';
+/**
+ * 构建推送消息
+ * @param event 解析后的事件
+ * @returns Koishi Element 消息数组
+ */
+export declare function buildMessage(event: ParsedEvent): Element[];

package/lib/parser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GitHub Webhook 事件解析器
+ * 需求: 4.1-4.7
+ */
+import { ParsedEvent } from './types';
+/**
+ * 解析 Issues 事件
+ * 需求 4.1: 提取 issue 标题、编号、操作者和链接
+ */
+export declare function parseIssuesEvent(payload: any): ParsedEvent | null;
+/**
+ * 解析 Release 事件
+ * 需求 4.2: 提取版本号、发布者和下载链接
+ */
+export declare function parseReleaseEvent(payload: any): ParsedEvent | null;
+/**
+ * 解析 Push 事件
+ * 需求 4.3, 4.6: 提取分支名、提交列表（最多5条）和推送者信息
+ */
+export declare function parsePushEvent(payload: any): ParsedEvent | null;
+/**
+ * 解析 Pull Request 事件
+ * 需求 4.4: 提取 PR 标题、编号、操作者和链接
+ */
+export declare function parsePullRequestEvent(payload: any): ParsedEvent | null;
+/**
+ * 解析 Star 事件
+ * 需求 4.5: 提取操作者和当前 star 数量
+ */
+export declare function parseStarEvent(payload: any): ParsedEvent | null;
+/**
+ * 统一的事件解析入口函数
+ * @param eventName X-GitHub-Event 头的值
+ * @param payload 解析后的 JSON 负载
+ * @returns 解析后的事件数据，不支持的事件返回 null
+ */
+export declare function parseEvent(eventName: string, payload: any): ParsedEvent | null;

package/lib/pusher.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 消息推送器
+ * 需求: 5.1, 5.2, 5.6, 5.7
+ */
+import { Context, Element } from 'koishi';
+import { EventType, ParsedEvent } from './types';
+import { PushTarget } from './repository/subscription';
+/** 推送结果 */
+export interface PushResult {
+    target: PushTarget;
+    success: boolean;
+    error?: Error;
+}
+/**
+ * 查询订阅目标
+ * 需求 5.1: 查询所有订阅该仓库的目标会话
+ * 需求 5.2: 根据订阅的事件类型过滤目标
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @param eventType 事件类型
+ * @returns 推送目标列表
+ */
+export declare function queryTargets(ctx: Context, repo: string, eventType: EventType): Promise<PushTarget[]>;
+/**
+ * 并发推送消息到多个目标
+ * 需求 5.6: 使用 Promise.allSettled 并发推送并限制并发数
+ * 需求 5.7: 推送失败记录错误日志但不影响其他目标的推送
+ * @param ctx Koishi 上下文
+ * @param targets 推送目标列表
+ * @param message 消息内容
+ * @param concurrency 并发数限制
+ * @returns 推送结果列表
+ */
+export declare function pushWithConcurrency(ctx: Context, targets: PushTarget[], message: Element[], concurrency: number): Promise<PushResult[]>;
+/**
+ * 推送消息到所有订阅目标
+ * @param ctx Koishi 上下文
+ * @param event 解析后的事件
+ * @param concurrency 并发数限制
+ * @returns 推送结果列表
+ */
+export declare function pushMessage(ctx: Context, event: ParsedEvent, concurrency?: number): Promise<PushResult[]>;
+/**
+ * 推送事件（完整流程）
+ * 整合事件解析、消息构建和推送
+ * @param ctx Koishi 上下文
+ * @param event 解析后的事件
+ * @param concurrency 并发数限制
+ * @returns 推送结果
+ */
+export declare function pushEvent(ctx: Context, event: ParsedEvent, concurrency?: number): Promise<{
+    pushed: number;
+    failed: number;
+    results: PushResult[];
+}>;

package/lib/repository/delivery.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 投递记录数据访问层
+ * 需求: 1.6
+ */
+import { Context } from 'koishi';
+import { Delivery } from '../database';
+/**
+ * 记录投递
+ * 需求 1.6: 记录 Delivery ID 用于去重
+ * @param ctx Koishi 上下文
+ * @param deliveryId GitHub Delivery ID
+ * @param repo 仓库名 (owner/repo)
+ * @param event 事件类型
+ * @returns 创建的投递记录
+ */
+export declare function recordDelivery(ctx: Context, deliveryId: string, repo: string, event: string): Promise<Delivery>;
+/**
+ * 检查是否已投递
+ * 需求 1.6: 检查 Delivery ID 是否已处理过，用于去重
+ * @param ctx Koishi 上下文
+ * @param deliveryId GitHub Delivery ID
+ * @returns 是否已投递
+ */
+export declare function isDelivered(ctx: Context, deliveryId: string): Promise<boolean>;
+/**
+ * 获取投递记录
+ * @param ctx Koishi 上下文
+ * @param deliveryId GitHub Delivery ID
+ * @returns 投递记录，不存在返回 null
+ */
+export declare function getDelivery(ctx: Context, deliveryId: string): Promise<Delivery | null>;
+/**
+ * 清理旧的投递记录
+ * @param ctx Koishi 上下文
+ * @param beforeDate 清理此日期之前的记录
+ * @returns 清理的记录数
+ */
+export declare function cleanupDeliveries(ctx: Context, beforeDate: Date): Promise<number>;

package/lib/repository/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 数据访问层导出
+ */
+export * from './trust';
+export * from './subscription';
+export * from './delivery';

package/lib/repository/subscription.d.ts

@@ -0,0 +1,99 @@
+/**
+ * 订阅数据访问层
+ * 需求: 3.1-3.7, 5.1, 5.2
+ */
+import { Context } from 'koishi';
+import { Subscription } from '../database';
+import { EventType } from '../types';
+/** 推送目标信息 */
+export interface PushTarget {
+    platform: string;
+    channelId: string;
+    guildId?: string;
+    userId?: string;
+}
+/** 会话标识 */
+export interface SessionIdentifier {
+    platform: string;
+    channelId: string;
+    guildId?: string;
+    userId?: string;
+}
+/**
+ * 创建订阅
+ * 需求 3.1: 为当前会话创建订阅记录
+ * @param ctx Koishi 上下文
+ * @param session 会话标识
+ * @param repo 仓库名 (owner/repo)
+ * @param defaultEvents 默认事件列表
+ * @returns 创建的订阅记录
+ */
+export declare function createSubscription(ctx: Context, session: SessionIdentifier, repo: string, defaultEvents: EventType[]): Promise<Subscription>;
+/**
+ * 移除订阅
+ * 需求 3.3: 移除当前会话对该仓库的订阅
+ * @param ctx Koishi 上下文
+ * @param session 会话标识
+ * @param repo 仓库名 (owner/repo)
+ * @returns 是否成功移除
+ */
+export declare function removeSubscription(ctx: Context, session: SessionIdentifier, repo: string): Promise<boolean>;
+/**
+ * 列出会话的所有订阅
+ * 需求 3.4: 显示当前会话的所有订阅及其事件设置
+ * @param ctx Koishi 上下文
+ * @param session 会话标识
+ * @returns 订阅列表
+ */
+export declare function listSubscriptions(ctx: Context, session: SessionIdentifier): Promise<Subscription[]>;
+/**
+ * 获取单个订阅
+ * 需求 3.5: 显示该仓库订阅的事件类型列表
+ * @param ctx Koishi 上下文
+ * @param session 会话标识
+ * @param repo 仓库名 (owner/repo)
+ * @returns 订阅记录，不存在返回 null
+ */
+export declare function getSubscription(ctx: Context, session: SessionIdentifier, repo: string): Promise<Subscription | null>;
+/**
+ * 更新订阅的事件类型
+ * 需求 3.6: 根据 +/- 前缀启用或禁用对应事件类型
+ * @param ctx Koishi 上下文
+ * @param session 会话标识
+ * @param repo 仓库名 (owner/repo)
+ * @param events 新的事件列表
+ * @returns 是否成功更新
+ */
+export declare function updateEvents(ctx: Context, session: SessionIdentifier, repo: string, events: EventType[]): Promise<boolean>;
+/**
+ * 查询订阅目标
+ * 需求 5.1, 5.2: 查询所有订阅该仓库的目标会话，并根据事件类型过滤
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @param eventType 事件类型
+ * @returns 推送目标列表
+ */
+export declare function queryTargets(ctx: Context, repo: string, eventType: EventType): Promise<PushTarget[]>;
+/**
+ * 获取仓库的所有订阅
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @returns 订阅列表
+ */
+export declare function getRepoSubscriptions(ctx: Context, repo: string): Promise<Subscription[]>;
+/**
+ * 启用订阅
+ * @param ctx Koishi 上下文
+ * @param session 会话标识
+ * @param repo 仓库名 (owner/repo)
+ * @returns 是否成功启用
+ */
+export declare function enableSubscription(ctx: Context, session: SessionIdentifier, repo: string): Promise<boolean>;
+/**
+ * 禁用订阅
+ * @param ctx Koishi 上下文
+ * @param session 会话标识
+ * @param repo 仓库名 (owner/repo)
+ * @returns 是否成功禁用
+ */
+export declare function disableSubscription(ctx: Context, session: SessionIdentifier, repo: string): Promise<boolean>;

package/lib/repository/trust.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 信任仓库数据访问层
+ * 需求: 2.1-2.7
+ */
+import { Context } from 'koishi';
+import { TrustedRepo } from '../database';
+/**
+ * 验证仓库名格式是否符合 owner/repo 格式
+ * @param repo 仓库名
+ * @returns 是否有效
+ */
+export declare function isValidRepoFormat(repo: string): boolean;
+/**
+ * 添加信任仓库
+ * 需求 2.1: 将仓库添加到信任列表并持久化到数据库
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @returns 添加的仓库记录，如果格式错误返回 null
+ */
+export declare function addTrustedRepo(ctx: Context, repo: string): Promise<TrustedRepo | null>;
+/**
+ * 移除信任仓库
+ * 需求 2.2: 从信任列表中移除该仓库
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @returns 是否成功移除
+ */
+export declare function removeTrustedRepo(ctx: Context, repo: string): Promise<boolean>;
+/**
+ * 列出所有信任仓库
+ * 需求 2.3: 显示所有信任仓库及其启用状态
+ * @param ctx Koishi 上下文
+ * @returns 信任仓库列表
+ */
+export declare function listTrustedRepos(ctx: Context): Promise<TrustedRepo[]>;
+/**
+ * 检查仓库是否在信任列表中且已启用
+ * 需求 2.6: 验证仓库是否可以处理事件
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @returns 是否信任且启用
+ */
+export declare function isTrusted(ctx: Context, repo: string): Promise<boolean>;
+/**
+ * 检查仓库是否在信任列表中（不考虑启用状态）
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @returns 是否在信任列表中
+ */
+export declare function isInTrustList(ctx: Context, repo: string): Promise<boolean>;
+/**
+ * 启用信任仓库
+ * 需求 2.4: 启用该仓库的事件处理
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @returns 是否成功启用
+ */
+export declare function enableRepo(ctx: Context, repo: string): Promise<boolean>;
+/**
+ * 禁用信任仓库
+ * 需求 2.5: 禁用该仓库的事件处理
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @returns 是否成功禁用
+ */
+export declare function disableRepo(ctx: Context, repo: string): Promise<boolean>;
+/**
+ * 获取单个信任仓库信息
+ * @param ctx Koishi 上下文
+ * @param repo 仓库名 (owner/repo)
+ * @returns 仓库信息，不存在返回 null
+ */
+export declare function getTrustedRepo(ctx: Context, repo: string): Promise<TrustedRepo | null>;

package/lib/signature.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 创建 GitHub Webhook 签名
+ * @param payload 原始请求体
+ * @param secret Webhook Secret
+ * @returns 签名字符串，格式为 sha256=<hex_digest>
+ */
+export declare function createSignature(payload: string, secret: string): string;
+/**
+ * 验证 GitHub Webhook 签名
+ * @param payload 原始请求体
+ * @param signature X-Hub-Signature-256 头的值
+ * @param secret 配置的 Webhook Secret
+ * @returns 签名是否有效
+ */
+export declare function verifySignature(payload: string, signature: string, secret: string): boolean;

package/lib/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 事件类型和接口定义
+ * 需求: 4.1-4.7
+ */
+/** 支持的事件类型 */
+export type EventType = 'issues' | 'release' | 'push' | 'pull_request' | 'star';
+/** 提交信息 */
+export interface CommitInfo {
+    sha: string;
+    message: string;
+    author: string;
+    url: string;
+}
+/** 解析后的事件数据 */
+export interface ParsedEvent {
+    type: EventType;
+    displayType: string;
+    repo: string;
+    actor: string;
+    action?: string;
+    title?: string;
+    number?: number;
+    url: string;
+    body?: string;
+    commits?: CommitInfo[];
+    totalCommits?: number;
+    ref?: string;
+    tagName?: string;
+    starCount?: number;
+}
+/** 事件类型显示信息 */
+export interface EventDisplayInfo {
+    name: string;
+    emoji: string;
+}
+/** 事件类型到显示名称和 emoji 的映射 */
+export declare const EVENT_DISPLAY_MAP: Record<EventType, EventDisplayInfo>;
+/**
+ * 获取事件类型的显示名称
+ * @param type 事件类型
+ * @returns 显示名称
+ */
+export declare function getDisplayType(type: EventType): string;
+/**
+ * 获取事件类型的 emoji
+ * @param type 事件类型
+ * @returns emoji 字符
+ */
+export declare function getEventEmoji(type: EventType): string;

package/lib/webhook.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Webhook 处理器
+ * 需求: 1.1-1.6, 2.6, 9.1-9.6
+ */
+import { Context } from 'koishi';
+import type { Context as KoaContext } from 'koa';
+import { Config } from './config';
+declare module 'koishi' {
+    interface Context {
+        server: {
+            post(path: string, handler: (ctx: KoaContext) => Promise<void>): void;
+        };
+    }
+}
+/**
+ * 注册 Webhook 处理器
+ * 需求 1.1: 在配置的路径上监听 HTTP POST 请求
+ * @param ctx Koishi 上下文
+ * @param config 插件配置
+ */
+export declare function registerWebhook(ctx: Context, config: Config): void;

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "koishi-plugin-github-webhook-pusher",
+  "description": "GitHub Webhook 事件推送插件",
+  "version": "0.0.1",
+  "contributors": [
+    "ClozyA <aoxuan233@gmail.com>"
+  ],
+  "homepage": "https://github.com/ClozyA/github-webhook-pusher",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ClozyA/github-webhook-pusher.git"
+  },
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "dist"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "test": "vitest --run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "chatbot",
+    "koishi",
+    "plugin",
+    "github",
+    "webhook"
+  ],
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "fast-check": "^3.22.0",
+    "koishi": "^4.18.7",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8"
+  },
+  "peerDependencies": {
+    "koishi": "^4.18.7"
+  },
+  "koishi": {
+    "description": {
+      "zh": "接收 GitHub Webhook 事件并推送到群聊，支持 Issues、Release、Push、PR、Star 等事件",
+      "en": "Receive GitHub Webhook events and push to chat groups, supporting Issues, Release, Push, PR, Star events"
+    },
+    "service": {
+      "required": [
+        "server",
+        "database"
+      ],
+      "optional": [],
+      "implements": []
+    }
+  }
+}

package/readme.md

@@ -0,0 +1,210 @@
+# koishi-plugin-github-webhook-pusher
+
+[![npm](https://img.shields.io/npm/v/koishi-plugin-github-webhook-pusher?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-github-webhook-pusher)
+
+Koishi 机器人框架的 GitHub Webhook 推送插件，支持将 GitHub 仓库事件（Issues、Release、Push、PR、Star）推送到 QQ 群聊或私聊。
+
+## 功能特性
+
+- 🔐 **安全验证** - 支持 HMAC SHA256 签名验证，确保 Webhook 请求来源可信
+- 📋 **信任仓库管理** - 管理员可控制哪些仓库的事件可以被处理
+- 🔔 **灵活订阅** - 用户可自由订阅感兴趣的仓库和事件类型
+- 📨 **多事件支持** - 支持 Issues、Release、Push、Pull Request、Star 等事件
+- 🚀 **并发推送** - 支持并发推送到多个订阅目标，可配置并发数
+- 💾 **数据持久化** - 订阅和信任仓库数据持久化存储
+
+## 安装
+
+### 通过 Koishi 插件市场安装
+
+在 Koishi 控制台的插件市场中搜索 `github-webhook-pusher` 并安装。
+
+### 通过 npm 安装
+
+```bash
+npm install koishi-plugin-github-webhook-pusher
+```
+
+## 配置说明
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| `path` | string | `/github/webhook` | Webhook 接收路径 |
+| `secret` | string | (必填) | GitHub Webhook Secret，用于签名验证 |
+| `baseUrl` | string | - | 显示用基础 URL |
+| `defaultEvents` | string[] | `['issues', 'release', 'push']` | 新订阅的默认事件类型 |
+| `debug` | boolean | `false` | 启用调试模式，输出详细日志 |
+| `allowUntrusted` | boolean | `false` | 是否允许处理非信任仓库的事件 |
+| `concurrency` | number | `5` | 消息推送并发数 |
+
+### 配置示例
+
+```yaml
+plugins:
+  github-webhook-pusher:
+    path: /github/webhook
+    secret: your-webhook-secret-here
+    defaultEvents:
+      - issues
+      - release
+      - push
+    debug: false
+    allowUntrusted: false
+    concurrency: 5
+```
+
+## GitHub Webhook 设置指南
+
+### 1. 获取 Webhook URL
+
+你的 Webhook URL 格式为：
+```
+https://your-koishi-server.com/github/webhook
+```
+
+其中 `/github/webhook` 是默认路径，可通过 `path` 配置项修改。
+
+### 2. 在 GitHub 仓库中配置 Webhook
+
+1. 进入你的 GitHub 仓库
+2. 点击 **Settings** → **Webhooks** → **Add webhook**
+3. 填写以下信息：
+   - **Payload URL**: 你的 Webhook URL
+   - **Content type**: `application/json`
+   - **Secret**: 与插件配置中的 `secret` 保持一致
+   - **Which events would you like to trigger this webhook?**: 选择需要的事件
+     - Issues
+     - Releases
+     - Pushes
+     - Pull requests
+     - Stars (Watch)
+4. 点击 **Add webhook** 保存
+
+### 3. 验证配置
+
+配置完成后，GitHub 会发送一个 ping 事件。你可以在 Webhook 设置页面查看投递记录，确认是否收到 200 响应。
+
+
+## 命令使用说明
+
+### 信任仓库管理（管理员）
+
+信任仓库是可以被订阅的仓库白名单，只有管理员可以管理。
+
+| 命令 | 说明 | 示例 |
+|------|------|------|
+| `gh.trust.add <repo>` | 添加信任仓库 | `gh.trust.add koishijs/koishi` |
+| `gh.trust.remove <repo>` | 移除信任仓库 | `gh.trust.remove koishijs/koishi` |
+| `gh.trust.list` | 列出所有信任仓库 | `gh.trust.list` |
+| `gh.trust.enable <repo>` | 启用信任仓库 | `gh.trust.enable koishijs/koishi` |
+| `gh.trust.disable <repo>` | 禁用信任仓库 | `gh.trust.disable koishijs/koishi` |
+
+### 订阅管理
+
+用户可以订阅信任列表中的仓库，接收事件通知。
+
+| 命令 | 说明 | 示例 |
+|------|------|------|
+| `gh.sub <repo>` | 订阅仓库 | `gh.sub koishijs/koishi` |
+| `gh.unsub <repo>` | 取消订阅 | `gh.unsub koishijs/koishi` |
+| `gh.list` | 列出当前会话的所有订阅 | `gh.list` |
+| `gh.events <repo>` | 查看订阅的事件类型 | `gh.events koishijs/koishi` |
+| `gh.events <repo> +/-event` | 修改订阅的事件类型 | `gh.events koishijs/koishi +issues -star` |
+
+### 工具命令
+
+| 命令 | 说明 | 示例 |
+|------|------|------|
+| `gh.ping` | 查看插件状态 | `gh.ping` |
+| `gh.test <repo> <event>` | 生成测试消息（管理员） | `gh.test koishijs/koishi push` |
+
+## 支持的事件类型
+
+| 事件类型 | 显示名称 | Emoji | 说明 |
+|----------|----------|-------|------|
+| `issues` | Issue | 📌 | Issue 的创建、关闭、重新打开、编辑 |
+| `release` | Release | 🚀 | 版本发布 |
+| `push` | Commit | ⬆️ | 代码推送（最多显示 5 条提交） |
+| `pull_request` | PR | 🔀 | Pull Request 的创建、关闭、合并 |
+| `star` | Star | ⭐ | Star 操作 |
+
+## 消息格式示例
+
+### Issues 事件
+```
+📌 [owner/repo] Issue
+user opened #123: Issue 标题
+https://github.com/owner/repo/issues/123
+```
+
+### Push 事件
+```
+⬆️ [owner/repo] Commit
+user 推送了 3 个提交到 main
+
+• abc1234 - 提交消息1
+• def5678 - 提交消息2
+• ghi9012 - 提交消息3
+
+https://github.com/owner/repo/compare/...
+```
+
+### Release 事件
+```
+🚀 [owner/repo] Release
+user 发布了 v1.0.0
+https://github.com/owner/repo/releases/tag/v1.0.0
+```
+
+## 常见问题解答
+
+### Q: Webhook 返回 401 错误？
+
+**A:** 签名验证失败。请检查：
+1. GitHub Webhook 设置中的 Secret 与插件配置的 `secret` 是否一致
+2. Content type 是否设置为 `application/json`
+
+### Q: 收不到 Webhook 事件？
+
+**A:** 请检查：
+1. Koishi 服务器是否可以从公网访问
+2. Webhook URL 是否正确（包括端口号）
+3. 防火墙是否允许 GitHub 的 IP 访问
+4. 在 GitHub Webhook 设置页面查看投递记录，确认请求是否发送成功
+
+### Q: 订阅仓库时提示"不在信任列表中"？
+
+**A:** 需要管理员先使用 `gh.trust.add owner/repo` 将仓库添加到信任列表。
+
+### Q: 如何修改订阅的事件类型？
+
+**A:** 使用 `gh.events` 命令：
+- 添加事件：`gh.events owner/repo +issues +release`
+- 移除事件：`gh.events owner/repo -star -push`
+- 混合操作：`gh.events owner/repo +issues -star`
+
+### Q: 如何查看当前订阅了哪些仓库？
+
+**A:** 使用 `gh.list` 命令查看当前会话的所有订阅。
+
+### Q: 消息推送失败会影响其他订阅者吗？
+
+**A:** 不会。插件使用错误隔离机制，单个目标的推送失败不会影响其他目标。
+
+### Q: 如何测试消息格式？
+
+**A:** 管理员可以使用 `gh.test owner/repo event` 命令生成测试消息，例如：
+```
+gh.test koishijs/koishi issues
+gh.test koishijs/koishi push
+```
+
+## 依赖
+
+- Koishi 4.x
+- 需要 `server` 服务（提供 HTTP 路由）
+- 需要 `database` 服务（数据持久化）
+
+## 许可证
+
+MIT License