huhaa-myskills 0.2.13 → 0.3.4

package/scripts/init-nextjs-project.sh

@@ -0,0 +1,421 @@
+#!/bin/bash
+# HuHaa-MySkills 前端框架初始化脚本
+# Next.js 15 + React 18 + TypeScript 完整项目结构
+
+set -e
+
+PROJECT_NAME="huhaa-myskills-web"
+WORKSPACE_DIR="/Users/mac/Project/HuHaa-MySkills"
+
+echo "🚀 初始化 Next.js 前端项目..."
+cd "$WORKSPACE_DIR"
+
+# 1. 创建 Next.js 项目（使用官方 create-next-app）
+npm create next-app@latest "$PROJECT_NAME" \
+  --typescript \
+  --tailwind \
+  --app \
+  --eslint \
+  --import-alias "@/*" \
+  --skip-git \
+  --no-src-dir
+
+cd "$PROJECT_NAME"
+
+# 2. 安装核心依赖
+echo "📦 安装依赖包..."
+npm install \
+  react@18.3.1 \
+  react-dom@18.3.1 \
+  zustand@4.4.7 \
+  @tanstack/react-query@5.36.2 \
+  react-hook-form@7.52.0 \
+  zod@3.23.5 \
+  lucide-react@0.408.0 \
+  class-variance-authority@0.7.0 \
+  clsx@2.1.0 \
+  tailwind-merge@2.3.0
+
+# 3. 安装 shadcn/ui 和开发工具
+npm install --save-dev \
+  @types/node@20.11.5 \
+  @types/react@18.2.48 \
+  @types/react-dom@18.2.18 \
+  typescript@5.3.3 \
+  autoprefixer@10.4.17 \
+  postcss@8.4.33 \
+  prettier@3.1.1 \
+  eslint@8.56.0 \
+  eslint-config-next@15.0.0 \
+  @typescript-eslint/parser@6.16.0 \
+  @typescript-eslint/eslint-plugin@6.16.0 \
+  eslint-plugin-react@7.33.2 \
+  eslint-plugin-react-hooks@4.6.0
+
+# 4. 创建项目目录结构
+echo "📁 创建项目目录结构..."
+
+mkdir -p \
+  src/components/ui \
+  src/components/common \
+  src/components/layout \
+  src/features \
+  src/hooks \
+  src/lib \
+  src/types \
+  src/constants \
+  src/config \
+  src/styles \
+  src/providers \
+  tests/unit \
+  tests/integration \
+  tests/__mocks__ \
+  public/images \
+  public/icons
+
+# 5. 创建核心配置文件
+echo "⚙️  创建配置文件..."
+
+# TypeScript 配置
+cat > tsconfig.json << 'EOF'
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noImplicitReturns": true,
+    "forceConsistentCasingInFileNames": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "allowSyntheticDefaultImports": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"],
+      "@/components/*": ["src/components/*"],
+      "@/lib/*": ["src/lib/*"],
+      "@/types/*": ["src/types/*"],
+      "@/hooks/*": ["src/hooks/*"],
+      "@/config/*": ["src/config/*"],
+      "@/styles/*": ["src/styles/*"],
+      "@/constants/*": ["src/constants/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules"]
+}
+EOF
+
+# ESLint 配置
+cat > .eslintrc.json << 'EOF'
+{
+  "extends": ["next/core-web-vitals", "next/typescript"],
+  "rules": {
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/no-unused-vars": "error",
+    "react-hooks/rules-of-hooks": "error",
+    "react-hooks/exhaustive-deps": "warn",
+    "react/prop-types": "off",
+    "no-console": ["warn", { "allow": ["warn", "error"] }]
+  }
+}
+EOF
+
+# Prettier 配置
+cat > .prettierrc << 'EOF'
+{
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "jsxBracketSameLine": false,
+  "arrowParens": "always"
+}
+EOF
+
+# Next.js 配置
+cat > next.config.js << 'EOF'
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  reactStrictMode: true,
+  swcMinify: true,
+  images: {
+    formats: ['image/avif', 'image/webp'],
+    remotePatterns: [],
+  },
+  typescript: {
+    tsconfigPath: './tsconfig.json',
+  },
+};
+
+module.exports = nextConfig;
+EOF
+
+# 6. 创建 Tailwind 配置和主题
+cat > tailwind.config.ts << 'EOF'
+import type { Config } from 'tailwindcss'
+import defaultTheme from 'tailwindcss/defaultTheme'
+
+const config: Config = {
+  darkMode: ['class'],
+  content: [
+    './src/pages/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/components/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/app/**/*.{js,ts,jsx,tsx,mdx}',
+  ],
+  theme: {
+    extend: {
+      fontFamily: {
+        sans: ['var(--font-sans)', ...defaultTheme.fontFamily.sans],
+      },
+      colors: {
+        border: 'hsl(var(--color-border))',
+        input: 'hsl(var(--color-input))',
+        ring: 'hsl(var(--color-ring))',
+        background: 'hsl(var(--color-background))',
+        foreground: 'hsl(var(--color-foreground))',
+        primary: {
+          DEFAULT: 'hsl(var(--color-primary))',
+          foreground: 'hsl(var(--color-primary-foreground))',
+        },
+        secondary: {
+          DEFAULT: 'hsl(var(--color-secondary))',
+          foreground: 'hsl(var(--color-secondary-foreground))',
+        },
+        destructive: {
+          DEFAULT: 'hsl(var(--color-destructive))',
+          foreground: 'hsl(var(--color-destructive-foreground))',
+        },
+        muted: {
+          DEFAULT: 'hsl(var(--color-muted))',
+          foreground: 'hsl(var(--color-muted-foreground))',
+        },
+        accent: {
+          DEFAULT: 'hsl(var(--color-accent))',
+          foreground: 'hsl(var(--color-accent-foreground))',
+        },
+      },
+      borderRadius: {
+        lg: 'var(--radius-lg)',
+        md: 'var(--radius-md)',
+        sm: 'var(--radius-sm)',
+      },
+    },
+  },
+  plugins: [require('tailwindcss-animate')],
+}
+
+export default config
+EOF
+
+# 7. 创建全局样式和主题变量
+mkdir -p src/styles
+cat > src/styles/globals.css << 'EOF'
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+  :root {
+    --font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
+      'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
+      sans-serif;
+
+    /* Light Mode (Default) */
+    --color-border: 220 13% 91%;
+    --color-input: 220 13% 91%;
+    --color-ring: 215 100% 46%;
+
+    --color-background: 0 0% 100%;
+    --color-foreground: 220 9% 12%;
+
+    --color-primary: 215 100% 46%;
+    --color-primary-foreground: 220 9% 12%;
+
+    --color-secondary: 217 33% 17%;
+    --color-secondary-foreground: 210 40% 96%;
+
+    --color-destructive: 0 84% 60%;
+    --color-destructive-foreground: 210 40% 96%;
+
+    --color-muted: 220 13% 91%;
+    --color-muted-foreground: 217 33% 40%;
+
+    --color-accent: 38 92% 50%;
+    --color-accent-foreground: 220 9% 12%;
+
+    --radius-lg: 0.5rem;
+    --radius-md: 0.375rem;
+    --radius-sm: 0.25rem;
+  }
+
+  .dark {
+    --color-border: 217 33% 17%;
+    --color-input: 217 33% 17%;
+    --color-ring: 215 100% 46%;
+
+    --color-background: 220 9% 8%;
+    --color-foreground: 210 40% 96%;
+
+    --color-primary: 215 100% 46%;
+    --color-primary-foreground: 220 9% 12%;
+
+    --color-secondary: 210 40% 96%;
+    --color-secondary-foreground: 217 33% 17%;
+
+    --color-destructive: 0 84% 60%;
+    --color-destructive-foreground: 0 0% 100%;
+
+    --color-muted: 217 33% 17%;
+    --color-muted-foreground: 215 14% 55%;
+
+    --color-accent: 38 92% 50%;
+    --color-accent-foreground: 220 9% 12%;
+  }
+}
+
+@layer base {
+  body {
+    @apply bg-background text-foreground;
+  }
+}
+EOF
+
+# 8. 创建 package.json 脚本
+cat > package.json << 'EOF'
+{
+  "name": "huhaa-myskills-web",
+  "version": "1.0.0",
+  "description": "HuHaa MySkills - 前端应用",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "format": "prettier --write \"src/**/*.{ts,tsx,json,css}\"",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx,json,css}\"",
+    "type-check": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "dependencies": {
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "next": "^15.0.0",
+    "zustand": "^4.4.7",
+    "@tanstack/react-query": "^5.36.2",
+    "react-hook-form": "^7.52.0",
+    "zod": "^3.23.5",
+    "lucide-react": "^0.408.0",
+    "class-variance-authority": "^0.7.0",
+    "clsx": "^2.1.0",
+    "tailwind-merge": "^2.3.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "@types/node": "^20.11.5",
+    "@types/react": "^18.2.48",
+    "@types/react-dom": "^18.2.18",
+    "tailwindcss": "^3.4.1",
+    "postcss": "^8.4.33",
+    "autoprefixer": "^10.4.17",
+    "prettier": "^3.1.1",
+    "eslint": "^8.56.0",
+    "eslint-config-next": "^15.0.0",
+    "@typescript-eslint/parser": "^6.16.0",
+    "@typescript-eslint/eslint-plugin": "^6.16.0",
+    "eslint-plugin-react": "^7.33.2",
+    "eslint-plugin-react-hooks": "^4.6.0",
+    "jest": "^29.7.0",
+    "@testing-library/react": "^14.1.2",
+    "@testing-library/jest-dom": "^6.1.5"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "npm": ">=10.0.0"
+  }
+}
+EOF
+
+# 9. 创建示例组件结构
+cat > src/types/index.ts << 'EOF'
+/**
+ * 全局类型定义
+ * 按功能模块组织，避免类型定义分散
+ */
+
+// 通用类型
+export interface BaseResponse<T> {
+  code: number
+  message: string
+  data: T
+}
+
+export interface PaginatedResponse<T> {
+  items: T[]
+  total: number
+  page: number
+  pageSize: number
+}
+
+// 用户相关
+export interface User {
+  id: string
+  name: string
+  email: string
+  avatar?: string
+  createdAt: string
+}
+
+// 技能相关
+export interface Skill {
+  id: string
+  name: string
+  description: string
+  category: string
+  level: 1 | 2 | 3 | 4 | 5
+  createdAt: string
+}
+EOF
+
+cat > src/lib/cn.ts << 'EOF'
+import { type ClassValue, clsx } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+/**
+ * 合并 Tailwind CSS 类名
+ * 处理 Tailwind 类名冲突
+ */
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}
+EOF
+
+echo "✅ 项目初始化完成！"
+echo ""
+echo "📋 后续步骤："
+echo "1. cd $PROJECT_NAME"
+echo "2. npm run dev"
+echo "3. 访问 http://localhost:3000"
+echo ""
+echo "📚 规范文档："
+echo "   - TypeScript Strict 模式已启用"
+echo "   - Tailwind CSS + CSS Variables 主题系统就绪"
+echo "   - shadcn/ui 组件库已配置"
+echo "   - ESLint + Prettier 自动格式化已启用"
+echo ""

