@silicaclaw/cli 1.0.0-beta.5 → 1.0.0-beta.7

package/INSTALL.md

@@ -22,6 +22,12 @@ CLI-style onboarding command (recommended, zero-config):
 npx @silicaclaw/cli@beta onboard
 ```
 
+Cross-network quick wizard (defaults to global-preview):
+
+```bash
+npx @silicaclaw/cli@beta connect
+```
+
 For most home users, just press Enter on defaults and use `local` mode first.
 
 Optional global install (advanced users only):
@@ -29,6 +35,7 @@ Optional global install (advanced users only):
 ```bash
 npm i -g @silicaclaw/cli
 silicaclaw onboard
+silicaclaw connect
 ```
 
 ## 3. Run

package/README.md

@@ -28,6 +28,12 @@ Without servers, accounts, or central control.
 npx @silicaclaw/cli@beta onboard
 ```
 
+Cross-network preview quick wizard:
+
+```bash
+npx @silicaclaw/cli@beta connect
+```
+
 Or manual:
 
 ```bash
@@ -53,11 +59,18 @@ Zero-config (recommended, no global install / no PATH setup):
 npx @silicaclaw/cli@beta onboard
 ```
 
+Cross-network preview (global-preview first):
+
+```bash
+npx @silicaclaw/cli@beta connect
+```
+
 Optional global install:
 
 ```bash
 npm i -g @silicaclaw/cli
 silicaclaw onboard
+silicaclaw connect
 ```
 
 ## Quick Start (OpenClaw-style)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silicaclaw/cli",
-  "version": "1.0.0-beta.5",
+  "version": "1.0.0-beta.7",
   "private": false,
   "publishConfig": {
     "access": "public"

package/scripts/quickstart.sh

@@ -5,6 +5,13 @@ INVOKE_PWD="${INIT_CWD:-$PWD}"
 ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
 WORK_DIR="$ROOT_DIR"
 IS_NPX_MODE=0
+DEFAULT_MODE_PICK="${QUICKSTART_DEFAULT_MODE:-1}"
+CONNECT_MODE="${QUICKSTART_CONNECT_MODE:-0}"
+
+case "$DEFAULT_MODE_PICK" in
+  1|2|3) ;;
+  *) DEFAULT_MODE_PICK="1" ;;
+esac
 
 case "$ROOT_DIR" in
   *"/.npm/_npx/"*)
@@ -66,6 +73,25 @@ detect_public_ip() {
   printf '%s' "$ip"
 }
 
+url_host() {
+  local raw="${1:-}"
+  if [ -z "$raw" ]; then
+    printf ''
+    return 0
+  fi
+  node -e "try{const u=new URL(process.argv[1]); process.stdout.write(u.hostname||'');}catch{process.stdout.write('');}" "$raw"
+}
+
+url_port_or_default() {
+  local raw="${1:-}"
+  local fallback="${2:-4510}"
+  if [ -z "$raw" ]; then
+    printf '%s' "$fallback"
+    return 0
+  fi
+  node -e "try{const u=new URL(process.argv[1]); process.stdout.write(String(u.port || '$fallback'));}catch{process.stdout.write('$fallback');}" "$raw"
+}
+
 title "SilicaClaw Quick Start 启动"
 echo "目录: $ROOT_DIR"
 echo "目标: 用终端一步步完成安装与启动（类似 OpenClaw Quick Start）"
@@ -151,13 +177,19 @@ echo "2) lan             局域网预览（A/B 双机）"
 echo "3) global-preview  非局域网预览（WebRTC）"
 echo "提示: 不确定就直接回车（默认 local）。"
 echo "提示: 只有在你已有可达 signaling 地址时，才选择 3。"
-read -r -p "请输入模式编号 [1/2/3] (默认 1): " MODE_PICK || true
-MODE_PICK="${MODE_PICK:-1}"
+if [ "$CONNECT_MODE" = "1" ]; then
+  MODE_PICK="3"
+  echo "connect 模式：已自动选择 global-preview。"
+else
+  read -r -p "请输入模式编号 [1/2/3] (默认 ${DEFAULT_MODE_PICK}): " MODE_PICK || true
+  MODE_PICK="${MODE_PICK:-$DEFAULT_MODE_PICK}"
+fi
 
 NETWORK_MODE="local"
 NETWORK_ADAPTER="local-event-bus"
 WEBRTC_SIGNALING_URL_VALUE=""
 WEBRTC_ROOM_VALUE="silicaclaw-demo"
