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

152
portable/lib/i18n/i18n.js Normal file
View File

@@ -0,0 +1,152 @@
/* U-Claw browser-side i18n.
*
* A classic script, not an ES module, and the catalogue is a script rather than
* JSON on purpose: these pages are opened from file:// (the launcher opens
* loading.html with a file:// URL, Welcome.html links to its siblings), and from
* a file:// origin both fetch() and ES-module imports of local files are blocked.
* That is the exact bug that left the old Config.html silently broken. A plain
* <script src> tag still works.
*
* Load order on a page:
* <script src="data/.openclaw/locale.js"></script> optional, written by the launcher
* <script src="lib/i18n/messages.js"></script>
* <script src="lib/i18n/i18n.js"></script>
*
* Then mark text with data-i18n="key". Attributes use data-i18n-attr="placeholder:key".
* The HTML keeps English as its literal fallback, so a missing catalogue degrades
* to readable English instead of raw keys.
*/
(function (global) {
'use strict';
var SUPPORTED = ['en', 'zh-CN'];
var FALLBACK = 'en';
function normalise(tag) {
if (!tag) return null;
var lower = String(tag).toLowerCase();
if (lower.indexOf('zh') === 0) return 'zh-CN';
if (lower.indexOf('en') === 0) return 'en';
return null;
}
// The language travels with the drive, not the machine: someone who set the
// drive up in Chinese and plugs it into a colleague's English Windows should
// still see Chinese. The launcher writes data/.openclaw/locale.js on startup;
// ?lang= is the manual override, and the browser language is the last resort.
function resolveLocale() {
var fromQuery = null;
try {
fromQuery = new URLSearchParams(global.location.search).get('lang');
} catch (e) { /* older browser or opaque URL */ }
return normalise(fromQuery)
|| normalise(global.UCLAW_LOCALE)
|| normalise(global.navigator && global.navigator.language)
|| FALLBACK;
}
var locale = resolveLocale();
var catalogues = global.UCLAW_I18N_MESSAGES || {};
var active = catalogues[SUPPORTED.indexOf(locale) === -1 ? FALLBACK : locale] || {};
var fallback = catalogues[FALLBACK] || {};
function t(key, vars) {
var template = active[key];
if (template === undefined) template = fallback[key];
if (template === undefined) return key;
if (!vars) return template;
return template.replace(/\{(\w+)\}/g, function (match, name) {
return Object.prototype.hasOwnProperty.call(vars, name) ? String(vars[name]) : match;
});
}
function apply(root) {
var scope = root || global.document;
scope.querySelectorAll('[data-i18n]').forEach(function (node) {
var value = t(node.getAttribute('data-i18n'));
// Keep the literal in the HTML when a key has no translation, rather than
// replacing readable English with the key name.
if (value !== node.getAttribute('data-i18n')) node.textContent = value;
});
scope.querySelectorAll('[data-i18n-attr]').forEach(function (node) {
node.getAttribute('data-i18n-attr').split(',').forEach(function (pair) {
var parts = pair.split(':');
if (parts.length !== 2) return;
var attr = parts[0].trim();
var value = t(parts[1].trim());
if (value !== parts[1].trim()) node.setAttribute(attr, value);
});
});
global.document.documentElement.lang = locale;
}
// Region defaults for Singapore. The old pages assumed China: Asia/Shanghai,
// YYYY-MM-DD, 24-hour, ¥. SG uses DD/MM/YYYY (neither Chinese nor American),
// 12-hour with am/pm, and S$.
var REGION = {
en: { locale: 'en-SG', timeZone: 'Asia/Singapore', currency: 'SGD', hour12: true },
'zh-CN': { locale: 'zh-SG', timeZone: 'Asia/Singapore', currency: 'SGD', hour12: true },
};
function region() {
return REGION[locale] || REGION.en;
}
function formatDate(date) {
var r = region();
try {
return new Intl.DateTimeFormat(r.locale, {
timeZone: r.timeZone, day: '2-digit', month: '2-digit', year: 'numeric',
}).format(date);
} catch (e) {
return String(date);
}
}
function formatTime(date) {
var r = region();
try {
return new Intl.DateTimeFormat(r.locale, {
timeZone: r.timeZone, hour: 'numeric', minute: '2-digit', hour12: r.hour12,
}).format(date);
} catch (e) {
return String(date);
}
}
// ICU renders SGD as a bare "$" in an en-SG locale, which is ambiguous next to
// USD prices. Prices are written S$ throughout the product, so format the
// number with Intl and put the symbol on ourselves rather than depending on
// whichever ICU build the browser or Node happens to ship.
function formatMoney(amount) {
var r = region();
try {
return 'S$' + new Intl.NumberFormat(r.locale, {
minimumFractionDigits: 2, maximumFractionDigits: 2,
}).format(amount);
} catch (e) {
return 'S$' + amount;
}
}
global.UClawI18n = {
locale: locale,
supported: SUPPORTED,
t: t,
apply: apply,
region: region,
formatDate: formatDate,
formatTime: formatTime,
formatMoney: formatMoney,
};
if (global.document.readyState === 'loading') {
global.document.addEventListener('DOMContentLoaded', function () { apply(); });
} else {
apply();
}
})(window);