feat: 海外化改造（新加坡市场）—— 阶段 0-3

按 U-Claw-海外化改造方案.md 与范围决策记录.md 实施。这是 fork，不回上游：海外版删掉的正是上游的中国市场默认值。阶段 0 地基 - 下载源全部改国际：脚本/CI 61 处 + lockfile 880 条 npmmirror URL 归零（lockfile 那 880 条是 npm 的 resolved 字段，脚本层参数化根本绕不过它） - 移除 install.ps1 里三个第三方 GitHub 加速代理，bundle 改直连 + SHA256 校验（原来只检查"文件大于 1MB"就解压运行） - 技能内容与分发分离：skills/manifest.json 单一来源，install.sh 1170→658 行、 install.ps1 721→546 行，两者技能内容归零实测原来是三份不一致：skills-cn 完整、install.sh 约 40%、install.ps1 约 17%，且 7 个通用技能只有 U 盘版有 —— 一键安装的用户一个能用的技能都没有 - Node 版本三种（v22.14/16/22.1）统一，新建 NODE_VERSION 单一来源 - Config 页三份合一。portable/Config.html 用根相对路径调 API 却只从 file:// 打开，保存功能已静默失效两个月；现缩为 120 行重定向壳 - 测试接入 CI（此前 node --test 无人运行，所有断言形同虚设）阶段 1 双语可用 - 浏览器侧 i18n：JSON 为源、生成经典 script（file:// 下 fetch 本地 JSON 被拦）语言跟盘走不跟机器走：启动器写 data/.openclaw/locale.js - 8 处硬编码 lang="zh-CN" 归零，data-i18n 覆盖 213 处，词条 en/zh 各 279 条 - B3 单框 Key：12 张模型卡 → 一个输入框，前缀识别 provider，服务端 /api/test-key 发 1-token 请求实测，错误映射成人话 Key 填错到得知：从"直到对话失败"降到 ≤1 秒 - 区域格式 SG：DD/MM/YYYY、12 小时、S$、Asia/Singapore （ICU 在 en-SG 下把 SGD 渲染成裸 $，与美元无法区分，故自行拼 S$） - README 内容分叉而非翻译，§1.3 证据清单逐条清零阶段 2 降门槛 - 启动逻辑上移 lib/start.mjs：Windows-Start.bat 220→28 行、 Mac-Start.command 235→33 行修掉 Mac 侧两个 bug：控制台端口硬编码 18788（回落时打开死页）、微信插件从未在 Mac 上安装 - U 盘根目录 23 → 3 个可点文件，其余进 advanced/ - 首启向导：语言 → 用途（7 角色，manifest 驱动）→ 密钥，答过不再问 - 三档界面，Simple 档隐藏一切技术名词 - 自动自愈：启动失败先自查自修，修不好导出脱敏诊断包（Doctor 从"用户要知道去点的工具"变成后台机制）阶段 3 技能库 - 19 个英文技能，planned 归零。sg-weather / sg-transport 的端点均实测过 - SkillHub 从 56 张手写第三方卡片改为 manifest 生成：703→125 行，中文归零其他 - origin.json 收拢所有运行时地址，tests/origin.test.mjs 保证迁移不会漏 - portable/ 下用户可见中文归零（由断言保证） - 82 项测试未验证（本机无 Windows / 无 pwsh）： - install.ps1、setup.ps1 约 210 行改动从未经 PowerShell 解析器 - 完整启动路径仅在假 node + 假 openclaw 上冒烟 - 8 个 .bat 的盘根推导仅静态断言详见 U盘实测清单.md 受阻： - 隐藏黑窗口 —— 需代码签名证书（.vbs 已被 Windows 弃用，替代方案都要签名） - 场景卡 —— OpenClaw 上游 Dashboard 无预填 prompt 接口 - 官网 36 条 —— 上游 2026-04-14 拆到私有仓库，无权限
2026-08-17 18:37:49 +08:00
parent 9a23aec097
commit b076815171
123 changed files with 13396 additions and 14723 deletions
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -31,6 +31,7 @@ jobs:
          mkdir -p "$stage_dir"
          cp -R portable/. "$stage_dir/"
          cp OPENCLAW_VERSION "$stage_dir/OPENCLAW_VERSION"
+          cp NODE_VERSION "$stage_dir/NODE_VERSION"
          rm -rf "$stage_dir/data/logs" 2>/dev/null || true

      - name: Pre-install Node.js (Windows) and OpenClaw deps
@@ -39,9 +40,9 @@ jobs:
          # Absolute paths so `cd "$core_dir"` later doesn't break `du`/`find`
          stage_dir="$(pwd)/dist/u-claw-portable-windows-${tag_name}"
          openclaw_version=$(tr -d '[:space:]' < OPENCLAW_VERSION)
