@cxyhhhhh/qqbot-cli 0.1.0-dev.202606011703

package/dist/src/index.js

@@ -0,0 +1,11 @@
+import {
+  BotRunner,
+  ConfigWatcher,
+  loadConfig
+} from "../chunk-XIJ6OSLY.js";
+export {
+  BotRunner,
+  ConfigWatcher,
+  loadConfig
+};
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@cxyhhhhh/qqbot-cli",
+  "version": "0.1.0-dev.202606011703",
+  "description": "CLI tool to run a QQ Bot with pluggable AI backends (Echo / OpenAI / CloudAgent ACP)",
+  "type": "module",
+  "bin": {
+    "qqbot-cli": "./dist/bin/cli.js"
+  },
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "dev": "tsx bin/cli.ts",
+    "build": "tsup",
+    "start": "node dist/bin/cli.js start",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "commitlint": "commitlint",
+    "clean": "rm -rf dist"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "qq",
+    "bot",
+    "cli",
+    "cloudagent",
+    "acp",
+    "openai"
+  ],
+  "license": "ISC",
+  "dependencies": {
+    "@agentclientprotocol/sdk": "^0.21.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/core": "^1.30.1",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.57.2",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.57.2",
+    "@opentelemetry/resources": "^1.30.1",
+    "@opentelemetry/sdk-metrics": "^1.30.1",
+    "@opentelemetry/sdk-trace-node": "^1.30.1",
+    "@opentelemetry/semantic-conventions": "^1.41.1",
+    "@tencent/qqbot-nodejs": "0.0.0-dev.e55b99d7",
+    "commander": "^12.1.0",
+    "cosmiconfig": "^9.0.1",
+    "dotenv": "^16.6.1",
+    "json-bigint": "^1.0.0",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "pino-roll": "^4.0.0",
+    "ws": "^8.20.1",
+    "yaml": "^2.9.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/js": "^9.27.0",
+    "@types/json-bigint": "^1.0.4",
+    "@types/node": "^20.19.41",
+    "@types/ws": "^8.18.1",
+    "eslint": "^9.27.0",
+    "globals": "^16.1.0",
+    "tsup": "^8.5.1",
+    "tsx": "^4.22.3",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.33.0"
+  }
+}

package/templates/bot.cloudagent.yaml

