@chbo297/infoflow 2026.5.4 → 2026.5.5

package/README.md

@@ -37,7 +37,55 @@ bash scripts/deploy.sh
 BAIDU_NPM_REGISTRY=http://registry.npm.baidu-int.com bash scripts/deploy.sh
 ```
 
+### 通过 npx 一键更新安装
+
+发布到 npm 后，可直接通过 `npx` 安装/升级到指定版本：
+
+```bash
+npm_config_registry=http://registry.npm.baidu-int.com npx -y @chbo297/infoflow update --version 2026.5.5
+```
+
+常用参数：
+
+- `--version <version>`: 指定安装版本（默认 `latest`）
+- `--registry <url>`: 指定 npm 源（默认读取 `npm_config_registry`，否则回退 `http://registry.npm.baidu-int.com`）
+- `--channel-id <id>`: 目标插件目录名（默认 `infoflow`，安装到 `~/.openclaw/extensions/<id>`）
+- `--dry-run`: 仅打印命令，不写入系统
+
+说明：
+
+- `npx ... update` 与 `bash scripts/deploy.sh` 复用同一套部署核心逻辑（依赖安装、websocket 依赖校验、构建、配置写入、按状态重启 gateway）。
+- 如果 gateway 未运行，脚本会跳过重启，仅完成插件安装与构建。
+
 ### WebSocket 模式（可选）
 
 当 `connectionMode="websocket"` 时，插件会动态 `import("@baidu/infoflow-sdk-nodejs")`。
-该依赖在 `peerDependencies` 中标记为 optional：不使用 websocket 模式时无需安装。
+该依赖在 `peerDependencies` 中标记为 optional：不使用 websocket 模式时无需安装。
+
+### 版本升级、打 tag、推送与 npm 发布流程
+
+每次发布新版本（例如 `2026.5.5`）建议按以下顺序执行：
+
+```bash
+# 1) 修改版本号（会同步 package-lock.json）
+npm version 2026.5.5 --no-git-tag-version
+
+# 2) 发布前校验
+npm run typecheck
+npm run test
+npm run build
+
+# 3) 提交版本变更
+git add package.json package-lock.json README.md scripts src
+git commit -m "2026.5.5"
+
+# 4) 打 tag 并推送代码与 tag
+git tag 2026.5.5
+git push origin main
+git push origin 2026.5.5
+
+# 5) 发布 npm（可按需指定 registry）
+npm publish
+# 或
+# npm publish --registry https://registry.npmjs.org
+```

