按 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:
167
lib/install-skills.mjs
Normal file
167
lib/install-skills.mjs
Normal 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));
|
||||
Reference in New Issue
Block a user