rainskills 0.1.29 → 0.1.30

package/README.md

@@ -239,7 +239,7 @@ node ~/.rainbond/lib/rainskills/bin/rainskills.js platform install --onboarding-
 
 Rainskills 会在用户下一次发起业务动作时，由本地运行时立即返回环境查询结果，并另行启动后台任务静默检查更新。更新只跟随 npm `latest` 指向的正式版。当前版本是 RC 或其他预发布版本时不会查询、不会自动升级；npm 上的新 RC 版本也不参与正式版自动升级。
 
-发现更高的正式版后，后台任务只委托到经过校验的精确版本，例如 `rainskills@0.1.29`，不会执行浮动的 `@latest` 业务代码。新版本原子刷新已经安装的 Rainskills Skills；当前业务继续使用启动时已经加载的版本，最迟从下一条新任务开始使用新版。npm 超时、版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本，且不会阻塞或改变当前操作。
+发现更高的正式版后，后台任务只委托到经过校验的精确版本，例如 `rainskills@0.1.30`，不会执行浮动的 `@latest` 业务代码。新版本原子刷新已经安装的 Rainskills Skills；当前业务继续使用启动时已经加载的版本，最迟从下一条新任务开始使用新版。npm 超时、版本检查失败、安装位置不安全或文件迁移失败时会保留旧版本，且不会阻塞或改变当前操作。
 
 升级只更新 Rainskills 自身，不触发 Rainbond 安装、运行环境选择、登录授权或重新对接，也不会新增 Agent MCP 配置。更新内容仅包括 Skills 和本地 CLI。原始业务操作会继续执行；只有该业务操作本身需要运行环境时，才按既有门禁检查当前连接。可用连接直接复用，401 只重新授权一次，403 立即停止，从未连接过运行环境时才进入环境选择。
 

package/SKILL.md

@@ -50,7 +50,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 
 DeepSeek Harness 和 WorkBuddy 也必须保持原命令附着直到退出；如果宿主把长命令转成持久终端或后台任务，只能轮询该原始命令句柄，不得另起 `runtime status` 推测授权结果。WorkBuddy 安装后若当前任务的 Skill 清单尚未刷新，在下一条业务动作前先刷新 Skill 列表或新建任务，不得退回内置 Sites 代替 Rainbond 部署。
 
-Rainskills 只保存一个全局运行环境，不维护环境列表、名称、默认值或环境 ID。使用固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.29`）：
+Rainskills 只保存一个全局运行环境，不维护环境列表、名称、默认值或环境 ID。使用固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.30`）：
 
 - 状态：执行 `runtime status --json`。
 - 首次连接：执行 `runtime connect <target> --saas` 或 `runtime connect <target> --rainbond-url <Console origin>`。

package/bin/rainskills-tools.js

@@ -449,6 +449,56 @@ function skillManifestPath(config) {
   return path.join(config.homeDir || os.homedir(), CONFIG_DIRECTORY, "bin", SKILL_MANIFEST_FILENAME);
 }
 