@@ -0,0 +1,131 @@
+# qqbot-cli 配置模板 — CloudAgent ACP 模式
+
+qq:
+  appId: ${QQBOT_APP_ID}
+  appSecret: ${QQBOT_APP_SECRET}
+  markdown: false
+  # userAgent: qqbot-cli/0.1.0   # 自定义 User-Agent（默认 qqbot-cli/<version>）
+  # baseUrl: https://api.sgroup.qq.com
+  # tokenBaseUrl: https://bots.qq.com
+  # Token 获取策略：sync (默认，阻塞启动，fail-fast) | async (异步，快速启动)
+  # tokenPrefetch: sync
+  # 事件传输模式：websocket (默认) | webhook
+  # transport: websocket
+  # webhook 模式配置：
+  # webhook:
+  #   port: 8080
+  #   path: /callback
+
+mcp:
+  enabled: true
+  # host: 127.0.0.1   # Docker 容器内需设为 0.0.0.0
+  port: 0
+  # pathPrefix: ""     # 文件路径前缀，拼接在工具收到的路径之前（容器卷映射场景）
+
+backend:
+  type: cloudagent
+  cloudagent:
+    apiKey: ${CODEBUDDY_API_KEY}
+    endpoint: https://www.codebuddy.cn/v2
+    sandbox:
+      mode: auto
+      # runtimeName: my-bot
+      # 复用已有沙箱（下次启动用 manual 模式）：
+      # mode: manual
+      # runtimeId: "xxx"
+      # 直连本地 ACP：
+      # mode: direct
+      # acpEndpoint: http://localhost:65225/acp
+    manifest:
+      systemPrompt: "你是一个有用的 QQ 机器人助手。用中文回答问题。"
+    acp:
+      lazyConnect: true
+      maxRetries: 20
+      retryIntervalMs: 3000
+      # 等待 ACP 事件超时（ms），工具调用可能耗时较长
+      eventTimeoutMs: 180000
+    # 多用户 Session 管理
+    session:
+      maxConnections: 50         # 单 Runtime 最大连接数
+      enableCleanup: false        # 是否启用空闲清理
+      idleTimeoutMs: 1800000     # 空闲超时（ms），默认 30 分钟
+      cleanupIntervalMs: 60000   # 清理扫描间隔（ms），默认 1 分钟
+      preserveOnEvict: true      # 淘汰时保留服务端会话（下次自动恢复上下文）
+
+middleware:
+  messageFilter:
+    skipSelfEcho: true
+    dedup: { windowMs: 5000 }
+  contentSanitizer:
+    stripBotMention: true
+  mentionGate:
+    requireMentionInGroup: true
+    alwaysAnswerC2C: true
+  typingIndicator:
+    enabled: true
+    durationSec: 30
+  # 指令白名单（用户 OpenID），为空则所有人可用
+  # slashCommands:
+  #   allowFrom:
+  #     - "USER_OPENID"
+  # 并发控制：同一用户/群串行处理 strategy: queue | drop | abort | merge
+  concurrency:
+    strategy: merge
+    maxQueue: 50
+
+streaming:
+  c2c: true
+  throttleMs: 500
+
+# 消息展示样式 preset: full | compact | minimal | text-only
+message:
+  display:
+    preset: minimal
+    # toolDetailMaxLength: 120
+    # toolDetailTruncate: [execute, other]
+  # errorMessages:
+  #   debug: false
+  #   troubleshootHint: "💡 如持续出现问题，请联系管理员。"
+  #   rules:
+  #     - match: ["session not bound", "session not found", "session expired"]
+  #       reply: "⚠️ 会话已断开，正在重新连接，请稍后再试。"
+  #       hint: "如反复出现，请发送 /new 重置会话。"
+  #     - match: ["agent not alive", "connection closed", "transport closed"]
+  #       reply: "⚠️ 服务连接中断，正在恢复，请稍后再试。"
+  #     - match: ["timeout", "timed out"]
+  #       reply: "⚠️ 响应超时，请稍后重试。"
+  #     - match: ["rate limit", "429"]
+  #       reply: "⚠️ 请求过于频繁，请稍后再试。"
+  #     - match: ["context window", "token limit", "max_tokens"]
+  #       reply: "⚠️ 对话上下文过长，请重新开始新会话。"
+  #       hint: "发送 /new 开始新对话。"
+  #   emptyReply: "⚠️ Agent 未生成回复内容，请换个方式描述或重试。"
+  #   unknown: "⚠️ 处理失败，请稍后重试。"
+    
+session:
+  persistence:
+    type: file
+    dir: ./.qqbot-data
+
+log:
+  level: info
+  # console: pretty           # pretty | json（Docker 建议 json）
+  # file:
+  #   enabled: true
+  #   dir: ./logs
+  #   maxSize: 10m
+  #   maxFiles: 7
+  #   frequency: daily         # daily | hourly | weekly（按时间滚动）
+  #   dateFormat: yyyy-MM-dd   # 文件名日期格式
+  #   symlink: true            # 创建 current.log 指向当前文件
+
+# OpenTelemetry 可观测性上报（Traces + Metrics）
+# telemetry:
+#   enabled: true
+#   serviceName: qqbot-cli
+#   endpoint: http://localhost:4318   # OTLP HTTP endpoint
+#   protocol: http                    # http | grpc
+#   sampleRate: 1.0                   # 采样率 0.0~1.0
+#   exportIntervalMs: 30000           # metrics 导出间隔
+#   attributes:
+#     env: production

package/templates/bot.echo.yaml

@@ -0,0 +1,55 @@
+# qqbot-cli 配置模板 — Echo 模式（开发测试用）
+
+qq:
+  appId: ${QQBOT_APP_ID}
+  appSecret: ${QQBOT_APP_SECRET}
+  markdown: false
+  # baseUrl: https://api.sgroup.qq.com
+  # tokenBaseUrl: https://bots.qq.com
+  # tokenPrefetch: sync
+  # transport: websocket
+  # webhook:
+  #   port: 8080
+  #   path: /callback
+
+backend:
+  type: echo
+
+middleware:
+  messageFilter:
+    skipSelfEcho: true
+    dedup: { windowMs: 5000 }
+  contentSanitizer:
+    stripBotMention: true
+  mentionGate:
+    requireMentionInGroup: true
+    alwaysAnswerC2C: true
+  typingIndicator:
+    enabled: true
+    durationSec: 30
+  # 并发控制：同一用户/群串行处理 strategy: queue | drop | abort
+  concurrency:
+    strategy: abort
+    maxQueue: 10
+
+streaming:
+  c2c: true
+  throttleMs: 500
+
+# 消息展示样式 preset: full | compact | minimal | text-only
+message:
+  display:
+    preset: minimal
+
+session:
+  persistence:
+    type: memory
+
+log:
+  level: info
+
+# MCP Server：在 qqbot-cli 进程内启动 HTTP+SSE MCP Server
+# 可供外部 Agent 调用已注册的工具（如 send_file）
+# mcp:
+#   enabled: true
+#   port: 0

