按 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:
87
skills/README.md
Normal file
87
skills/README.md
Normal file
@@ -0,0 +1,87 @@
|
||||
# Skills
|
||||
|
||||
Single source of truth for skill content and distribution.
|
||||
|
||||
## Why this directory exists
|
||||
|
||||
Skill content used to be inlined as heredocs inside `install/install.sh` and as
|
||||
here-strings inside `install/install.ps1`, with a third copy on disk under
|
||||
`portable/skills-cn/`. The three drifted:
|
||||
|
||||
| Source | Skills | Typical length |
|
||||
|---|---|---|
|
||||
| `portable/skills-cn/` | 17 | full |
|
||||
| `install/install.sh` | 10 | ~40% of full |
|
||||
| `install/install.ps1` | 10 | ~17% of full |
|
||||
|
||||
Seven skills (`excel-helper`, `word-writer`, `ppt-designer`, `pdf-toolkit`,
|
||||
`image-compress`, `qrcode-maker`, `web-to-markdown`) existed **only** on the USB
|
||||
build — anyone who used the one-line installer never got them.
|
||||
|
||||
`tests/windows-launchers.test.mjs` also requires customer-facing `.bat` launchers
|
||||
to be pure ASCII, because Chinese Windows `cmd.exe` reads non-ASCII bytes as GBK
|
||||
and mis-parses the script. That constraint is what pushed the `.ps1` copies into
|
||||
being truncated in the first place.
|
||||
|
||||
Separating content from distribution removes all of this: the installers carry no
|
||||
skill text at all.
|
||||
|
||||
## Layout
|
||||
|
||||
```
|
||||
skills/
|
||||
manifest.json # the only thing installers read
|
||||
en/
|
||||
<skill-id>/SKILL.md
|
||||
```
|
||||
|
||||
## manifest.json
|
||||
|
||||
```jsonc
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"personas": [ { "id": "developer", "tier": "expert" }, ... ],
|
||||
"skills": [
|
||||
{
|
||||
"id": "excel-helper",
|
||||
"status": "shipping", // "shipping" | "planned"
|
||||
"locales": ["en"], // which locales have a SKILL.md on disk
|
||||
"categories": ["office"],
|
||||
"personas": ["admin", "finance"],
|
||||
"emoji": "📊"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
`status: "planned"` entries have no content yet. They are listed so the roadmap
|
||||
lives next to the code — installers skip them. `replaces` records which retired
|
||||
skill an entry supersedes.
|
||||
|
||||
## Installing
|
||||
|
||||
`lib/install-skills.mjs` is the only installer. It reads the manifest, filters by
|
||||
locale and persona, and writes to the target directory.
|
||||
|
||||
```bash
|
||||
node lib/install-skills.mjs --target <dir> [--locale en] [--persona general] [--dry-run] [--list]
|
||||
```
|
||||
|
||||
It resolves content in this order:
|
||||
|
||||
1. `skills/` next to the script (repo checkout and USB builds)
|
||||
2. `--source <dir>` if given
|
||||
3. Download from GitHub at the pinned ref (one-line remote installers, which have
|
||||
no repo on disk)
|
||||
|
||||
## Adding a skill
|
||||
|
||||
1. Create `skills/en/<id>/SKILL.md` with the standard front matter
|
||||
2. Add an entry to `manifest.json` with `status: "shipping"`
|
||||
3. Run `node --test tests/` — `tests/skills-manifest.test.mjs` checks that every
|
||||
shipping skill has content, that front matter matches the manifest, and that
|
||||
the shell and PowerShell installers agree on the resulting skill list
|
||||
|
||||
Do not add skill text to any `.sh`, `.ps1` or `.bat` file. The parity test fails
|
||||
if the two installers disagree, and the ASCII test fails if non-ASCII ends up in a
|
||||
`.bat`.
|
||||
Reference in New Issue
Block a user