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

167
lib/install-skills.mjs Normal file
View File

@@ -0,0 +1,167 @@
#!/usr/bin/env node
// Installs skills from skills/manifest.json into a target directory.
//
// This is the only place skill content is handled. install.sh and install.ps1
// call it and contain no skill text of their own, which is what keeps the two
// platforms provably identical (see tests/skills-manifest.test.mjs) and keeps
// non-ASCII bytes out of .bat launchers (see tests/windows-launchers.test.mjs).
//
// node lib/install-skills.mjs --target <dir> [--locale en] [--persona general]
// [--source <dir>] [--ref <git-ref>]
// [--list] [--dry-run] [--json]
import { mkdirSync, readFileSync, writeFileSync, existsSync, copyFileSync } from 'node:fs';
import { dirname, join, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
// Where to fetch from lives in origin.json so a move to our own host is one
// edit. Falling back to literals keeps this working when the file is absent —
// the remote installers download this script on its own, without the repo.
const ORIGIN = (() => {
for (const dir of [join(scriptDirOf(), '..'), scriptDirOf()]) {
try { return JSON.parse(readFileSync(join(dir, 'origin.json'), 'utf8')); } catch { /* try next */ }
}
return null;
})();
// A template rather than a base URL: Gitea and GitHub lay raw paths out
// differently, and hardcoding either shape makes the other impossible.
const RAW_TEMPLATE = ORIGIN?.urls?.rawTemplate
?? 'https://gitea.fanghe.it.com/zhenghy/u-claw/raw/branch/{ref}/{path}';
const DEFAULT_REF = ORIGIN?.repo?.ref ?? 'main';
function scriptDirOf() { return dirname(fileURLToPath(import.meta.url)); }
const scriptDir = scriptDirOf();
function parseArgs(argv) {
const opts = { locale: 'en', personas: [], list: false, dryRun: false, json: false, ref: DEFAULT_REF };
for (let i = 0; i < argv.length; i++) {
const arg = argv[i];
const next = () => {
const value = argv[++i];
if (value === undefined) fail(`${arg} needs a value`);
return value;
};
switch (arg) {
case '--target': opts.target = next(); break;
case '--source': opts.source = next(); break;
case '--locale': opts.locale = next(); break;
case '--persona': opts.personas.push(next()); break;
case '--ref': opts.ref = next(); break;
case '--list': opts.list = true; break;
case '--dry-run': opts.dryRun = true; break;
case '--json': opts.json = true; break;
case '--help': case '-h': usage(); process.exit(0); break;
default: fail(`unknown argument: ${arg}`);
}
}
return opts;
}
function usage() {
process.stdout.write(
'Usage: install-skills.mjs --target <dir> [--locale en] [--persona <id>]...\n' +
' [--source <dir>] [--ref <git-ref>] [--list] [--dry-run] [--json]\n'
);
}
function fail(message) {
process.stderr.write(`install-skills: ${message}\n`);
process.exit(1);
}
// Content lives in the repo checkout or on the USB. The one-line installers have
// neither, so they fall through to fetching from GitHub at a pinned ref.
function resolveLocalSource(explicit) {
const candidates = [explicit, join(scriptDir, '..', 'skills'), join(scriptDir, 'skills')];
for (const dir of candidates) {
if (dir && existsSync(join(dir, 'manifest.json'))) return resolve(dir);
}
return null;
}
async function fetchText(url) {
const response = await fetch(url);
if (!response.ok) throw new Error(`${response.status} ${response.statusText} for ${url}`);
return response.text();
}
function rawUrl(ref, path) {
return RAW_TEMPLATE.replace('{ref}', ref).replace('{path}', `skills/${path}`);
}
function selectSkills(manifest, { locale, personas }) {
return manifest.skills
.filter((skill) => skill.status === 'shipping')
.filter((skill) => (skill.locales ?? []).includes(locale))
// No --persona means install everything available for the locale.
.filter((skill) => personas.length === 0 || personas.some((p) => (skill.personas ?? []).includes(p)))
.sort((a, b) => a.id.localeCompare(b.id));
}
async function main() {
const opts = parseArgs(process.argv.slice(2));
if (!opts.target && !opts.list) fail('--target is required (or use --list)');
const localSource = resolveLocalSource(opts.source);
const remote = localSource === null;
let manifest;
try {
manifest = JSON.parse(
remote
? await fetchText(rawUrl(opts.ref, 'manifest.json'))
: readFileSync(join(localSource, 'manifest.json'), 'utf8')
);
} catch (error) {
fail(`could not read the skill manifest: ${error.message}`);
}
const selected = selectSkills(manifest, opts);
if (opts.list) {
process.stdout.write(
opts.json
? `${JSON.stringify(selected.map((s) => s.id))}\n`
: `${selected.map((s) => s.id).join('\n')}\n`
);
return;
}
let installed = 0;
let skipped = 0;
const failures = [];
for (const skill of selected) {
const destDir = join(opts.target, skill.id);
const destFile = join(destDir, 'SKILL.md');
if (existsSync(destFile)) { skipped++; continue; }
if (opts.dryRun) { installed++; continue; }
try {
mkdirSync(destDir, { recursive: true });
if (remote) {
writeFileSync(destFile, await fetchText(rawUrl(opts.ref, `${opts.locale}/${skill.id}/SKILL.md`)), 'utf8');
} else {
const src = join(localSource, opts.locale, skill.id, 'SKILL.md');
if (!existsSync(src)) throw new Error(`missing ${src}`);
copyFileSync(src, destFile);
}
installed++;
} catch (error) {
// One bad skill should not abort the install — report at the end instead.
failures.push(`${skill.id}: ${error.message}`);
}
}
if (opts.json) {
process.stdout.write(`${JSON.stringify({ installed, skipped, failed: failures })}\n`);
} else {
process.stdout.write(`skills installed: ${installed}, already present: ${skipped}\n`);
for (const failure of failures) process.stderr.write(` failed: ${failure}\n`);
}
if (failures.length > 0 && installed === 0) process.exit(1);
}
main().catch((error) => fail(error.message));