@jerryliang122/openclaw-qqbot 1.0.0 → 1.0.1

package/dist/index.d.cts

@@ -155,11 +155,6 @@ interface QQBotAccountConfig {
      * 禁用时：公网 URL 始终由插件先下载到本地，再以 Base64 上传（适用于 QQ 平台无法访问目标 URL 的场景）
      */
     urlDirectUpload?: boolean;
-    /**
-     * /bot-upgrade 指令返回的升级指引网址
-     * 默认: 本仓库 CHANGELOG（含各版本升级说明）
-     */
-    upgradeUrl?: string;
     /**
      * 群消息是否默认需要 @机器人才响应（默认 true）
      * 优先级低于 groups.{groupId}.requireMention 和 groups."*".requireMention

package/index.ts

@@ -1,5 +1,5 @@
 /**
- * @tencent-connect/openclaw-qqbot
+ * @jerryliang122/openclaw-qqbot
  *
  * 独立版 QQ Bot 通道插件 — 基于 @tencent-connect/qqbot-nodejs SDK 重构。
  *

package/openclaw.plugin.json

@@ -4,7 +4,7 @@
   "description": "QQ Bot channel plugin with message support, cron jobs, and proactive messaging",
   "channels": ["qqbot"],
   "extensions": ["./preload.cjs"],
-  "skills": ["skills/qqbot-channel", "skills/qqbot-remind", "skills/qqbot-upgrade"],
+  "skills": ["skills/qqbot-channel", "skills/qqbot-remind"],
   "contracts": {
     "tools": ["qqbot_platform_api", "qqbot_remind", "qqbot_secret_input"]
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jerryliang122/openclaw-qqbot",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "QQ Bot channel plugin for OpenClaw (independently maintained fork)",
   "publishConfig": {
     "access": "public",

package/src/commands/bot-help.ts

@@ -6,7 +6,7 @@ const PLUGIN_VERSION = getPackageVersion();
 
 /** 群聊时隐藏的仅限私聊指令 */
 const GROUP_EXCLUDED = new Set([
-  'bot-upgrade', 'bot-clear-storage', 'bot-logs',
+  'bot-clear-storage', 'bot-logs',
   'bot-approve', 'bot-group-always', 'bot-group-allways', 'bot-streaming', 'bot-me',
 ]);
 

package/src/commands/bot-version.ts

@@ -1,7 +1,6 @@
 import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
 import type { ResolvedQQBotAccount } from '../types.js';
 import { getPackageVersion } from '../utils/pkg-version.js';
-import { getUpdateInfo } from '../features/update-checker.js';
 import { getOpenClawVersion } from '../bot-instance.js';
 
 const PLUGIN_VERSION = getPackageVersion();
@@ -16,25 +15,15 @@ export function botVersion(_account: ResolvedQQBotAccount): SlashCommand {
       '/bot-version',
       '',
       '查看当前 QQBot 插件版本和 OpenClaw 框架版本。',
-      '同时检查是否有新版本可用。',
     ].join('\n'),
     handler: async () => {
       const frameworkVersion = getOpenClawVersion();
       const lines = [
         `🦞框架版本：${frameworkVersion}`,
         `🤖QQBot 插件版本：v${PLUGIN_VERSION}`,
+        `🌟官方 GitHub 仓库：[点击前往](${GITHUB_URL})`,
       ];
 
-      const info = await getUpdateInfo();
-      if (info.checkedAt === 0) {
-        lines.push('⏳ 版本检查中...');
-      } else if (info.error) {
-        lines.push('⚠️ 版本检查失败');
-      } else if (info.hasUpdate && info.latest) {
-        lines.push(`🆕最新可用版本：v${info.latest}，点击 <qqbot-cmd-input text="/bot-upgrade" show="/bot-upgrade"/> 查看升级指引`);
-      }
-
-      lines.push(`🌟官方 GitHub 仓库：[点击前往](${GITHUB_URL})`);
       return lines.join('\n');
     },
   };

package/src/commands/index.ts

@@ -11,7 +11,6 @@ import { botHelp } from './bot-help.js';
 import { botPing } from './bot-ping.js';
 import { botVersion } from './bot-version.js';
 import { botMe } from './bot-me.js';
-import { botUpgrade } from './bot-upgrade.js';
 import { botStreaming } from './bot-streaming.js';
 import { botClearStorage } from './bot-clear-storage.js';
 import { botLogs } from './bot-logs.js';