package/dist/src/cli.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+import { mkdtempSync, readFileSync, rmSync } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { spawnSync } from "node:child_process";
+const DEFAULT_REGISTRY = "http://registry.npm.baidu-int.com";
+function printHelp() {
+    console.log(`Usage:
+  npx -y @chbo297/infoflow update [options]
+
+Commands:
+  update                 Download and install/update Infoflow plugin
+
+Options:
+  --version <version>    Package version (default: latest)
+  --registry <url>       npm registry URL (default: npm_config_registry or ${DEFAULT_REGISTRY})
+  --channel-id <id>      OpenClaw channel/plugin id (default: infoflow)
+  --dry-run              Print commands without changing system
+  --source-dir <path>    Internal use: deploy directly from local source directory
+  -h, --help             Show help
+`);
+}
+function runOrFail(command, args, cwd, dryRun) {
+    const line = [command, ...args].join(" ");
+    console.log(`$ (${cwd}) ${line}`);
+    if (dryRun)
+        return;
+    const result = spawnSync(command, args, { cwd, stdio: "inherit" });
+    if (result.status !== 0) {
+        process.exit(result.status ?? 1);
+    }
+}
+function runAndCollect(command, args, cwd) {
+    const result = spawnSync(command, args, { cwd, encoding: "utf8" });
+    if (result.status !== 0) {
+        if (result.stdout)
+            process.stdout.write(result.stdout);
+        if (result.stderr)
+            process.stderr.write(result.stderr);
+        process.exit(result.status ?? 1);
+    }
+    return result.stdout ?? "";
+}
+function parseArgs(argv) {
+    const args = [...argv];
+    const command = args.shift() ?? "";
+    const options = {
+        version: "latest",
+        registry: process.env.npm_config_registry || DEFAULT_REGISTRY,
+        channelId: "infoflow",
+        dryRun: false,
+    };
+    for (let i = 0; i < args.length; i += 1) {
+        const value = args[i];
+        if (value === "--version")
+            options.version = args[++i] ?? options.version;
+        else if (value === "--registry")
+            options.registry = args[++i] ?? options.registry;
+        else if (value === "--channel-id")
+            options.channelId = args[++i] ?? options.channelId;
+        else if (value === "--source-dir")
+            options.sourceDir = args[++i];
+        else if (value === "--dry-run")
+            options.dryRun = true;
+        else if (value === "-h" || value === "--help") {
+            printHelp();
+            process.exit(0);
+        }
+        else {
+            console.error(`Unknown option: ${value}`);
+            printHelp();
+            process.exit(1);
+        }
+    }
+    return { command, options };
+}
+function installFromRegistry(options, packageName, pluginDir) {
+    const tempRoot = mkdtempSync(join(tmpdir(), "infoflow-update-"));
+    try {
+        const spec = `${packageName}@${options.version}`;
+        let tarball = "";
+        if (options.dryRun) {
+            console.log(`$ (${tempRoot}) npm pack ${spec} --registry ${options.registry} --json`);
+            tarball = "<generated-by-npm-pack>.tgz";
+        }
+        else {
+            const output = runAndCollect("npm", ["pack", spec, "--registry", options.registry, "--json"], tempRoot);
+            const parsed = JSON.parse(output);
+            tarball = parsed[0]?.filename ?? "";
+            if (!tarball) {
+                console.error("Unable to resolve packed tarball filename from npm pack output.");
+                process.exit(1);
+            }
+        }
+        runOrFail("tar", ["-xzf", tarball], tempRoot, options.dryRun);
+        runOrFail("mkdir", ["-p", pluginDir], tempRoot, options.dryRun);
+        runOrFail("rsync", ["-av", "--delete", `${join(tempRoot, "package")}/`, `${pluginDir}/`, "--exclude", "node_modules", "--exclude", "dist"], tempRoot, options.dryRun);
+    }
+    finally {
+        if (!options.dryRun)
+            rmSync(tempRoot, { recursive: true, force: true });
+    }
+}
+function installFromSource(options, pluginDir) {
+    const sourceDir = resolve(options.sourceDir);
+    runOrFail("mkdir", ["-p", pluginDir], sourceDir, options.dryRun);
+    runOrFail("rsync", [
+        "-av",
+        "--delete",
+        `${sourceDir}/`,
+        `${pluginDir}/`,
+        "--exclude",
+        "node_modules",
+        "--exclude",
+        "dist",
+        "--exclude",
+        ".git",
+    ], sourceDir, options.dryRun);
+}
+function main() {
+    const { command, options } = parseArgs(process.argv.slice(2));
+    if (!command) {
+        printHelp();
+        process.exit(0);
+    }
+    if (command !== "update") {
+        console.error(`Unknown command: ${command}`);
+        printHelp();
+        process.exit(1);
+    }
+    const filePath = fileURLToPath(import.meta.url);
+    const packageDir = resolve(dirname(filePath), "..", "..");
+    const pkg = JSON.parse(readFileSync(resolve(packageDir, "package.json"), "utf8"));
+    const packageName = pkg.name || "@chbo297/infoflow";
+    const pluginDir = resolve(process.env.HOME || homedir(), ".openclaw", "extensions", options.channelId);
+    if (options.sourceDir) {
+        installFromSource(options, pluginDir);
+    }
+    else {
+        installFromRegistry(options, packageName, pluginDir);
+    }
+    const commonScriptPath = join(pluginDir, "scripts", "lib", "deploy-common.sh");
+    runOrFail("bash", [
+        commonScriptPath,
+        "--plugin-dir",
+        pluginDir,
+        "--plugin-id",
+        options.channelId,
+        "--config-file",
+        resolve(process.env.HOME || homedir(), ".openclaw", "openclaw.json"),
+        "--baidu-registry",
+        options.registry,
+        ...(options.dryRun ? ["--dry-run"] : []),
+    ], pluginDir, options.dryRun);
+}
+main();

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@chbo297/infoflow",
-  "version": "2026.5.4",
+  "version": "2026.5.5",
   "description": "OpenClaw Infoflow (如流) channel plugin for Baidu enterprise messaging",
   "type": "module",
   "main": "dist/index.js",
