zhenghy/u-claw
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
271 Commits 2 Branches 0 Tags
0be8c3e3fedc298c87d1c272a9f0f13d3b8fa048
Commit Graph

14 Commits

Author SHA1 Message Date
zheng
0be8c3e3fe ci: 将 workflow 的 runs-on 改为 internal_docker
All checks were successful
Tests / test (push) Successful in 55s
Details 
自托管 Gitea runner 只注册了 internal_docker 标签，ubuntu-latest 会导致 job 永远排队。

Co-authored-by: Cursor <cursoragent@cursor.com>
 2026-08-18 14:03:48 +08:00
zheng
d2cd9d4528 docs: 中文 README 与英文版同步
Some checks failed
Tests / test (push) Has been cancelled
Details 
中文版一直是上游的旧内容，和英文版已经完全对不上：虾盘云首选卡片、
10 个中国技能、QQ 列为预装、还夹着上游另一个产品的推广段落。312 → 165 行。

现在两版讲同一个产品，面向新加坡的华语用户，而不是中国市场。

顺带修掉一条和事实相反的建议：中文版原来写着「U 盘请用 NTFS 格式（不要
exFAT/FAT32）」。macOS 对 NTFS 只读 —— 照做的话「配置跟着盘走」在 Mac 上
直接失效，首次启动连配置都写不进去。这和 release.yml 里那条是同一个错误，
两处都改了。

英文版补上 fork 说明（原来只写在 CLAUDE.md 里），两版现在都写明这是
dongsheng123132/u-claw 的分支、且不向上游提交。

新增断言 tests/i18n-pages.test.mjs：两版必须互链、必须都写明是 fork、
必须都建议 exFAT 且不得出现推荐 NTFS 的措辞、中文版不得再出现英文版
已经删掉的那批上游内容。这条断言的存在是因为它们上次就是这么漂开的。
 2026-08-17 19:29:03 +08:00
zheng
3221856d50 docs: 文档改为英文，并修正过时内容
Some checks failed
Tests / test (push) Has been cancelled
Details 
不是翻译 —— 多数文档描述的行为已经不存在了。

先修一个更基本的问题：我们不拥有 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
zheng
46a1218fc8 ci: 让测试真的跑起来（Gitea Actions + pre-push 钩子）
Some checks failed
Tests / test (push) Has been cancelled
Details 
`node --test tests/` 在 Node 22 上根本不工作 —— Node 把路径当模块加载，
报 "Cannot find module .../tests"，退出码 1，零个测试执行。而这条命令在
CLAUDE.md 里被当作标准用法记了很久。这大概就是这套断言从来没人跑起来的
一个主要原因：照文档敲，得到一个看不懂的错误。

