agentdev 0.1.8 → 0.1.9

package/node_modules/@sliverp/qqbot/bin/qqbot-cli.js

@@ -0,0 +1,227 @@
+#!/usr/bin/env node
+
+/**
+ * QQBot CLI - 用于升级和管理 QQBot 插件
+ * 
+ * 用法:
+ *   npx @sliverp/qqbot upgrade    # 升级插件
+ *   npx @sliverp/qqbot install    # 安装插件
+ */
+
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, writeFileSync, rmSync } from 'fs';
+import { homedir } from 'os';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// 获取包的根目录
+const PKG_ROOT = join(__dirname, '..');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+// 检测使用的是 clawdbot 还是 openclaw
+function detectInstallation() {
+  const home = homedir();
+  if (existsSync(join(home, '.openclaw'))) {
+    return 'openclaw';
+  }
+  if (existsSync(join(home, '.clawdbot'))) {
+    return 'clawdbot';
+  }
+  return null;
+}
+
+// 清理旧版本插件，返回旧的 qqbot 配置
+function cleanupInstallation(appName) {
+  const home = homedir();
+  const appDir = join(home, `.${appName}`);
+  const configFile = join(appDir, `${appName}.json`);
+  const extensionDir = join(appDir, 'extensions', 'qqbot');
+
+  let oldQqbotConfig = null;
+
+  console.log(`\n>>> 处理 ${appName} 安装...`);
+
+  // 1. 先读取旧的 qqbot 配置
+  if (existsSync(configFile)) {
+    try {
+      const config = JSON.parse(readFileSync(configFile, 'utf8'));
+      if (config.channels?.qqbot) {
+        oldQqbotConfig = { ...config.channels.qqbot };
+        console.log('已保存旧的 qqbot 配置');
+      }
+    } catch (err) {
+      console.error('读取配置文件失败:', err.message);
+    }
+  }
+
+  // 2. 删除旧的扩展目录
+  if (existsSync(extensionDir)) {
+    console.log(`删除旧版本插件: ${extensionDir}`);
+    rmSync(extensionDir, { recursive: true, force: true });
+  } else {
+    console.log('未找到旧版本插件目录，跳过删除');
+  }
+
+  // 3. 清理配置文件中的 qqbot 相关字段
+  if (existsSync(configFile)) {
+    console.log('清理配置文件中的 qqbot 字段...');
+    try {
+      const config = JSON.parse(readFileSync(configFile, 'utf8'));
+
+      // 删除 channels.qqbot
+      if (config.channels?.qqbot) {
+        delete config.channels.qqbot;
+        console.log('  - 已删除 channels.qqbot');
+      }
+
+      // 删除 plugins.entries.qqbot
+      if (config.plugins?.entries?.qqbot) {
+        delete config.plugins.entries.qqbot;
+        console.log('  - 已删除 plugins.entries.qqbot');
+      }
+
+      // 删除 plugins.installs.qqbot
+      if (config.plugins?.installs?.qqbot) {
+        delete config.plugins.installs.qqbot;
+        console.log('  - 已删除 plugins.installs.qqbot');
+      }
+
+      writeFileSync(configFile, JSON.stringify(config, null, 2));
+      console.log('配置文件已更新');
+    } catch (err) {
+      console.error('清理配置文件失败:', err.message);
+    }
+  } else {
+    console.log(`未找到配置文件: ${configFile}`);
+  }
+
+  return oldQqbotConfig;
+}
+
+// 执行命令并继承 stdio
+function runCommand(cmd, args = []) {
+  try {
+    execSync([cmd, ...args].join(' '), { stdio: 'inherit' });
+    return true;
+  } catch (err) {
+    return false;
+  }
+}
+
+// 升级命令
+function upgrade() {
+  console.log('=== QQBot 插件升级脚本 ===');
+
+  let foundInstallation = null;
+  let savedConfig = null;
+  const home = homedir();
+
+  // 检查 openclaw
+  if (existsSync(join(home, '.openclaw'))) {
+    savedConfig = cleanupInstallation('openclaw');
+    foundInstallation = 'openclaw';
+  }
+
+  // 检查 clawdbot
+  if (existsSync(join(home, '.clawdbot'))) {
+    const clawdbotConfig = cleanupInstallation('clawdbot');
+    if (!savedConfig) savedConfig = clawdbotConfig;
+    foundInstallation = 'clawdbot';
+  }
+
+  if (!foundInstallation) {
+    console.log('\n未找到 clawdbot 或 openclaw 安装目录');
+    console.log('请确认已安装 clawdbot 或 openclaw');
+    process.exit(1);
+  }
+
+  console.log('\n=== 清理完成 ===');
+
+  // 自动安装插件
+  console.log('\n[1/2] 安装新版本插件...');
+  runCommand(foundInstallation, ['plugins', 'install', '@sliverp/qqbot']);
+
+  // 自动配置通道（使用保存的 appId 和 clientSecret）
+  console.log('\n[2/2] 配置机器人通道...');
+  if (savedConfig?.appId && savedConfig?.clientSecret) {
+    const token = `${savedConfig.appId}:${savedConfig.clientSecret}`;
+    console.log(`使用已保存的配置: appId=${savedConfig.appId}`);
+    runCommand(foundInstallation, ['channels', 'add', '--channel', 'qqbot', '--token', `"${token}"`]);
+    
+    // 恢复其他配置项（如 markdownSupport）
+    if (savedConfig.markdownSupport !== undefined) {
+      runCommand(foundInstallation, ['config', 'set', 'channels.qqbot.markdownSupport', String(savedConfig.markdownSupport)]);
+    }
+  } else {
+    console.log('未找到已保存的 qqbot 配置，请手动配置:');
+    console.log(`  ${foundInstallation} channels add --channel qqbot --token "AppID:AppSecret"`);
+    return;
+  }
+
+  console.log('\n=== 升级完成 ===');
+  console.log(`\n可以运行以下命令前台运行启动机器人:`);
+  console.log(`  ${foundInstallation} gateway  stop && ${foundInstallation} gateway --port 18789 --verbose`);
+}
+
+// 安装命令
+function install() {
+  console.log('=== QQBot 插件安装 ===');
+
+  const cmd = detectInstallation();
+  if (!cmd) {
+    console.log('未找到 clawdbot 或 openclaw 安装');
+    console.log('请先安装 openclaw 或 clawdbot');
+    process.exit(1);
+  }
+
+  console.log(`\n使用 ${cmd} 安装插件...`);
+  runCommand(cmd, ['plugins', 'install', '@sliverp/qqbot']);
+
+  console.log('\n=== 安装完成 ===');
+  console.log('\n请配置机器人通道:');
+  console.log(`  ${cmd} channels add --channel qqbot --token "AppID:AppSecret"`);
+}
+
+// 显示帮助
+function showHelp() {
+  console.log(`
+QQBot CLI - QQ机器人插件管理工具
+
+用法:
+  npx @sliverp/qqbot <命令>
+
+命令:
+  upgrade       清理旧版本插件（升级前执行）
+  install       安装插件到 openclaw/clawdbot
+
+示例:
+  npx @sliverp/qqbot upgrade
+  npx @sliverp/qqbot install
+`);
+}
+
+// 主入口
+switch (command) {
+  case 'upgrade':
+    upgrade();
+    break;
+  case 'install':
+    install();
+    break;
+  case '-h':
+  case '--help':
+  case 'help':
+    showHelp();
+    break;
+  default:
+    if (command) {
+      console.log(`未知命令: ${command}`);
+    }
+    showHelp();
+    process.exit(command ? 1 : 0);
+}