+  "bin": {
+    "infoflow-openclaw": "dist/src/cli.js"
+  },
   "license": "MIT",
   "keywords": [
     "openclaw",
@@ -29,7 +32,7 @@
   },
   "openclaw": {
     "extensions": [
-      "./index.ts"
+      "./dist/index.js"
     ],
     "channel": {
       "id": "infoflow",
@@ -52,5 +55,12 @@
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.5"
-  }
+  },
+  "files": [
+    "dist/**",
+    "openclaw.plugin.json",
+    "scripts/deploy.sh",
+    "scripts/lib/**",
+    "README.md"
+  ]
 }

package/scripts/deploy.sh

@@ -1,215 +1,29 @@
 #!/usr/bin/env bash
 # 部署 openclaw-infoflow 插件到本地 OpenClaw 并重启 gateway
 
-set -e
+set -euo pipefail
 
 PLUGIN_ID="infoflow"
 PLUGIN_DIR="$HOME/.openclaw/extensions/$PLUGIN_ID"
 CONFIG_FILE="$HOME/.openclaw/openclaw.json"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 PROJECT_DIR="$(dirname "$SCRIPT_DIR")"
+COMMON_SCRIPT="$SCRIPT_DIR/lib/deploy-common.sh"
 
 echo "==> 同步插件文件到 $PLUGIN_DIR"
 mkdir -p "$PLUGIN_DIR"
 rsync -av --delete "$PROJECT_DIR/" "$PLUGIN_DIR/" \
   --exclude node_modules \
   --exclude dist \
-  --exclude .git \
-  --exclude scripts
+  --exclude .git
 
