feat: 海外化改造(新加坡市场)—— 阶段 0-3
Some checks failed
Tests / test (push) Has been cancelled

按 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 拆到私有仓库,无权限
This commit is contained in:
2026-08-17 18:37:49 +08:00
parent 9a23aec097
commit b076815171
123 changed files with 13396 additions and 14723 deletions

View File

@@ -0,0 +1,186 @@
@echo off
setlocal EnableDelayedExpansion
chcp 65001 >nul 2>&1
title U-Claw - Diagnostic Tool
for %%I in ("%~dp0..") do set "UCLAW_DIR=%%~fI\"
set "LOG_FILE=%UCLAW_DIR%diagnostic-log.txt"
echo.
echo ========================================
echo U-Claw Diagnostic Tool
echo ========================================
echo.
echo Checking system...
echo.
REM Clear old log
echo U-Claw Diagnostic Report > "%LOG_FILE%"
echo Generated: %date% %time% >> "%LOG_FILE%"
echo ======================================== >> "%LOG_FILE%"
echo. >> "%LOG_FILE%"
REM System info
echo System Info: >> "%LOG_FILE%"
for /f "tokens=2 delims==" %%v in ('wmic os get Version /format:list 2^>nul ^| findstr "="') do echo Windows Version: %%v >> "%LOG_FILE%"
for /f "tokens=2 delims==" %%v in ('wmic os get OSArchitecture /format:list 2^>nul ^| findstr "="') do echo Architecture: %%v >> "%LOG_FILE%"
echo. >> "%LOG_FILE%"
REM 1. Check Node.js
echo [1/7] Checking Node.js
set "NODE_BIN=%UCLAW_DIR%app\runtime\node-win-x64\node.exe"
set "ERROR_COUNT=0"
if exist "%NODE_BIN%" (
echo [OK] Node.js found >> "%LOG_FILE%"
for /f "tokens=*" %%v in ('"%NODE_BIN%" --version 2^>^&1') do (
echo Version: %%v >> "%LOG_FILE%"
echo [OK] Node.js: %%v
)
) else (
echo [ERROR] Node.js not found >> "%LOG_FILE%"
echo [!!] Node.js: missing
echo Path: %NODE_BIN% >> "%LOG_FILE%"
set /a ERROR_COUNT+=1
)
REM Migration shim: rename old core-win to core for existing USB users
if exist "%UCLAW_DIR%app\core-win" if not exist "%UCLAW_DIR%app\core" ren "%UCLAW_DIR%app\core-win" core
REM 2. Check core directory
echo [2/7] Checking folders
set "CORE_DIR=%UCLAW_DIR%app\core"
if exist "%CORE_DIR%" (
echo [OK] core directory exists >> "%LOG_FILE%"
echo [OK] Folders: ok
) else (
echo [ERROR] core directory not found >> "%LOG_FILE%"
echo [!!] Folders: missing
set /a ERROR_COUNT+=1
)
REM 3. Check node_modules
echo [3/7] Checking dependencies
if exist "%CORE_DIR%\node_modules" (
echo [OK] node_modules exists >> "%LOG_FILE%"
echo [OK] Dependencies: installed
) else (
echo [ERROR] node_modules not found >> "%LOG_FILE%"
echo [!!] Dependencies: not installed
set /a ERROR_COUNT+=1
)
REM 4. Check OpenClaw
echo [4/7] Checking OpenClaw
set "OPENCLAW_MJS=%CORE_DIR%\node_modules\openclaw\openclaw.mjs"
if exist "%OPENCLAW_MJS%" (
echo [OK] openclaw.mjs found >> "%LOG_FILE%"
echo [OK] OpenClaw: ok
) else (
echo [ERROR] openclaw.mjs not found >> "%LOG_FILE%"
echo [!!] OpenClaw: missing
echo Path: %OPENCLAW_MJS% >> "%LOG_FILE%"
set /a ERROR_COUNT+=1
)
REM 5. Check config
echo [5/7] Checking settings
set "STATE_DIR=%UCLAW_DIR%data\.openclaw"
if exist "%STATE_DIR%\openclaw.json" (
echo [OK] Config file exists >> "%LOG_FILE%"
echo [OK] Settings file: ok
REM Check if model is configured
findstr /c:"model" "%STATE_DIR%\openclaw.json" >nul 2>&1
if !errorlevel!==0 (
echo [OK] Model: configured
) else (
echo [ ?] Model: not set up yet
)
) else (
echo [WARNING] Config not found >> "%LOG_FILE%"
echo [ ?] Settings file: not created yet, U-Claw makes it on first run
)
REM 6. Check port availability
echo [6/7] Checking ports
set "PORT_ISSUE=0"
for /l %%p in (18789,1,18799) do (
netstat -an | findstr ":%%p " | findstr "LISTENING" >nul 2>&1
if !errorlevel!==0 (
echo [WARNING] Port %%p is in use >> "%LOG_FILE%"
echo [ ?] Port %%p: in use
for /f "tokens=5" %%a in ('netstat -ano ^| findstr ":%%p " ^| findstr "LISTENING"') do (
echo PID: %%a >> "%LOG_FILE%"
)
set "PORT_ISSUE=1"
)
)
if "!PORT_ISSUE!"=="0" (
echo [OK] Ports 18789-18799 available >> "%LOG_FILE%"
echo [OK] Ports 18789-18799: all free
)
REM 7. Test OpenClaw startup
echo [7/7] Testing OpenClaw
echo. >> "%LOG_FILE%"
echo Testing OpenClaw startup: >> "%LOG_FILE%"
echo ---------------------------------------- >> "%LOG_FILE%"
set "OPENCLAW_HOME=%UCLAW_DIR%data"
set "OPENCLAW_STATE_DIR=%UCLAW_DIR%data\.openclaw"
set "OPENCLAW_CONFIG_PATH=%OPENCLAW_STATE_DIR%\openclaw.json"
if exist "%NODE_BIN%" if exist "%OPENCLAW_MJS%" (
cd /d "%CORE_DIR%"
for /f "tokens=*" %%v in ('"%NODE_BIN%" "%OPENCLAW_MJS%" --version 2^>^&1') do (
echo %%v >> "%LOG_FILE%"
echo [OK] OpenClaw starts: yes (%%v^)
)
if !errorlevel! neq 0 (
echo [!!] OpenClaw starts: no
echo [ERROR] OpenClaw failed to start >> "%LOG_FILE%"
set /a ERROR_COUNT+=1
)
) else (
echo [ ?] OpenClaw starts: skipped, files missing
echo [SKIP] Cannot test - required files missing >> "%LOG_FILE%"
)
REM Disk space check
echo. >> "%LOG_FILE%"
echo Disk Space: >> "%LOG_FILE%"
for /f "tokens=*" %%s in ('powershell -command "(Get-ChildItem '%UCLAW_DIR%' -Recurse -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum).Sum / 1MB" 2^>nul') do (
echo Total size: %%s MB >> "%LOG_FILE%"
)
echo.
echo. >> "%LOG_FILE%"
echo ======================================== >> "%LOG_FILE%"
echo Diagnostic complete. >> "%LOG_FILE%"
echo Error count: !ERROR_COUNT! >> "%LOG_FILE%"
echo ========================================
echo Check complete
echo ========================================
echo.
if !ERROR_COUNT!==0 (
echo [OK] Everything checks out.
echo Every component U-Claw needs is present.
echo.
echo Next:
echo - Double-click START HERE - Windows.bat to run it
echo - Settings opens by itself the first time
) else (
echo [!!] Found !ERROR_COUNT! problem^(s^).
echo.
echo What to do:
echo 1. Open diagnostic-log.txt for the details
echo 2. Run START HERE - Windows.bat again
echo it reinstalls anything missing by itself
echo 3. Still stuck? See:
echo gitea.fanghe.it.com/zhenghy/u-claw
)
echo.
echo Saved a log to diagnostic-log.txt
echo.
pause