package/node_modules/@sliverp/qqbot/clawdbot.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "qqbot",
+  "name": "QQ Bot Channel",
+  "description": "QQ Bot channel plugin with message support, cron jobs, and proactive messaging",
+  "channels": ["qqbot"],
+  "skills": ["skills/qqbot-cron", "skills/qqbot-media"],
+  "capabilities": {
+    "proactiveMessaging": true,
+    "cronJobs": true
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {}
+  }
+}

package/node_modules/@sliverp/qqbot/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+declare const plugin: {
+    id: string;
+    name: string;
+    description: string;
+    configSchema: unknown;
+    register(api: OpenClawPluginApi): void;
+};
+export default plugin;
+export { qqbotPlugin } from "./src/channel.js";
+export { setQQBotRuntime, getQQBotRuntime, hasQQBotRuntime, tryGetQQBotRuntime } from "./src/runtime.js";
+export { setQQBotAgentAdapter, getQQBotAgentAdapter } from "./src/agent.js";
+export { createOpenClawAgentAdapter } from "./src/openclaw-agent-adapter.js";
+export { qqbotOnboardingAdapter } from "./src/onboarding.js";
+export * from "./src/types.js";
+export * from "./src/agent.js";
+export * from "./src/api.js";
+export * from "./src/config.js";
+export * from "./src/gateway.js";
+export * from "./src/outbound.js";