-echo "==> 链接 openclaw peer dependency（build 前确保可解析）"
-if [ -n "$OPENCLAW_DIR" ] && [ -d "$OPENCLAW_DIR" ]; then
-  OPENCLAW_GLOBAL="$OPENCLAW_DIR"
-elif command -v pnpm >/dev/null 2>&1; then
-  OPENCLAW_GLOBAL="$(pnpm root -g 2>/dev/null)/openclaw"
-else
-  OPENCLAW_GLOBAL="$(npm root -g 2>/dev/null)/openclaw"
-fi
-
-if [ -d "$OPENCLAW_GLOBAL" ]; then
-  mkdir -p "$PLUGIN_DIR/node_modules"
-  rm -rf "$PLUGIN_DIR/node_modules/openclaw"
-  ln -s "$OPENCLAW_GLOBAL" "$PLUGIN_DIR/node_modules/openclaw"
-  echo "  ✓ 已链接 $OPENCLAW_GLOBAL -> $PLUGIN_DIR/node_modules/openclaw"
-else
-  echo "  ✗ 找不到全局 openclaw 安装，尝试使用 which openclaw 推断..."
-  OPENCLAW_BIN="$(which openclaw 2>/dev/null)"
-  if [ -n "$OPENCLAW_BIN" ]; then
-    # pnpm global shim (macOS): extract the openclaw.mjs path from the shim.
-    OPENCLAW_SHIM_BASEDIR="$(cd "$(dirname "$OPENCLAW_BIN")" && pwd)"
-    OPENCLAW_MJS_REL="$(grep -Eo 'global/[^ ]+/\\.pnpm/openclaw@[^ ]+/node_modules/openclaw/openclaw\\.mjs' "$OPENCLAW_BIN" | head -1)"
-    if [ -n "$OPENCLAW_MJS_REL" ]; then
-      OPENCLAW_MJS_ABS="$OPENCLAW_SHIM_BASEDIR/$OPENCLAW_MJS_REL"
-      OPENCLAW_GLOBAL="$(dirname "$OPENCLAW_MJS_ABS")"
-    else
-      # npm layout fallback
-      OPENCLAW_GLOBAL="$(cd "$(dirname "$OPENCLAW_BIN")/.." && pwd)/lib/node_modules/openclaw"
-    fi
-
-    if [ -d "$OPENCLAW_GLOBAL" ]; then
-      mkdir -p "$PLUGIN_DIR/node_modules"
-      rm -rf "$PLUGIN_DIR/node_modules/openclaw"
-      ln -s "$OPENCLAW_GLOBAL" "$PLUGIN_DIR/node_modules/openclaw"
-      echo "  ✓ 已链接 $OPENCLAW_GLOBAL -> $PLUGIN_DIR/node_modules/openclaw"
-    else
-      echo "  ✗ 无法找到 openclaw 安装目录，跳过链接（插件可能无法加载/无法编译）"
-    fi
-  else
-    echo "  ✗ openclaw 未安装，跳过链接（插件可能无法加载/无法编译）"
-  fi
-fi
-
-echo "==> 安装依赖"
-cd "$PLUGIN_DIR" && npm install --silent
-
-WEBSOCKET_ENABLED="false"
-if [ -f "$CONFIG_FILE" ]; then
-  WEBSOCKET_ENABLED="$(node -e "
-    const fs = require('fs');
-    try {
-      const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
-      const section = cfg?.channels?.infoflow ?? {};
-      const topMode = section?.connectionMode;
-      const accounts = section?.accounts && typeof section.accounts === 'object' ? Object.values(section.accounts) : [];
-      const accountWebsocket = accounts.some((acc) => acc && typeof acc === 'object' && acc.connectionMode === 'websocket');
-      const enabled = topMode === 'websocket' || accountWebsocket;
-      process.stdout.write(enabled ? 'true' : 'false');
-    } catch {
-      process.stdout.write('false');
-    }
-  ")"
-fi
-
-if [ "$WEBSOCKET_ENABLED" = "true" ]; then
-  echo "==> 检测到 websocket 模式，确保安装 @baidu/infoflow-sdk-nodejs"
-  BAIDU_NPM_REGISTRY="${BAIDU_NPM_REGISTRY:-${NPM_CONFIG_REGISTRY_BAIDU:-http://registry.npm.baidu-int.com}}"
-
-  # 校验方式用 import()（与插件运行时一致）。注意：一些包可能禁止访问 package.json 子路径。
-  if node --input-type=module -e "import('@baidu/infoflow-sdk-nodejs').then(()=>process.exit(0)).catch(()=>process.exit(1))"; then
-    echo "  ✓ @baidu/infoflow-sdk-nodejs 已可用"
-  else
-    echo "  - 使用私有源安装: $BAIDU_NPM_REGISTRY"
-    # 重要：npm 11 对 peerDependencies + --no-save 的行为在某些场景下不会落盘安装。
-    # 这里改为写入部署目录的 optionalDependencies（不会影响仓库，下一次 rsync 会覆盖），确保依赖真的安装到 node_modules。
-    npm_config_registry="$BAIDU_NPM_REGISTRY" npm install --save-optional --registry "$BAIDU_NPM_REGISTRY" @baidu/infoflow-sdk-nodejs
-
-    if node --input-type=module -e "import('@baidu/infoflow-sdk-nodejs').then(()=>process.exit(0)).catch(()=>process.exit(1))"; then
-      echo "  ✓ 运行时依赖校验通过：@baidu/infoflow-sdk-nodejs"
-    else
-      echo "  ✗ @baidu/infoflow-sdk-nodejs 仍不可用（websocket 模式必须）。"
-      echo "    请确认私有源、网络与鉴权后重试："
-      echo "    npm_config_registry=$BAIDU_NPM_REGISTRY npm install --save-optional --registry $BAIDU_NPM_REGISTRY @baidu/infoflow-sdk-nodejs"
-      exit 1
-    fi
-  fi
-else
-  echo "==> 当前非 websocket 模式，跳过 @baidu/infoflow-sdk-nodejs 安装"
-fi
-
-echo "==> 构建插件（确保 build 完成）"
-cd "$PLUGIN_DIR"
-
-# 1) Prefer package.json scripts.build if present
-if node -e "const p=require('./package.json'); process.exit(p?.scripts?.build ? 0 : 1)"; then
-  echo "  - 检测到 scripts.build，执行 npm run build"
-  npm run build
-else
-  # 2) Fallback to tsc when tsconfig.json exists
-  if [ -f "$PLUGIN_DIR/tsconfig.json" ]; then
-    BUILD_TSCONFIG="tsconfig.json"
-    if [ -f "$PLUGIN_DIR/tsconfig.build.json" ]; then
-      BUILD_TSCONFIG="tsconfig.build.json"
-    fi
-    echo "  - 未检测到 scripts.build，回退执行 TypeScript 编译（npx -p typescript tsc -p $BUILD_TSCONFIG）"
-    npx -y -p typescript tsc -p "$BUILD_TSCONFIG"
-  else
-    echo "  ✗ 未检测到 scripts.build 且不存在 tsconfig.json，无法确认已完成编译"
-    exit 1
-  fi
-fi
-
-# 3) Post-build sanity check: outDir defaults to dist, but honor tsconfig.json if present.
-OUT_DIR="dist"
-if [ -f "$PLUGIN_DIR/tsconfig.json" ]; then
-  OUT_DIR_FROM_TSCONFIG="$(node -e "
-    const fs = require('fs');
-    const cfg = JSON.parse(fs.readFileSync('tsconfig.json','utf8'));
-    const outDir = cfg?.compilerOptions?.outDir;
-    if (typeof outDir === 'string' && outDir.trim()) process.stdout.write(outDir.trim());
-  ")"
-  if [ -n "$OUT_DIR_FROM_TSCONFIG" ]; then
-    OUT_DIR="$OUT_DIR_FROM_TSCONFIG"
-  fi
-fi
-
-if [ ! -d "$PLUGIN_DIR/$OUT_DIR" ]; then
-  echo "  ✗ 构建完成但未发现产物目录：$PLUGIN_DIR/$OUT_DIR"
-  echo "    请检查 tsconfig.json 的 outDir 或 build 脚本是否输出到其它目录"
+if [ ! -f "$COMMON_SCRIPT" ]; then
+  echo "✗ 缺少公共部署脚本: $COMMON_SCRIPT"
   exit 1
 fi