package/scripts/install-and-sync.sh

@@ -0,0 +1,209 @@
+#!/bin/bash
+
+###############################################################################
+# HuHaa-MySkills 远程安装与技能同步入口 (v0.1.5)
+#
+# 用法：
+#   curl -fsSL https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills/main/install-and-sync.sh | bash
+#   或
+#   curl -fsSL https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills/main/install-and-sync.sh | bash -s -- --sync-only
+#
+# 参数：
+#   --sync-only    只执行同步，不安装
+#   --local PATH   使用本地项目路径
+#   --branch NAME  指定分支（默认 main）
+#
+###############################################################################
+
+set -euo pipefail
+
+# 配置
+REPO_URL="https://github.com/aquarkgn/HuHaa-MySkills.git"
+REPO_RAW="https://raw.githubusercontent.com/aquarkgn/HuHaa-MySkills"
+BRANCH="main"
+SYNC_ONLY=false
+LOCAL_PATH=""
+
+# 颜色定义
+readonly BLUE='\033[0;34m'
+readonly GREEN='\033[0;32m'
+readonly YELLOW='\033[1;33m'
+readonly RED='\033[0;31m'
+readonly CYAN='\033[0;36m'
+readonly NC='\033[0m'
+
+# 日志函数
+log_info() { echo -e "${BLUE}ℹ${NC} $*"; }
+log_success() { echo -e "${GREEN}✓${NC} $*"; }
+log_warn() { echo -e "${YELLOW}⚠${NC} $*"; }
+log_error() { echo -e "${RED}✗${NC} $*" >&2; }
+
+# 解析命令行参数
+parse_args() {
+  while [[ $# -gt 0 ]]; do
+    case "$1" in
+      --sync-only)
+        SYNC_ONLY=true
+        shift
+        ;;
+      --local)
+        LOCAL_PATH="$2"
+        SYNC_ONLY=true
+        shift 2
+        ;;
+      --branch)
+        BRANCH="$2"
+        shift 2
+        ;;
+      *)
+        log_error "未知参数: $1"
+        exit 1
+        ;;
+    esac
+  done
+}
+
+# 获取临时目录
+get_temp_dir() {
+  if command -v mktemp &>/dev/null; then
+    mktemp -d
+  else
+    local tmpdir="/tmp/huhaa-myskills-$$"
+    mkdir -p "$tmpdir"
+    echo "$tmpdir"
+  fi
+}
+
+# 检查依赖
+check_deps() {
+  if ! command -v curl &>/dev/null; then
+    log_error "需要 curl，请先安装"
+    exit 1
+  fi
+
+  if ! $SYNC_ONLY && ! command -v git &>/dev/null; then
+    log_error "需要 git，请先安装"
+    exit 1
+  fi
+}
+
+# 下载并执行同步脚本
+download_and_sync() {
+  local sync_script_url="$REPO_RAW/$BRANCH/service/scripts/sync-skills.sh"
+
+  log_info "下载同步脚本..."
+
+  local temp_script
+  temp_script=$(mktemp)
+  trap "rm -f '$temp_script'" EXIT
+
+  if ! curl -fsSL "$sync_script_url" -o "$temp_script"; then
+    log_error "下载失败: $sync_script_url"
+    return 1
+  fi
+
+  if [[ -n "$LOCAL_PATH" ]]; then
+    export HUHAA_LOCAL_PATH="$LOCAL_PATH"
+  fi
+
+  log_success "同步脚本已下载"
+
+  # 执行同步脚本
+  bash "$temp_script"
+}
+
+# 本地安装（git clone）
+local_install() {
+  local temp_dir
+  temp_dir=$(get_temp_dir)
+  trap "rm -rf '$temp_dir'" EXIT
+
+  log_info "克隆项目仓库..."
+
+  if ! git clone --depth 1 --branch "$BRANCH" "$REPO_URL" "$temp_dir"; then
+    log_error "克隆失败"
+    return 1
+  fi
+
+  local_path="$temp_dir"
+  log_success "项目已克隆到临时目录"
+
+  # 执行同步
+  export HUHAA_LOCAL_PATH="$local_path"
+  download_and_sync
+}
+
+# 检查 npm 全局安装
+npm_install() {
+  if ! command -v npm &>/dev/null; then
+    log_warn "未安装 npm，跳过全局安装"
+    return 0
+  fi
+
+  log_info "正在进行 npm 全局安装..."
+
+  if npm install -g "github:aquarkgn/HuHaa-MySkills#$BRANCH"; then
+    log_success "npm 全局安装完成"
+
+    # 获取安装位置
+    local npm_prefix
+    npm_prefix=$(npm prefix -g)
+    export HUHAA_LOCAL_PATH="$npm_prefix/node_modules/huhaa-myskills"
+
+    return 0
+  else
+    log_warn "npm 全局安装失败，将使用远程脚本"
+    return 1
+  fi
+}
+
+# 主函数
+main() {
+  echo -e "\n${CYAN}╔════════════════════════════════════════════════════════╗${NC}"
+  echo -e "${CYAN}║     HuHaa-MySkills v0.1.5 - 编辑器技能自动同步        ║${NC}"
+  echo -e "${CYAN}╚════════════════════════════════════════════════════════╝${NC}\n"
+
+  parse_args "$@"
+  check_deps
+
+  if $SYNC_ONLY; then
+    log_info "执行同步模式"
+    if [[ -z "$LOCAL_PATH" ]]; then
+      # 只下载并执行远程脚本
+      download_and_sync
+    else
+      # 使用本地路径
+      if [[ ! -d "$LOCAL_PATH" ]]; then
+        log_error "本地路径不存在: $LOCAL_PATH"
+        exit 1
+      fi
+      export HUHAA_LOCAL_PATH="$LOCAL_PATH"
+      download_and_sync
+    fi
+  else
+    log_info "执行完整安装 + 同步流程"
+
+    # 尝试 npm 全局安装
+    if ! npm_install; then
+      # 如果 npm 安装失败，使用 git clone
+      log_info "使用 git clone 方式安装"
+      local_install
+    else
+      # npm 安装成功，执行同步
+      download_and_sync
+    fi
+  fi
+
+  echo -e "\n${GREEN}╔════════════════════════════════════════════════════════╗${NC}"
+  echo -e "${GREEN}║                   ✨ 同步完成！ ✨                    ║${NC}"
+  echo -e "${GREEN}╚════════════════════════════════════════════════════════╝${NC}\n"
+
+  log_info "后续步骤："
+  echo "  1. 启动 HuHaa: npm start"
+  echo "  2. 查看技能中心: http://localhost:11520"
+  echo "  3. 在编辑器中使用你的技能"
+  echo -e "\n更多信息: https://github.com/aquarkgn/HuHaa-MySkills\n"
+}
+
+# 执行主程序
+main "$@"