package/node_modules/@sliverp/qqbot/dist/index.js

@@ -0,0 +1,25 @@
+import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
+import { qqbotPlugin } from "./src/channel.js";
+import { setQQBotRuntime } from "./src/runtime.js";
+const plugin = {
+    id: "qqbot",
+    name: "QQ Bot",
+    description: "QQ Bot channel plugin",
+    configSchema: emptyPluginConfigSchema(),
+    register(api) {
+        setQQBotRuntime(api.runtime);
+        api.registerChannel({ plugin: qqbotPlugin });
+    },
+};
+export default plugin;
+export { qqbotPlugin } from "./src/channel.js";
+export { setQQBotRuntime, getQQBotRuntime, hasQQBotRuntime, tryGetQQBotRuntime } from "./src/runtime.js";
+export { setQQBotAgentAdapter, getQQBotAgentAdapter } from "./src/agent.js";
+export { createOpenClawAgentAdapter } from "./src/openclaw-agent-adapter.js";
+export { qqbotOnboardingAdapter } from "./src/onboarding.js";
+export * from "./src/types.js";
+export * from "./src/agent.js";
+export * from "./src/api.js";
+export * from "./src/config.js";
+export * from "./src/gateway.js";
+export * from "./src/outbound.js";

package/node_modules/@sliverp/qqbot/dist/src/agent.d.ts

@@ -0,0 +1,76 @@
+import type { ResolvedQQBotAccount } from "./types.js";
+export interface QQBotAgentLog {
+    info: (msg: string) => void;
+    error: (msg: string) => void;
+    debug?: (msg: string) => void;
+}
+export interface QQBotInboundAttachment {
+    kind: "image" | "voice" | "file";
+    contentType?: string;
+    fileName?: string;
+    originalUrl?: string;
+    localPath?: string;
+    transcript?: string;
+}
+export interface QQBotInboundRequest {
+    channel: "qqbot";
+    accountId: string;
+    eventType: "c2c" | "guild" | "dm" | "group";
+    chatType: "direct" | "group";
+    senderId: string;
+    senderName?: string;
+    messageId: string;
+    timestamp: number;
+    rawText: string;
+    text: string;
+    from: string;
+    to: string;
+    qualifiedTarget: string;
+    commandAuthorized: boolean;
+    channelId?: string;
+    guildId?: string;
+    groupOpenid?: string;
+    imageUrls: string[];
+    localMediaPaths: string[];
+    localMediaTypes: string[];
+    remoteMediaUrls: string[];
+    remoteMediaTypes: string[];
+    attachments: QQBotInboundAttachment[];
+}
+export interface QQBotAgentOutput {
+    text?: string;
+    mediaUrl?: string;
+    mediaUrls?: string[];
+}
+export interface QQBotAgentDeliverInfo {
+    kind: string;
+}
+export interface QQBotAgentActivityRecord {
+    channel: "qqbot";
+    accountId: string;
+    direction: "inbound" | "outbound";
+}
+export interface QQBotAgentHandleMessageContext {
+    request: QQBotInboundRequest;
+    account: ResolvedQQBotAccount;
+    cfg: unknown;
+    abortSignal: AbortSignal;
+    log?: QQBotAgentLog;
+    deliver: (payload: QQBotAgentOutput, info: QQBotAgentDeliverInfo) => Promise<void>;
+}
+export interface QQBotAgentAdapter {
+    name?: string;
+    recordActivity?: (record: QQBotAgentActivityRecord) => void;
+    handleMessage: (ctx: QQBotAgentHandleMessageContext) => Promise<void>;
+}
+export interface QQBotSimpleAgentContext {
+    account: ResolvedQQBotAccount;
+    cfg: unknown;
+    abortSignal: AbortSignal;
+    log?: QQBotAgentLog;
+}
+export type QQBotSimpleAgentResult = string | QQBotAgentOutput | Array<string | QQBotAgentOutput> | null | undefined;
+export type QQBotSimpleAgentHandler = (request: QQBotInboundRequest, ctx: QQBotSimpleAgentContext) => Promise<QQBotSimpleAgentResult> | QQBotSimpleAgentResult;
+export declare function createQQBotAgentAdapter(handler: QQBotSimpleAgentHandler): QQBotAgentAdapter;
+export declare function setQQBotAgentAdapter(adapter: QQBotAgentAdapter | null): void;
+export declare function getQQBotAgentAdapter(): QQBotAgentAdapter | null;

