dk-frontend-skills 2.1.1 → 2.1.3

package/package.json

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

package/scripts/cli.js

@@ -6,7 +6,14 @@ const { getPackageSkills, getUserSkills } = require("./core");
 
 // npx 运行时：process.cwd() 是用户项目目录
 // __dirname 是包内 scripts/ 目录
-const projectRoot = process.cwd();
+// 用 fs.realpathSync.native() 归一化 Windows 路径，处理中文/Unicode 编码问题
+const projectRoot = (() => {
+  try {
+    return fs.realpathSync.native(process.cwd());
+  } catch {
+    return process.cwd();
+  }
+})();
 const packageDir = path.join(__dirname, "..");
 const claudeDest = path.join(projectRoot, ".claude");
 const skillsDest = path.join(claudeDest, "skills");
@@ -16,7 +23,8 @@ const pkgSkillsSource = path.join(packageDir, ".claude", "skills");
 // ---------- 文件写入 ----------
 
 function readSettings() {
-  if (!fs.existsSync(settingsPath)) return { skills: {}, always_apply_skills: [] };
+  if (!fs.existsSync(settingsPath))
+    return { skills: {}, always_apply_skills: [] };
   try {
     return JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
   } catch {
@@ -28,11 +36,29 @@ function writeSettings(settings) {
   if (!fs.existsSync(claudeDest)) {
     fs.mkdirSync(claudeDest, { recursive: true });
   }
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+  fs.writeFileSync(
+    settingsPath,
+    JSON.stringify(settings, null, 2) + "\n",
+    "utf-8",
+  );
 }
 
 // ---------- 安装勾选的技能 ----------
 
+// 手动递归拷贝目录，绕开 Windows 中文路径下 fs.cpSync({ recursive: true }) 死锁的 bug
+function copyDirSync(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const item of fs.readdirSync(src)) {
+    const srcPath = path.join(src, item);
+    const destPath = path.join(dest, item);
+    if (fs.statSync(srcPath).isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
 function installSelectedSkills(selectedNames) {
   // 创建 .claude/ 和 skills/ 目录
   if (!fs.existsSync(skillsDest)) {
@@ -49,8 +75,12 @@ function installSelectedSkills(selectedNames) {
     if (selectedNames.includes(name)) {
       // 勾选了的 → 安装（不存在才装）
       if (!fs.existsSync(dest)) {
-        fs.cpSync(src, dest, { recursive: true });
-        installedCount++;
+        try {
+          copyDirSync(src, dest);
+          installedCount++;
+        } catch (err) {
+          console.error(`  ❌ 安装技能 "${name}" 失败:`, err.message);
+        }
       }
     } else {
       // 没勾选的 → 如果之前装了，删掉
@@ -108,13 +138,15 @@ async function cmdList() {
   const allSkills = [...skillMap.values()];
 
   console.log(`\n${chalk.bold("📋 dk-frontend-skills 技能清单")}\n`);
-  console.log(`  ${chalk.dim("状态        技能名                版本    描述")}`);
-  console.log(`  ${chalk.dim("─────────────────────────────────────────────────────")}`);
+  console.log(
+    `  ${chalk.dim("状态        技能名                版本    描述")}`,
+  );
+  console.log(
+    `  ${chalk.dim("─────────────────────────────────────────────────────")}`,
+  );
 
   for (const skill of allSkills) {
-    const status = skill.enabled
-      ? chalk.green("● 启用")
-      : chalk.gray("○ 停用");
+    const status = skill.enabled ? chalk.green("● 启用") : chalk.gray("○ 停用");
     const name = chalk.white(skill.name.padEnd(20));
     const ver = chalk.dim(skill.version.padEnd(7));
     const desc = skill.description
@@ -123,7 +155,9 @@ async function cmdList() {
     console.log(`  ${status}  ${name} ${ver} ${desc}`);
   }
 
-  console.log(`\n  ${chalk.cyan("💡")} ${chalk.dim("运行 npx dk-frontend-skills 进入交互选择模式")}\n`);
+  console.log(
+    `\n  ${chalk.cyan("💡")} ${chalk.dim("运行 npx dk-frontend-skills 进入交互选择模式")}\n`,
+  );
 }
 
 // ---------- 交互式菜单（选完即装） ----------
@@ -172,7 +206,9 @@ async function startInteractiveMenu() {
   });
 
   const newCount = selected.filter((name) => !installedSet.has(name)).length;
-  const removedCount = [...installedSet].filter((name) => !selected.includes(name)).length;
+  const removedCount = [...installedSet].filter(
+    (name) => !selected.includes(name),
+  ).length;
 
   const installed = installSelectedSkills(selected);
 
@@ -212,7 +248,9 @@ async function main() {
   } else if (command === "list") {
     await cmdList();
   } else if (command === "enable" || command === "disable") {
-    console.log(`  ⚠️  该命令已废弃，请直接运行 npx dk-frontend-skills 使用交互菜单\n`);
+    console.log(
+      `  ⚠️  该命令已废弃，请直接运行 npx dk-frontend-skills 使用交互菜单\n`,
+    );
   } else {
     console.log(`  未知命令: ${command}\n  可用: ${COMMANDS.join(", ")}\n`);
     process.exit(1);

package/scripts/copy-skills.js

@@ -4,12 +4,15 @@ const {
   backupTimestamp,
   appendLog,
   backupDir,
+  copyDirSync,
   installSkills,
   installSettings,
 } = require("./core");
 
 // 获取用户项目根目录
-const projectRoot = path.resolve(__dirname, "..", "..", "..");
+// npm lifecycle 脚本会设置 INIT_CWD 为执行命令时的目录，比从 __dirname 爬三级更可靠
+const projectRoot =
+  process.env.INIT_CWD || path.resolve(__dirname, "..", "..", "..");
 const packageDir = path.join(__dirname, "..");
 
 // 源路径
@@ -41,7 +44,7 @@ if (fs.existsSync(claudeSource)) {
   } else {
     // 全新安装
     appendLog(logFile, "INFO", "Install started (fresh)");
-    fs.cpSync(claudeSource, claudeDest, { recursive: true });
+    copyDirSync(claudeSource, claudeDest);
     appendLog(logFile, "INFO", `.claude/ directory created`);
   }
 }
@@ -59,7 +62,11 @@ 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)`);
+    appendLog(
+      logFile,
+      "BACKUP",
+      `backups/${bakName} (CLAUDE.md user version preserved)`,
+    );
   }
 }
 

package/scripts/core.js

@@ -46,7 +46,7 @@ function backupDir(dir) {
 
   for (const item of fs.readdirSync(dir)) {
     if (item === "backups") continue;
-    fs.cpSync(path.join(dir, item), path.join(bakPath, item), { recursive: true });
+    copyDirSync(path.join(dir, item), path.join(bakPath, item));
   }
 
   // 清理旧备份，只保留最近 3 份
@@ -70,6 +70,22 @@ function isPlainObject(val) {
   return Object.prototype.toString.call(val) === "[object Object]";
 }
 
+/**
+ * 手动递归拷贝目录，绕开 Windows 中文路径下 fs.cpSync({ recursive: true }) 死锁的 bug
+ */
+function copyDirSync(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const item of fs.readdirSync(src)) {
+    const srcPath = path.join(src, item);
+    const destPath = path.join(dest, item);
+    if (fs.statSync(srcPath).isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
 /**
  * 递归深合并，用户值优先，目标新增字段补充
  */
@@ -122,7 +138,7 @@ function installSkills(skillsSource, skillsDest, logFile) {
     const version = meta ? meta.version : "?";
 
     if (!fs.existsSync(destSkill)) {
-      fs.cpSync(srcSkill, destSkill, { recursive: true });
+      copyDirSync(srcSkill, destSkill);
       appendLog(logFile, "SKILL", `${dir} (${version}) → installed`);
       results.push({ name: dir, version, action: "installed" });
     } else {
@@ -132,9 +148,9 @@ function installSkills(skillsSource, skillsDest, logFile) {
       if (needUpdate) {
         const bakName = `${dir}.bak.${backupTimestamp()}`;
         const bakPath = path.join(skillsDest, bakName);
-        fs.cpSync(destSkill, bakPath, { recursive: true });
+        copyDirSync(destSkill, bakPath);
         fs.rmSync(destSkill, { recursive: true, force: true });
-        fs.cpSync(srcSkill, destSkill, { recursive: true });
+        copyDirSync(srcSkill, destSkill);
         appendLog(logFile, "SKILL", `${dir} (${destMeta.version} → ${meta.version}) → updated`);
         results.push({ name: dir, version: meta.version, action: "updated" });
       } else {
@@ -230,6 +246,7 @@ module.exports = {
   backupTimestamp,
   appendLog,
   backupDir,
+  copyDirSync,
   deepMerge,
   readMeta,
   installSkills,