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

63 Commits

Author SHA1 Message Date
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
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
9a23aec097 docs: redesign README landing page
Some checks failed
Track OpenClaw upstream / Check upstream & auto-bump (push) Has been cancelled
Details
2026-07-27 23:45:12 +08:00
hfshfg
02bf4ddf95 docs(readme): 顶部加 U-King 装机管家导流 + 代理合作加 U-King 分销条目 
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
 2026-07-04 15:58:45 +08:00
hfshfg
8cd5dbfea4 chore: 停发并归档 Electron 桌面版,产品只保留便携 U 盘版 
桌面 Electron 版是商业版 ClawX 已做得更好的事的劣化版,且启动坑多
(冷启动建编译缓存 >30s 撞写死的 30s 硬超时,绿色版每次解压 837MB
永远冷启动)。U-Claw 的本质是「插上 U 盘解压即用」,故停发桌面版,
只发便携版。

- release.yml: 删除 desktop-windows / desktop-mac 两个 job;publish
  只依赖 portable-windows-full;发布说明去掉桌面安装版/dmg,只留便携版
- u-claw-app/DEPRECATED.md: 新增归档说明(停发原因、坑、如何捡回)
- u-claw-app/src/main.js: 顺带修 gateway 超时 30s→180s + spawn 加固定
  NODE_COMPILE_CACHE(让归档代码处于可用状态)
- 删除 usb-release/: portable/ 的老前身,2026-04 后无人维护、全仓库零
  引用,是「为什么有两个 U 盘版」的混乱源
- README.md / CLAUDE.md: 分发形态更新为便携版唯一主发

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-20 00:15:32 +08:00
hfshfg
0d88c9b0cc chore(portable): 回归纯开源 — 移除指纹/自动开户/崩溃上报 
去掉不适合开源的商业逻辑，保持一个纯粹的开源 U 盘工具：

- 删除设备指纹 (fingerprint.mjs)、虾盘云自动开户 (bootstrap-xiapan.mjs /
  xiapan-client.mjs)、自动崩溃上报 (report-bug.mjs)，portable 和 Electron 两份都删
