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,120 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>U-Claw Settings</title>
<!--
This page used to be a second, hand-maintained copy of the settings UI (748
lines) alongside config-server/public/index.html. It could never actually work:
it called the API through a root-relative path, and from a file:// origin that
resolves to a file:/// URL, which browsers refuse outright. Anyone who
double-clicked it — the route Read me first.html and the README both point at — got a
form whose Save button failed silently.
config-server/public/index.html is now the only implementation. This file is a
redirect to it, so the old entry point keeps working.
-->
<style>
:root { color-scheme: light dark; }
body {
margin: 0; min-height: 100vh;
display: flex; align-items: center; justify-content: center;
font-family: -apple-system, "Segoe UI", "PingFang SC", "Microsoft YaHei", sans-serif;
background: #f5f6f8; color: #1a1d21;
}
@media (prefers-color-scheme: dark) { body { background: #16181c; color: #e8eaed; } }
.card {
max-width: 30rem; padding: 2.5rem 2rem; text-align: center;
background: #fff; border-radius: 14px; box-shadow: 0 10px 40px rgba(0,0,0,.08);
}
@media (prefers-color-scheme: dark) { .card { background: #22252a; box-shadow: none; } }
.mark { font-size: 2.5rem; }
h1 { font-size: 1.15rem; margin: .75rem 0 .5rem; font-weight: 600; }
p { margin: .5rem 0; line-height: 1.6; color: #5b6169; }
@media (prefers-color-scheme: dark) { p { color: #a8adb5; } }
.action { margin-top: 1.5rem; font-weight: 600; }
code {
padding: .15em .45em; border-radius: 5px; font-size: .9em;
background: rgba(127,127,127,.15);
}
.hidden { display: none; }
</style>
</head>
<body>
<div class="card">
<div class="mark">🦞</div>
<div id="searching">
<h1 data-msg="looking">Opening settings…</h1>
</div>
<div id="offline" class="hidden">
<h1 data-msg="what">U-Claw is not running yet.</h1>
<p data-msg="why">The settings page lives inside U-Claw, so it has to be started first.</p>
<p class="action" data-msg="action">Start U-Claw, then open this page again.</p>
<p><code data-msg="how"></code></p>
</div>
</div>
<script>
// The config server binds the first free port in this range and can fall back
// when 18788 is taken, so probe rather than assume. no-cors keeps this working
// from a file:// origin: the response is opaque, but it still resolves when a
// server answered and rejects when nothing is listening.
const PORT_FROM = 18788;
const PORT_TO = 18798;
const MESSAGES = {
en: {
looking: 'Opening settings…',
what: 'U-Claw is not running yet.',
why: 'The settings page lives inside U-Claw, so it has to be started first.',
action: 'Start U-Claw, then open this page again.',
how: navigator.userAgent.includes('Windows') ? 'Double-click START HERE - Windows.bat' : 'Double-click START HERE - Mac.command',
},
'zh-CN': {
looking: '正在打开设置…',
what: 'U-Claw 还没有启动。',
why: '设置页面是 U-Claw 的一部分,需要先把它启动起来。',
action: '先启动 U-Claw然后重新打开这个页面。',
how: navigator.userAgent.includes('Windows') ? '双击 START HERE - Windows.bat' : '双击 START HERE - Mac.command',
},
};
const locale = String(navigator.language || 'en').toLowerCase().startsWith('zh') ? 'zh-CN' : 'en';
document.documentElement.lang = locale;
function render() {
const strings = MESSAGES[locale];
for (const node of document.querySelectorAll('[data-msg]')) {
node.textContent = strings[node.dataset.msg];
}
}
async function reachable(port) {
try {
await fetch(`http://127.0.0.1:${port}/`, { mode: 'no-cors', cache: 'no-store' });
return true;
} catch {
return false;
}
}
async function findServer() {
for (let port = PORT_FROM; port <= PORT_TO; port++) {
if (await reachable(port)) return port;
}
return null;
}
render();
findServer().then((port) => {
if (port) {
location.replace(`http://127.0.0.1:${port}/`);
return;
}
document.getElementById('searching').classList.add('hidden');
document.getElementById('offline').classList.remove('hidden');
});
</script>
</body>
</html>