dk-frontend-skills 3.0.0 → 3.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dk-frontend-skills",
-  "version": "3.0.0",
+  "version": "3.0.2",
   "description": "dk-engineer - 幽默沉稳靠谱的前端开发助手 Claude Skills 配置包，一键注入 .claude/ 技能目录和 CLAUDE.md 人设配置",
   "author": "XiaoMa",
   "license": "MIT",

package/scripts/cli.js

@@ -52,80 +52,62 @@ function writeSettings(settings) {
 
 async function downloadAndInstallSkill(name, index) {
   const skillInfo = index.skills[name];
-  if (!skillInfo) {
-    console.error(`  ❌ 技能 "${name}" 不在索引中`);
-    return false;
-  }
+  if (!skillInfo) return false;
 
   const destDir = path.join(skillsDest, name);
 
-  // 检查本地是否已安装且版本一致
+  // 检查本地版本
   const localMetaPath = path.join(destDir, ".meta.json");
   if (fs.existsSync(localMetaPath)) {
     try {
       const localMeta = JSON.parse(fs.readFileSync(localMetaPath, "utf-8"));
-      if (localMeta.version === skillInfo.version) {
-        return true; // 已是最新，跳过
-      }
-    } catch {
-      // 元信息损坏，重新下载
-    }
+      if (localMeta.version === skillInfo.version) return true;
+    } catch {}
   }
 
-  // 构造下载地址
   const url = `${index.baseUrl}/${skillInfo.fileName}`;
   const tempDir = path.join(claudeDest, ".temp");
-  if (!fs.existsSync(tempDir)) {
-    fs.mkdirSync(tempDir, { recursive: true });
-  }
-  const tempFile = path.join(tempDir, skillInfo.fileName);
+  if (!fs.existsSync(tempDir)) fs.mkdirSync(tempDir, { recursive: true });
 
-  // 下载带进度条
   const { SingleBar, Presets } = await import("cli-progress");
-  const bar = new SingleBar(
-    {
-      format: `  📥 ${name} |{bar}| {percentage}% | {value}/{total} bytes`,
-      barCompleteChar: "\u2588",
-      barIncompleteChar: "\u2591",
-      hideCursor: true,
-    },
-    Presets.shades_classic,
-  );
+  const bar = new SingleBar({
+    format: `  ${name} |{bar}| {percentage}%`,
+    barCompleteChar: "\u2588",
+    barIncompleteChar: "\u2591",
+    hideCursor: true,
+  }, Presets.shades_classic);
 
-  try {
-    console.log(`  ⏬ 正在下载 ${name} (${skillInfo.version})...`);
-    bar.start(skillInfo.size || 100, 0);
-    await downloadFile(url, tempFile, (downloaded, total) => {
-      bar.setTotal(total || skillInfo.size || 100);
-      bar.update(downloaded);
-    });
-    bar.stop();
-
-    // 创建目标目录，解压
-    if (fs.existsSync(destDir)) {
-      fs.rmSync(destDir, { recursive: true, force: true });
+  const MAX_RETRIES = 3;
+
+  for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
+    const tempFile = path.join(tempDir, skillInfo.fileName);
+    try {
+      if (attempt > 1) console.log(`  ↻ ${name} 重试第 ${attempt} 次...`);
+      bar.start(100, 0);
+      await downloadFile(url, tempFile, (d, t) => {
+        bar.setTotal(t || skillInfo.size || 100);
+        bar.update(d);
+      });
+      bar.stop();
+
+      if (fs.existsSync(destDir)) fs.rmSync(destDir, { recursive: true, force: true });
+      fs.mkdirSync(destDir, { recursive: true });
+
+      await tar.x({ file: tempFile, C: destDir });
+
+      fs.rmSync(tempFile, { force: true });
+      return true;
+    } catch (err) {
+      bar.stop();
+      if (fs.existsSync(tempFile)) fs.rmSync(tempFile, { force: true });
+      if (fs.existsSync(destDir)) fs.rmSync(destDir, { recursive: true, force: true });
+      if (attempt === MAX_RETRIES) {
+        console.error(`  ✗ ${name}: ${err.message}`);
+        return false;
+      }
     }
-    fs.mkdirSync(destDir, { recursive: true });
-
-    await tar.x({
-      file: tempFile,
-      C: destDir,
-    });
-
-    // 清理临时文件
-    fs.rmSync(tempFile, { force: true });
-
-    console.log(`  ✅ ${name} (${skillInfo.version}) 安装成功`);
-    return true;
-  } catch (err) {
-    bar.stop();
-    // 清理残留
-    if (fs.existsSync(tempFile)) fs.rmSync(tempFile, { force: true });
-    if (fs.existsSync(destDir))
-      fs.rmSync(destDir, { recursive: true, force: true });
-    console.error(`  ❌ 下载 "${name}" 失败: ${err.message}`);
-    return false;
   }
+  return false;
 }
 
 async function installSelectedSkills(selectedNames) {
@@ -275,11 +257,11 @@ async function startInteractiveMenu() {
   const installed = await installSelectedSkills(selected);
 
   const parts = [];
-  if (newCount > 0) parts.push(`新装 ${newCount} 个`);
-  if (removedCount > 0) parts.push(`移除 ${removedCount} 个`);
-  const summary = parts.length > 0 ? `（${parts.join("，")}）` : "";
+  if (newCount > 0) parts.push(`+${newCount}`);
+  if (removedCount > 0) parts.push(`-${removedCount}`);
+  const summary = parts.length > 0 ? ` ${parts.join(" ")}` : "";
 
-  console.log(`\n  ✅ 技能安装完成 ${summary}\n`);
+  console.log(`  ✅ 完成${summary}\n`);
 }
 
 // ---------- 主入口 ----------

package/scripts/copy-skills.js

@@ -7,7 +7,6 @@ const {
 } = require("./core");
 
 // 获取用户项目根目录
-// npm lifecycle 脚本会设置 INIT_CWD 为执行命令时的目录，比从 __dirname 爬三级更可靠
 const projectRoot =
   process.env.INIT_CWD || path.resolve(__dirname, "..", "..", "..");
 const packageDir = path.join(__dirname, "..");
@@ -25,15 +24,12 @@ const logFile = path.join(claudeDest, ".install.log");
 
 // ===================== 主流程 =====================
 
-console.log("\n📦 dk-frontend-skills 技能包安装开始\n");
-
-// 确保 .claude/ 目录存在
+// 确保 .claude/ 和 skills/ 目录存在
 if (!fs.existsSync(claudeDest)) {
   fs.mkdirSync(claudeDest, { recursive: true });
   appendLog(logFile, "INFO", `.claude/ directory created`);
 }
 
-// 确保 .claude/skills/ 目录存在（不覆盖已有技能）
 const skillsDest = path.join(claudeDest, "skills");
 if (!fs.existsSync(skillsDest)) {
   fs.mkdirSync(skillsDest, { recursive: true });
@@ -55,25 +51,8 @@ if (fs.existsSync(mdSource)) {
     const bakName = `CLAUDE.md.${backupTimestamp()}`;
     const bakPath = path.join(backupsDir, bakName);
     fs.copyFileSync(mdDest, bakPath);
-    appendLog(
-      logFile,
-      "BACKUP",
-      `backups/${bakName} (CLAUDE.md user version preserved)`,
-    );
-  }
-}
-
-// 输出摘要
-console.log("✅ dk-frontend-skills 安装完成！\n");
-
-if (fs.existsSync(logFile)) {
-  const logs = fs.readFileSync(logFile, "utf-8").trim().split("\n");
-  const recent = logs.slice(-10);
-  console.log("📋 操作日志：");
-  for (const line of recent) {
-    console.log(`  ${line}`);
+    appendLog(logFile, "BACKUP", `backups/${bakName} (CLAUDE.md user version preserved)`);
   }
-  console.log("");
 }
 
-console.log("💡 提示：运行 npx dk-skills 可交互选择安装/启用/禁用技能\n");
+console.log("💡 npx dk-skills 可交互选择安装技能\n");

package/scripts/core.js

@@ -206,6 +206,21 @@ function getUserSkills(claudeDest) {
   });
 }
 
