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
This commit is contained in:
dongsheng123132
2026-03-12 10:59:26 +08:00
parent 75b5daab57
commit be734cb111
21 changed files with 16931 additions and 171 deletions

90
usb-scripts/Mac-Install.command Executable file
View File

@@ -0,0 +1,90 @@
#!/bin/bash
# U-Claw - Extract and Launch (macOS)
GREEN='\033[0;32m'
CYAN='\033[0;36m'
RED='\033[0;31m'
YELLOW='\033[1;33m'
NC='\033[0m'
clear
echo ""
echo -e "${CYAN}"
echo " ╔══════════════════════════════════════╗"
echo " ║ U-Claw 虾盘 v1.1 ║"
echo " ║ 一键解压并启动 (macOS) ║"
echo " ╚══════════════════════════════════════╝"
echo -e "${NC}"
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
ARCHIVE="$SCRIPT_DIR/U-Claw.tar.gz"
INSTALL_DIR="$SCRIPT_DIR/U-Claw"
# 移除 macOS 隔离标记
xattr -rd com.apple.quarantine "$SCRIPT_DIR" 2>/dev/null || true
# 检查压缩包
if [ ! -f "$ARCHIVE" ]; then
echo -e " ${RED}错误: 找不到 U-Claw.tar.gz${NC}"
echo " 请确保此脚本和压缩包在同一目录"
read -p " 按回车键退出..."
exit 1
fi
# 检查是否已解压
if [ -d "$INSTALL_DIR/app/core/node_modules" ]; then
echo -e " ${GREEN}检测到已解压的 U-Claw${NC}"
echo " 位置: $INSTALL_DIR"
echo ""
echo -e " ${YELLOW}[1] 直接启动(跳过解压)${NC}"
echo " [2] 重新解压(覆盖现有)"
echo ""
read -p " 请选择 [1/2默认1]: " choice
choice="${choice:-1}"
if [ "$choice" = "2" ]; then
echo ""
echo -e " ${YELLOW}正在重新解压...${NC}"
rm -rf "$INSTALL_DIR"
else
echo ""
echo -e " ${CYAN}跳过解压,直接启动...${NC}"
fi
fi
# 解压(如果需要)
if [ ! -d "$INSTALL_DIR/app/core/node_modules" ]; then
echo ""
echo -e " ${CYAN}正在解压 U-Claw ...${NC}"
echo " 解压到: $INSTALL_DIR"
echo ""
# 检测是否在 U 盘上(挂载点判断)
if echo "$SCRIPT_DIR" | grep -q "/Volumes/"; then
echo -e " ${YELLOW}检测到 U 盘,解压可能需要 3-5 分钟,请耐心等待...${NC}"
else
echo " 大约需要 1-2 分钟..."
fi
echo ""
cd "$SCRIPT_DIR"
tar xzf "$ARCHIVE"
if [ $? -ne 0 ]; then
echo -e " ${RED}解压失败!${NC}"
read -p " 按回车键退出..."
exit 1
fi
# 解压后移除隔离标记
xattr -rd com.apple.quarantine "$INSTALL_DIR" 2>/dev/null || true
echo -e " ${GREEN}解压完成!${NC}"
echo ""
fi
# 启动
echo -e " ${CYAN}正在启动 OpenClaw...${NC}"
echo ""
cd "$INSTALL_DIR"
exec bash "$INSTALL_DIR/Mac-Start.command"

51
usb-scripts/README.txt Normal file
View File

@@ -0,0 +1,51 @@
========================================
U-Claw 虾盘 v1.1
插上就能用的 AI 助手
u-claw.org
========================================
【使用方法】
Mac 用户: 双击 Mac-Install.command
Windows 用户: 双击 Windows-Install.bat
就这一步!浏览器会自动打开。
脚本会把 U-Claw 解压到你的电脑约2分钟然后自动启动。
========================================
【常见问题】
Q: Mac 提示"无法验证开发者"怎么办?
A: 右键点击脚本 → 选择"打开" → 再点"打开"
Q: Windows 弹出安全警告怎么办?
A: 点击"更多信息" → 点击"仍要运行"
Q: 安装到哪里了?
A: Mac: ~/U-Claw
Windows: C:\Users\你的用户名\U-Claw
Q: 怎么配置 AI 模型和 API Key
A: 启动后浏览器会自动打开配置页面,按提示操作即可
Q: 支持哪些 AI 模型?
A: DeepSeek、Kimi、通义千问、智谱GLM、MiniMax、豆包
全部国内直连,不需要翻墙
Q: 怎么升级?
A: 重新运行安装脚本,选择"重新安装"
你的配置和记忆会保留在 data/ 文件夹里
Q: Toolkit 文件夹是什么?
A: 给工程师的 DIY 素材包Node.js + 源码),普通用户不需要
========================================
【联系我们】
微信: hecare888
官网: u-claw.org
GitHub: github.com/dongsheng123132/u-claw
========================================

View File

@@ -0,0 +1,74 @@
@echo off
chcp 65001 >/dev/null 2>&1
title U-Claw - Extract and Launch
echo.
echo ========================================
echo U-Claw v1.1
echo Extract and Launch (Windows)
echo ========================================
echo.
set "SCRIPT_DIR=%~dp0"
set "ARCHIVE=%SCRIPT_DIR%U-Claw.tar.gz"
set "INSTALL_DIR=%SCRIPT_DIR%U-Claw"
REM Check archive
if not exist "%ARCHIVE%" (
echo [ERROR] U-Claw.tar.gz not found
echo Please ensure this script and the archive are in the same directory
echo.
pause
exit /b 1
)
REM Check if already extracted
if exist "%INSTALL_DIR%\app\core\node_modules" (
echo U-Claw already extracted at: %INSTALL_DIR%
echo.
echo [1] Launch directly (skip extract)
echo [2] Re-extract (overwrite)
echo.
set /p choice=" Choose [1/2, default 1]: "
if "%choice%"=="2" (
echo.
echo Re-extracting...
rmdir /s /q "%INSTALL_DIR%" >/dev/null 2>&1
) else (
echo.
echo Launching...
goto :start
)
)
REM Extract
echo.
echo Extracting U-Claw to: %INSTALL_DIR%
echo This may take a few minutes...
echo.
where tar >/dev/null 2>&1
if %errorlevel%==0 (
cd /d "%SCRIPT_DIR%"
tar xzf "%ARCHIVE%"
if %errorlevel% neq 0 (
echo Extract failed! Please extract U-Claw.tar.gz manually
pause
exit /b 1
)
) else (
echo tar not available. Please extract U-Claw.tar.gz manually
echo using 7-Zip or WinRAR to this directory.
pause
exit /b 1
)
echo Extract complete!
echo.
:start
echo Starting OpenClaw...
echo.
cd /d "%INSTALL_DIR%"
call "%INSTALL_DIR%\Windows-Start.bat"