+AUTO_START_SIGNALING=0
 
 case "$MODE_PICK" in
   2)
@@ -168,7 +200,7 @@ case "$MODE_PICK" in
     NETWORK_MODE="global-preview"
     NETWORK_ADAPTER="webrtc-preview"
     PUBLIC_IP="$(detect_public_ip)"
-    SIGNALING_DEFAULT="http://localhost:4510"
+    SIGNALING_DEFAULT="${WEBRTC_SIGNALING_URL:-http://localhost:4510}"
     if [ -n "$PUBLIC_IP" ]; then
       SIGNALING_DEFAULT="http://$PUBLIC_IP:4510"
     fi
@@ -186,6 +218,18 @@ case "$MODE_PICK" in
       echo "global-preview 必须提供 signaling URL"
       exit 1
     fi
+
+    SIGNALING_HOST="$(url_host "$WEBRTC_SIGNALING_URL_VALUE")"
+    if [ "$SIGNALING_HOST" = "localhost" ] || [ "$SIGNALING_HOST" = "127.0.0.1" ]; then
+      echo "提示: 当前 signaling URL 是本机地址，仅本机可用，不适合跨网络双机演示。"
+    fi
+
+    if ask_yes_no "是否在当前机器自动后台启动 signaling server（用于演示）？" "Y"; then
+      AUTO_START_SIGNALING=1
+      SIGNALING_PORT_VALUE="$(url_port_or_default "$WEBRTC_SIGNALING_URL_VALUE" "4510")"
+      echo "将尝试以 PORT=$SIGNALING_PORT_VALUE 后台启动 signaling server"
+    fi
+
     read -r -p "请输入 room（默认 silicaclaw-demo）: " WEBRTC_ROOM_VALUE_INPUT || true
     WEBRTC_ROOM_VALUE="${WEBRTC_ROOM_VALUE_INPUT:-silicaclaw-demo}"
     ;;
@@ -199,6 +243,14 @@ echo "已选择: $NETWORK_MODE ($NETWORK_ADAPTER)"
 
 title "启动 local-console"
 if [ "$NETWORK_MODE" = "global-preview" ]; then
+  if [ "$AUTO_START_SIGNALING" -eq 1 ]; then
+    mkdir -p "$WORK_DIR/.silicaclaw"
+    SIGNALING_LOG="$WORK_DIR/.silicaclaw/signaling.log"
+    SIGNALING_PID_FILE="$WORK_DIR/.silicaclaw/signaling.pid"
+    run_cmd "cd \"$WORK_DIR\" && PORT=${SIGNALING_PORT_VALUE:-4510} nohup npm run webrtc-signaling > \"$SIGNALING_LOG\" 2>&1 & echo \$! > \"$SIGNALING_PID_FILE\""
+    echo "已后台启动 signaling server，日志: $SIGNALING_LOG"
+    echo "停止 signaling: kill \$(cat \"$SIGNALING_PID_FILE\")"
+  fi
   echo "将使用以下参数启动："
   echo "NETWORK_ADAPTER=$NETWORK_ADAPTER"
   echo "WEBRTC_SIGNALING_URL=$WEBRTC_SIGNALING_URL_VALUE"

package/scripts/silicaclaw-cli.mjs

@@ -35,6 +35,7 @@ SilicaClaw CLI
 
 Usage:
   silicaclaw onboard
+  silicaclaw connect
   silicaclaw local-console
   silicaclaw explorer
   silicaclaw signaling
@@ -44,6 +45,7 @@ Usage:
 
 Commands:
   onboard        Interactive step-by-step onboarding (recommended)
+  connect        Cross-network connect wizard (global-preview first)
   local-console  Start local console (http://localhost:4310)
   explorer       Start public explorer (http://localhost:4311)
   signaling      Start WebRTC signaling preview server
@@ -59,6 +61,15 @@ switch (cmd) {
   case "onboard":
     run("bash", [resolve(ROOT_DIR, "scripts", "quickstart.sh")]);
     break;
+  case "connect":
+    run("bash", [resolve(ROOT_DIR, "scripts", "quickstart.sh")], {
+      env: {
+        ...process.env,
+        QUICKSTART_DEFAULT_MODE: "3",
+        QUICKSTART_CONNECT_MODE: "1",
+      },
+    });
+    break;
   case "local-console":
   case "console":
     run("npm", ["run", "local-console"]);