+/**
+ * 校验文件是否为有效的 gzip 格式（magic number: 0x1F 0x8B）
+ */
+function isValidGzip(filePath) {
+  try {
+    const fd = fs.openSync(filePath, "r");
+    const buf = Buffer.alloc(2);
+    fs.readSync(fd, buf, 0, 2, 0);
+    fs.closeSync(fd);
+    return buf[0] === 0x1f && buf[1] === 0x8b;
+  } catch {
+    return false;
+  }
+}
+
 /**
  * 从远程下载文件到本地临时路径
  */
@@ -215,6 +230,15 @@ async function downloadFile(url, destPath, onProgress) {
     throw new Error(`HTTP ${response.status} ${response.statusText}`);
   }
 
+  // 检查 Content-Type，如果不是 gzip 大概率是 404 页面
+  const contentType = response.headers.get("content-type") || "";
+  if (!contentType.includes("gzip") && !contentType.includes("octet-stream") && !contentType.includes("binary")) {
+    const text = await response.clone().text();
+    if (text.includes("<!doctype") || text.includes("<html")) {
+      throw new Error("下载链接无效，请检查 GitHub Release 是否存在");
+    }
+  }
+
   const total = parseInt(response.headers.get("content-length") || "0", 10);
   let downloaded = 0;
 
@@ -232,6 +256,12 @@ async function downloadFile(url, destPath, onProgress) {
   } finally {
     writer.close();
   }
+
+  // 下载完后校验 gzip 格式
+  if (fs.existsSync(destPath) && !isValidGzip(destPath)) {
+    fs.rmSync(destPath, { force: true });
+    throw new Error("下载的文件不是有效的压缩包，可能是 GitHub Release 尚未创建或链接错误");
+  }
 }
 
 module.exports = {