- 启动脚本去掉绑定指纹调用 + 全部 --auto 自动上报；保留 bonjour 禁用与括号转义
- config-server 删掉 /api/xiapan/* 和 /api/report-bug 端点
- Config.html：虾盘云改为普通「首选」卡片，强调中转站 / 国内外全部大模型，
  和其它 provider 一样需用户自填 Key（去 u-claw.org/cloud.html 注册），不再自动开户
- 报 Bug 表单改为指向 GitHub Issue，不再上传日志
- README / release notes / CLAUDE.md 文案改为「选模型填 Key，不绑定设备、不打指纹、不上传数据」
- OPENCLAW_VERSION 跟进最新龙虾版本 2026.6.6 → 2026.6.8

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-17 11:47:19 +08:00
hfshfg
9ecbbd445c feat: 内置虾盘云 + 设备指纹绑定 + Release 流水线 
- 新增 portable/lib/{fingerprint,xiapan-client,bootstrap-xiapan}.mjs：
  跨平台设备指纹（Win USB/disk + Mac UUID + Linux machine-id + seed 兜底）
  生成 sk-uc-{fingerprint} 形式的虾盘云 apiKey，启动时 merge 到 openclaw.json
- Config.html 顶部新增「已绑定虾盘云」横幅：指纹来源 + Key + 余额 + 充值/解绑
- config-server 增加 /api/xiapan/{status,bind,unbind} 三个端点
- Electron app 在 whenReady 调 bootstrap，新增 sync-lib.js 让 build 前自动同步
- 锁 OpenClaw 版本到 2026.4.29（OPENCLAW_VERSION 单一来源）
- 删除死代码 portable/充值.html
- 新增 .github/workflows/release.yml：tag 触发，出 portable zip + Electron exe/dmg
- README 增加内置虾盘云说明 + 直接下载发行版指引
 2026-05-02 17:07:42 +08:00
hfshfg
a42a1269a4 docs: 署名改为贺去病 ai 工作室 2026-04-21 12:17:28 +08:00
hfshfg
3ff102f1d0 docs: 添加微信二维码 + 代理合作招募 
- 新增 assets/wechat-qr.jpg（贺去病 ai 工作室微信二维码）
- README 中文/英文联系区域各插入二维码图片和代理合作说明

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-21 12:16:06 +08:00
hfshfg
2b7522d173 docs: 扩充 FAQ + 添加 Issue 模板 
- README FAQ 新增 8 个高频问题（Node 版本兼容、npm 安装失败、U 盘格式、多 provider 配置、QQbot 编译等），中英文同步更新
- 新增 .github/ISSUE_TEMPLATE/：bug 报告模板（含环境信息字段）、功能建议模板、config.yml（禁用空白 issue，引导至 FAQ 和教程）

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-21 11:47:30 +08:00
dongsheng123132
49b875b081 feat: add uninstall.sh for one-click uninstall 2026-04-13 18:17:14 +08:00
hfshfg
974a59d3ba docs: clarify Windows setup options (setup.bat / setup.ps1) in README 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-04 21:25:27 +08:00
dongsheng123132
c0ea59e16f feat: add Windows setup.ps1 for portable 
# Add Windows setup.ps1 for portable
 2026-04-04 21:21:57 +08:00
dongsheng123132
1f9726ac16 docs: add Japanese README section 
docs: add JA section
 2026-04-04 21:21:54 +08:00
hfshfg
5c7408495d feat: 添加拼多多购买渠道，更新淘宝链接和口令 
淘宝口令 HU293，同步更新 README、index.html、guide.html。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-04-01 10:43:36 +08:00
hfshfg
8ebb8d82b9 fix: 更新淘宝商品链接为正式链接 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-31 22:33:13 +08:00
hfshfg
04ac67ceaf docs: 添加淘宝购买链接和口令 MF278 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-31 21:07:43 +08:00
hfshfg
37aa557123 docs: 更新2.0商业版文案，标注已正式销售并添加购买渠道 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-31 21:03:25 +08:00
hfshfg
8c1d0eb809 docs: 精简 README blockquote，中英文各从7条压缩到2条 
去除与「寻找技术伙伴」section 重复的内容，保留新手提示和2.0商业版核心信息。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-31 20:45:57 +08:00
hfshfg
1b19342395 docs: 优化寻找技术伙伴文案，中英文同步更新 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-31 20:41:15 +08:00
hfshfg
5b5ffd03bf docs: 加强招募号召，虾盘只是开始 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-31 19:50:31 +08:00
hfshfg
d4205215d3 docs: 更新新手提示、隐藏虾盘云注册入口 
- README 新手提示加入产品经理故事和招募号召
- 删除 SophNet 广告大段内容
- cloud.html 注册按钮置灰，加暂停服务提示
- index.html 虾盘云入口全部改为不可点击

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-31 19:41:54 +08:00
hfshfg
0fc415c2d5 docs: 新手提示补充 AI 不焦虑鼓励语 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-30 22:51:43 +08:00
hfshfg
c199a0ce42 docs: 补充硬件开发和技术极客招募信息 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-30 22:47:08 +08:00
hfshfg
607f2d101b docs: 在 README 中前置新手提示和 2.0 商业版介绍 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-03-30 22:40:54 +08:00
Ikko Ashimine
e2ed196795 docs: add JA section 2026-03-30 13:01:04 +09:00
JingleCai
5bd5adf898 add sophnet to Readme 2026-03-27 21:06:13 +08:00
JingleCai
ad06496ed4 add sophnet to Readme 2026-03-27 20:49:07 +08:00
JingleCai
6cfc6cf407 add sophnet to Readme 2026-03-27 20:46:57 +08:00
JingleCai
561d0fd4ba add sophnet to Readme 2026-03-27 20:44:59 +08:00
JingleCai
ca8e95978f add sophnet to Readme 2026-03-27 20:40:34 +08:00
JingleCai
77b692a8b7 add sophnet to Readme 2026-03-27 20:38:12 +08:00
JingleCai
dc1470c0a6 more detail about sophnet model 2026-03-27 20:36:00 +08:00
JingleCai
7bfd5f212a add sophnet to Readme 2026-03-27 14:44:02 +08:00
Skandhas5
ecc03ab859 Add setup.ps1 for portable setup in Windows 2026-03-22 17:03:19 +08:00
dongsheng123132
15460fef62 docs: add 虾盘 (Xia Pan) keyword throughout README for GitHub search 
GitHub search indexes README content. Added 虾盘 in title, Chinese section,
and English section so searching "虾盘" on GitHub will find this repo.
 2026-03-19 22:10:47 +08:00
dongsheng123132
f36ab26fc7 feat: 首页 + README 添加远程维护/定制开发服务板块 
- index.html: 新增「专业服务」section（远程安装/故障排查/定制开发），CTA 按钮链接到 guide
- README.md: 新增 Professional Services 板块，含价格表、一键远程命令、微信联系方式
 2026-03-19 11:33:08 +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
dongsheng123132
b8ec5902f0 docs: add tutorial link to README 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-03-16 17:03:20 +08:00
dongsheng123132
1159073c5f feat: add partner recruitment section to README and guide 
Add bilingual "Looking for Partners" section in README (Chinese + English)
and a new "合作招募" page in guide.html sidebar, plus a recruitment card
in the existing "联系我们" contact page.
 2026-03-14 20:57:32 +08:00
hfshfg
b9f37e1e1b feat: add bootable Linux USB module (independent within repo) 
Add bootable/ directory with complete toolkit to create a bootable
Ubuntu USB drive with OpenClaw AI:
- 4-step PowerShell scripts for USB preparation on Windows
- Ventoy 1.0.99 boot manager with casper-rw persistence
- Self-contained Linux setup and startup scripts
- Detailed README with architecture, usage guide, and troubleshooting

bootable/ is fully independent - does not reference any files from
portable/, u-claw-app/, or website/. Also maintained as standalone
repo at u-claw-linux for convenience.

Update main README to reference both bootable/ and u-claw-linux repo.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 18:35:41 +08:00
hfshfg
16778dd104 docs: add Linux bootable USB as separate repo (u-claw-linux) 
- Add links to u-claw-linux repo in README (both CN and EN sections)
- Add Linux x64 to platform support table
- Update CLAUDE.md platform status
- Move bootable/ to .gitignore (now independent repo)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-03-14 18:28:32 +08:00
dongsheng123132
4fcd22d4e3 cleanup: remove Linux scripts, unify core dir, fix Intel Mac bug 
- Delete usb-scripts/, Linux-*.sh, setup-linux-usb.sh, migrate.js
- Rename core-mac/core-win → core (with migration shims for existing USBs)
- Fix Mac-Menu.command ARM64 hardcode — now detects Intel/Apple Silicon
- setup.sh: remove Linux branch, Windows download only with --all-platforms
- Update README.md and CLAUDE.md to reflect Mac + Windows only
 2026-03-14 00:08:56 +08:00
dongsheng123132
7766d59e55 merge: resolve conflict in Windows-Start.bat, add Linux scripts and maintain lib 2026-03-13 17:35:55 +08:00
dongsheng123132
b9037ebfa1 fix: remove build-usb.sh, correct README positioning 
The repo IS the USB content (minus large deps), not a builder tool.
setup.sh fills in missing deps → folder is ready to copy to USB.
 2026-03-12 15:24:55 +08:00
dongsheng123132
9136b5ae69 feat: add USB builder tool and install-to-computer scripts 
- build-usb.sh: one-click USB drive builder (downloads Node.js + OpenClaw
  from China mirrors, packages into USB-ready directory)
- Mac-Install.command: install from USB to Mac (~/.uclaw/), offline-first
  with China mirror fallback
- Windows-Install.bat: same for Windows
- README.md rewritten to position project as "USB drive builder toolkit"
 2026-03-12 14:02:53 +08:00
dongsheng123132
71e4f5b357 feat: add one-click setup scripts for desktop app (Mac + Windows) 
- setup.sh: auto-downloads Node.js + npm deps + runtime from China mirrors
- setup.bat: same for Windows, guides to install Node.js if missing
- Both set Electron mirror to npmmirror.com for China users
- Updated README with new setup instructions
 2026-03-12 13:25:18 +08:00
dongsheng123132
be734cb111 feat: restructure repo for collaboration + add desktop app source 
- Reorganize project: clean structure (portable/ u-claw-app/ usb-scripts/ website/)
- Move docs into website/, rename uclaw-scripts to usb-scripts
- Add u-claw-app/ Electron desktop source code
- Add portable/setup.sh: one-command dev environment setup
- Add portable/SkillHub.html: skill marketplace page
- Update README: dev guide, contribution workflow, project structure
- Update .gitignore: exclude runtime binaries and build artifacts
- Expand China install guide: npm mirrors, detailed onboard wizard
 2026-03-12 10:59:26 +08:00
dongsheng123132
bdae129e44 docs: bilingual README for v1.1 release 2026-03-11 00:16:00 +08:00