package/templates/bot.galileo.yaml

@@ -0,0 +1,63 @@
+# qqbot-cli 配置模板 — 接入伽利略监控平台
+#
+# 使用前请替换以下变量：
+#   - QQBOT_APP_ID / QQBOT_APP_SECRET: QQ Bot 凭证
+#   - CODEBUDDY_API_KEY: CloudAgent API Key
+#   - galileo.platform / app / server: 伽利略可观测对象标识
+
+qq:
+  appId: ${QQBOT_APP_ID}
+  appSecret: ${QQBOT_APP_SECRET}
+  # tokenPrefetch: sync
+
+backend:
+  type: cloudagent
+  cloudagent:
+    apiKey: ${CODEBUDDY_API_KEY}
+    endpoint: https://www.codebuddy.cn/v2
+    sandbox:
+      mode: auto
+
+middleware:
+  mentionGate:
+    requireMentionInGroup: true
+    alwaysAnswerC2C: true
+  concurrency:
+    strategy: merge
+    maxQueue: 50
+
+streaming:
+  c2c: true
+  throttleMs: 500
+
+message:
+  display:
+    preset: minimal
+
+log:
+  level: info
+  console: json
+  file:
+    enabled: true
+    dir: ./logs
+    maxSize: 10m
+    maxFiles: 7
+    frequency: daily
+    dateFormat: yyyy-MM-dd
+    symlink: true
+
+# 伽利略监控平台上报配置
+telemetry:
+  enabled: true
+  endpoint: http://localhost:4318
+  protocol: http
+  sampleRate: 1.0
+  exportIntervalMs: 10000
+  galileo:
+    platform: YOUR_PLATFORM      # 平台标识
+    app: qqbot                   # 应用名
+    server: qqbot-cli                  # 服务名（最终 target = platform.app.server）
+    namespace: Production        # 命名空间：Production / Development
+    envName: formal              # 环境：formal / test
+  attributes:
+    env: production

package/templates/bot.openai.yaml

@@ -0,0 +1,63 @@
+# qqbot-cli 配置模板 — OpenAI 兼容 API 模式
+
+qq:
+  appId: ${QQBOT_APP_ID}
+  appSecret: ${QQBOT_APP_SECRET}
+  markdown: false
+  # baseUrl: https://api.sgroup.qq.com
+  # tokenBaseUrl: https://bots.qq.com
+  # tokenPrefetch: sync
+  # transport: websocket
+  # webhook:
+  #   port: 8080
+  #   path: /callback
+
+backend:
+  type: openai
+  openai:
+    apiKey: ${OPENAI_API_KEY}
+    baseUrl: https://api.openai.com/v1
+    model: gpt-4o
+    systemPrompt: "你是一个 QQ 机器人助手。用中文简洁回答。"
+    maxTokens: 2048
+    temperature: 0.7
+
+middleware:
+  messageFilter:
+    skipSelfEcho: true
+    dedup: { windowMs: 5000 }
+  contentSanitizer:
+    stripBotMention: true
+  mentionGate:
+    requireMentionInGroup: true
+    alwaysAnswerC2C: true
+  typingIndicator:
+    enabled: true
+    durationSec: 30
+  # 并发控制：同一用户/群串行处理 strategy: queue | drop | abort
+  concurrency:
+    strategy: abort
+    maxQueue: 10
+
+streaming:
+  c2c: true
+  throttleMs: 500
+
+# 消息展示样式 preset: full | compact | minimal | text-only
+message:
+  display:
+    preset: minimal
+
+session:
+  persistence:
+    type: file
+    dir: ./.qqbot-data
+
+log:
+  level: info
+
+# MCP Server：在 qqbot-cli 进程内启动 HTTP+SSE MCP Server
+# 可供外部 Agent 调用已注册的工具（如 send_file）
+# mcp:
+#   enabled: true
+#   port: 0