按 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:
254
portable/Read me first.html
Normal file
254
portable/Read me first.html
Normal file
@@ -0,0 +1,254 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title data-i18n="welcome.title">U-Claw — Getting Started</title>
|
||||
<style>
|
||||
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||||
body {
|
||||
font-family: -apple-system, "Microsoft YaHei", "PingFang SC", sans-serif;
|
||||
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
|
||||
min-height: 100vh;
|
||||
padding: 30px 20px;
|
||||
}
|
||||
.container {
|
||||
max-width: 700px;
|
||||
margin: 0 auto;
|
||||
background: white;
|
||||
border-radius: 16px;
|
||||
padding: 40px;
|
||||
box-shadow: 0 20px 60px rgba(0,0,0,0.3);
|
||||
}
|
||||
h1 {
|
||||
text-align: center;
|
||||
color: #333;
|
||||
font-size: 2.5em;
|
||||
margin-bottom: 10px;
|
||||
}
|
||||
h1 .emoji { font-size: 1.2em; }
|
||||
.subtitle {
|
||||
text-align: center;
|
||||
color: #666;
|
||||
font-size: 1.1em;
|
||||
margin-bottom: 40px;
|
||||
}
|
||||
.section {
|
||||
margin-bottom: 35px;
|
||||
}
|
||||
.section-title {
|
||||
color: #667eea;
|
||||
font-size: 1.4em;
|
||||
margin-bottom: 20px;
|
||||
padding-bottom: 10px;
|
||||
border-bottom: 2px solid #e0e0e0;
|
||||
}
|
||||
.steps {
|
||||
counter-reset: step;
|
||||
}
|
||||
.step {
|
||||
position: relative;
|
||||
padding: 20px;
|
||||
padding-left: 70px;
|
||||
margin-bottom: 20px;
|
||||
background: #f8f9fa;
|
||||
border-radius: 12px;
|
||||
border-left: 4px solid #667eea;
|
||||
}
|
||||
.step::before {
|
||||
content: counter(step);
|
||||
counter-increment: step;
|
||||
position: absolute;
|
||||
left: 20px;
|
||||
top: 20px;
|
||||
background: #667eea;
|
||||
color: white;
|
||||
width: 36px;
|
||||
height: 36px;
|
||||
border-radius: 50%;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
font-weight: bold;
|
||||
font-size: 1.2em;
|
||||
}
|
||||
.step-title {
|
||||
font-weight: 600;
|
||||
color: #333;
|
||||
font-size: 1.1em;
|
||||
margin-bottom: 8px;
|
||||
}
|
||||
.step-desc {
|
||||
color: #666;
|
||||
line-height: 1.6;
|
||||
}
|
||||
.step-desc code {
|
||||
background: #e3e8ff;
|
||||
padding: 3px 8px;
|
||||
border-radius: 4px;
|
||||
color: #667eea;
|
||||
font-size: 0.95em;
|
||||
font-family: "Consolas", monospace;
|
||||
}
|
||||
.tip-box {
|
||||
background: #fff3cd;
|
||||
border-left: 4px solid #ffc107;
|
||||
padding: 15px 20px;
|
||||
border-radius: 8px;
|
||||
margin-top: 20px;
|
||||
}
|
||||
.tip-box strong {
|
||||
color: #856404;
|
||||
display: block;
|
||||
margin-bottom: 5px;
|
||||
}
|
||||
.tip-box p {
|
||||
color: #856404;
|
||||
margin: 0;
|
||||
line-height: 1.6;
|
||||
}
|
||||
.success-box {
|
||||
background: #d4edda;
|
||||
border-left: 4px solid #28a745;
|
||||
padding: 15px 20px;
|
||||
border-radius: 8px;
|
||||
margin-top: 20px;
|
||||
}
|
||||
.success-box p {
|
||||
color: #155724;
|
||||
margin: 0;
|
||||
}
|
||||
.model-grid {
|
||||
display: grid;
|
||||
grid-template-columns: 1fr 1fr;
|
||||
gap: 12px;
|
||||
margin-top: 15px;
|
||||
}
|
||||
.model-item {
|
||||
background: #f8f9fa;
|
||||
padding: 12px;
|
||||
border-radius: 8px;
|
||||
border: 1px solid #e0e0e0;
|
||||
}
|
||||
.model-item strong {
|
||||
color: #667eea;
|
||||
display: block;
|
||||
margin-bottom: 4px;
|
||||
}
|
||||
.model-item span {
|
||||
color: #666;
|
||||
font-size: 0.9em;
|
||||
}
|
||||
.btn {
|
||||
display: inline-block;
|
||||
padding: 12px 24px;
|
||||
background: #667eea;
|
||||
color: white;
|
||||
text-decoration: none;
|
||||
border-radius: 8px;
|
||||
font-weight: 600;
|
||||
transition: all 0.3s;
|
||||
margin-right: 10px;
|
||||
margin-top: 10px;
|
||||
}
|
||||
.btn:hover {
|
||||
background: #5568d3;
|
||||
transform: translateY(-2px);
|
||||
box-shadow: 0 4px 12px rgba(102, 126, 234, 0.4);
|
||||
}
|
||||
.footer {
|
||||
text-align: center;
|
||||
margin-top: 40px;
|
||||
padding-top: 20px;
|
||||
border-top: 1px solid #e0e0e0;
|
||||
color: #999;
|
||||
}
|
||||
</style>
|
||||
<script src="data/.openclaw/locale.js"></script>
|
||||
<script src="lib/i18n/messages.js"></script>
|
||||
<script src="lib/i18n/i18n.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<div class="container">
|
||||
<h1><span class="emoji">🦞</span> <span data-i18n="welcome.title">U-Claw — Getting Started</span></h1>
|
||||
<div class="subtitle" data-i18n="welcome.subtitle">Your AI assistant on a USB drive · three steps</div>
|
||||
|
||||
<div class="section">
|
||||
<div class="section-title" data-i18n="welcome.quickstart">Quick start</div>
|
||||
<div class="steps">
|
||||
<div class="step">
|
||||
<div class="step-title" data-i18n="welcome.step1_title">1. Start U-Claw</div>
|
||||
<div class="step-desc">
|
||||
<span data-i18n="welcome.step1_desc">Double-click the file for your computer:</span><br><br>
|
||||
<strong>Windows</strong> — <code>START HERE - Windows.bat</code><br>
|
||||
<strong>Mac</strong> — <code>START HERE - Mac.command</code>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="step">
|
||||
<div class="step-title" data-i18n="welcome.step2_title">2. Add a key</div>
|
||||
<div class="step-desc">
|
||||
<span data-i18n="welcome.step2_desc">Settings opens on its own the first time. You need one API key to get going — Google Gemini is the easiest to obtain: sign in with a Google account, no card required.</span><br>
|
||||
<a href="https://aistudio.google.com/apikey" target="_blank" rel="noopener" data-i18n="welcome.step2_link">Get a free Gemini key →</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="step">
|
||||
<div class="step-title" data-i18n="welcome.step3_title">3. Start talking</div>
|
||||
<div class="step-desc">
|
||||
<span data-i18n="welcome.step3_desc">Once the key is saved, the chat window opens by itself. That is it.</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="success-box">
|
||||
<p data-i18n="welcome.portable_note">✅ Your settings and history stay in the <code>data/</code> folder on the drive, so they travel with you between Mac and Windows.</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="section">
|
||||
<div class="section-title" data-i18n="welcome.models_title">Which model?</div>
|
||||
<div class="model-grid">
|
||||
<div class="model-item">
|
||||
<strong>🌟 Claude</strong>
|
||||
<span data-i18n="welcome.model_claude">Best all-rounder</span>
|
||||
</div>
|
||||
<div class="model-item">
|
||||
<strong>💬 GPT</strong>
|
||||
<span data-i18n="welcome.model_gpt">Most widely used</span>
|
||||
</div>
|
||||
<div class="model-item">
|
||||
<strong>🆓 Gemini</strong>
|
||||
<span data-i18n="welcome.model_gemini">Free tier, easiest signup</span>
|
||||
</div>
|
||||
<div class="model-item">
|
||||
<strong>🔒 Local model</strong>
|
||||
<span data-i18n="welcome.model_local">Offline · nothing leaves this machine</span>
|
||||
</div>
|
||||
</div>
|
||||
<p class="subtitle" style="margin-top:14px" data-i18n="welcome.models_more">More options, including SEA-LION for Malay, Tamil and Singlish, are in Settings.</p>
|
||||
</div>
|
||||
|
||||
<div class="section">
|
||||
<div class="section-title" data-i18n="welcome.trouble_title">Something not working?</div>
|
||||
<div class="tip-box">
|
||||
<strong data-i18n="welcome.trouble_lead">💡 Run the check-up tool</strong>
|
||||
<p>
|
||||
<span data-i18n="welcome.trouble_desc">If U-Claw will not start, double-click:</span><br>
|
||||
Windows — <code>Windows-Diagnose.bat</code><br>
|
||||
Mac — <code>Mac-Diagnose.command</code>
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div style="text-align: center; margin-top: 30px;">
|
||||
<a href="advanced/Config.html" class="btn" data-i18n="welcome.open_settings">Open Settings</a>
|
||||
<a href="https://u-claw.org" class="btn" target="_blank" rel="noopener" data-i18n="welcome.open_docs">Documentation</a>
|
||||
</div>
|
||||
|
||||
<div class="footer">
|
||||
U-Claw v1.1 · MIT License · <a href="https://gitea.fanghe.it.com/zhenghy/u-claw" target="_blank" style="color: #667eea;">GitHub</a>
|
||||
</div>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user