-echo "  ✓ 已检测到构建产物目录：$PLUGIN_DIR/$OUT_DIR"
-
-if [ ! -f "$CONFIG_FILE" ]; then
-  echo "  ✗ 未找到 $CONFIG_FILE，请先完成 OpenClaw 初始化后再部署"
-  exit 1
-fi
-
-echo "==> 更新 OpenClaw 配置"
-node -e "
-  const fs = require('fs');
-  const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
-  const id = '$PLUGIN_ID';
 
-  // 1. plugins.entries: 确保插件已启用
-  cfg.plugins = cfg.plugins ?? {};
-  cfg.plugins.entries = cfg.plugins.entries ?? {};
-  if (!cfg.plugins.entries[id]) {
-    cfg.plugins.entries[id] = { enabled: true };
-    console.log('  + 已添加 plugins.entries.' + id);
-  } else if (!cfg.plugins.entries[id].enabled) {
-    cfg.plugins.entries[id].enabled = true;
-    console.log('  + 已启用 plugins.entries.' + id);
-  } else {
-    console.log('  ✓ plugins.entries.' + id + ' 已存在');
-  }
-
-  // 2. plugins.allow: 如果配置了白名单，确保插件在列表中
-  if (Array.isArray(cfg.plugins.allow)) {
-    if (!cfg.plugins.allow.includes(id)) {
-      cfg.plugins.allow.push(id);
-      console.log('  + 已添加到 plugins.allow');
-    } else {
-      console.log('  ✓ plugins.allow 已包含 ' + id);
-    }
-  } else {
-    console.log('  - plugins.allow 未配置，跳过');
-  }
-
-  fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 2) + '\n');
-"
-
-echo "==> 检查 OpenClaw gateway 运行状态"
-GATEWAY_STATUS="$(openclaw gateway status 2>/dev/null || true)"
-DID_RESTART="false"
-if echo "$GATEWAY_STATUS" | rg -q "Runtime: running"; then
-  echo "==> gateway 当前运行中，执行重启"
-  openclaw gateway restart
-  DID_RESTART="true"
-else
-  echo "==> gateway 当前未运行，按要求跳过启动/重启"
-fi
-
-echo "==> 检查启动状态"
-sleep 2
-if [ "$DID_RESTART" = "true" ]; then
-  # Restart 之后才做运行态确认，避免误匹配其它 openclaw 进程。
-  if openclaw gateway status 2>/dev/null | rg -q "Runtime: running"; then
-    echo "✓ gateway 重启完成"
-  else
-    echo "✗ gateway 重启后未处于 running 状态，请查看状态与日志：openclaw gateway status"
-    exit 1
-  fi
-else
-  # 未重启/未启动时，仅输出当前状态
-  openclaw gateway status 2>/dev/null || true
-fi
+bash "$COMMON_SCRIPT" \
+  --plugin-dir "$PLUGIN_DIR" \
+  --plugin-id "$PLUGIN_ID" \
+  --config-file "$CONFIG_FILE" \
+  --baidu-registry "${BAIDU_NPM_REGISTRY:-${NPM_CONFIG_REGISTRY_BAIDU:-http://registry.npm.baidu-int.com}}"

package/scripts/lib/deploy-common.sh