package/scripts/start-dev.sh

@@ -0,0 +1,72 @@
+#!/bin/bash
+
+# HuHaa-MySkills 智能启动脚本 - 完全后台运行
+# 功能：后台启动，自动处理端口占用，重启本服务或切换端口
+
+DEFAULT_PORT=11522
+PORT=$DEFAULT_PORT
+MAX_ATTEMPTS=5
+ATTEMPT=0
+
+# 日志文件
+LOG_FILE="/tmp/huhaa-myskills-dev.log"
+
+# 检查端口是否被占用
+check_port() {
+  lsof -i :$1 >/dev/null 2>&1
+  return $?
+}
+
+# 获取占用端口的进程信息
+get_process_info() {
+  lsof -ti :$1 2>/dev/null | head -1
+}
+
+# 检查是否为本服务进程
+is_our_process() {
+  pid=$1
+  if [ -z "$pid" ]; then return 1; fi
+  ps -p $pid 2>/dev/null | grep -E "huhaa-myskills|node.*bin" >/dev/null 2>&1
+  return $?
+}
+
+# 主逻辑（后台运行）
+{
+  ATTEMPT=0
+  while [ $ATTEMPT -lt $MAX_ATTEMPTS ]; do
+    if check_port $PORT; then
+      # 端口被占用
+      pid=$(get_process_info $PORT)
+      if is_our_process $pid; then
+        echo "[$(date +'%Y-%m-%d %H:%M:%S')] ✓ Service already running on port $PORT (PID: $pid)"
+        # 杀死旧进程并重启
+        kill -9 $pid 2>/dev/null
+        sleep 1
+        nohup npm run start >/dev/null 2>&1 &
+        sleep 2
+        echo "[$(date +'%Y-%m-%d %H:%M:%S')] ✓ Service restarted on port $PORT"
+        exit 0
+      else
+        echo "[$(date +'%Y-%m-%d %H:%M:%S')] ⚠ Port $PORT occupied by other process (PID: $pid), trying $((PORT + 1))..."
+        PORT=$((PORT + 1))
+        ATTEMPT=$((ATTEMPT + 1))
+      fi
+    else
+      # 端口空闲，启动服务
+      echo "[$(date +'%Y-%m-%d %H:%M:%S')] Starting HuHaa-MySkills on port $PORT..."
+      nohup npm run start >/dev/null 2>&1 &
+      sleep 2
+      echo "[$(date +'%Y-%m-%d %H:%M:%S')] ✓ Service started on port $PORT"
+      exit 0
+    fi
+  done
+
+  echo "[$(date +'%Y-%m-%d %H:%M:%S')] ✗ Failed to start: no available ports"
+  exit 1
+} >> $LOG_FILE 2>&1 &
+
+# 立即返回（真正的后台运行）
+exec 2>/dev/null
+exit 0
+
+