+function loadTelemetryPackageVersion(config) {
+  try {
+    const manifest = JSON.parse(fs.readFileSync(skillManifestPath(config), "utf8"));
+    return typeof manifest.package_version === "string" && manifest.package_version
+      ? manifest.package_version
+      : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+function createBridgeTelemetry(config) {
+  try {
+    const directory = path.join(config.homeDir || os.homedir(), CONFIG_DIRECTORY, "rainskills", "telemetry");
+    const { createResultTelemetry } = requireRuntimeModule("result-telemetry.js");
+    return createResultTelemetry({
+      directory,
+      packageVersion: loadTelemetryPackageVersion(config),
+    });
+  } catch {
+    return null;
+  }
+}
+
+async function executeWithUsageTelemetry(command, config) {
+  const tracksUsage = command.command === "read" || command.command === "call";
+  const telemetry = tracksUsage ? createBridgeTelemetry(config) : null;
+  if (telemetry) await telemetry.flushPending(3).catch(() => {});
+  try {
+    const output = await execute(command, config);
+    if (telemetry) {
+      const firstUse = telemetry.recordFirstUse("success");
+      const active = telemetry.recordActiveDaily();
+      await Promise.allSettled([firstUse.delivery, active.delivery]);
+    }
+    return output;
+  } catch (error) {
+    if (telemetry) {
+      const firstUse = telemetry.recordFirstUse("failed", {
+        error_stage: "first_use",
+        error_code: error instanceof BridgeError && error.exitCode === EXIT.TRANSPORT
+          ? "transport_failed"
+          : "tool_call_failed",
+      });
+      await firstUse.delivery.catch(() => false);
+    }
+    throw error;
+  }
+}
+
 function loadSkillBinding(config, skillId, rootSkillId) {
   const target = skillManifestPath(config);
   let manifest;
@@ -1370,7 +1420,7 @@ async function main(args = process.argv.slice(2)) {
       if (config.isInsecureHttp) {
         process.stderr.write('{"warning":"using insecure HTTP transport"}\n');
       }
-      const output = await execute(command, config);
+      const output = await executeWithUsageTelemetry(command, config);
       process.stdout.write(`${JSON.stringify(fitOutput(output))}\n`);
       return;
     }
@@ -1380,7 +1430,7 @@ async function main(args = process.argv.slice(2)) {
     if (config.isInsecureHttp) {
       process.stderr.write('{"warning":"using insecure HTTP transport"}\n');
     }
-    const output = await execute(command, config);
+    const output = await executeWithUsageTelemetry(command, config);
     process.stdout.write(`${JSON.stringify(fitOutput(output))}\n`);
   } catch (error) {
     const bridgeError = error instanceof BridgeError

package/install.sh

@@ -176,6 +176,7 @@ VALIDATED_TOKEN=""
 OBTAINED_RAINBOND_TOKEN=""
 RAINSKILLS_INSTALL_REPORT_URL="https://log.rainbond.com/api/rainskills/installations"
 RAINSKILLS_LIFECYCLE_REPORT_URL="https://log.rainbond.com/api/rainskills/lifecycle-events"
+RAINSKILLS_TELEMETRY_REPORT_URL="${RAINSKILLS_TELEMETRY_REPORT_URL:-https://log.rainbond.com/api/rainskills/events}"
 RAINSKILLS_INSTALL_ATTEMPT_ID="${RAINSKILLS_INSTALL_ATTEMPT_ID:-}"
 RAINSKILLS_INSTALL_EID=""
 RAINSKILLS_INSTALL_CLIENT="unknown"
@@ -183,6 +184,8 @@ RAINSKILLS_INSTALL_ACTION="install"
 RAINSKILLS_INSTALL_FAILURE_STAGE="bootstrap"
 RAINSKILLS_INSTALL_FAILURE_CATEGORY="invalid_arguments"
 RAINSKILLS_INSTALL_TERMINAL_REPORTED=0
+RAINSKILLS_V2_TERMINAL_REPORTED=0
+RAINSKILLS_V2_CURRENT_AGENT=""
 RAINSKILLS_TELEMETRY_SEQUENCE=0
 RAINSKILLS_BROWSER_LOGIN_SERVER_PID=""
 RAINSKILLS_BROWSER_LOGIN_READER_PID=""
@@ -286,13 +289,282 @@ new_rainskills_install_attempt_id() {
     python3 - <<'PY'
 import uuid
 
-print(uuid.uuid4().hex)
+print(str(uuid.uuid4()))
 PY
     return 0
   fi
   printf '%s-%s-%s\n' "$(date +%s)" "$$" "${RANDOM:-0}"
 }
 
+rainskills_v2_enabled() {
+  [[ "${RAINSKILLS_TELEMETRY_DISABLED:-0}" != "1" ]]
+}
+
+initialize_rainskills_v2_identity() {
+  rainskills_v2_enabled || return 0
+  command -v python3 >/dev/null 2>&1 || return 0
+  local telemetry_dir package_file
+  telemetry_dir="${RAINSKILLS_TELEMETRY_DIR:-${HOME:-/tmp}/.rainbond/rainskills/telemetry}"
+  package_file="$SCRIPT_DIR/package.json"
+  RAINSKILLS_TELEMETRY_INSTALLATION_ID="$({
+    python3 - "$telemetry_dir" "${RAINSKILLS_TELEMETRY_INSTALLATION_ID:-}" <<'PY'
+import os
+import re
+import sys
+import uuid
+
+directory, provided = sys.argv[1:]
+pattern = re.compile(r"^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", re.I)
+os.makedirs(directory, mode=0o700, exist_ok=True)
+os.chmod(directory, 0o700)
+path = os.path.join(directory, "installation-id")
+value = provided.strip()
+if not pattern.match(value):
+    try:
+        value = open(path, encoding="utf-8").read().strip()
+    except Exception:
+        value = ""
+if not pattern.match(value):
+    value = str(uuid.uuid4())
+    temporary = "{}.{}.tmp".format(path, os.getpid())
+    with open(temporary, "x", encoding="utf-8") as stream:
+        stream.write(value + "\n")
+    os.chmod(temporary, 0o600)
+    os.replace(temporary, path)
+os.chmod(path, 0o600)
+print(value)
+PY
+  } 2>/dev/null || true)"
+  if [[ -z "${RAINSKILLS_PACKAGE_VERSION:-}" && -f "$package_file" ]]; then
+    RAINSKILLS_PACKAGE_VERSION="$({
+      python3 - "$package_file" <<'PY'
+import json
+import sys
+
+try:
+    value = json.load(open(sys.argv[1], encoding="utf-8")).get("version")
+except Exception:
+    value = None
+print(value if isinstance(value, str) and value else "unknown")
+PY
+    } 2>/dev/null || printf 'unknown')"
+  fi
+  export RAINSKILLS_TELEMETRY_INSTALLATION_ID RAINSKILLS_PACKAGE_VERSION
+}
+
+rainskills_v2_action() {
+  case "$RAINSKILLS_INSTALL_ACTION" in
+    install|refresh|upgrade|repair) printf '%s\n' "$RAINSKILLS_INSTALL_ACTION" ;;
+    connect) printf 'repair\n' ;;
+    *) printf 'install\n' ;;
+  esac
+}
+
+rainskills_v2_agent() {
+  case "$1" in
+    codex) printf 'codex\n' ;;
+    claude|claude_code) printf 'claude_code\n' ;;
+    pi) printf 'pi\n' ;;
+    dsh|deepseek_harness|deepseek) printf 'deepseek\n' ;;
+    workbuddy) printf 'workbuddy\n' ;;
+    other) printf 'other\n' ;;
+    *) printf 'unknown\n' ;;
+  esac
+}
+
+rainskills_v2_os_type() {
+  case "$(uname -s 2>/dev/null || true)" in
+    Darwin) printf 'darwin\n' ;;
+    MINGW*|MSYS*|CYGWIN*) printf 'windows\n' ;;
+    *) printf 'linux\n' ;;
+  esac
+}
+
+rainskills_v2_os_arch() {
+  case "$(uname -m 2>/dev/null || true)" in
+    x86_64|amd64) printf 'amd64\n' ;;
+    arm64|aarch64) printf 'arm64\n' ;;
+    "") printf 'unknown\n' ;;
+    *) printf 'other\n' ;;
+  esac
+}
+
+rainskills_v2_execution_environment() {
+  if [[ -n "${WSL_DISTRO_NAME:-}" || -n "${WSL_INTEROP:-}" ]]; then
+    printf 'wsl\n'
+  elif [[ -n "${SSH_CONNECTION:-}" || -n "${SSH_CLIENT:-}" ]]; then
+    printf 'ssh\n'
+  elif [[ -n "${container:-}" ]]; then
+    printf 'container\n'
+  else
+    printf 'native\n'
+  fi
+}
+
+rainskills_v2_error_stage() {
+  case "${RAINSKILLS_INSTALL_FAILURE_STAGE:-install}" in
+    bootstrap) printf 'preflight\n' ;;
+    download) printf 'download\n' ;;
+    skill_installation) printf 'agent_configuration\n' ;;
+    authorization) printf 'authorization\n' ;;
+    verification) printf 'verification\n' ;;
+    configuration) printf 'agent_configuration\n' ;;
+    *) printf 'install\n' ;;
+  esac
+}
+
+rainskills_v2_error_code() {
+  case "${RAINSKILLS_INSTALL_FAILURE_CATEGORY:-unknown}" in
+    invalid_arguments) printf 'invalid_arguments\n' ;;
+    tarball_unavailable|download_failed) printf 'download_failed\n' ;;
+    authorization_failed) printf 'authorization_failed\n' ;;
+    mcp_verification_failed) printf 'verification_failed\n' ;;
+    mcp_configuration_failed|cli_configuration_failed|skill_installation_failed) printf 'agent_config_failed\n' ;;
+    network_unreachable) printf 'network_unreachable\n' ;;
+    *) printf 'unknown\n' ;;
+  esac
+}
+
+report_rainskills_v2_event() {
+  local event_type="$1"
+  local status="${2:-}"
+  local agent="${3:-}"
+  local error_stage="${4:-}"
+  local error_code="${5:-}"
+  rainskills_v2_enabled || return 0
+  [[ -n "${RAINSKILLS_TELEMETRY_INSTALLATION_ID:-}" ]] || return 0
+  command -v curl >/dev/null 2>&1 || return 0
+  command -v python3 >/dev/null 2>&1 || return 0
+
+  local payload telemetry_dir
+  telemetry_dir="${RAINSKILLS_TELEMETRY_DIR:-${HOME:-/tmp}/.rainbond/rainskills/telemetry}"
+  payload="$({
+    python3 - \
+      "$event_type" \
+      "$RAINSKILLS_TELEMETRY_INSTALLATION_ID" \
+      "$RAINSKILLS_INSTALL_ATTEMPT_ID" \
+      "${RAINSKILLS_PACKAGE_VERSION:-unknown}" \
+      "$(rainskills_v2_action)" \
+      "$(rainskills_v2_agent "$agent")" \
+      "$(rainskills_v2_os_type)" \
+      "$(rainskills_v2_os_arch)" \
+      "$(rainskills_v2_execution_environment)" \
+      "$status" \
+      "$error_stage" \
+      "$error_code" \
+      "$telemetry_dir" <<'PY'
+import datetime
+import json
+import os
+import sys
+import time
+import uuid
+
+(event_type, installation_id, attempt_id, package_version, action, agent,
+ os_type, os_arch, execution_environment, status, error_stage, error_code,
+ telemetry_dir) = sys.argv[1:]
+event = {
+    "schema": "rainskills.telemetry-event.v2",
+    "event_id": str(uuid.uuid4()),
+    "event_type": event_type,
+    "installation_id": installation_id,
+    "package_version": package_version,
+    "occurred_at": datetime.datetime.now(datetime.timezone.utc).isoformat(timespec="milliseconds").replace("+00:00", "Z"),
+}
+if event_type in {"install_result", "agent_config_result"}:
+    event["install_attempt_id"] = attempt_id
+    event["action"] = action
+if event_type == "install_result":
+    event.update({
+        "os_type": os_type,
+        "os_arch": os_arch,
+        "execution_environment": execution_environment,
+        "status": status,
+    })
+elif event_type == "agent_config_result":
+    event.update({"agent_type": agent, "status": status})
+if status == "failed":
+    event["error_stage"] = error_stage
+    event["error_code"] = error_code
+pending_dir = os.path.join(telemetry_dir, "pending-v2")
+try:
+    os.makedirs(pending_dir, mode=0o700, exist_ok=True)
+    os.chmod(telemetry_dir, 0o700)
+    os.chmod(pending_dir, 0o700)
+    now = time.time()
+    entries = []
+    for name in os.listdir(pending_dir):
+        if not name.endswith(".json"):
+            continue
+        file_path = os.path.join(pending_dir, name)
+        try:
+            entries.append((os.stat(file_path).st_mtime, file_path))
+        except OSError:
+            pass
+    entries.sort()
+    expired = [entry for entry in entries if now - entry[0] > 7 * 24 * 60 * 60]
+    remaining = [entry for entry in entries if now - entry[0] <= 7 * 24 * 60 * 60]
+    overflow = remaining[:max(0, len(remaining) - 99)]
+    for _, file_path in expired + overflow:
+        try:
+            os.remove(file_path)
+        except OSError:
+            pass
+    event_path = os.path.join(pending_dir, event["event_id"] + ".json")
+    with open(event_path, "x", encoding="utf-8") as stream:
+        stream.write(json.dumps(event, separators=(",", ":")) + "\n")
+    os.chmod(event_path, 0o600)
+except Exception:
+    pass
+print(json.dumps(event, separators=(",", ":")))
+PY
+  } 2>/dev/null || true)"
+  [[ -n "$payload" ]] || return 0
+  local event_id pending_file
+  event_id="$(python3 -c 'import json,sys; print(json.load(sys.stdin)["event_id"])' <<<"$payload" 2>/dev/null || true)"
+  pending_file="$telemetry_dir/pending-v2/${event_id}.json"
+  (
+    if curl --silent --show-error --connect-timeout 2 --max-time 3 \
+      -X POST "$RAINSKILLS_TELEMETRY_REPORT_URL" \
+      -H 'Content-Type: application/json' \
+      --data-binary "$payload" >/dev/null 2>&1; then
+      [[ -n "$event_id" ]] && rm -f "$pending_file"
+    fi
+  ) &
+}
+
+record_rainskills_v2_configured_agent() {
+  local agent
+  agent="$(rainskills_v2_agent "$1")"
+  [[ "$agent" != "unknown" ]] || return 0
+  rainskills_v2_enabled || return 0
+  command -v python3 >/dev/null 2>&1 || return 0
+  local telemetry_dir
+  telemetry_dir="${RAINSKILLS_TELEMETRY_DIR:-${HOME:-/tmp}/.rainbond/rainskills/telemetry}"
+  python3 - "$telemetry_dir" "$agent" <<'PY' >/dev/null 2>&1 || true
+import json
+import os
+import sys
+
+directory, agent = sys.argv[1:]
+os.makedirs(directory, mode=0o700, exist_ok=True)
+os.chmod(directory, 0o700)
+path = os.path.join(directory, "configured-agents.json")
+try:
+    current = json.load(open(path, encoding="utf-8"))
+except Exception:
+    current = []
+agents = sorted(set(value for value in current + [agent] if isinstance(value, str)))
+temporary = "{}.{}.tmp".format(path, os.getpid())
+with open(temporary, "x", encoding="utf-8") as stream:
+    json.dump(agents, stream, separators=(",", ":"))
+    stream.write("\n")
+os.chmod(temporary, 0o600)
+os.replace(temporary, path)
+os.chmod(path, 0o600)
+PY
+}
+
 rainskills_install_client_for_target() {
   case "$1" in
     codex)
