ylib-syim 0.0.1

package/scripts/install/im-agent-hub-ctl.sh

@@ -0,0 +1,283 @@
+#!/usr/bin/env bash
+# 全局管理命令：im-agent-hub-ctl（独立 im-agent-hub 项目）
+# 配置来自 ~/.im-agent-hub/manifest.env
+
+set -euo pipefail
+
+DEFAULT_HOME="${HOME:?}/.im-agent-hub"
+MANIFEST="${IM_AGENT_HUB_HOME:-$DEFAULT_HOME}/manifest.env"
+PID_FILE=""
+LOG_FILE=""
+
+load_manifest() {
+  if [[ ! -f "$MANIFEST" ]]; then
+    echo "未找到 $MANIFEST ，请先运行 scripts/install/install-dingtalk-bridge.sh 安装。" >&2
+    exit 1
+  fi
+  # shellcheck disable=SC1090
+  source "$MANIFEST"
+  IM_AGENT_HUB_HOME="${IM_AGENT_HUB_HOME:-$DEFAULT_HOME}"
+  PID_FILE="$IM_AGENT_HUB_HOME/run/dingtalk-stdio-bridge.pid"
+  LOG_FILE="$IM_AGENT_HUB_HOME/logs/dingtalk-stdio-bridge.log"
+}
+
+ensure_dirs() {
+  mkdir -p "$(dirname "$PID_FILE")" "$(dirname "$LOG_FILE")"
+}
+
+nvm_bootstrap() {
+  if [[ -f "$HOME/.nvm/nvm.sh" ]]; then
+    # shellcheck disable=SC1090
+    source "$HOME/.nvm/nvm.sh"
+  fi
+}
+
+cmd_start() {
+  load_manifest
+  ensure_dirs
+  if [[ -f "$PID_FILE" ]]; then
+    local old
+    old="$(cat "$PID_FILE" 2>/dev/null || true)"
+    if [[ -n "$old" ]] && kill -0 "$old" 2>/dev/null; then
+      echo "已在运行 (pid=$old)"
+      exit 0
+    fi
+    rm -f "$PID_FILE"
+  fi
+  nvm_bootstrap
+  cd "$IM_AGENT_HUB_PACKAGE_ROOT"
+  echo "工作目录: $IM_AGENT_HUB_PACKAGE_ROOT" >>"$LOG_FILE"
+  echo "---- $(date -Iseconds) start ----" >>"$LOG_FILE"
+  # 若已执行 npm run build:bridge，优先用单文件 bundle（CJS，避免 ws 等对 events 的 dynamic require 在 ESM 包里报错）
+  if [[ -f "$IM_AGENT_HUB_PACKAGE_ROOT/dist/dingtalk-stdio-bridge.cjs" ]]; then
+    echo "[start] 使用打包产物: node dist/dingtalk-stdio-bridge.cjs" >>"$LOG_FILE"
+    nohup node dist/dingtalk-stdio-bridge.cjs >>"$LOG_FILE" 2>&1 &
+  elif [[ -f "$IM_AGENT_HUB_PACKAGE_ROOT/dist/dingtalk-stdio-bridge.mjs" ]]; then
+    echo "[start] 使用旧版 .mjs 产物（建议改为 npm run build:bridge 生成 .cjs）" >>"$LOG_FILE"
+    nohup node dist/dingtalk-stdio-bridge.mjs >>"$LOG_FILE" 2>&1 &
+  else
+    echo "[start] 使用源码: npx tsx scripts/dingtalk-stdio-bridge.ts" >>"$LOG_FILE"
+    nohup npx tsx scripts/dingtalk-stdio-bridge.ts >>"$LOG_FILE" 2>&1 &
+  fi
+  echo $! >"$PID_FILE"
+  echo "已启动 dingtalk-stdio-bridge，pid=$(cat "$PID_FILE")，日志: $LOG_FILE"
+}
+
+cmd_stop() {
+  load_manifest
+  if [[ ! -f "$PID_FILE" ]]; then
+    echo "未找到 pid 文件，可能未启动"
+    exit 0
+  fi
+  local pid
+  pid="$(cat "$PID_FILE" 2>/dev/null || true)"
+  if [[ -z "$pid" ]]; then
+    rm -f "$PID_FILE"
+    exit 0
+  fi
+  if kill -0 "$pid" 2>/dev/null; then
+    kill "$pid" 2>/dev/null || true
+    sleep 1
+    kill -9 "$pid" 2>/dev/null || true
+  fi
+  rm -f "$PID_FILE"
+  echo "已停止"
+}
+
+cmd_restart() {
+  cmd_stop || true
+  cmd_start
+}
+
+cmd_status() {
+  load_manifest
+  if [[ -f "$PID_FILE" ]]; then
+    local pid
+    pid="$(cat "$PID_FILE" 2>/dev/null || true)"
+    if [[ -n "$pid" ]] && kill -0 "$pid" 2>/dev/null; then
+      echo "运行中 pid=$pid"
+      echo "项目目录: $IM_AGENT_HUB_PACKAGE_ROOT"
+      echo "日志: $LOG_FILE"
+      exit 0
+    fi
+  fi
+  echo "未运行"
+  exit 1
+}
+
+cmd_logs() {
+  load_manifest
+  touch "$LOG_FILE"
+  tail -n "${2:-100}" -f "$LOG_FILE"
+}
+
+cmd_config() {
+  load_manifest
+  "${EDITOR:-vi}" "$IM_AGENT_HUB_PACKAGE_ROOT/openclaw.json"
+}
+
+cmd_update_help() {
+  cat <<'EOF'
+更新流程（推荐一条命令）
+
+  im-agent-hub-ctl update
+
+等价于（在 manifest 记录的项目目录下）：
+
+  1. 可选：备份 openclaw.json → openclaw.json.bak.<时间戳>
+  2. 停止桥接进程
+  3. git pull（若非 git 仓库则跳过，仅 npm install）
+  4. npm install
+  5. 重新启动桥接
+
+会保留的内容
+
+  - openclaw.json（git pull 若与远端冲突需手动解决；备份文件在项目根目录）
+  - ~/.im-agent-hub/manifest.env（安装路径不变则无需重装）
+
+环境变量
+
+  USE_CN_MIRROR=1 / IM_AGENT_HUB_USE_CN=1  → npm 使用 registry.npmmirror.com
+  IM_AGENT_HUB_NO_BACKUP=1                → 更新前不备份 openclaw.json
+  IM_AGENT_HUB_UPDATE_NO_RESTART=1        → 拉取与 npm install 后不自动 start
+  IM_AGENT_HUB_REBUILD_BUNDLE=1           → 即使尚无 dist/，也执行 npm run build:bridge
+
+若 package.json 使用 file:../dingtalk-openclaw-connector，请先同步该目录再执行 update。
+
+若你使用 npm run build:bridge 生成 dist/dingtalk-stdio-bridge.cjs，update 后请再执行一次 npm run build:bridge 再 restart。
+
+若本机 im-agent-hub-ctl 较旧没有 update 子命令，请在仓库内重新执行：
+
+  bash scripts/install/install-dingtalk-bridge.sh
+
+（可 Ctrl+C 在写入配置前退出，仅用于重新安装 ctl；或手动 cp scripts/install/im-agent-hub-ctl.sh ~/.local/bin/im-agent-hub-ctl）
+
+冲突 / 回滚
+
+  - git 冲突：在项目目录解决后再次 im-agent-hub-ctl update，或手动 npm install && im-agent-hub-ctl restart
+  - 配置被误改：用 openclaw.json.bak.* 恢复
+
+卸载安装项（ctl + ~/.im-agent-hub，不删 Node / 不删项目 node_modules）
+
+  在 im-agent-hub 仓库内：bash scripts/install/uninstall-im-agent-hub.sh
+EOF
+}
+
+npm_install_in_project() {
+  local root="$1"
+  cd "$root"
+  local reg=()
+  if [[ "${USE_CN_MIRROR:-0}" == "1" ]] || [[ "${IM_AGENT_HUB_USE_CN:-0}" == "1" ]]; then
+    reg=(--registry=https://registry.npmmirror.com)
+    echo "[update] npm 使用镜像 registry.npmmirror.com"
+  fi
+  npm install "${reg[@]}"
+}
+
+cmd_update() {
+  load_manifest
+  local root="$IM_AGENT_HUB_PACKAGE_ROOT"
+  if [[ ! -d "$root" ]]; then
+    echo "项目目录不存在: $root （请检查 manifest 或重新运行 install-dingtalk-bridge.sh）" >&2
+    exit 1
+  fi
+
+  echo "[update] 项目目录: $root"
+
+  if [[ "${IM_AGENT_HUB_NO_BACKUP:-0}" != "1" ]] && [[ -f "$root/openclaw.json" ]]; then
+    local bak="$root/openclaw.json.bak.$(date +%Y%m%d%H%M%S)"
+    cp -a "$root/openclaw.json" "$bak"
+    echo "[update] 已备份 openclaw.json → $(basename "$bak")"
+  fi
+
+  cmd_stop || true
+
+  cd "$root"
+
+  if command -v git &>/dev/null && [[ -d .git ]]; then
+    echo "[update] git pull ..."
+    if ! git pull --ff-only; then
+      echo "[update] git pull --ff-only 不可用（例如需 merge），尝试 git pull ..." >&2
+      git pull || {
+        echo "[update] git pull 失败（可能有冲突），请在本目录手动处理后再: npm install && im-agent-hub-ctl start" >&2
+        exit 1
+      }
+    fi
+  else
+    echo "[update] 非 git 仓库或未安装 git，跳过 git pull，仅执行 npm install"
+  fi
+
+  npm_install_in_project "$root"
+
+  if [[ -f "$root/dist/dingtalk-stdio-bridge.cjs" ]] || [[ -f "$root/dist/dingtalk-stdio-bridge.mjs" ]] || [[ "${IM_AGENT_HUB_REBUILD_BUNDLE:-0}" == "1" ]]; then
+    if grep -q '"build:bridge"' "$root/package.json" 2>/dev/null; then
+      echo "[update] npm run build:bridge ..."
+      (cd "$root" && npm run build:bridge) || echo "[update] build:bridge 失败，将仍可用 npx tsx 启动" >&2
+    fi
+  fi
+
+  {
+    echo "LAST_UPDATED_UTC=$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+    (cd "$root" && node -p "require('./package.json').version" 2>/dev/null) | sed 's/^/PACKAGE_VERSION=/' || true
+    (cd "$root" && git rev-parse --short HEAD 2>/dev/null) | sed 's/^/GIT_REV=/' || true
+  } >"$IM_AGENT_HUB_HOME/last-update.env" 2>/dev/null || true
+  (cd "$root" && node -p "require('./package.json').version" 2>/dev/null) >"$IM_AGENT_HUB_HOME/package-version.txt" 2>/dev/null || true
+
+  if [[ "${IM_AGENT_HUB_UPDATE_NO_RESTART:-0}" == "1" ]]; then
+    echo "[update] 已完成依赖更新，未自动启动（IM_AGENT_HUB_UPDATE_NO_RESTART=1）"
+    echo "[update] 需要时执行: im-agent-hub-ctl start"
+    return 0
+  fi
+
+  cmd_start
+  echo "[update] 完成。"
+}
+
+cmd_version() {
+  load_manifest
+  local root="$IM_AGENT_HUB_PACKAGE_ROOT"
+  echo "IM_AGENT_HUB_HOME=$IM_AGENT_HUB_HOME"
+  echo "IM_AGENT_HUB_PACKAGE_ROOT=$root"
+  if [[ -f "$root/package.json" ]]; then
+    echo -n "package.json version: "
+    (cd "$root" && node -p "require('./package.json').version" 2>/dev/null) || echo "?"
+  fi
+  if command -v git &>/dev/null && [[ -d "$root/.git" ]]; then
+    echo -n "git HEAD: "
+    (cd "$root" && git rev-parse --short HEAD 2>/dev/null) || echo "?"
+  fi
+  if [[ -f "$IM_AGENT_HUB_HOME/last-update.env" ]]; then
+    echo "--- last update ---"
+    cat "$IM_AGENT_HUB_HOME/last-update.env"
+  fi
+}
+
+usage() {
+  cat <<'EOF'
+用法: im-agent-hub-ctl <command>
+
+  start         后台启动（npx tsx scripts/dingtalk-stdio-bridge.ts）
+  stop / restart / status
+  logs          跟踪日志
+  config        编辑 openclaw.json
+  update        拉取代码 + npm install + 重启（更新主流程）
+  version       显示安装路径、包版本、git 提交、上次 update 记录
+  update-help   更新流程详细说明
+
+环境变量: IM_AGENT_HUB_HOME（默认 ~/.im-agent-hub）
+EOF
+}
+
+case "${1:-}" in
+  start) cmd_start ;;
+  stop) cmd_stop ;;
+  restart) cmd_restart ;;
+  status) cmd_status ;;
+  logs) cmd_logs "$@" ;;
+  config) cmd_config ;;
+  update) cmd_update ;;
+  version) cmd_version ;;
+  update-help) cmd_update_help ;;
+  ""|-h|--help) usage ;;
+  *) echo "未知命令: $1" >&2; usage; exit 1 ;;
+esac

