harmonyos-skills-pack 0.1.0 → 0.1.2

package/README.md

@@ -1,6 +1,9 @@
 # HarmonyOS Skills Pack
 
-Current Version: 0.1.0
+[![npm version](https://img.shields.io/npm/v/harmonyos-skills-pack.svg)](https://www.npmjs.com/package/harmonyos-skills-pack)
+[![GitHub release](https://img.shields.io/github/v/release/yibaiba/harmonyos-skills-pack)](https://github.com/yibaiba/harmonyos-skills-pack/releases)
+
+Current Version: 0.1.1
 
 这是一个面向 Claude、GitHub Copilot、Codex 等 Coding Agent 的可安装 Skills 项目。
 
@@ -29,13 +32,13 @@ Current Version: 0.1.0
 - 2025 创作激励与审核避坑
 - Starter Kit 极速实现包
 
-其中 starter-kit 已包含：
+其中 starter-kit 已包含 15 个模块模板：
 
-- 登录模块模板
-- 单机离线 / 免登录模块
-- 游客升级登录同步模块
-- 列表页、详情页、表单页、TabBar 模板
+- 登录模块、单机离线/免登录、游客升级登录同步
+- 列表页、详情页、表单页、TabBar 导航
 - 深色模式与多端适配模板
+- 本地数据持久化、后台任务、通知处理
+- WebSocket 实时通信、相机与媒体、支付与计费
 - Day-by-Day 执行顺序与提审前清单
 
 ### 2. universal-product-quality
@@ -67,14 +70,39 @@ Current Version: 0.1.0
 
 ## 快速开始
 
-### 1. 克隆仓库
+### 方式 1：npx 一键安装（推荐）
+
+```bash
+# 安装到当前项目（自动安装到 .claude/.github/.codex/skills）
+npx harmonyos-skills-pack
+
+# 国内用户加速
+npx harmonyos-skills-pack --mirror
+
+# 仅安装到 Claude
+npx harmonyos-skills-pack --claude-only
+
+# 仅安装到 Copilot
+npx harmonyos-skills-pack --copilot-only
+
+# 仅安装到 Codex
+npx harmonyos-skills-pack --codex-only
+
+# 强制覆盖已有文件
+npx harmonyos-skills-pack --force
+
+# 卸载
+npx harmonyos-skills-pack uninstall
+```
+
+### 方式 2：克隆仓库 + 脚本安装
 
 ```bash
-git clone <your-repo-url> harmonyos-skills-pack
+git clone https://github.com/yibaiba/harmonyos-skills-pack.git
 cd harmonyos-skills-pack
 ```
 
-### 2. 安装到 Claude
+### 安装到 Claude
 
 ```bash
 ./scripts/install-skills.sh --claude
@@ -85,7 +113,7 @@ cd harmonyos-skills-pack
 - ~/.claude/skills/harmonyos-ark
 - ~/.claude/skills/universal-product-quality
 
-### 3. 安装到 Copilot 工作区
+### 安装到 Copilot 工作区
 
 ```bash
 ./scripts/install-skills.sh --copilot-workspace /path/to/your/workspace
@@ -96,14 +124,14 @@ cd harmonyos-skills-pack
 - /path/to/your/workspace/.github/skills/harmonyos-ark
 - /path/to/your/workspace/.github/skills/universal-product-quality
 
-### 4. 强制覆盖安装
+### 强制覆盖安装
 
 ```bash
 ./scripts/install-skills.sh --claude --force
 ./scripts/install-skills.sh --copilot-workspace /path/to/your/workspace --force
 ```
 
-### 5. 维护者同步标准目录
+### 维护者同步标准目录
 
 ```bash
 ./scripts/sync-skills.sh

package/bin/cli.js

@@ -23,6 +23,8 @@ const REPO = 'yibaiba/harmonyos-skills-pack';
 const BRANCH = 'main';
 const SKILLS = ['harmonyos-ark', 'universal-product-quality'];
 const ARCHIVE_URL = `https://github.com/${REPO}/archive/refs/heads/${BRANCH}.tar.gz`;
+// 国内镜像（ghproxy.net 加速 GitHub 下载）
+const MIRROR_URL = `https://ghproxy.net/https://github.com/${REPO}/archive/refs/heads/${BRANCH}.tar.gz`;
 
 // ── 颜色输出 ──────────────────────────────────────────
 const color = {
@@ -44,6 +46,7 @@ ${color.cyan('用法:')}
   npx harmonyos-skills-pack              安装到当前目录
   npx harmonyos-skills-pack --target .   指定目标目录
   npx harmonyos-skills-pack --force      强制覆盖已有文件
+  npx harmonyos-skills-pack --mirror     使用国内镜像加速下载
   npx harmonyos-skills-pack --claude-only    仅 .claude/skills
   npx harmonyos-skills-pack --copilot-only   仅 .github/skills
   npx harmonyos-skills-pack --codex-only     仅 .codex/skills
@@ -70,6 +73,7 @@ const force = args.includes('--force');
 const claudeOnly = args.includes('--claude-only');
 const copilotOnly = args.includes('--copilot-only');
 const codexOnly = args.includes('--codex-only');
+const useMirror = args.includes('--mirror') || args.includes('--cn');
 const isUninstall = args.includes('uninstall');
 
 // 默认全部安装
@@ -107,22 +111,36 @@ if (isUninstall) {
 // ── 安装 ─────────────────────────────────────────────
 console.log(`
 ${color.bold('🚀 harmonyos-skills-pack')}
-${color.cyan('从 GitHub 下载最新 skills...')}
+${color.cyan(useMirror ? '从国内镜像下载最新 skills...' : '从 GitHub 下载最新 skills...')}
 `);
 
 // 创建临时目录
 const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'hm-skills-'));
 
 try {
-  // 下载并解压
-  console.log(`  📥 下载 ${ARCHIVE_URL}`);
-
-  try {
-    execSync(`curl -sL "${ARCHIVE_URL}" | tar -xz -C "${tmpDir}"`, {
-      stdio: ['pipe', 'pipe', 'pipe'],
-      timeout: 60000,
-    });
-  } catch (e) {
+  // 下载并解压（镜像优先，失败自动回退 GitHub）
+  const urls = useMirror ? [MIRROR_URL, ARCHIVE_URL] : [ARCHIVE_URL, MIRROR_URL];
+
+  let downloaded = false;
+  for (let i = 0; i < urls.length; i++) {
+    const url = urls[i];
+    const label = url.includes('ghproxy') ? '国内镜像' : 'GitHub';
+    console.log(`  📥 ${i > 0 ? '回退到 ' : ''}下载 (${label})`);
+    try {
+      execSync(`curl -sL --connect-timeout 10 "${url}" | tar -xz -C "${tmpDir}"`, {
+        stdio: ['pipe', 'pipe', 'pipe'],
+        timeout: 60000,
+      });
+      downloaded = true;
+      break;
+    } catch (e) {
+      if (i < urls.length - 1) {
+        console.log(`  ${color.yellow('⚠')} ${label} 下载失败，尝试备用源...`);
+      }
+    }
+  }
+
+  if (!downloaded) {
     console.error(color.red('\n❌ 下载失败。请检查网络连接。'));
     console.error(color.yellow('   可尝试: git clone https://github.com/' + REPO + '.git'));
     process.exit(1);
@@ -167,16 +185,6 @@ try {
     }
   }
 
-  // 复制 AGENTS.md 和 CLAUDE.md 到项目根目录（如果不存在）
-  for (const f of ['AGENTS.md', 'CLAUDE.md']) {
-    const src = path.join(sourceRoot, f);
-    const dst = path.join(targetDir, f);
-    if (fs.existsSync(src) && (!fs.existsSync(dst) || force)) {
-      fs.copyFileSync(src, dst);
-      console.log(`  ${color.green('✓')} ${f}`);
-    }
-  }
-
   // 完成
   console.log(`
 ${color.green(color.bold(`✅ 安装完成！${installed} 个 skill 目录已就位。`))}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harmonyos-skills-pack",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "一键安装鸿蒙 Ark 开发文档 + 通用产品质量 skills pack，适配 Claude/Copilot/Codex Agent",
   "keywords": [
     "harmonyos",