-          node_version="v22.22.1"
-          mirror_node="https://npmmirror.com/mirrors/node"
-          mirror_npm="https://registry.npmmirror.com"
+          node_version=$(tr -d "[:space:]" < NODE_VERSION)
+          mirror_node="https://nodejs.org/dist"
+          mirror_npm="https://registry.npmjs.org"

          app_dir="$stage_dir/app"
          runtime_dir="$app_dir/runtime"
@@ -49,8 +50,8 @@ jobs:
          mkdir -p "$runtime_dir" "$core_dir"

          # 1) Download Node for Windows x64 only.
-          #    Mac users: Mac-Start.command runs setup.sh on first launch which
-          #    downloads node-mac-arm64 from npmmirror.com (~30MB, ~10s in China).
+          #    Mac users: START HERE - Mac.command runs setup.sh on first launch which
+          #    downloads node-mac-arm64 from nodejs.org (~30MB).
          #    Stanley pattern: ship one platform per zip, keep size reasonable.
          win_node="$runtime_dir/node-win-x64"
          mkdir -p "$win_node"
@@ -121,15 +122,16 @@ jobs:
              --no-fund || echo "WARN: $cn_pkg install failed, skipping (便携版仍可用其它渠道)"
          done

-          # 6) Copy China-optimized skills if present
-          skills_cn="$stage_dir/skills-cn"
+          # 6) Install skills from the manifest.
+          # skills/ is the single source of truth (see skills/README.md). Ship it
+          # plus the installer onto the USB so the drive can re-install or switch
+          # locale offline, then populate OpenClaw's skills dir from it.
          skills_target="$core_dir/node_modules/openclaw/skills"
-          if [ -d "$skills_cn" ] && [ -d "$skills_target" ]; then
-            for skill_dir in "$skills_cn"/*/; do
-              skill_name=$(basename "$skill_dir")
-              [ ! -d "$skills_target/$skill_name" ] && cp -R "$skill_dir" "$skills_target/$skill_name"
-            done
-          fi
+          mkdir -p "$stage_dir/lib" "$skills_target"
+          cp -R skills "$stage_dir/skills"
+          cp lib/install-skills.mjs "$stage_dir/lib/install-skills.mjs"
+          node "$stage_dir/lib/install-skills.mjs" --target "$skills_target" --locale en
+          echo "Skills on the drive: $(ls -1 "$skills_target" | wc -l)"

          # 6b) Install WeChat (Weixin) plugin into app/extensions/openclaw-weixin
          # 官方 npm 包 @tencent-weixin/openclaw-weixin 自带 dist/index.js(发布时已编译,无需 build)。
@@ -191,7 +193,11 @@ jobs:
          tag_name="${GITHUB_REF_NAME:-${{ github.event.inputs.tag }}}"
          cd dist
          zip -qry "u-claw-portable-windows-${tag_name}.zip" "u-claw-portable-windows-${tag_name}"
+          # Publish a checksum next to every asset so installers can verify what
+          # they downloaded instead of trusting "the file is bigger than 1MB".
+          sha256sum "u-claw-portable-windows-${tag_name}.zip" > "u-claw-portable-windows-${tag_name}.zip.sha256"
          ls -lh "u-claw-portable-windows-${tag_name}.zip"
+          cat "u-claw-portable-windows-${tag_name}.zip.sha256"

      - name: Size guard (lesson from 5916ff5 — GitHub 2GB asset cap)
        run: |
@@ -211,7 +217,9 @@ jobs:
      - uses: actions/upload-artifact@v4
        with:
          name: portable-windows-full
-          path: dist/u-claw-portable-windows-*.zip
+          path: |
+            dist/u-claw-portable-windows-*.zip
+            dist/u-claw-portable-windows-*.zip.sha256

  publish:
    name: Publish GitHub Release
@@ -255,8 +263,8 @@ jobs:

            ### 下载

-            - **Windows 便携完整版（U 盘版）**：`u-claw-portable-windows-*.zip`（约 150-200 MB，已预装 Node.js + OpenClaw，**解压即用，零网络依赖**）。解压到 U 盘后双击 `Windows-Start.bat` 启动。
-            - **macOS 便携版**：源码在 `portable/` 目录，`bash setup.sh` 自动下载 Node + OpenClaw（国内镜像约 1 分钟），双击 `Mac-Start.command` 启动。
+            - **Windows 便携完整版（U 盘版）**：`u-claw-portable-windows-*.zip`（约 150-200 MB，已预装 Node.js + OpenClaw，**解压即用，零网络依赖**）。解压到 U 盘后双击 `START HERE - Windows.bat` 启动。
+            - **macOS 便携版**：源码在 `portable/` 目录，`bash setup.sh` 自动下载 Node + OpenClaw（约 1 分钟），双击 `START HERE - Mac.command` 启动。

            > **U 盘格式建议**：请用 **NTFS** 格式化 U 盘（NOT exFAT/FAT32）。Node.js 在 exFAT 上 IO 极慢且不支持符号链接，可能导致启动失败。
            > Windows 下右键 U 盘 → 格式化 → 文件系统选择 NTFS。