@@ -325,6 +597,7 @@ report_rainskills_installation() {
   local failure_stage="${3:-}"
   local failure_category="${4:-}"
 
+  [[ "${RAINSKILLS_LEGACY_TELEMETRY_ENABLED:-0}" == "1" ]] || return 0
   [[ -n "$RAINSKILLS_INSTALL_ATTEMPT_ID" ]] || return 0
   if [[ "$phase" == "authorized" || "$phase" == "configured" ]]; then
     [[ -n "$RAINSKILLS_INSTALL_EID" ]] || return 0
@@ -423,6 +696,7 @@ report_rainskills_lifecycle_event() {
   local blocked_reason="${6:-}"
   local auth_method="${7:-}"
 
+  [[ "${RAINSKILLS_LEGACY_TELEMETRY_ENABLED:-0}" == "1" ]] || return 0
   [[ -n "$RAINSKILLS_INSTALL_ATTEMPT_ID" ]] || return 0
   command -v python3 >/dev/null 2>&1 || return 0
   RAINSKILLS_TELEMETRY_SEQUENCE=$((RAINSKILLS_TELEMETRY_SEQUENCE + 1))
@@ -536,6 +810,7 @@ initialize_rainskills_installation_reporting() {
     esac
   done
   RAINSKILLS_INSTALL_CLIENT="$(rainskills_install_client_for_target "$target")"
+  initialize_rainskills_v2_identity
   report_rainskills_lifecycle_event "bootstrap" "resume" "resume" "started"
   report_rainskills_installation "started" "started"
 }
@@ -634,6 +909,25 @@ set_rainskills_failure_context() {
 
 report_unhandled_rainskills_installation_failure() {
   local exit_status="$1"
+  if [[ "$exit_status" -ne 0 && \
+        "${BASH_SUBSHELL:-0}" -eq 0 && \
+        "$RAINSKILLS_V2_TERMINAL_REPORTED" -eq 0 ]]; then
+    RAINSKILLS_V2_TERMINAL_REPORTED=1
+    if [[ -n "$RAINSKILLS_V2_CURRENT_AGENT" ]]; then
+      report_rainskills_v2_event \
+        "agent_config_result" \
+        "failed" \
+        "$RAINSKILLS_V2_CURRENT_AGENT" \
+        "agent_configuration" \
+        "agent_config_failed"
+    fi
+    report_rainskills_v2_event \
+      "install_result" \
+      "failed" \
+      "" \
+      "$(rainskills_v2_error_stage)" \
+      "$(rainskills_v2_error_code)"
+  fi
   if [[ "$exit_status" -ne 0 && \
         "${BASH_SUBSHELL:-0}" -eq 0 && \
         "$RAINSKILLS_INSTALL_TERMINAL_REPORTED" -eq 0 ]]; then
@@ -716,6 +1010,23 @@ handle_installer_exit() {
 }
 
 die() {
+  if [[ "${BASH_SUBSHELL:-0}" -eq 0 && "$RAINSKILLS_V2_TERMINAL_REPORTED" -eq 0 ]]; then
+    RAINSKILLS_V2_TERMINAL_REPORTED=1
+    if [[ -n "$RAINSKILLS_V2_CURRENT_AGENT" ]]; then
+      report_rainskills_v2_event \
+        "agent_config_result" \
+        "failed" \
+        "$RAINSKILLS_V2_CURRENT_AGENT" \
+        "agent_configuration" \
+        "agent_config_failed"
+    fi
+    report_rainskills_v2_event \
+      "install_result" \
+      "failed" \
+      "" \
+      "$(rainskills_v2_error_stage)" \
+      "$(rainskills_v2_error_code)"
+  fi
   if [[ "${BASH_SUBSHELL:-0}" -eq 0 && "$RAINSKILLS_INSTALL_TERMINAL_REPORTED" -eq 0 ]]; then
     RAINSKILLS_INSTALL_TERMINAL_REPORTED=1
     report_rainskills_installation \
@@ -1104,6 +1415,24 @@ collect_destinations() {
   printf '%s\n' "${destinations[@]}"
 }
 
+collect_target_agents() {
+  if [[ -n "$CUSTOM_DEST" ]]; then
+    printf 'unknown\n'
+    return 0
+  fi
+  case "$TARGET" in
+    claude) printf 'claude\n' ;;
+    codex) printf 'codex\n' ;;
+    pi) printf 'pi\n' ;;
+    dsh) printf 'dsh\n' ;;
+    workbuddy) printf 'workbuddy\n' ;;
+    all)
+      printf '%s\n' claude codex pi dsh workbuddy
+      ;;
+    *) printf 'unknown\n' ;;
+  esac
+}
+
 normalize_rainbond_url() {
   local raw
   raw="$(trim "$1")"
@@ -2549,6 +2878,8 @@ do_refresh() {
     log "如果想立刻在当前终端使用，请执行：source ${ACTIVE_SHELL_RC}"
   fi
   RAINSKILLS_INSTALL_TERMINAL_REPORTED=1
+  RAINSKILLS_V2_TERMINAL_REPORTED=1
+  report_rainskills_v2_event "install_result" "success"
   report_rainskills_lifecycle_event "configure_cli" "install_cli" "configure_cli" "completed"
   report_rainskills_installation "configured" "success"
 }
@@ -2629,6 +2960,10 @@ configure_runtime_connection() {
   report_rainskills_lifecycle_event "configure_cli" "install_cli" "configure_cli" "started"
   install_local_cli
   RAINSKILLS_INSTALL_TERMINAL_REPORTED=1
+  RAINSKILLS_V2_TERMINAL_REPORTED=1
+  report_rainskills_v2_event "agent_config_result" "success" "$TARGET"
+  record_rainskills_v2_configured_agent "$TARGET"
+  report_rainskills_v2_event "install_result" "success"
   report_rainskills_lifecycle_event "configure_cli" "install_cli" "configure_cli" "completed"
   report_rainskills_installation "configured" "success"
 
@@ -2690,16 +3025,28 @@ main() {
   done
 
   local destinations=()
+  local target_agents=()
   local dest
   while IFS= read -r dest; do
     destinations+=("$dest")
   done < <(collect_destinations)
 
-  for dest in "${destinations[@]}"; do
+  local target_agent
+  while IFS= read -r target_agent; do
+    target_agents+=("$target_agent")
+  done < <(collect_target_agents)
+
+  local destination_index
+  for destination_index in "${!destinations[@]}"; do
+    dest="${destinations[$destination_index]}"
+    RAINSKILLS_V2_CURRENT_AGENT="${target_agents[$destination_index]:-unknown}"
     install_detail_log "安装到：$dest"
     for skill_dir in "${skills[@]}"; do
       copy_skill "$skill_dir" "$dest"
     done
+    report_rainskills_v2_event "agent_config_result" "success" "$RAINSKILLS_V2_CURRENT_AGENT"
+    record_rainskills_v2_configured_agent "$RAINSKILLS_V2_CURRENT_AGENT"
+    RAINSKILLS_V2_CURRENT_AGENT=""
   done
 
   install_local_cli
@@ -2708,6 +3055,9 @@ main() {
   install_detail_log "安装完成。本次：${INSTALL_COUNT_NEW} 项新装 / ${INSTALL_COUNT_UPDATED} 项已更新 / ${INSTALL_COUNT_UNCHANGED} 项已是最新 / ${INSTALL_COUNT_FORCED} 项强制覆盖"
   install_detail_log ""
   print_capability_summary
+  RAINSKILLS_INSTALL_TERMINAL_REPORTED=1
+  RAINSKILLS_V2_TERMINAL_REPORTED=1
+  report_rainskills_v2_event "install_result" "success"
 }
 
 if [[ "${BASH_SOURCE[0]}" == "$0" ]]; then

package/marketplace/rainskills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rainskills",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "description": "Install the complete Rainskills AI deployment skill suite as one product.",
   "author": {
     "name": "Goodrain",

package/marketplace/rainskills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "rainskills",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "description": "Install the complete Rainskills AI deployment skill suite as one product.",
   "author": {
     "name": "Goodrain",

package/marketplace/rainskills/skills/rainskills/SKILL.md

@@ -14,7 +14,7 @@ This is the single marketplace entry for the complete Rainskills product. The in
 3. Keep stdin, stdout, and stderr attached. When `RAINSKILLS_USER_INPUT_REQUIRED` appears, pause for that installer choice. If the installer emits `rainskills.next-action.v1`, execute only its fixed `argv` through the same launcher; never evaluate output as a shell command. If the adjacent `bin/rainskills.js` exists, use it for fixed next actions; otherwise use the same versioned npm package fallback described below.
 4. Stay attached until every independent Skill is installed. Do not select, connect, or configure an application runtime during installation. In the user-facing response, output only the fixed completion message below.
 
-If the adjacent installer is missing, check the local Node.js version before choosing the fallback. With `npx` and Node.js 18 or newer, use `npx --yes rainskills@0.1.29 <target>`. With no Node.js or a version below 18, use `bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh) <target>` instead. Omit `<target>` only when the host cannot be determined reliably. Keep either command attached to the interactive terminal. For an update or repair, refresh this marketplace Skill first, then run the installer again; it compares and updates every independent internal Skill.
+If the adjacent installer is missing, check the local Node.js version before choosing the fallback. With `npx` and Node.js 18 or newer, use `npx --yes rainskills@0.1.30 <target>`. With no Node.js or a version below 18, use `bash <(curl -fsSL https://get.rainbond.com/rainskills/install.sh) <target>` instead. Omit `<target>` only when the host cannot be determined reliably. Keep either command attached to the interactive terminal. For an update or repair, refresh this marketplace Skill first, then run the installer again; it compares and updates every independent internal Skill.
 
 Skills-only 安装不需要 Node.js；CDN fallback 只负责安装 Skill 文件，不代表运行环境连接、应用部署或平台安装已经可执行。用户首次提出需要运行环境的动作时，对应业务 Skill 才检查 Node.js；固定 Rainskills launcher 需要 Node.js 18 或更高版本。缺失或版本过低时保留原始 intent 并停止，等待用户或 agent 明确同意安装或升级 Node.js，安装完成消息不得提前提示 Node.js。
 
@@ -50,7 +50,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 
 DeepSeek Harness 和 WorkBuddy 也必须保持原命令附着直到退出；如果宿主把长命令转成持久终端或后台任务，只能轮询该原始命令句柄，不得另起 `runtime status` 推测授权结果。WorkBuddy 安装后若当前任务的 Skill 清单尚未刷新，在下一条业务动作前先刷新 Skill 列表或新建任务，不得退回内置 Sites 代替 Rainbond 部署。
 
-Rainskills 只保存一个全局运行环境，不维护环境列表、名称、默认值或环境 ID。使用固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.29`）：
+Rainskills 只保存一个全局运行环境，不维护环境列表、名称、默认值或环境 ID。使用固定 launcher `node <home>/.rainbond/lib/rainskills/bin/rainskills.js`（运行包版本 `rainskills@0.1.30`）：
 
 - 状态：执行 `runtime status --json`。
 - 首次连接：执行 `runtime connect <target> --saas` 或 `runtime connect <target> --rainbond-url <Console origin>`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rainskills",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "description": "Interactive Rainbond skill installer for Codex, Claude Code, Pi Agent, DeepSeek Harness, and WorkBuddy",
   "license": "Apache-2.0",
   "homepage": "https://github.com/goodrain/rainskills#readme",

package/rainbond-app-assistant/references/runtime-gate.md

@@ -22,7 +22,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",

package/rainbond-app-version-assistant/SKILL.md

@@ -34,7 +34,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",

package/rainbond-delivery-verifier/SKILL.md

@@ -57,7 +57,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",

package/rainbond-env-sync/SKILL.md

@@ -34,7 +34,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",

package/rainbond-fullstack-bootstrap/SKILL.md

@@ -34,7 +34,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",

package/rainbond-fullstack-troubleshooter/SKILL.md

@@ -57,7 +57,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",

package/rainbond-opensource-app-deploy/references/runtime-gate.md

@@ -22,7 +22,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",

package/rainbond-platform-installer/SKILL.md

@@ -32,7 +32,7 @@ Do not use it to deploy an application to an existing Rainbond. Route those requ
 ## Workflow
 
 1. Read [installation-policy.md](references/installation-policy.md).
-2. Use the installed local launcher `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`; its protected runtime package marker is `rainskills@0.1.29` and must equal this package's `package.json`. For a Rainskills marker, first validate schema `rainskills.next-action.v1`, action, onboarding id, and the bounded `argv` array, then append that array to the launcher. Never use `latest` or evaluate a shell string from output.
+2. Use the installed local launcher `["node", "<home>/.rainbond/lib/rainskills/bin/rainskills.js"]`; its protected runtime package marker is `rainskills@0.1.30` and must equal this package's `package.json`. For a Rainskills marker, first validate schema `rainskills.next-action.v1`, action, onboarding id, and the bounded `argv` array, then append that array to the launcher. Never use `latest` or evaluate a shell string from output.
 3. 业务 Skill 的四项运行环境菜单会把本机或独立服务器选择写入 `rainskills.next-action.v1` 的显式 `--location`；收到这类 next-action 后直接执行固定 argv，不得再次调用 `private-deployment-location`。只有用户直接要求安装 Rainbond 平台且尚未选择部署位置时，才执行 launcher + `["runtime", "message", "--id", "private-deployment-location"]` 并原样输出固定的三项部署位置消息：选择 1 后执行带 `["--location", "local", "--mode", "single-node"]` 的 `platform install`；选择 2 后执行带 `["--location", "server"]` 的 `platform install`，由 helper 继续显示固定的服务器类型消息；选择 3 后执行 launcher + `["runtime", "message", "--id", "private-console-origin"]` 并进入已有环境连接，不得执行 `platform install`。平台安装 onboarding 只保存安装断点，不保存或恢复业务 intent。
 4. Let the helper perform one read-only preflight against the already selected local or remote target, then show resources, blockers, and applicable host changes. Never invoke `platform install` without an explicit `--location`; the helper must not ask for the deployment location again.
 5. 主机集群开始前必须获得 explicit confirmation，并使用受限 AI 交接：首次调用在固定安装 argv 后追加 `--agent-handoff`，记录该子进程会话；用户确认后，使用相同固定 argv 追加 `--agent-handoff --yes` 一次。不得向等待进程写入 `y`、不得启动第二个竞争安装、不得 `kill` 安装进程，也不得让用户复制完整安装或恢复命令。用户取消时，仅使用同一 argv 追加 `--agent-handoff --cancel`；它只能清除匹配的待确认状态，不能建立 SSH 连接或修改服务器。

package/rainbond-platform-installer/scripts/installed-version.js

@@ -1,5 +1,5 @@
 "use strict";
 
 module.exports = Object.freeze({
-  version: "0.1.29",
+  version: "0.1.30",
 });

package/rainbond-platform-installer/scripts/result-telemetry.js

@@ -0,0 +1,285 @@
+"use strict";
+
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+const { randomUUID: defaultRandomUUID } = require("node:crypto");
+
+const SCHEMA = "rainskills.telemetry-event.v2";
+const DEFAULT_REPORT_URL = "https://log.rainbond.com/api/rainskills/events";
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+const AGENTS = new Set(["codex", "pi", "claude_code", "deepseek", "workbuddy", "other", "unknown"]);
+const MAX_PENDING_EVENTS = 100;
+const MAX_PENDING_AGE_MS = 7 * 24 * 60 * 60 * 1000;
+
+function defaultDirectory() {
+  return path.join(os.homedir(), ".rainbond", "rainskills", "telemetry");
+}
+
+function safeMkdir(directory) {
+  fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+  try { fs.chmodSync(directory, 0o700); } catch { /* best effort */ }
+}
+
+function readPrivateText(file) {
+  try {
+    const info = fs.lstatSync(file);
+    if (!info.isFile() || info.isSymbolicLink() || info.size > 1024 * 1024) return null;
+    return fs.readFileSync(file, "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") return null;
+    throw error;
+  }
+}
+
+function writePrivateFile(file, content) {
+  safeMkdir(path.dirname(file));
+  const temporary = path.join(
+    path.dirname(file),
+    `.${path.basename(file)}.${process.pid}.${defaultRandomUUID()}.tmp`
+  );
+  try {
+    fs.writeFileSync(temporary, content, { encoding: "utf8", flag: "wx", mode: 0o600 });
+    fs.renameSync(temporary, file);
+    fs.chmodSync(file, 0o600);
+  } finally {
+    try { fs.rmSync(temporary, { force: true }); } catch { /* keep original error */ }
+  }
+}
+
+function ensureInstallationId(directory = defaultDirectory(), randomUUID = defaultRandomUUID) {
+  const file = path.join(directory, "installation-id");
+  const existing = (readPrivateText(file) || "").trim();
+  if (UUID_PATTERN.test(existing)) return existing;
+  const generated = randomUUID();
+  if (!UUID_PATTERN.test(generated)) throw new Error("telemetry installation id must be a UUID");
+  writePrivateFile(file, `${generated}\n`);
+  return generated;
+}
+
+function normalizeAgent(value) {
+  const aliases = {
+    claude: "claude_code",
+    dsh: "deepseek",
+    deepseek_harness: "deepseek",
+  };
+  const normalized = aliases[value] || value;
+  return AGENTS.has(normalized) ? normalized : "unknown";
+}
+
+function readConfiguredAgent(directory = defaultDirectory()) {
+  try {
+    const raw = readPrivateText(path.join(directory, "configured-agents.json"));
+    const agents = JSON.parse(raw || "[]").map(normalizeAgent);
+    const unique = [...new Set(agents.filter((agent) => agent !== "unknown"))];
+    return unique.length === 1 ? unique[0] : "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+
+function writeConfiguredAgents(directory, agents) {
+  let existing = [];
+  try {
+    existing = JSON.parse(readPrivateText(path.join(directory, "configured-agents.json")) || "[]");
+  } catch { /* replace invalid state with the validated targets */ }
+  const normalized = [...new Set([...existing, ...(agents || [])]
+    .map(normalizeAgent)
+    .filter((agent) => agent !== "unknown"))].sort();
+  writePrivateFile(path.join(directory, "configured-agents.json"), `${JSON.stringify(normalized)}\n`);
+  return normalized;
+}
+
+function loadState(directory) {
+  try {
+    const raw = readPrivateText(path.join(directory, "v2-state.json"));
+    const parsed = JSON.parse(raw || "{}");
+    return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+
+function saveState(directory, state) {
+  writePrivateFile(path.join(directory, "v2-state.json"), `${JSON.stringify(state)}\n`);
+}
+
+function pendingDirectory(directory) {
+  return path.join(directory, "pending-v2");
+}
+
+function prunePending(directory, nowMs) {
+  const pending = pendingDirectory(directory);
+  let entries;
+  try {
+    entries = fs.readdirSync(pending)
+      .filter((name) => name.endsWith(".json"))
+      .map((name) => {
+        const file = path.join(pending, name);
+        return { file, mtimeMs: fs.lstatSync(file).mtimeMs };
+      })
+      .sort((left, right) => left.mtimeMs - right.mtimeMs);
+  } catch (error) {
+    if (error.code === "ENOENT") return;
+    throw error;
+  }
+  const expired = entries.filter((entry) => nowMs - entry.mtimeMs > MAX_PENDING_AGE_MS);
+  const remaining = entries.filter((entry) => nowMs - entry.mtimeMs <= MAX_PENDING_AGE_MS);
+  const overflow = remaining.slice(0, Math.max(0, remaining.length - MAX_PENDING_EVENTS + 1));
+  for (const entry of [...expired, ...overflow]) {
+    try { fs.rmSync(entry.file, { force: true }); } catch { /* best effort */ }
+  }
+}
+
+function buildEvent({ installationId, packageVersion, agentType, randomUUID, now }, input) {
+  const event = {
+    schema: SCHEMA,
+    event_id: randomUUID(),
+    event_type: input.event_type,
+    installation_id: installationId,
+    package_version: packageVersion,
+    occurred_at: now().toISOString(),
+  };
+  const fields = [
+    "install_attempt_id", "action", "agent_type", "os_type", "os_arch",
+    "execution_environment", "status", "error_stage", "error_code",
+  ];
+  for (const field of fields) {
+    const usesDefaultAgent = ["first_use_result", "active_daily"].includes(input.event_type);
+    const value = field === "agent_type"
+      ? (input[field] || (usesDefaultAgent ? agentType : ""))
+      : input[field];
+    if (typeof value === "string" && value.length > 0) event[field] = value;
+  }
+  if (event.agent_type) event.agent_type = normalizeAgent(event.agent_type);
+  return event;
+}
+
+function createResultTelemetry({
+  directory = defaultDirectory(),
+  reportUrl = process.env.RAINSKILLS_TELEMETRY_REPORT_URL || DEFAULT_REPORT_URL,
+  fetchImpl = globalThis.fetch,
+  randomUUID = defaultRandomUUID,
+  now = () => new Date(),
+  timeoutMs = 1500,
+  installationId,
+  packageVersion = "unknown",
+  agentType,
+  disabled = process.env.RAINSKILLS_TELEMETRY_DISABLED === "1",
+} = {}) {
+  const resolvedAgent = normalizeAgent(agentType || readConfiguredAgent(directory));
+  const resolvedInstallationId = installationId || (disabled ? null : ensureInstallationId(directory, randomUUID));
+
+  async function send(event, file) {
+    if (typeof fetchImpl !== "function" || !reportUrl) return false;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+      const response = await fetchImpl(reportUrl, {
+        method: "POST",
+        headers: {
+          accept: "application/json",
+          "content-type": "application/json",
+          "idempotency-key": event.event_id,
+        },
+        body: JSON.stringify(event),
+        signal: controller.signal,
+      });
+      const status = Number(response?.status || 0);
+      const shouldDiscard = Boolean(response?.ok)
+        || (status >= 400 && status < 500 && status !== 429);
+      if (shouldDiscard && file) {
+        try { fs.rmSync(file, { force: true }); } catch { /* best effort */ }
+      }
+      return Boolean(response?.ok);
+    } catch {
+      return false;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+
+  function skippedResult() {
+    return { event: null, delivery: Promise.resolve(false), recorded: false };
+  }
+
+  function record(input, onceKey = null) {
+    if (disabled) return skippedResult();
+    const state = loadState(directory);
+    if (onceKey && state[onceKey]) return skippedResult();
+
+    const event = buildEvent({
+      installationId: resolvedInstallationId,
+      packageVersion,
+      agentType: resolvedAgent,
+      randomUUID,
+      now,
+    }, input);
+    const pending = pendingDirectory(directory);
+    safeMkdir(pending);
+    prunePending(directory, now().getTime());
+    const file = path.join(pending, `${event.event_id}.json`);
+    writePrivateFile(file, `${JSON.stringify(event)}\n`);
+    if (onceKey) saveState(directory, { ...state, [onceKey]: event.event_id });
+    return { event, delivery: send(event, file), recorded: true };
+  }
+
+  function recordFirstUse(status, error = {}) {
+    if (!new Set(["success", "failed"]).has(status)) return skippedResult();
+    return record({
+      event_type: "first_use_result",
+      status,
+      ...(status === "failed" ? {
+        error_stage: error.error_stage,
+        error_code: error.error_code,
+      } : {}),
+    }, `first_use:${resolvedAgent}:${status}`);
+  }
+
+  function recordActiveDaily() {
+    const activeDate = now().toISOString().slice(0, 10);
+    return record({ event_type: "active_daily" }, `active:${resolvedAgent}:${activeDate}`);
+  }
+
+  async function flushPending(limit = MAX_PENDING_EVENTS) {
+    if (disabled) return;
+    let files;
+    try {
+      files = fs.readdirSync(pendingDirectory(directory))
+        .filter((name) => name.endsWith(".json"))
+        .sort()
+        .slice(0, Math.max(0, Math.min(limit, MAX_PENDING_EVENTS)))
+        .map((name) => path.join(pendingDirectory(directory), name));
+    } catch (error) {
+      if (error.code === "ENOENT") return;
+      throw error;
+    }
+    for (const file of files) {
+      try {
+        const event = JSON.parse(readPrivateText(file));
+        await send(event, file);
+      } catch {
+        try { fs.rmSync(file, { force: true }); } catch { /* best effort */ }
+      }
+    }
+  }
+
+  return {
+    installationId: resolvedInstallationId,
+    agentType: resolvedAgent,
+    record,
+    recordFirstUse,
+    recordActiveDaily,
+    flushPending,
+  };
+}
+
+module.exports = {
+  DEFAULT_REPORT_URL,
+  SCHEMA,
+  createResultTelemetry,
+  ensureInstallationId,
+  normalizeAgent,
+  readConfiguredAgent,
+  writeConfiguredAgents,
+};

package/rainbond-platform-installer/scripts/telemetry.js

@@ -98,6 +98,7 @@ function createLifecycleTelemetry({
   randomUUID = crypto.randomUUID,
   now = () => new Date().toISOString(),
   timeoutMs = 1500,
+  enabled = process.env.RAINSKILLS_LEGACY_TELEMETRY_ENABLED === "1",
 } = {}) {
   let sequence = 0;
   const deliveries = new Set();
@@ -213,6 +214,7 @@ function createLifecycleTelemetry({
   }
 
   async function send(event) {
+    if (!enabled) return false;
     const result = await sendRequest(reportUrl, event);
     if (result.ok) return true;
     if (![400, 404, 415, 422].includes(result.status)) return false;
@@ -224,6 +226,7 @@ function createLifecycleTelemetry({
 
   function record(input = {}) {
     const event = buildEvent(input);
+    if (!enabled) return { event, delivery: Promise.resolve(false) };
     writeLocalEvent(directory, event);
     const delivery = send(event).catch(() => false);
     deliveries.add(delivery);

package/rainbond-platform-installer/scripts/windows-client-config.js

@@ -74,7 +74,6 @@ async function validateMcp({
     timedOut = true;
     controller.abort();
   }, timeoutMs);
-  timeout.unref?.();
   try {
     const response = await fetchImpl(url, {
       method: "POST",

package/rainbond-platform-installer/scripts/windows-onboarding.js

@@ -18,6 +18,11 @@ const {
 } = require("./windows-auth.js");
 const { validateMcp } = require("./windows-client-config.js");
 const { createLifecycleTelemetry } = require("./telemetry.js");
+const {
+  createResultTelemetry,
+  normalizeAgent,
+  writeConfiguredAgents,
+} = require("./result-telemetry.js");
 const {
   destinationsForHostTarget,
   isHostTarget,
@@ -619,21 +624,100 @@ async function main(argv, dependencies = {}) {
   const skills = discoverSkills(packageRoot);
   const logger = dependencies.logger || ((message) => stdout.write(`${message}\n`));
   const detailLogger = options.verbose ? logger : () => {};
-  const counts = copySkills({
-    skills,
-    destinations,
-    force: options.force,
-    logger: detailLogger,
-  });
-  if (!options.customDest) {
-    await (dependencies.installLocalCli || installLocalCli)({ packageRoot, home });
+  const telemetryDirectory = path.join(home, ".rainbond", "rainskills", "telemetry");
+  const packageVersion = (() => {
+    try {
+      const value = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8")).version;
+      return typeof value === "string" && value ? value : "unknown";
+    } catch {
+      return "unknown";
+    }
+  })();
+  const installAttemptId = UUID_PATTERN.test(environment.RAINSKILLS_INSTALL_ATTEMPT_ID || "")
+    ? environment.RAINSKILLS_INSTALL_ATTEMPT_ID
+    : crypto.randomUUID();
+  const osArch = os.arch() === "x64" ? "amd64" : os.arch() === "arm64" ? "arm64" : "other";
+  const resultTelemetry = (() => {
+    try {
+      return (dependencies.resultTelemetryFactory || createResultTelemetry)({
+        directory: telemetryDirectory,
+        packageVersion,
+        agentType: "unknown",
+        disabled: environment.RAINSKILLS_TELEMETRY_DISABLED === "1",
+        installAttemptId,
+        osArch,
+      });
+    } catch {
+      return {
+        record: () => ({ recorded: false, delivery: Promise.resolve(false) }),
+      };
+    }
+  })();
+  const targets = options.customDest
+    ? ["unknown"]
+    : (target === "all" ? ["claude", "codex", "pi", "dsh", "workbuddy"] : [target]);
+  const deliveries = [];
+  try {
+    const counts = copySkills({
+      skills,
+      destinations,
+      force: options.force,
+      logger: detailLogger,
+    });
+    if (!options.customDest) {
+      await (dependencies.installLocalCli || installLocalCli)({ packageRoot, home });
+    }
+    for (const configuredTarget of targets) {
+      const agent = normalizeAgent(configuredTarget);
+      const result = resultTelemetry.record({
+        event_type: "agent_config_result",
+        install_attempt_id: installAttemptId,
+        action: "install",
+        agent_type: agent,
+        status: "success",
+      });
+      deliveries.push(result.delivery);
+    }
+    const installResult = resultTelemetry.record({
+      event_type: "install_result",
+      install_attempt_id: installAttemptId,
+      action: "install",
+      os_type: "windows",
+      os_arch: osArch,
+      execution_environment: "native",
+      status: "success",
+    });
+    deliveries.push(installResult.delivery);
+    if (environment.RAINSKILLS_TELEMETRY_DISABLED !== "1") {
+      try {
+        (dependencies.configuredAgentsWriter || writeConfiguredAgents)(
+          telemetryDirectory,
+          targets.map(normalizeAgent)
+        );
+      } catch { /* telemetry state must not block installation */ }
+    }
+    await Promise.allSettled(deliveries);
+    detailLogger("");
+    detailLogger(`安装完成。本次：${counts.installed} 项新装 / ${counts.updated} 项已更新 / ${counts.unchanged} 项已是最新 / ${counts.forced} 项强制覆盖`);
+    detailLogger("");
+    logger(CAPABILITY_SUMMARY);
+    logger(AGENT_SUMMARY_REQUIREMENT);
+    return { status: "skills-installed", counts };
+  } catch (error) {
+    const failure = resultTelemetry.record({
+      event_type: "install_result",
+      install_attempt_id: installAttemptId,
+      action: "install",
+      os_type: "windows",
+      os_arch: osArch,
+      execution_environment: "native",
+      status: "failed",
+      error_stage: "agent_configuration",
+      error_code: "agent_config_failed",
+    });
+    await failure.delivery.catch(() => false);
+    throw error;
   }
-  detailLogger("");
-  detailLogger(`安装完成。本次：${counts.installed} 项新装 / ${counts.updated} 项已更新 / ${counts.unchanged} 项已是最新 / ${counts.forced} 项强制覆盖`);
-  detailLogger("");
-  logger(CAPABILITY_SUMMARY);
-  logger(AGENT_SUMMARY_REQUIREMENT);
-  return { status: "skills-installed", counts };
 }
 
 module.exports = {

package/rainbond-platform-query/SKILL.md

@@ -25,7 +25,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",

package/rainbond-project-init/SKILL.md

@@ -34,7 +34,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",

package/rainbond-template-installer/SKILL.md

@@ -34,7 +34,7 @@ Codex 中命令工具一旦返回 `session_id`，必须立即对该 `session_id`
 ```json
 {
   "schema": "rainskills.single-runtime-contract.v1",
-  "package_version": "rainskills@0.1.29",
+  "package_version": "rainskills@0.1.30",
   "runtime_status": [
     "node",
     "<home>/.rainbond/lib/rainskills/bin/rainskills.js",