package/scripts/install/install-dingtalk-bridge.sh

@@ -0,0 +1,314 @@
+#!/usr/bin/env bash
+# im-agent-hub（独立仓库）钉钉桥接安装脚本
+# 用法：在仓库根目录执行
+#   bash scripts/install/install-dingtalk-bridge.sh
+#
+# 已安装后的更新（不覆盖 openclaw.json，除非再次跑本脚本并确认合并）：
+#   im-agent-hub-ctl update
+#   im-agent-hub-ctl update-help
+#
+# 可选环境变量：
+#   IM_AGENT_HUB_HOME      数据目录，默认 ~/.im-agent-hub
+#   SKIP_NODE_INSTALL      1 则只检查 Node、不自动装 nvm
+#   USE_CN_MIRROR / IM_AGENT_HUB_USE_CN  1 则 npm 使用 npmmirror
+
+set -euo pipefail
+
+IM_AGENT_HUB_HOME="${IM_AGENT_HUB_HOME:-$HOME/.im-agent-hub}"
+NODE_MIN_MAJOR="${NODE_MIN_MAJOR:-20}"
+NODE_MIN_MINOR="${NODE_MIN_MINOR:-0}"
+
+BOLD='\033[1m'
+INFO='\033[36m'
+SUCCESS='\033[32m'
+WARN='\033[33m'
+ERROR='\033[31m'
+NC='\033[0m'
+
+ui_info() { echo -e "${INFO}[INFO]${NC} $*"; }
+ui_ok() { echo -e "${SUCCESS}[OK]${NC} $*"; }
+ui_warn() { echo -e "${WARN}[WARN]${NC} $*"; }
+ui_err() { echo -e "${ERROR}[ERROR]${NC} $*" >&2; }
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# scripts/install -> 仓库根目录
+PACKAGE_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+CTL_TEMPLATE="$SCRIPT_DIR/im-agent-hub-ctl.sh"
+
+parse_node_major() {
+  command -v node &>/dev/null || return 1
+  node -v 2>/dev/null | sed 's/^v//' | cut -d. -f1
+}
+
+parse_node_minor() {
+  node -v 2>/dev/null | sed 's/^v//' | cut -d. -f2
+}
+
+node_meets_minimum() {
+  command -v node &>/dev/null || return 1
+  local ma mi
+  ma="$(parse_node_major || echo 0)"
+  mi="$(parse_node_minor || echo 0)"
+  [[ "$ma" -gt "$NODE_MIN_MAJOR" ]] && return 0
+  [[ "$ma" -eq "$NODE_MIN_MAJOR" && "$mi" -ge "$NODE_MIN_MINOR" ]] && return 0
+  return 1
+}
+
+ensure_node() {
+  if node_meets_minimum; then
+    ui_ok "Node.js $(node -v) 已满足 >= ${NODE_MIN_MAJOR}.${NODE_MIN_MINOR}"
+    return 0
+  fi
+  if [[ "${SKIP_NODE_INSTALL:-0}" == "1" ]]; then
+    ui_err "需要 Node.js >= ${NODE_MIN_MAJOR}.${NODE_MIN_MINOR}，请手动安装后重试"
+    exit 1
+  fi
+  ui_warn "未检测到满足版本的 Node，尝试通过 nvm + 国内镜像安装 Node ${NODE_MIN_MAJOR}..."
+  if [[ ! -f "$HOME/.nvm/nvm.sh" ]]; then
+    ui_info "正在安装 nvm..."
+    curl -fsSL "https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh" | bash
+  fi
+  # shellcheck disable=SC1090
+  source "$HOME/.nvm/nvm.sh"
+  export NVM_NODEJS_ORG_MIRROR="${NVM_NODEJS_ORG_MIRROR:-https://npmmirror.com/mirrors/node}"
+  nvm install "${NODE_MIN_MAJOR}"
+  nvm alias default "${NODE_MIN_MAJOR}" >/dev/null 2>&1 || true
+  nvm use "${NODE_MIN_MAJOR}"
+  if ! node_meets_minimum; then
+    ui_err "Node 安装后仍不满足版本要求"
+    exit 1
+  fi
+  ui_ok "Node.js $(node -v) 已就绪"
+}
+
+prompt_required() {
+  local label="$1"
+  local var_name="$2"
+  local val=""
+  while true; do
+    read -r -p "${label}（必填）: " val || true
+    val="${val//$'\r'/}"
+    val="$(sed 's/^[[:space:]]*//;s/[[:space:]]*$//' <<<"$val")"
+    if [[ -n "$val" ]]; then
+      printf -v "$var_name" '%s' "$val"
+      return 0
+    fi
+    ui_warn "不能为空，请重新输入。"
+  done
+}
+
+prompt_optional() {
+  local label="$1"
+  local var_name="$2"
+  local val=""
+  read -r -p "${label}（可回车跳过）: " val || true
+  printf -v "$var_name" '%s' "$val"
+}
+
+normalize_base_url() {
+  local u="$1"
+  u="${u//$'\r'/}"
+  u="$(sed 's/^[[:space:]]*//;s/[[:space:]]*$//' <<<"$u")"
+  u="${u%/}"
+  echo "$u"
+}
+
+write_openclaw_json() {
+  export _IMH_GATEWAY_BASE="$2"
+  export _IMH_GATEWAY_TOKEN="$3"
+  export _IMH_CLIENT_ID="$4"
+  export _IMH_CLIENT_SECRET="$5"
+  export _IMH_MODEL_NAME="$6"
+  export _IMH_OUT="$1"
+
+  mkdir -p "$(dirname "$1")"
+  python3 <<'PY'
+import copy
+import json
+import os
+from urllib.parse import urlparse
+
+gateway_base = os.environ["_IMH_GATEWAY_BASE"].strip().rstrip("/")
+token = os.environ["_IMH_GATEWAY_TOKEN"].strip()
+client_id = os.environ["_IMH_CLIENT_ID"].strip()
+secret = os.environ["_IMH_CLIENT_SECRET"].strip()
+model = os.environ.get("_IMH_MODEL_NAME", "").strip()
+out = os.environ["_IMH_OUT"]
+
+ding_url = gateway_base + "/api/v1/yucegpt/dingtalk/chat/"
+
+CHANNEL_KEY = "dingtalk-connector"
+
+cfg = {}
+if os.path.isfile(out):
+    try:
+        with open(out, "r", encoding="utf-8") as f:
+            cfg = json.load(f)
+    except Exception:
+        cfg = {}
+
+if not isinstance(cfg, dict):
+    cfg = {}
+
+channels = cfg.get("channels")
+if not isinstance(channels, dict):
+    channels = {}
+    cfg["channels"] = channels
+
+existing = channels.get(CHANNEL_KEY)
+if not isinstance(existing, dict):
+    existing = {}
+
+# 在原有 channels.dingtalk-connector 上合并（保留如 gatewayPort、accounts 等未询问的字段）
+ch = copy.deepcopy(existing)
+ch["enabled"] = True
+ch["clientId"] = client_id
+ch["clientSecret"] = secret
+ch["gatewayToken"] = token
+ch["dingtalkAgentAccessToken"] = token
+ch["gatewayBaseUrl"] = gateway_base
+ch["dingtalkAgentUrl"] = ding_url
+ch.setdefault("separateSessionByConversation", True)
+ch.setdefault("groupSessionScope", "group")
+ch.setdefault("asyncMode", True)
+if model:
+    ch["modelName"] = model
+
+# 与当前精简 openclaw.json 一致：若 URL 中带端口则同步 gatewayPort（如 http://127.0.0.1:4999）
+try:
+    parsed = urlparse(gateway_base if "://" in gateway_base else "http://" + gateway_base)
+    if parsed.port is not None:
+        ch["gatewayPort"] = parsed.port
+except Exception:
+    pass
+
+channels[CHANNEL_KEY] = ch
+
+# 不再自动写入 bindings：项目约定 openclaw.json 可为仅含 channels 的精简结构
+
+with open(out, "w", encoding="utf-8") as f:
+    json.dump(cfg, f, indent=2, ensure_ascii=False)
+    f.write("\n")
+PY
+  unset _IMH_GATEWAY_BASE _IMH_GATEWAY_TOKEN _IMH_CLIENT_ID _IMH_CLIENT_SECRET _IMH_MODEL_NAME _IMH_OUT
+}
+
+npm_install_project() {
+  local root="$1"
+  cd "$root"
+  local reg=()
+  if [[ "${USE_CN_MIRROR:-0}" == "1" ]] || [[ "${IM_AGENT_HUB_USE_CN:-0}" == "1" ]]; then
+    ui_info "npm 使用镜像: registry.npmmirror.com"
+    reg=(--registry=https://registry.npmmirror.com)
+  fi
+  ui_info "在仓库根目录执行 npm install..."
+  npm install "${reg[@]}"
+}
+
+write_install_manifest() {
+  mkdir -p "$IM_AGENT_HUB_HOME"
+  cat >"$IM_AGENT_HUB_HOME/manifest.env" <<EOF
+# im-agent-hub 独立项目安装清单
+IM_AGENT_HUB_HOME=$IM_AGENT_HUB_HOME
+IM_AGENT_HUB_PACKAGE_ROOT=$1
+INSTALLED_AT=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+EOF
+  if [[ -f "$1/package.json" ]]; then
+    (cd "$1" && node -p "require('./package.json').version" 2>/dev/null) >"$IM_AGENT_HUB_HOME/package-version.txt" || true
+  fi
+}
+
+install_ctl() {
+  local bin_dir="${IM_AGENT_HUB_BIN:-$HOME/.local/bin}"
+  mkdir -p "$bin_dir"
+  if [[ ! -f "$CTL_TEMPLATE" ]]; then
+    ui_err "未找到 ctl 模板: $CTL_TEMPLATE"
+    exit 1
+  fi
+  install -m 0755 "$CTL_TEMPLATE" "$bin_dir/im-agent-hub-ctl"
+  echo "IM_AGENT_HUB_CTL_PATH=$bin_dir/im-agent-hub-ctl" >>"$IM_AGENT_HUB_HOME/manifest.env"
+  ui_ok "已安装全局命令: $bin_dir/im-agent-hub-ctl （请确保该目录在 PATH 中）"
+  if [[ ":$PATH:" != *":$bin_dir:"* ]]; then
+    ui_warn "将以下内容加入 ~/.zshrc 或 ~/.bashrc:"
+    echo "  export PATH=\"$bin_dir:\$PATH\""
+  fi
+}
+
+verify_project() {
+  if [[ ! -f "$PACKAGE_ROOT/package.json" ]]; then
+    ui_err "未在 $PACKAGE_ROOT 找到 package.json，请从 im-agent-hub 仓库内运行本脚本。"
+    exit 1
+  fi
+  if [[ ! -f "$PACKAGE_ROOT/scripts/dingtalk-stdio-bridge.ts" ]]; then
+    ui_err "未找到 scripts/dingtalk-stdio-bridge.ts"
+    exit 1
+  fi
+  # package.json 中 file: 依赖需在安装 npm 前存在
+  if grep -q '"file:' "$PACKAGE_ROOT/package.json" 2>/dev/null; then
+    ui_info "检测到 file: 本地依赖，将运行 npm install（若失败请检查相对路径目录是否存在）"
+  fi
+}
+
+main() {
+  echo -e "${BOLD}im-agent-hub（独立项目）钉钉桥接安装${NC}"
+  echo ""
+
+  [[ -t 0 ]] || { ui_err "请在交互式终端中运行本脚本"; exit 1; }
+
+  verify_project
+  ui_info "项目根目录: $PACKAGE_ROOT"
+
+  ensure_node
+
+  echo ""
+  echo -e "${BOLD}钉钉插件配置（@dingtalk-real-ai/dingtalk-connector）${NC}"
+  ui_info "下面几项会写入项目根目录 ${INFO}openclaw.json${NC} 的 ${INFO}channels.dingtalk-connector${NC}。"
+  ui_info "当前仓库约定可为精简结构（仅 ${INFO}channels${NC}）；若文件中还有其它顶级键会原样保留。"
+  ui_info "不会自动添加 ${INFO}bindings${NC} 等字段；与 im-agent-hub 默认 openclaw.json 结构一致。"
+  echo ""
+
+  local gateway_base gateway_token client_id client_secret model_name
+  prompt_required "[钉钉插件] 服务域名 / Gateway Base URL → gatewayBaseUrl（例 https://api.example.com 或 http://127.0.0.1:4999）" gateway_base
+  prompt_required "[钉钉插件] Gateway Token → gatewayToken / dingtalkAgentAccessToken（与 yuce-gpt Python 侧一致）" gateway_token
+  prompt_required "[钉钉插件] 钉钉开放平台 Client ID → clientId（DINGTALK_CLIENT_ID）" client_id
+  prompt_required "[钉钉插件] 钉钉开放平台 Client Secret → clientSecret（DINGTALK_CLIENT_SECRET）" client_secret
+  prompt_optional "[钉钉插件] 对话模型 → modelName（可选；回车则保留原 openclaw.json 中的 modelName）" model_name
+
+  gateway_base="$(normalize_base_url "$gateway_base")"
+
+  local cfg_target="$PACKAGE_ROOT/openclaw.json"
+  ui_warn "将更新 $cfg_target 内的 channels.dingtalk-connector（钉钉插件）；并自动生成 dingtalkAgentUrl"
+  read -r -p "确认继续？[y/N] " confirm || true
+  if [[ ! "${confirm:-}" =~ ^[yY]$ ]]; then
+    ui_info "已取消"
+    exit 0
+  fi
+
+  write_openclaw_json "$cfg_target" "$gateway_base" "$gateway_token" "$client_id" "$client_secret" "$model_name"
+  ui_ok "已写入 openclaw.json → channels.dingtalk-connector（钉钉插件）"
+
+  npm_install_project "$PACKAGE_ROOT"
+
+  write_install_manifest "$PACKAGE_ROOT"
+  echo "$IM_AGENT_HUB_HOME" >"$IM_AGENT_HUB_HOME/install_home_path.txt"
+
+  install_ctl
+
+  ui_ok "安装完成。"
+  echo ""
+  ui_info "彻底卸载（不删 Node / 不删项目 node_modules 与 openclaw.json）："
+  echo "  bash scripts/install/uninstall-im-agent-hub.sh"
+  echo ""
+  ui_info "常用命令："
+  echo "  im-agent-hub-ctl start | stop | restart | status | logs | config | update-help"
+  echo ""
+  ui_info "更新版本：在仓库内 git pull 后执行 npm install，再 im-agent-hub-ctl restart"
+  echo ""
+
+  read -r -p "是否现在后台启动服务？[y/N] " start_now || true
+  if [[ "${start_now:-}" =~ ^[yY]$ ]]; then
+    "${IM_AGENT_HUB_BIN:-$HOME/.local/bin}/im-agent-hub-ctl" start || true
+  fi
+}
+
+main "$@"

package/scripts/install/systemd/im-agent-hub-dingtalk.service.example

@@ -0,0 +1,18 @@
+# 复制到 ~/.config/systemd/user/im-agent-hub-dingtalk.service 后修改路径
+# systemctl --user daemon-reload && systemctl --user enable --now im-agent-hub-dingtalk.service
+
+[Unit]
+Description=im-agent-hub DingTalk stdio bridge (standalone)
+After=network-online.target
+
+[Service]
+Type=simple
+# 改为你的 im-agent-hub 绝对路径
+WorkingDirectory=%h/work/im-agent-hub
+Environment=PATH=%h/.nvm/versions/node/v22.12.0/bin:/usr/bin:/bin
+ExecStart=/usr/bin/env bash -lc 'cd "%h/work/im-agent-hub" && npx tsx scripts/dingtalk-stdio-bridge.ts'
+Restart=on-failure
+RestartSec=5
+
+[Install]
+WantedBy=default.target