package/node_modules/@sliverp/qqbot/dist/src/agent.js

@@ -0,0 +1,36 @@
+function normalizeSimpleResult(result) {
+    if (result === null || result === undefined) {
+        return [];
+    }
+    if (typeof result === "string") {
+        return [{ text: result }];
+    }
+    if (Array.isArray(result)) {
+        return result.flatMap((item) => normalizeSimpleResult(item));
+    }
+    return [result];
+}
+export function createQQBotAgentAdapter(handler) {
+    return {
+        name: "custom",
+        async handleMessage(ctx) {
+            const result = await handler(ctx.request, {
+                account: ctx.account,
+                cfg: ctx.cfg,
+                abortSignal: ctx.abortSignal,
+                log: ctx.log,
+            });
+            const outputs = normalizeSimpleResult(result);
+            for (const output of outputs) {
+                await ctx.deliver(output, { kind: "message" });
+            }
+        },
+    };
+}
+let currentAgentAdapter = null;
+export function setQQBotAgentAdapter(adapter) {
+    currentAgentAdapter = adapter;
+}
+export function getQQBotAgentAdapter() {
+    return currentAgentAdapter;
+}

package/node_modules/@sliverp/qqbot/dist/src/api.d.ts

@@ -0,0 +1,138 @@
+/**
+ * QQ Bot API 鉴权和请求封装
+ * [修复版] 已重构为支持多实例并发，消除全局变量冲突
+ */
+/**
+ * 初始化 API 配置
+ * @param options.markdownSupport - 是否支持 markdown 消息（默认 false，需要机器人具备该权限才能启用）
+ */
+export declare function initApiConfig(options: {
+    markdownSupport?: boolean;
+}): void;
+/**
+ * 获取当前是否支持 markdown
+ */
+export declare function isMarkdownSupport(): boolean;
+/**
+ * 获取 AccessToken（带缓存 + singleflight 并发安全）
+ *
+ * 使用 singleflight 模式：当多个请求同时发现 Token 过期时，
+ * 只有第一个请求会真正去获取新 Token，其他请求复用同一个 Promise。
+ *
+ * 按 appId 隔离，支持多机器人并发请求。
+ */
+export declare function getAccessToken(appId: string, clientSecret: string): Promise<string>;
+/**
+ * 清除 Token 缓存
+ * @param appId 选填。如果有，只清空特定账号的缓存；如果没有，清空所有账号。
+ */
+export declare function clearTokenCache(appId?: string): void;
+/**
+ * 获取 Token 缓存状态（用于监控）
+ */
+export declare function getTokenStatus(appId: string): {
+    status: "valid" | "expired" | "refreshing" | "none";
+    expiresAt: number | null;
+};
+/**
+ * 获取全局唯一的消息序号（范围 0 ~ 65535）
+ * 使用毫秒级时间戳低位 + 随机数异或混合，无状态，避免碰撞
+ */
+export declare function getNextMsgSeq(_msgId: string): number;
+/**
+ * API 请求封装
+ */
+export declare function apiRequest<T = unknown>(accessToken: string, method: string, path: string, body?: unknown, timeoutMs?: number): Promise<T>;
+export declare function getGatewayUrl(accessToken: string): Promise<string>;
+export interface MessageResponse {
+    id: string;
+    timestamp: number | string;
+}
+export declare function sendC2CMessage(accessToken: string, openid: string, content: string, msgId?: string): Promise<MessageResponse>;
+export declare function sendC2CInputNotify(accessToken: string, openid: string, msgId?: string, inputSecond?: number): Promise<void>;
+export declare function sendChannelMessage(accessToken: string, channelId: string, content: string, msgId?: string): Promise<{
+    id: string;
+    timestamp: string;
+}>;
+export declare function sendGroupMessage(accessToken: string, groupOpenid: string, content: string, msgId?: string): Promise<MessageResponse>;
+export declare function sendProactiveC2CMessage(accessToken: string, openid: string, content: string): Promise<{
+    id: string;
+    timestamp: number;
+}>;
+export declare function sendProactiveGroupMessage(accessToken: string, groupOpenid: string, content: string): Promise<{
+    id: string;
+    timestamp: string;
+}>;
+export declare enum MediaFileType {
+    IMAGE = 1,
+    VIDEO = 2,
+    VOICE = 3,
+    FILE = 4
+}
+export interface UploadMediaResponse {
+    file_uuid: string;
+    file_info: string;
+    ttl: number;
+    id?: string;
+}
+export declare function uploadC2CMedia(accessToken: string, openid: string, fileType: MediaFileType, url?: string, fileData?: string, srvSendMsg?: boolean, fileName?: string): Promise<UploadMediaResponse>;
+export declare function uploadGroupMedia(accessToken: string, groupOpenid: string, fileType: MediaFileType, url?: string, fileData?: string, srvSendMsg?: boolean, fileName?: string): Promise<UploadMediaResponse>;
+export declare function sendC2CMediaMessage(accessToken: string, openid: string, fileInfo: string, msgId?: string, content?: string): Promise<{
+    id: string;
+    timestamp: number;
+}>;
+export declare function sendGroupMediaMessage(accessToken: string, groupOpenid: string, fileInfo: string, msgId?: string, content?: string): Promise<{
+    id: string;
+    timestamp: string;
+}>;
+export declare function sendC2CImageMessage(accessToken: string, openid: string, imageUrl: string, msgId?: string, content?: string): Promise<{
+    id: string;
+    timestamp: number;
+}>;
+export declare function sendGroupImageMessage(accessToken: string, groupOpenid: string, imageUrl: string, msgId?: string, content?: string): Promise<{
+    id: string;
+    timestamp: string;
+}>;
+export declare function sendC2CVoiceMessage(accessToken: string, openid: string, voiceBase64: string, msgId?: string): Promise<{
+    id: string;
+    timestamp: number;
+}>;
+export declare function sendGroupVoiceMessage(accessToken: string, groupOpenid: string, voiceBase64: string, msgId?: string): Promise<{
+    id: string;
+    timestamp: string;
+}>;
+export declare function sendC2CFileMessage(accessToken: string, openid: string, fileBase64?: string, fileUrl?: string, msgId?: string, fileName?: string): Promise<{
+    id: string;
+    timestamp: number;
+}>;
+export declare function sendGroupFileMessage(accessToken: string, groupOpenid: string, fileBase64?: string, fileUrl?: string, msgId?: string, fileName?: string): Promise<{
+    id: string;
+    timestamp: string;
+}>;
+export declare function sendC2CVideoMessage(accessToken: string, openid: string, videoUrl?: string, videoBase64?: string, msgId?: string, content?: string): Promise<{
+    id: string;
+    timestamp: number;
+}>;
+export declare function sendGroupVideoMessage(accessToken: string, groupOpenid: string, videoUrl?: string, videoBase64?: string, msgId?: string, content?: string): Promise<{
+    id: string;
+    timestamp: string;
+}>;
+interface BackgroundTokenRefreshOptions {
+    refreshAheadMs?: number;
+    randomOffsetMs?: number;
+    minRefreshIntervalMs?: number;
+    retryDelayMs?: number;
+    log?: {
+        info: (msg: string) => void;
+        error: (msg: string) => void;
+        debug?: (msg: string) => void;
+    };
+}
+export declare function startBackgroundTokenRefresh(appId: string, clientSecret: string, options?: BackgroundTokenRefreshOptions): void;
+/**
+ * 停止后台 Token 刷新
+ * @param appId 选填。如果有，仅停止该账号的定时刷新。
+ */
+export declare function stopBackgroundTokenRefresh(appId?: string): void;
+export declare function isBackgroundTokenRefreshRunning(appId?: string): boolean;
+export {};