@cxyhhhhh/qqbot-cli 0.1.0-dev.202606011703

package/README.md

@@ -0,0 +1,239 @@
+# qqbot-cli
+
+配置驱动的 AI QQ 机器人 CLI 工具。基于 [`@tencent-connect/qqbot-nodejs`](https://github.com/tencent-connect/qqbot-nodejs) SDK，支持多种 AI 后端适配。
+
+## 特性
+
+- **零代码启动** — YAML 配置即可运行
+- **多后端适配** — Echo / OpenAI / CloudAgent ACP
+- **双传输模式** — WebSocket（默认）/ Webhook（HTTP 回调）
+- **流式输出** — C2C 私聊自动打字机效果
+- **Koa Middleware** — 完整中间件链（防御/限流/脱敏/typing）
+- **生产就绪** — 熔断/重连/敏感脱敏/优雅退出
+
+## 安装
+
+```bash
+# 克隆项目
+
+# 安装依赖
+npm install
+```
+
+### 依赖说明
+
+| 包名 | 说明 |
+|------|------|
+| `@tencent-connect/qqbot-nodejs` | QQ 开放平台 Node.js SDK（协议/中间件/流式） |
+| `@agentclientprotocol/sdk` | ACP 协议 SDK（CloudAgent 后端） |
+| `commander` | CLI 命令框架 |
+| `zod` | 配置 schema 运行时校验 |
+| `yaml` | YAML 配置解析 |
+
+## 快速开始
+
+```bash
+# 1. 初始化配置文件
+npx tsx bin/cli.ts init --template cloudagent
+# 生成 bot.yaml
+
+# 2. 设置环境变量
+export QQBOT_APP_ID="你的 AppID"
+export QQBOT_APP_SECRET="你的 AppSecret"
+export CODEBUDDY_API_KEY="sk-xxxx"
+
+# 3. 启动
+npx tsx bin/cli.ts start
+
+# 带参数启动
+npx tsx bin/cli.ts start --config ./bot.yaml --verbose
+```
+
+## 配置模板
+
+| 模板 | 命令 | 说明 |
+|------|------|------|
+| `cloudagent` | `init --template cloudagent` | CloudAgent ACP 协议（AI 沙箱） |
+| `openai` | `init --template openai` | OpenAI 兼容 API（GPT-4o 等） |
+| `echo` | `init --template echo` | 回显模式（开发测试） |
+
+## CLI 命令
+
+```bash
+qqbot-cli start [--config bot.yaml] [--env .env] [--verbose]
+qqbot-cli init [--template cloudagent|openai|echo] [--output bot.yaml]
+qqbot-cli validate [--config bot.yaml]
+qqbot-cli --version
+```
+
+## 架构
+
+```
+CLI (commander)
+  → Config Loader (yaml + zod schema)
+  → BotRunner
+      → QQBot SDK (WS + Koa Middleware + Streaming)
+      → ReplyBackend (pluggable)
+          → Echo / OpenAI / CloudAgent ACP
+```
+
+## 后端说明
+
+### Echo
+
+原样回显用户输入，用于验证 QQ 协议链路。
+
+### OpenAI
+
+兼容 OpenAI Chat Completions API（支持 streaming SSE），可对接：
+- OpenAI (gpt-4o, gpt-3.5-turbo)
+- DeepSeek
+- 其他 OpenAI 兼容服务
+
+### CloudAgent ACP
+
+通过 ACP 协议与 CloudAgent（AgentOS）AI 沙箱交互：
+- 基于 `@agentclientprotocol/sdk` 完整实现
+- GET SSE 持久通知流 + POST SSE 响应流 + DELETE 优雅关闭
+- 自动创建/复用沙箱 Runtime
+- ACP 懒连接（首条消息触发 + 沙箱自动唤醒）
+- 工具调用权限自动批准
+- 双流时序补偿
+- 附件透传（resource_link）
+
+## 环境变量
+
+| 变量 | 必填 | 说明 |
+|------|------|------|
+| `QQBOT_APP_ID` | ✓ | QQ 机器人 AppID |
+| `QQBOT_APP_SECRET` | ✓ | QQ 机器人 AppSecret |
+| `CODEBUDDY_API_KEY` | cloudagent 模式 | AgentOS API Key |
+| `OPENAI_API_KEY` | openai 模式 | OpenAI API Key |
+| `LOG_LEVEL` | ✗ | 日志级别 (debug/info/warn/error) |
+
+## 项目结构
+
+```
+qqbot-cli/
+├── bin/cli.ts              # CLI 入口
+├── src/
+│   ├── index.ts            # 程序化 API
+│   ├── cli.ts              # 命令实现
+│   ├── runner.ts           # BotRunner 编排器
+│   ├── config/             # zod schema + 配置加载器
+│   ├── backend/            # 可插拔后端（echo/openai/cloudagent）
+│   ├── cloudagent/         # ACP 协议实现（基于 @agentclientprotocol/sdk）
+│   └── utils/              # 日志/优雅退出
+├── templates/              # 配置模板（YAML）
+├── DESIGN.md               # 设计方案
+└── README.md
+```
+
+## 开发
+
+```bash
+# 类型检查
+npm run typecheck
+
+# 开发模式（tsx 热重载）
+npm run dev start -- --config bot.yaml
+
+# 构建
+npm run build
+```
+
+## Docker
+
+### 构建镜像
+
+采用**预构建模式**：先在本地编译 TypeScript，再将产物打入 Docker 镜像。
+
+```bash
+cd qqbot-cli
+
+# 1. 安装依赖 & 编译
+pnpm install
+pnpm build
+
+# 2. 构建 Docker 镜像（指定 amd64 平台）
+docker build --platform linux/amd64 -t qqbot-cli .
+```
+
+### 推送镜像
+
+```bash
+# 打 tag
+docker tag qqbot-cli qqai-images.tencentcloudcr.com/qqbot/workbuddy-qqbot-cli:latest
+
+# 登录 & 推送
+docker login qqai-images.tencentcloudcr.com
+docker push qqai-images.tencentcloudcr.com/qqbot/workbuddy-qqbot-cli:latest
+```
+
+### 启动容器
+
+镜像内置了 `bot.yaml` 默认配置，可直接通过环境变量启动：
+
+```bash
+# 使用内置配置
+docker run -d \
+  --name qqbot \
+  --restart unless-stopped \
+  -v /path/to/qqbot-data:/app/.qqbot-data \
+  -e QQBOT_APP_ID=你的AppID \
+  -e QQBOT_APP_SECRET=你的AppSecret \
+  -e CODEBUDDY_API_KEY=sk-xxxx \
+  qqbot-cli
+```
+
+如需自定义配置，挂载配置文件并设置 `BOT_CONFIG`：
+
+```bash
+# 使用自定义配置
+docker run -d \
+  --name qqbot \
+  --restart unless-stopped \
+  -v /path/to/bot.yaml:/app/config/bot.yaml:ro \
+  -v /path/to/qqbot-data:/app/.qqbot-data \
+  -e BOT_CONFIG=/app/config/bot.yaml \
+  -e QQBOT_APP_ID=你的AppID \
+  -e QQBOT_APP_SECRET=你的AppSecret \
+  -e CODEBUDDY_API_KEY=sk-xxxx \
+  qqbot-cli
+```
+
+| 参数 | 说明 |
+|------|------|
+| `-e BOT_CONFIG=...` | 指定配置文件路径（默认 `/app/bot.yaml` 内置配置） |
+| `-v bot.yaml:/app/config/bot.yaml:ro` | 挂载自定义配置文件（只读） |
+| `-v qqbot-data:/app/.qqbot-data` | 持久化会话数据 |
+| `-e QQBOT_APP_ID=xxx` | 注入环境变量（`bot.yaml` 中 `${QQBOT_APP_ID}` 自动替换） |
+| `--restart unless-stopped` | 异常退出自动重启 |
+
+### 运维命令
+
+```bash
+# 查看日志
+docker logs -f qqbot
+
+# 进入容器
+docker exec -it qqbot sh
+
+# 停止（触发优雅关闭）
+docker stop qqbot
+
+# 停止并删除
+docker stop qqbot && docker rm qqbot
+```
+
+### 镜像说明
+
+- **基础镜像**: `node:22-alpine`（~80MB）
+- **PID 1**: [tini](https://github.com/krallin/tini)，正确转发 `SIGTERM` 实现优雅停机
+- **内置配置**: `bot.yaml` 打包在 `/app/bot.yaml`，通过 `BOT_CONFIG` 环境变量可覆盖
+- **VOLUME**: `/app/.qqbot-data`（会话持久化）、`/app/config`（配置挂载点）
+- 敏感信息通过 `-e` 环境变量传入，不写入镜像
+
+## License
+
+ISC

package/dist/bin/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import {
+  APP_VERSION,
+  startCommand
+} from "../chunk-WRKDI4MF.js";
+import "../chunk-XIJ6OSLY.js";
+
+// bin/cli.ts
+import { program } from "commander";
+program.name("qqbot-cli").description("QQ Bot CLI \u2014 \u914D\u7F6E\u9A71\u52A8\u7684 AI QQ \u673A\u5668\u4EBA").version(APP_VERSION);
+program.command("start").description("\u542F\u52A8 QQ \u673A\u5668\u4EBA").option("-c, --config <path>", "\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84", "bot.yaml").option("-e, --env <path>", ".env \u6587\u4EF6\u8DEF\u5F84").option("-v, --verbose", "\u5F00\u542F debug \u65E5\u5FD7").action(startCommand);
+program.command("init").description("\u4EA4\u4E92\u5F0F\u521D\u59CB\u5316\u914D\u7F6E\u6587\u4EF6").option("-t, --template <type>", "\u6A21\u677F\u7C7B\u578B: cloudagent | openai | echo", "cloudagent").option("-o, --output <path>", "\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84", "bot.yaml").action(async (opts) => {
+  const { initCommand } = await import("../cli-TUC3HG75.js");
+  await initCommand(opts);
+});
+program.command("validate").description("\u9A8C\u8BC1\u914D\u7F6E\u6587\u4EF6").option("-c, --config <path>", "\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84", "bot.yaml").action(async (opts) => {
+  const { validateCommand } = await import("../cli-TUC3HG75.js");
+  await validateCommand(opts);
+});
+program.command("send").description("Send a proactive message (text and/or files) to a user or group").argument("[text...]", "Text message content").requiredOption("--to <openid>", "Target user or group openid").option("--scope <scope>", "Chat scope: c2c or group", "c2c").option("-f, --file <path...>", "Attach file(s): image, video, voice, or generic file").option("--file-prefix <prefix>", "Path prefix for files (e.g. /host for Docker bind mount)").option("-c, --config <path>", "Config file path", "bot.yaml").option("-e, --env <path>", ".env file path").option("-v, --verbose", "Enable debug logging").action(async (textArgs, opts) => {
+  const { sendCommand } = await import("../cli-TUC3HG75.js");
+  await sendCommand(textArgs, opts);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../bin/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * qqbot-cli — CLI 入口\n */\n\nimport { program } from \"commander\";\nimport { startCommand } from \"../src/cli.js\";\nimport { APP_VERSION } from \"../src/version.js\";\n\nprogram\n  .name(\"qqbot-cli\")\n  .description(\"QQ Bot CLI — 配置驱动的 AI QQ 机器人\")\n  .version(APP_VERSION);\n\nprogram\n  .command(\"start\")\n  .description(\"启动 QQ 机器人\")\n  .option(\"-c, --config <path>\", \"配置文件路径\", \"bot.yaml\")\n  .option(\"-e, --env <path>\", \".env 文件路径\")\n  .option(\"-v, --verbose\", \"开启 debug 日志\")\n  .action(startCommand);\n\nprogram\n  .command(\"init\")\n  .description(\"交互式初始化配置文件\")\n  .option(\"-t, --template <type>\", \"模板类型: cloudagent | openai | echo\", \"cloudagent\")\n  .option(\"-o, --output <path>\", \"输出文件路径\", \"bot.yaml\")\n  .action(async (opts) => {\n    const { initCommand } = await import(\"../src/cli.js\");\n    await initCommand(opts);\n  });\n\nprogram\n  .command(\"validate\")\n  .description(\"验证配置文件\")\n  .option(\"-c, --config <path>\", \"配置文件路径\", \"bot.yaml\")\n  .action(async (opts) => {\n    const { validateCommand } = await import(\"../src/cli.js\");\n    await validateCommand(opts);\n  });\n\nprogram\n  .command(\"send\")\n  .description(\"Send a proactive message (text and/or files) to a user or group\")\n  .argument(\"[text...]\", \"Text message content\")\n  .requiredOption(\"--to <openid>\", \"Target user or group openid\")\n  .option(\"--scope <scope>\", \"Chat scope: c2c or group\", \"c2c\")\n  .option(\"-f, --file <path...>\", \"Attach file(s): image, video, voice, or generic file\")\n  .option(\"--file-prefix <prefix>\", \"Path prefix for files (e.g. /host for Docker bind mount)\")\n  .option(\"-c, --config <path>\", \"Config file path\", \"bot.yaml\")\n  .option(\"-e, --env <path>\", \".env file path\")\n  .option(\"-v, --verbose\", \"Enable debug logging\")\n  .action(async (textArgs, opts) => {\n    const { sendCommand } = await import(\"../src/cli.js\");\n    await sendCommand(textArgs, opts);\n  });\n\nprogram.parse();\n"],"mappings":";;;;;;;;AAKA,SAAS,eAAe;AAIxB,QACG,KAAK,WAAW,EAChB,YAAY,2EAA8B,EAC1C,QAAQ,WAAW;AAEtB,QACG,QAAQ,OAAO,EACf,YAAY,oCAAW,EACvB,OAAO,uBAAuB,wCAAU,UAAU,EAClD,OAAO,oBAAoB,+BAAW,EACtC,OAAO,iBAAiB,iCAAa,EACrC,OAAO,YAAY;AAEtB,QACG,QAAQ,MAAM,EACd,YAAY,8DAAY,EACxB,OAAO,yBAAyB,wDAAoC,YAAY,EAChF,OAAO,uBAAuB,wCAAU,UAAU,EAClD,OAAO,OAAO,SAAS;AACtB,QAAM,EAAE,YAAY,IAAI,MAAM,OAAO,oBAAe;AACpD,QAAM,YAAY,IAAI;AACxB,CAAC;AAEH,QACG,QAAQ,UAAU,EAClB,YAAY,sCAAQ,EACpB,OAAO,uBAAuB,wCAAU,UAAU,EAClD,OAAO,OAAO,SAAS;AACtB,QAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,oBAAe;AACxD,QAAM,gBAAgB,IAAI;AAC5B,CAAC;AAEH,QACG,QAAQ,MAAM,EACd,YAAY,iEAAiE,EAC7E,SAAS,aAAa,sBAAsB,EAC5C,eAAe,iBAAiB,6BAA6B,EAC7D,OAAO,mBAAmB,4BAA4B,KAAK,EAC3D,OAAO,wBAAwB,sDAAsD,EACrF,OAAO,0BAA0B,0DAA0D,EAC3F,OAAO,uBAAuB,oBAAoB,UAAU,EAC5D,OAAO,oBAAoB,gBAAgB,EAC3C,OAAO,iBAAiB,sBAAsB,EAC9C,OAAO,OAAO,UAAU,SAAS;AAChC,QAAM,EAAE,YAAY,IAAI,MAAM,OAAO,oBAAe;AACpD,QAAM,YAAY,UAAU,IAAI;AAClC,CAAC;AAEH,QAAQ,MAAM;","names":[]}

package/dist/chunk-WRKDI4MF.js

@@ -0,0 +1,407 @@
+import {
+  BotRunner,
+  ConfigWatcher,
+  GALILEO_RESOURCE,
+  loadConfig,
+  setBizDefaultAttrs
+} from "./chunk-XIJ6OSLY.js";
+
+// src/cli.ts
+import * as fs from "fs";
+import * as path from "path";
+
+// src/utils/logger.ts
+import pino from "pino";
+import { mkdirSync } from "fs";
+import { join, resolve } from "path";
+function createLogger(config, levelOverride) {
+  const level = levelOverride ?? config?.level ?? "info";
+  const consoleMode = config?.console ?? "pretty";
+  const file = config?.file ?? { enabled: false, dir: "./logs", maxSize: "10m", maxFiles: 7 };
+  const targets = [];
+  if (consoleMode === "pretty") {
+    targets.push({
+      target: "pino-pretty",
+      options: {
+        destination: 2,
+        colorize: process.stderr.isTTY ?? false,
+        translateTime: "SYS:yyyy-mm-dd HH:MM:ss.l",
+        ignore: "pid,hostname"
+      },
+      level
+    });
+  } else {
+    targets.push({
+      target: "pino/file",
+      options: { destination: 2 },
+      level
+    });
+  }
+  if (file.enabled) {
+    const dir = resolve(file.dir);
+    mkdirSync(dir, { recursive: true });
+    targets.push({
+      target: "pino-roll",
+      options: {
+        file: join(dir, "qqbot"),
+        size: file.maxSize,
+        limit: { count: file.maxFiles },
+        mkdir: true,
+        ...file.frequency ? { frequency: file.frequency } : {},
+        ...file.dateFormat ? { dateFormat: file.dateFormat } : {},
+        ...file.symlink ? { symlink: true } : {}
+      },
+      level
+    });
+  }
+  return pino(
+    {
+      level,
+      redact: {
+        paths: ["req.headers.authorization", "access_token"],
+        censor: "***"
+      }
+    },
+    pino.transport({ targets })
+  );
+}
+
+// src/utils/graceful.ts
+function setupGracefulShutdown(logger, cleanup) {
+  const ac = new AbortController();
+  let shuttingDown = false;
+  const shutdown = async (signal) => {
+    if (shuttingDown) return;
+    shuttingDown = true;
+    logger.info(`\u6536\u5230 ${signal}\uFF0C\u6B63\u5728\u505C\u6B62...`);
+    try {
+      ac.abort();
+      await cleanup();
+    } catch (err) {
+      logger.warn(`\u6E05\u7406\u51FA\u9519: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    process.exit(0);
+  };
+  process.on("SIGINT", () => void shutdown("SIGINT"));
+  process.on("SIGTERM", () => void shutdown("SIGTERM"));
+  process.on("uncaughtException", (err) => {
+    logger.error(`uncaughtException: ${err.stack ?? err.message}`);
+  });
+  process.on("unhandledRejection", (err) => {
+    logger.error(`unhandledRejection: ${err instanceof Error ? err.stack ?? err.message : String(err)}`);
+  });
+  return ac;
+}
+
+// src/telemetry/index.ts
+import { metrics, diag, DiagConsoleLogger, DiagLogLevel } from "@opentelemetry/api";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { OTLPMetricExporter } from "@opentelemetry/exporter-metrics-otlp-http";
+import {
+  MeterProvider,
+  PeriodicExportingMetricReader,
+  ConsoleMetricExporter,
+  AggregationTemporality
+} from "@opentelemetry/sdk-metrics";
+import { NodeTracerProvider, BatchSpanProcessor } from "@opentelemetry/sdk-trace-node";
+import { Resource } from "@opentelemetry/resources";
+import { W3CTraceContextPropagator, TraceIdRatioBasedSampler } from "@opentelemetry/core";
+
+// src/version.ts
+import { createRequire } from "module";
+function resolveVersion() {
+  if (true) return "0.1.0-dev.202606011703";
+  try {
+    const req = createRequire(import.meta.url);
+    try {
+      return req("../package.json").version;
+    } catch {
+      return req("../../package.json").version;
+    }
+  } catch {
+    return "0.0.0-dev";
+  }
+}
+var APP_VERSION = resolveVersion();
+
+// src/telemetry/index.ts
+import { networkInterfaces } from "os";
+function getLocalIp() {
+  const envIp = process.env.POD_IP || process.env.HOST_IP || process.env.INSTANCE_IP;
+  if (envIp) return envIp;
+  const interfaces = networkInterfaces();
+  for (const name of Object.keys(interfaces)) {
+    for (const iface of interfaces[name] ?? []) {
+      if (iface.family === "IPv4" && !iface.internal) {
+        return iface.address;
+      }
+    }
+  }
+  return "";
+}
+var tracerProvider = null;
+var meterProvider = null;
+function initTelemetry(config, logger, opts) {
+  if (!config.enabled) return;
+  if (config.debug) {
+    diag.setLogger(new DiagConsoleLogger(), DiagLogLevel.DEBUG);
+  }
+  const galileo = config.galileo;
+  const objectName = galileo ? `${galileo.app}.${galileo.server}` : config.serviceName;
+  const resourceAttrs = {
+    "service.name": objectName,
+    [GALILEO_RESOURCE.SERVICE_NAME]: objectName,
+    [GALILEO_RESOURCE.SDK_LANGUAGE]: "nodejs",
+    [GALILEO_RESOURCE.SDK_NAME]: "qqbot-cli",
+    [GALILEO_RESOURCE.APP_ID]: opts?.appId ?? "",
+    ...config.attributes
+  };
+  if (galileo) {
+    resourceAttrs[GALILEO_RESOURCE.TARGET] = `${galileo.platform}.${objectName}`;
+    resourceAttrs[GALILEO_RESOURCE.NAMESPACE] = galileo.namespace;
+    resourceAttrs[GALILEO_RESOURCE.ENV_NAME] = galileo.envName;
+    resourceAttrs[GALILEO_RESOURCE.CONTAINER_NAME] = "";
+    resourceAttrs[GALILEO_RESOURCE.INSTANCE] = getLocalIp();
+    resourceAttrs[GALILEO_RESOURCE.VERSION] = APP_VERSION;
+    resourceAttrs[GALILEO_RESOURCE.CON_SETID] = "";
+  }
+  const resource = new Resource(resourceAttrs);
+  setBizDefaultAttrs({
+    app_id: opts?.appId ?? "",
+    instance: getLocalIp(),
+    version: APP_VERSION
+  });
+  const metricsUrl = `${config.endpoint}/v1/metrics`;
+  const tracesUrl = `${config.endpoint}/v1/traces`;
+  tracerProvider = new NodeTracerProvider({
+    resource,
+    sampler: new TraceIdRatioBasedSampler(config.sampleRate)
+  });
+  tracerProvider.addSpanProcessor(
+    new BatchSpanProcessor(new OTLPTraceExporter({ url: tracesUrl }))
+  );
+  tracerProvider.register({
+    propagator: new W3CTraceContextPropagator()
+  });
+  meterProvider = new MeterProvider({ resource });
+  meterProvider.addMetricReader(
+    new PeriodicExportingMetricReader({
+      exporter: new OTLPMetricExporter({
+        url: metricsUrl,
+        temporalityPreference: AggregationTemporality.DELTA
+      }),
+      exportIntervalMillis: config.exportIntervalMs
+    })
+  );
+  if (config.debug) {
+    meterProvider.addMetricReader(
+      new PeriodicExportingMetricReader({
+        exporter: new ConsoleMetricExporter(),
+        exportIntervalMillis: config.exportIntervalMs
+      })
+    );
+  }
+  metrics.setGlobalMeterProvider(meterProvider);
+  logger?.info(`[telemetry] ready (metrics=${metricsUrl}, traces=${tracesUrl})`);
+}
+async function shutdownTelemetry() {
+  await tracerProvider?.shutdown();
+  await meterProvider?.shutdown();
+  tracerProvider = null;
+  meterProvider = null;
+}
+
+// src/cli.ts
+async function startCommand(opts) {
+  if (opts.env) {
+    const { config: config2 } = await import("dotenv");
+    config2({ path: opts.env });
+  } else if (fs.existsSync(".env")) {
+    const { config: config2 } = await import("dotenv");
+    config2();
+  }
+  const logLevel = opts.verbose ? "debug" : void 0;
+  let logger = createLogger(void 0, logLevel);
+  let config;
+  try {
+    config = await loadConfig(opts.config);
+  } catch (err) {
+    logger.error(`\u914D\u7F6E\u9519\u8BEF: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(2);
+  }
+  const effectiveLevel = logLevel ?? config.log.level;
+  config.log.level = effectiveLevel;
+  logger = createLogger(config.log, logLevel);
+  initTelemetry(config.telemetry, logger, { appId: config.qq.appId });
+  logger.info(`qqbot-cli v${APP_VERSION} \u542F\u52A8\u4E2D...`);
+  logger.info(`  \u914D\u7F6E: ${opts.config}`);
+  logger.info(`  \u540E\u7AEF: ${config.backend.type}`);
+  logger.info(`  \u4F20\u8F93: ${config.qq.transport}${config.qq.transport === "webhook" ? ` (port=${config.qq.webhook.port}, path=${config.qq.webhook.path})` : ""}`);
+  logger.info(`  AppID: ${config.qq.appId}`);
+  if (config.telemetry.enabled) {
+    logger.info(`  Telemetry: ${config.telemetry.endpoint} (sample=${config.telemetry.sampleRate})`);
+  }
+  const runner = new BotRunner(config, logger);
+  const watcher = new ConfigWatcher({
+    configPath: path.resolve(opts.config),
+    currentConfig: config,
+    logger,
+    onChange: (newConfig) => {
+      if (logLevel) {
+        newConfig.log.level = logLevel;
+      }
+      runner.applyConfigUpdate(newConfig);
+    }
+  });
+  watcher.start();
+  runner.setConfigWriter((patches, currentConfig) => watcher.writeBack(patches, currentConfig));
+  const ac = setupGracefulShutdown(logger, async () => {
+    await shutdownTelemetry();
+    watcher.stop();
+    await runner.stop();
+  });
+  try {
+    await runner.start(ac.signal);
+    logger.info("Bot \u5DF2\u505C\u6B62\u3002");
+  } catch (err) {
+    logger.error(`\u542F\u52A8\u5931\u8D25: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+}
+async function initCommand(opts) {
+  const templateFile = path.resolve(
+    path.dirname(new URL(import.meta.url).pathname),
+    `../templates/bot.${opts.template}.yaml`
+  );
+  if (!fs.existsSync(templateFile)) {
+    console.error(`\u274C \u672A\u77E5\u6A21\u677F: ${opts.template}\uFF08\u53EF\u9009: cloudagent | openai | echo\uFF09`);
+    process.exit(2);
+  }
+  if (fs.existsSync(opts.output)) {
+    console.error(`\u26A0\uFE0F  ${opts.output} \u5DF2\u5B58\u5728\uFF0C\u8DF3\u8FC7\u751F\u6210\u3002`);
+    process.exit(0);
+  }
+  fs.copyFileSync(templateFile, opts.output);
+  console.log(`\u2705 \u5DF2\u751F\u6210 ${opts.output}\uFF08\u6A21\u677F: ${opts.template}\uFF09`);
+  console.log(`
+\u4E0B\u4E00\u6B65\uFF1A`);
+  console.log(`  1. \u7F16\u8F91 ${opts.output}\uFF0C\u586B\u5165 AppID / AppSecret / API Key`);
+  console.log(`  2. \u8FD0\u884C qqbot-cli start --config ${opts.output}`);
+}
+async function validateCommand(opts) {
+  try {
+    const config = await loadConfig(opts.config);
+    console.log(`\u2705 \u914D\u7F6E\u6587\u4EF6\u6709\u6548`);
+    console.log(`   \u540E\u7AEF: ${config.backend.type}`);
+    console.log(`   AppID: ${config.qq.appId}`);
+  } catch (err) {
+    console.error(`\u274C \u914D\u7F6E\u65E0\u6548: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(2);
+  }
+}
+async function sendCommand(textArgs, opts) {
+  if (opts.env) {
+    const { config: config2 } = await import("dotenv");
+    config2({ path: opts.env });
+  } else if (fs.existsSync(".env")) {
+    const { config: config2 } = await import("dotenv");
+    config2();
+  }
+  const logger = createLogger(void 0, opts.verbose ? "debug" : "error");
+  let config;
+  try {
+    config = await loadConfig(opts.config);
+  } catch (err) {
+    console.error(`\u274C Config error: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(2);
+  }
+  if (!opts.to) {
+    console.error("\u274C --to <openid> is required");
+    process.exit(2);
+  }
+  const scope = opts.scope ?? "c2c";
+  if (scope !== "c2c" && scope !== "group") {
+    console.error(`\u274C Invalid scope: ${scope} (must be "c2c" or "group")`);
+    process.exit(2);
+  }
+  const { QQBot, MediaFileType } = await import("@tencent/qqbot-nodejs");
+  const bot = new QQBot({
+    appId: config.qq.appId,
+    appSecret: config.qq.appSecret,
+    baseUrl: config.qq.baseUrl,
+    tokenBaseUrl: config.qq.tokenBaseUrl,
+    logger
+  });
+  const target = { scope, targetId: opts.to };
+  const text = textArgs.join(" ").trim();
+  const files = opts.file ?? [];
+  const filePrefix = opts.filePrefix ?? process.env.FILE_PATH_PREFIX ?? "";
+  try {
+    if (text) {
+      const resp = await bot.sendText(target, text);
+      console.log(`\u2705 Text sent (id=${resp.id})`);
+    }
+    for (const filePath of files) {
+      const resolved = resolveFilePath(filePath, filePrefix);
+      if (!fs.existsSync(resolved)) {
+        console.error(`\u274C File not found: ${resolved}`);
+        continue;
+      }
+      const ext = path.extname(resolved).toLowerCase();
+      const fileType = inferFileType(ext);
+      const fileName = path.basename(resolved);
+      const buffer = fs.readFileSync(resolved);
+      console.log(`\u{1F4E4} Uploading ${fileName} (${formatSize(buffer.length)}, type=${MediaFileType[fileType]}) ...`);
+      const { upload, message } = await bot.sendMedia({
+        target,
+        fileType,
+        buffer,
+        fileName,
+        onProgress: (uploaded, total) => {
+          const pct = total > 0 ? Math.round(uploaded / total * 100) : 0;
+          process.stdout.write(`\r   Progress: ${pct}% (${formatSize(uploaded)}/${formatSize(total)})`);
+        }
+      });
+      process.stdout.write("\n");
+      console.log(`\u2705 ${fileName} sent (file_uuid=${upload.file_uuid ?? "-"}, msg_id=${message?.id ?? "-"})`);
+    }
+    if (!text && files.length === 0) {
+      console.error("\u274C Nothing to send. Provide text and/or --file <path>.");
+      process.exit(2);
+    }
+  } catch (err) {
+    console.error(`\u274C Send failed: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+  }
+}
+var IMAGE_EXTS = /* @__PURE__ */ new Set([".jpg", ".jpeg", ".png", ".gif", ".webp", ".bmp"]);
+var VIDEO_EXTS = /* @__PURE__ */ new Set([".mp4", ".mov", ".avi", ".mkv", ".webm"]);
+var VOICE_EXTS = /* @__PURE__ */ new Set([".mp3", ".wav", ".ogg", ".aac", ".silk", ".amr"]);
+function inferFileType(ext) {
+  if (IMAGE_EXTS.has(ext)) return 1;
+  if (VIDEO_EXTS.has(ext)) return 2;
+  if (VOICE_EXTS.has(ext)) return 3;
+  return 4;
+}
+function formatSize(bytes) {
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+function resolveFilePath(filePath, prefix) {
+  const resolved = path.resolve(filePath);
+  if (!prefix || fs.existsSync(resolved)) {
+    return resolved;
+  }
+  const prefixed = path.join(prefix, resolved);
+  return prefixed;
+}
+
+export {
+  APP_VERSION,
+  startCommand,
+  initCommand,
+  validateCommand,
+  sendCommand
+};
+//# sourceMappingURL=chunk-WRKDI4MF.js.map