@@ -37,7 +36,6 @@ export function buildCommandList(account: ResolvedQQBotAccount, opts: CommandBui
     botPing(),
     botVersion(account),
     botMe(),
-    botUpgrade(account),
     botLogs(opts.getRuntime()),
     botStreaming(account, opts.getRuntime),
     botClearStorage(account),

package/src/gateway/lifecycle.ts

@@ -22,7 +22,6 @@ import { createPluginLogger } from '../utils/plugin-logger.js';
 import type { PluginLogger } from '../utils/plugin-logger.js';
 import { registerGateway, unregisterGateway, getGateway } from '../outbound/outbound-service.js';
 import { saveCredentialBackup, loadCredentialBackup } from '../features/credential-backup.js';
-import { triggerUpdateCheck } from '../features/update-checker.js';
 import { syncCommandPanels } from '../features/command-panel.js';
 import { CHANNEL_APPROVAL_NATIVE_RUNTIME_CONTEXT_CAPABILITY } from '../features/approval-capability.js';
 import { cleanupTypingByAccount } from '../typing-lifecycle.js';
@@ -111,16 +110,13 @@ async function initFeatures(
   ctx: StartAccountContext,
   log: PluginLogger,
 ): Promise<void> {
-  // 1. 版本更新检测（后台预热，fire-and-forget）
-  triggerUpdateCheck(log);
-
-  // 2. 注册 "approval.native" 运行时上下文。框架的 approval bootstrap 监听此上下文，
+  // 1. 注册 "approval.native" 运行时上下文。框架的 approval bootstrap 监听此上下文，
   //    据此为该账户自动 spawn native 审批 handler（消费 exec/plugin approval 事件，
   //    回调 qqbotPlugin.approvalCapability.nativeRuntime 的 availability/presentation/transport）。
   //    账户停止时 abortSignal 触发，上下文自动注销。
   registerApprovalNativeContext(account.accountId, ctx);
 
-  // 3. 指令面板同步：把 openclaw essential 原生指令注册到 QQ Bot 指令面板（/v2/panels）。
+  // 2. 指令面板同步：把 openclaw essential 原生指令注册到 QQ Bot 指令面板（/v2/panels）。
   //    每进程每账号仅一次；失败只记日志并由 once-guard 释放等待重连重试，不影响消息收发。
   syncCommandPanels(account, ctx.cfg, log).catch((e) => {
     log?.error(`[qqbot:${account.accountId}] command panel sync error: ${e}`);

package/src/types.ts

@@ -163,11 +163,6 @@ export interface QQBotAccountConfig {
    * 禁用时：公网 URL 始终由插件先下载到本地，再以 Base64 上传（适用于 QQ 平台无法访问目标 URL 的场景）
    */
   urlDirectUpload?: boolean;
-  /**
-   * /bot-upgrade 指令返回的升级指引网址
-   * 默认: 本仓库 CHANGELOG（含各版本升级说明）
-   */
-  upgradeUrl?: string;
   /**
    * 群消息是否默认需要 @机器人才响应（默认 true）
    * 优先级低于 groups.{groupId}.requireMention 和 groups."*".requireMention

package/skills/qqbot-upgrade/SKILL.md

@@ -1,56 +0,0 @@
----
-name: qqbot-upgrade
-description: 将 openclaw-qqbot 插件（@jerryliang122/openclaw-qqbot）升级到最新版本。当用户要求更新 QQ 机器人插件、升级 qqbot 扩展或同步最新版时使用。
-metadata: {"openclaw":{"emoji":"⬆️","requires":{"config":["channels.qqbot"]}}}
----
-
-# QQBot 插件升级
-
-## 何时使用
-
-用户表达以下意图时，应在**本机终端**执行升级命令（不要只口头说明「去官网升级」）：
-
-- 更新 / 升级 `openclaw-qqbot` / QQBot 插件 / QQ 机器人插件
-- 同步本仓库（jerryliang122/qqbot-openclaw）最新版
-
----
-
-## 标准命令
-
-npm 包（推荐）：
-
-```bash
-openclaw plugins install @jerryliang122/openclaw-qqbot
-```
-
-指定版本：
-
-```bash
-openclaw plugins install @jerryliang122/openclaw-qqbot@<version>
-```
-
-或从 GitHub（无法访问 npm 时）：
-
-```bash
-openclaw plugins install git+https://github.com/jerryliang122/qqbot-openclaw.git
-```
-
-升级完成后重启网关使其生效：
-
-```bash
-openclaw gateway restart
-```
-
----
-
-## 前置条件
-
-- OpenClaw >= 2026.9.2（低版本框架无法加载本插件）
-- 需 **Node.js / npm** 环境可访问 npm registry（或 GitHub）
-- 从 2.x 旧版本升级：先阅读仓库 CHANGELOG 的 Breaking Changes 与配置迁移表
-
----
-
-## 执行后
-
-根据命令退出码与终端输出向用户简要汇报：成功则提示新版本号并确认网关已重启；失败则摘录关键错误并提示检查网络、npm 权限与 OpenClaw 版本。

package/src/commands/bot-upgrade.ts

@@ -1,56 +0,0 @@
-import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
-import type { ResolvedQQBotAccount } from '../types.js';
-import { getPackageVersion } from '../utils/pkg-version.js';
-import { getUpdateInfo } from '../features/update-checker.js';
-import { checkCommandAuth } from './config-util.js';
-
-const PLUGIN_VERSION = getPackageVersion();
-const DEFAULT_UPGRADE_URL = 'https://github.com/jerryliang122/qqbot-openclaw/blob/main/CHANGELOG.md';
-const GITHUB_URL = 'https://github.com/jerryliang122/qqbot-openclaw';
-
-/** /bot-upgrade — 检查更新并查看升级指引 */
-export function botUpgrade(account: ResolvedQQBotAccount): SlashCommand {
-  return {
-    name: 'bot-upgrade',
-    description: '检查更新并查看升级指引',
-    scope: 'c2c',
-    authorized: checkCommandAuth,
-    usage: [
-      '/bot-upgrade              检查是否有新版本',
-    ].join('\n'),
-    handler: async () => {
-      const url = account.config.upgradeUrl ?? DEFAULT_UPGRADE_URL;
-      const info = await getUpdateInfo();
-
-      if (info.checkedAt === 0) {
-        return '⏳ 版本检查中，请稍后再试';
-      }
-
-      if (info.error) {
-        return [
-          '❌ 主机网络访问异常，无法检查更新',
-          '',
-          `查看升级指引：[点击查看](${url})`,
-        ].join('\n');
-      }
-
-      if (!info.hasUpdate) {
-        return [
-          `✅ 当前已是最新版本 v${PLUGIN_VERSION}`,
-          '',
-          `项目地址：[GitHub](${GITHUB_URL})`,
-        ].join('\n');
-      }
-
-      return [
-        '🆕 发现新版本',
-        '',
-        `当前版本：**v${PLUGIN_VERSION}**`,
-        `最新版本：**v${info.latest}**`,
-        '',
-        `📖 升级指引：[点击查看](${url})`,
-        `🌟 GitHub 仓库：[点击前往](${GITHUB_URL})`,
-      ].join('\n');
-    },
-  };
-}

package/src/features/update-checker.ts

@@ -1,166 +0,0 @@
-/**
- * 版本检查器
- *
- * - triggerUpdateCheck(): gateway 启动时调用，后台预热缓存
- * - getUpdateInfo(): 每次实时查询 npm registry，返回最新结果
- *
- * 使用 HTTPS 直接请求 npm registry API（不依赖 npm CLI），
- * 支持多 registry fallback：npmjs.org → npmmirror.com，解决国内网络问题。
- */
-
-import https from "node:https";
-import { getPackageVersion } from "../utils/pkg-version.js";
-import type { PluginLogger } from '../utils/plugin-logger.js';
-
-const PKG_NAME = "@jerryliang122/openclaw-qqbot";
-const ENCODED_PKG = encodeURIComponent(PKG_NAME);
-
-const REGISTRIES = [
-  `https://registry.npmjs.org/${ENCODED_PKG}`,
-  `https://registry.npmmirror.com/${ENCODED_PKG}`,
-];
-
-let CURRENT_VERSION = getPackageVersion();
-
-export interface UpdateInfo {
-  current: string;
-  latest: string | null;
-  stable: string | null;
-  alpha: string | null;
-  hasUpdate: boolean;
-  checkedAt: number;
-  error?: string;
-}
-
-function fetchJson(url: string, timeoutMs: number): Promise<any> {
-  return new Promise((resolve, reject) => {
-    const req = https.get(url, { timeout: timeoutMs, headers: { Accept: "application/json" } }, (res) => {
-      if (res.statusCode !== 200) {
-        res.resume();
-        reject(new Error(`HTTP ${res.statusCode} from ${url}`));
-        return;
-      }
-      let data = "";
-      res.on("data", (chunk: string) => { data += chunk; });
-      res.on("end", () => {
-        try { resolve(JSON.parse(data)); } catch (e) { reject(e); }
-      });
-    });
-    req.on("error", reject);
-    req.on("timeout", () => { req.destroy(); reject(new Error(`timeout fetching ${url}`)); });
-  });
-}
-
-async function fetchDistTags(log?: PluginLogger): Promise<Record<string, string>> {
-  for (const url of REGISTRIES) {
-    try {
-      const json = await fetchJson(url, 10_000);
-      const tags = json["dist-tags"];
-      if (tags && typeof tags === "object") return tags;
-    } catch (e: any) {
-      log?.debug(`[update-checker] ${url} failed: ${e.message}`);
-    }
-  }
-  throw new Error("all registries failed");
-}
-
-function buildUpdateInfo(tags: Record<string, string>): UpdateInfo {
-  const currentIsPrerelease = CURRENT_VERSION.includes("-");
-  const stableTag = tags.latest || null;
-  const alphaTag = tags.alpha || null;
-
-  const compareTarget = currentIsPrerelease ? alphaTag : stableTag;
-
-  const hasUpdate = typeof compareTarget === "string"
-    && compareTarget !== CURRENT_VERSION
-    && compareVersions(compareTarget, CURRENT_VERSION) > 0;
-
-  return {
-    current: CURRENT_VERSION,
-    latest: compareTarget,
-    stable: stableTag,
-    alpha: alphaTag,
-    hasUpdate,
-    checkedAt: Date.now(),
-  };
-}
-
-/**
- * Gateway 启动时调用，后台预热版本缓存。
- * log 通过闭包传递，避免模块级可变状态。
- */
-export function triggerUpdateCheck(log: PluginLogger): void {
-  getUpdateInfo(log).then((info) => {
-    if (info.hasUpdate) {
-      log.info(`[update-checker] new version available: ${info.latest} (current: ${CURRENT_VERSION})`);
-    }
-  }).catch(() => {});
-}
-
-/** 每次实时查询 npm registry */
-export async function getUpdateInfo(log?: PluginLogger): Promise<UpdateInfo> {
-  try {
-    const tags = await fetchDistTags(log);
-    return buildUpdateInfo(tags);
-  } catch (err: any) {
-    log?.debug(`[update-checker] check failed: ${err.message}`);
-    return { current: CURRENT_VERSION, latest: null, stable: null, alpha: null, hasUpdate: false, checkedAt: Date.now(), error: err.message };
-  }
-}
-
-/**
- * 检查指定版本是否存在于 npm registry
- */
-export async function checkVersionExists(version: string, pkgName?: string): Promise<boolean> {
-  const registries = pkgName ? buildRegistries(pkgName) : REGISTRIES;
-  for (const baseUrl of registries) {
-    try {
-      const url = `${baseUrl}/${version}`;
-      const json = await fetchJson(url, 10_000);
-      if (json && json.version === version) return true;
-    } catch {
-      // try next registry
-    }
-  }
-  return false;
-}
-
-function buildRegistries(pkgName: string): string[] {
-  const encoded = encodeURIComponent(pkgName);
-  return [
-    `https://registry.npmjs.org/${encoded}`,
-    `https://registry.npmmirror.com/${encoded}`,
-  ];
-}
-
-function compareVersions(a: string, b: string): number {
-  const parse = (v: string) => {
-    const clean = v.replace(/^v/, "");
-    const [main, pre] = clean.split("-", 2);
-    return { parts: main.split(".").map(Number), pre: pre || null };
-  };
-  const pa = parse(a);
-  const pb = parse(b);
-  for (let i = 0; i < 3; i++) {
-    const diff = (pa.parts[i] || 0) - (pb.parts[i] || 0);
-    if (diff !== 0) return diff;
-  }
-  if (!pa.pre && pb.pre) return 1;
-  if (pa.pre && !pb.pre) return -1;
-  if (!pa.pre && !pb.pre) return 0;
-  const aParts = pa.pre!.split(".");
-  const bParts = pb.pre!.split(".");
-  for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
-    const aP = aParts[i] ?? "";
-    const bP = bParts[i] ?? "";
-    const aNum = Number(aP);
-    const bNum = Number(bP);
-    if (!isNaN(aNum) && !isNaN(bNum)) {
-      if (aNum !== bNum) return aNum - bNum;
-    } else {
-      if (aP < bP) return -1;
-      if (aP > bP) return 1;
-    }
-  }
-  return 0;
-}