@@ -0,0 +1,157 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+PLUGIN_DIR=""
+PLUGIN_ID="infoflow"
+CONFIG_FILE="$HOME/.openclaw/openclaw.json"
+BAIDU_NPM_REGISTRY="${BAIDU_NPM_REGISTRY:-${NPM_CONFIG_REGISTRY_BAIDU:-http://registry.npm.baidu-int.com}}"
+DRY_RUN="false"
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --plugin-dir) PLUGIN_DIR="$2"; shift 2 ;;
+    --plugin-id) PLUGIN_ID="$2"; shift 2 ;;
+    --config-file) CONFIG_FILE="$2"; shift 2 ;;
+    --baidu-registry) BAIDU_NPM_REGISTRY="$2"; shift 2 ;;
+    --dry-run) DRY_RUN="true"; shift ;;
+    *) echo "Unknown argument: $1"; exit 1 ;;
+  esac
+done
+
+if [[ -z "$PLUGIN_DIR" ]]; then
+  echo "Missing --plugin-dir"
+  exit 1
+fi
+
+cd "$PLUGIN_DIR"
+
+run_cmd() {
+  echo "$ $*"
+  if [[ "$DRY_RUN" == "true" ]]; then
+    return 0
+  fi
+  "$@"
+}
+
+echo "==> 链接 openclaw peer dependency（build 前确保可解析）"
+if [ -n "${OPENCLAW_DIR:-}" ] && [ -d "${OPENCLAW_DIR:-}" ]; then
+  OPENCLAW_GLOBAL="$OPENCLAW_DIR"
+elif command -v pnpm >/dev/null 2>&1; then
+  OPENCLAW_GLOBAL="$(pnpm root -g 2>/dev/null)/openclaw"
+else
+  OPENCLAW_GLOBAL="$(npm root -g 2>/dev/null)/openclaw"
+fi
+
+if [ -d "${OPENCLAW_GLOBAL:-}" ]; then
+  run_cmd mkdir -p "$PLUGIN_DIR/node_modules"
+  run_cmd rm -rf "$PLUGIN_DIR/node_modules/openclaw"
+  run_cmd ln -s "$OPENCLAW_GLOBAL" "$PLUGIN_DIR/node_modules/openclaw"
+  echo "  ✓ 已链接 $OPENCLAW_GLOBAL -> $PLUGIN_DIR/node_modules/openclaw"
+else
+  echo "  - 未检测到全局 openclaw，跳过链接"
+fi
+
+echo "==> 安装依赖"
+  run_cmd npm install --silent
+
+WEBSOCKET_ENABLED="false"
+if [ -f "$CONFIG_FILE" ]; then
+  WEBSOCKET_ENABLED="$(node -e "
+    const fs = require('fs');
+    try {
+      const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+      const section = cfg?.channels?.$PLUGIN_ID ?? {};
+      const topMode = section?.connectionMode;
+      const accounts = section?.accounts && typeof section.accounts === 'object' ? Object.values(section.accounts) : [];
+      const accountWebsocket = accounts.some((acc) => acc && typeof acc === 'object' && acc.connectionMode === 'websocket');
+      const enabled = topMode === 'websocket' || accountWebsocket;
+      process.stdout.write(enabled ? 'true' : 'false');
+    } catch {
+      process.stdout.write('false');
+    }
+  ")"
+fi
+
+if [ "$WEBSOCKET_ENABLED" = "true" ]; then
+  echo "==> 检测到 websocket 模式，确保安装 @baidu/infoflow-sdk-nodejs"
+  if [[ "$DRY_RUN" == "true" ]]; then
+    echo "  - dry-run 模式，跳过 websocket 依赖安装"
+  elif node --input-type=module -e "import('@baidu/infoflow-sdk-nodejs').then(()=>process.exit(0)).catch(()=>process.exit(1))"; then
+    echo "  ✓ @baidu/infoflow-sdk-nodejs 已可用"
+  else
+    echo "  - 使用私有源安装: $BAIDU_NPM_REGISTRY"
+    npm_config_registry="$BAIDU_NPM_REGISTRY" npm install --save-optional --registry "$BAIDU_NPM_REGISTRY" @baidu/infoflow-sdk-nodejs
+    if node --input-type=module -e "import('@baidu/infoflow-sdk-nodejs').then(()=>process.exit(0)).catch(()=>process.exit(1))"; then
+      echo "  ✓ 运行时依赖校验通过：@baidu/infoflow-sdk-nodejs"
+    else
+      echo "  ✗ @baidu/infoflow-sdk-nodejs 仍不可用（websocket 模式必须）"
+      exit 1
+    fi
+  fi
+else
+  echo "==> 当前非 websocket 模式，跳过 @baidu/infoflow-sdk-nodejs 安装"
+fi
+
+echo "==> 构建插件（确保 build 完成）"
+if [[ "$DRY_RUN" == "true" ]]; then
+  echo "  - dry-run 模式，跳过实际构建"
+else
+  if node -e "const p=require('./package.json'); process.exit(p?.scripts?.build ? 0 : 1)"; then
+    npm run build
+  elif [ -f "$PLUGIN_DIR/tsconfig.build.json" ]; then
+    npx -y -p typescript tsc -p "$PLUGIN_DIR/tsconfig.build.json"
+  elif [ -f "$PLUGIN_DIR/tsconfig.json" ]; then
+    npx -y -p typescript tsc -p "$PLUGIN_DIR/tsconfig.json"
+  else
+    echo "  ✗ 未检测到 scripts.build 或 tsconfig，无法构建"
+    exit 1
+  fi
+fi
+
+if [ ! -d "$PLUGIN_DIR/dist" ] && [[ "$DRY_RUN" != "true" ]]; then
+  echo "  ✗ 构建完成但未发现产物目录：$PLUGIN_DIR/dist"
+  exit 1
+fi
+echo "  ✓ 已检测到构建产物目录：$PLUGIN_DIR/dist"
+
+if [ ! -f "$CONFIG_FILE" ]; then
+  echo "  ✗ 未找到 $CONFIG_FILE，请先完成 OpenClaw 初始化后再部署"
+  exit 1
+fi
+
+if [[ "$DRY_RUN" == "true" ]]; then
+  echo "==> dry-run 模式，跳过配置写入与 gateway 操作"
+  exit 0
+fi
+
+echo "==> 更新 OpenClaw 配置"
+node -e "
+  const fs = require('fs');
+  const cfg = JSON.parse(fs.readFileSync('$CONFIG_FILE', 'utf8'));
+  const id = '$PLUGIN_ID';
+
+  cfg.plugins = cfg.plugins ?? {};
+  cfg.plugins.entries = cfg.plugins.entries ?? {};
+  if (!cfg.plugins.entries[id]) cfg.plugins.entries[id] = { enabled: true };
+  else if (!cfg.plugins.entries[id].enabled) cfg.plugins.entries[id].enabled = true;
+
+  if (Array.isArray(cfg.plugins.allow) && !cfg.plugins.allow.includes(id)) cfg.plugins.allow.push(id);
+  fs.writeFileSync('$CONFIG_FILE', JSON.stringify(cfg, null, 2) + '\n');
+"
+
+echo "==> 检查 OpenClaw gateway 运行状态"
+GATEWAY_STATUS="$(openclaw gateway status 2>/dev/null || true)"
+if echo "$GATEWAY_STATUS" | rg -q "Runtime: running"; then
+  echo "==> gateway 当前运行中，执行重启"
+  openclaw gateway restart
+  sleep 2
+  if openclaw gateway status 2>/dev/null | rg -q "Runtime: running"; then
+    echo "✓ gateway 重启完成"
+  else
+    echo "✗ gateway 重启后未处于 running 状态，请查看 openclaw gateway status"
+    exit 1
+  fi
+else
+  echo "==> gateway 当前未运行，按要求跳过启动/重启"
+fi

package/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(git add:*)",
-      "Bash(git commit -m \"$\\(cat <<''EOF''\nfeat: add assistant watchMentions, followUp, replyMode and actions support\n\n- Add watchMentions config for assistant-style replies when watched users are @mentioned\n- Add @mention detection and resolution in group messages \\(user and agent\\)\n- Add followUp window for automatic follow-up replies after bot interaction\n- Add 5 replyMode options: ignore, record, mention-only, mention-and-watch, proactive\n- Add ChannelMessageActionAdapter for LLM-initiated message sends\n- Refactor logging: unified logVerbose\\(\\) and formatInfoflowError\\(\\)\n- Update openclaw.plugin.json config schema with new group config format \\(breaking change\\)\n- Add CHANGELOG.md\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>\nEOF\n\\)\")",
-      "Bash(npm publish:*)"
-    ]
-  }
-}