3221856d50
docs: 文档改为英文，并修正过时内容
...
Tests / test (push) Has been cancelled
不是翻译 —— 多数文档描述的行为已经不存在了。
先修一个更基本的问题：我们不拥有 u-claw.org 域名，那是上游的。所以之前写在
README、诊断包提示、联系方式里的 help@u-claw.org 全都会把用户的问题发给
上游 —— 一个没有理由回复的人。改为指向我们自己的 issue tracker，并加断言
禁止再出现指向该域名的支持入口。
重写（内容过时，不是语言问题）：
- install/README.md —— 还写着 10 个中国技能、DeepSeek 优先、国内镜像。
现在按实际流程写：技能读 manifest、模型菜单 Gemini 优先、bundle 有
SHA256 校验。并如实写明 curl|bash 在受管企业电脑上会被 EDR 拦。
- CLAUDE.md 的模型配置整节 —— 还在描述虾盘云首选卡片和 12 个 provider，
那个界面已经换成单框 Key 输入了。
- SECURITY.md —— 安全报告原本指向上游维护者个人邮箱。fork 之后那条路由
是错的：漏洞会发给写不了这份代码、也修不了的人。
- CONTRIBUTING.md —— 补上 fork 关系、pre-push 钩子怎么装、以及
`node --test tests/` 为什么不能用。
翻译并保留：
- bootable/README.md、TROUBLESHOOTING.md —— 面向用户，顺带把
「国内镜像」「小米/华为 BIOS 按键」等换成目标市场的实际情况
HANDOFF.md 重写为一份事故复盘：原文一半是过时的一次性交接笔记（引用的
website/guide.html 已不在本仓库），另一半是 persistence.dat 未格式化导致
启动失败的排查记录 —— 后者有长期价值，尤其是「读 offset 1080 的两字节
验证 ext4」这个判断方法，已同时写进 bootable/README.md。
bootable/IMPROVEMENTS_SUMMARY.md 保留中文，加了说明：它是上游 fork 前的
历史改进记录，没人引用，描述的是已完成的工作而非当前行为。翻译它反而会
让人误以为是现行文档。
新增 skills/en/uclaw-help —— 把「怎么用、东西在哪、出问题怎么办」做成
内置知识，每个角色都装。方案 C10.8：能问的产品才是不需要学的产品。
2026-08-17 19:12:07 +08:00
b076815171
feat: 海外化改造（新加坡市场）—— 阶段 0-3
...
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 拆到私有仓库，无权限
2026-08-17 18:37:49 +08:00
hfshfg
2d0f33d5a0
chore: 加 .gitattributes 锁定换行符（修跨平台脚本隐患）
...
core.autocrlf 在不同机器上会把 .command/.sh 转成 CRLF，导致 Mac 用户
双击 .command 报 bad interpreter。明确锁定：
- .bat/.cmd/.ps1 → CRLF（Windows 批处理需要）
- .command/.sh/.mjs/.js/.json → LF（Mac/Linux 需要）
附带把 install/README.md、Windows-Menu.bat 的换行一次性规范化（纯换行，
无内容改动）。
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com >
2026-06-15 12:29:45 +08:00
hfshfg
c5b9b77c9b
docs(install): 更新 README 安装流程，区分 Mac/Linux(7步) 和 Windows(6步)
...
补充 Windows bundle 下载所用的国内镜像列表说明。
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com >
2026-03-31 20:04:43 +08:00
dongsheng123132
bb537f3ce2
feat: add one-line install module (curl | bash / irm | iex)
...
New install/ module for network-based installation without USB:
- install.sh: Mac/Linux 7-step installer (Node.js + OpenClaw + QQ plugin + 10 CN skills + interactive model config + launcher)
- install.ps1: Windows PowerShell equivalent
- All downloads via npmmirror.com China mirrors
- 10 AI model choices with Chinese interactive menu (default DeepSeek)
- Scripts copied to website/ for Vercel hosting at u-claw.org/install.sh
Updated guide.html with dedicated "一键在线安装" page section and quickstart integration.
2026-03-18 15:39:33 +08:00