正确形式是裸 `node --test`（自动发现 **/*.test.mjs）。四处全改，并加断言
钉住 —— 我自己第一版钩子和 workflow 也照抄了那个错误形式，实测才发现
它会无条件拦住每一次 push。

- .gitea/workflows/tests.yml：Gitea 原生位置。用 node 容器而非 setup-node，
  自建 Gitea 上后者要从 GitHub 拉，是新 runner 上又一个可能缺的东西。
  容器 tag 与 NODE_VERSION 绑定，否则 CI 测的运行时和出货的不是一个。
- .github/workflows/tests.yml：镜像一份，断言保证两边执行内容一致。
- .githooks/pre-push：不依赖任何 runner 的兜底。实测过它会拦下失败的 push。
  写明 --no-verify 怎么跳过 —— 拦不掉的钩子会被第一个被卡住的人删掉。

为什么需要钩子这一层：这台 Gitea 的 Actions 是开着的，但推上去的 workflow
产生了 0 次运行（total_count: 0），runner API 要鉴权查不了，最可能是没注册
runner。钩子是唯一完全不需要服务端支持的一层。

CLAUDE.md 补上 `git config core.hooksPath .githooks` —— 钩子是 per-clone 的，
没人替你装。
 2026-08-17 18:46:53 +08:00
zheng
b076815171 feat: 海外化改造（新加坡市场）—— 阶段 0-3
Some checks failed
Tests / test (push) Has been cancelled
Details 
按 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
6ab87c6b67 fix(portable): 微信扫码重定向/Telegram botToken/Windows 启动端口 (v2.1.11) 
- 微信扫码卡死: config-server 跟随 IDC scaned_but_redirect 把后续轮询切到
  redirect_host,刷新二维码时重置 pollBaseUrl(扫码后不再卡住等不到 confirmed)。新增测试。
- Telegram 渠道改用 botToken(顶层 telegram 只认 botToken,旧 token 别名被静默忽略 → 连不上)。
- Windows-Start: 先起 config-server 再探测 gateway 端口,从 runtime.json 读实际
  configServerPort 并按该端口开 Config Center / 传给 wait-gateway(18788 被占也能开)。
- wait-gateway.bat: 用 ping 代替 timeout /t(避开 PATH 上 GNU coreutils timeout 冲突),接受 CONFIG_PORT 参数。
- Windows-Menu: IF 块内 echo 的 () 转义为 ^(^),修 v2.1.10 闪退回归。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-24 00:41:20 +08:00
hfshfg
3439db32ad feat(portable): 内网/局域网可用性工具包 + 启动绕代理 (v2.1.10) 
便携版在内网/离线/受控浏览器环境下"配不上、用不了、查不清"的三个痛点工具化，
Win + Mac 双端，纯 Node 零依赖脚本，中文提示由 node 打印（.bat 保持纯 ASCII，
.command 保持 LF），三端真机验证（本机 Win / Mac mini / 客户机 pc-7512）。

新增工具:
- lib/intranet-check.mjs (+ Windows-IntranetFix.bat / Mac-IntranetFix.command)
  一键体检: 代理env + 直连可达 + 真发一条对话，分清"网络不通 vs 配置错"。
- lib/setup-local-model.mjs (+ Windows-LocalModel.bat / Mac-LocalModel.command)
  纯命令行配 Ollama / newapi 并当场实测，绕开打不开的 Control UI；写前自动备份+merge。
- lib/resolve-no-proxy.mjs 接入 Windows-Start.bat / Mac-Start.command:
  把配置里的模型 host 写进 NO_PROXY，避免系统代理劫持内网模型请求
  (OpenClaw 自身只 bypass loopback CDP，不管模型 host)。
- OpenClaw-Doctor.bat / Mac-OpenClaw-Doctor.command: 官方 doctor 的隔离进阶入口
  (只读、非交互；doctor 实跑慢且 TTY-only，故不进客户一键流程)。

测试: tests/windows-launchers.test.mjs 新增回归
- 客户面 .bat 必须纯 ASCII (UTF-8 中文会被 GBK cmd 读乱，报 usebackq 不是命令)
- macOS .command 必须 LF-only (CRLF 触发 bad interpreter: /bin/bash^M)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 18:53:21 +08:00
hfshfg
1517152a19 fix(portable): keep config center visible on startup 2026-06-20 12:16:42 +08:00
8000cabbage
3ff3661825 fix: stabilize Windows launchers for v2.1.4 
Fix Windows portable, installer, and desktop launcher startup paths; bump desktop metadata to 2.1.4.
 2026-05-19 14:30:34 +08:00
dongsheng123132
022f4f1f9a feat: v1.1 - simplified menus, pre-installed QQ plugin, updated README 
- Simplify menus from 17 to 8 options (config, dashboard, QQ, platforms, diagnostics, backup, restore, sysinfo)
- Pre-install QQ bot plugin (@sliverp/qqbot) - users only need AppID + Secret
- Install scripts now extract next to themselves (works on USB or computer)
- Rename all scripts to English (Mac-Install, Windows-Install, Mac-Start, etc.)
- Add README.txt for USB drive with bilingual instructions
- Rewrite README.md to match current v1.1 structure
- Remove old Chinese-named scripts, build script, test files, QR images
- Add Toolkit/ and U-Claw-CN/ to .gitignore
 2026-03-11 00:09:10 +08:00
dongsheng123132
eef6ead800 refactor: use concise script names (从U盘启动/全部功能/安装到电脑) 2026-03-09 20:19:56 +08:00
dongsheng123132
30907dedc8 feat: rename scripts with descriptive Chinese names 
Mac-插上U盘直接用.command / Windows-插上U盘直接用.bat
Mac-全部功能菜单(17项).command / Windows-全部功能菜单(17项).bat
Mac-安装到电脑(永久).command / Windows-安装到电脑(永久).bat
Linux-插上U盘直接用.sh
 2026-03-09 20:18:23 +08:00
dongsheng123132
98a8b2e2c0 refactor: use platform prefix for script names (Mac-/Windows-/Linux-) 
Easier for users to identify at a glance which file to double-click.
e.g. Mac-运行.command, Windows-运行.bat, Linux-运行.sh
 2026-03-09 20:07:55 +08:00
dongsheng123132
8538f14926 feat: add platform suffix to script names + test suite 
Rename scripts with -Windows/-Mac/-Linux suffix so users can easily
identify which file to double-click on the USB drive.

Add tests/test-scripts.sh with 93 checks covering:
- File existence, bash syntax, portable mode, gateway run, security
- Cross-platform consistency between .bat and .command versions
 2026-03-09 20:03:42 +08:00