mdk-skills 2.1.3

package/scripts/core.js

@@ -0,0 +1,256 @@
+const fs = require("fs");
+const path = require("path");
+
+// 时间戳格式：YYYY-MM-DD HH:mm:ss
+function timestamp() {
+  const d = new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
+}
+
+// 紧凑时间戳用于备份目录名：YYYYMMDD.HHmmss
+function backupTimestamp() {
+  const d = new Date();
+  const pad = (n) => String(n).padStart(2, "0");
+  return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}.${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
+}
+
+/**
+ * 追加日志到 .claude/.install.log
+ * 需要传入 logFile 路径
+ */
+function appendLog(logFile, level, message) {
+  const dir = path.dirname(logFile);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  const line = `[${timestamp()}] [${level}] ${message}\n`;
+  fs.appendFileSync(logFile, line, "utf-8");
+}
+
+/**
+ * 备份已有目录到 dir/backups/<timestamp>/
+ * 排除 backups/ 自身，清理超过 3 份的旧备份
+ */
+function backupDir(dir) {
+  if (!fs.existsSync(dir)) return null;
+
+  const backupsDir = path.join(dir, "backups");
+  if (!fs.existsSync(backupsDir)) {
+    fs.mkdirSync(backupsDir, { recursive: true });
+  }
+
+  const ts = backupTimestamp();
+  const bakPath = path.join(backupsDir, ts);
+  fs.mkdirSync(bakPath, { recursive: true });
+
+  for (const item of fs.readdirSync(dir)) {
+    if (item === "backups") continue;
+    copyDirSync(path.join(dir, item), path.join(bakPath, item));
+  }
+
+  // 清理旧备份，只保留最近 3 份
+  const backups = fs
+    .readdirSync(backupsDir)
+    .filter((name) => /^\d{8}\.\d{6}$/.test(name))
+    .sort()
+    .reverse();
+
+  if (backups.length > 3) {
+    for (const old of backups.slice(3)) {
+      const oldPath = path.join(backupsDir, old);
+      fs.rmSync(oldPath, { recursive: true, force: true });
+    }
+  }
+
+  return bakPath;
+}
+
+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);
+    }
+  }
+}
+
+/**
+ * 递归深合并，用户值优先，目标新增字段补充
+ */
+function deepMerge(userObj, pkgObj) {
+  const result = { ...userObj };
+
+  for (const key of Object.keys(pkgObj)) {
+    if (!(key in result)) {
+      result[key] = pkgObj[key];
+    } else if (isPlainObject(pkgObj[key]) && isPlainObject(result[key])) {
+      result[key] = deepMerge(result[key], pkgObj[key]);
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 读取技能目录下的 .meta.json，没有则返回 null
+ */
+function readMeta(skillDir) {
+  const metaPath = path.join(skillDir, ".meta.json");
+  if (fs.existsSync(metaPath)) {
+    try {
+      return JSON.parse(fs.readFileSync(metaPath, "utf-8"));
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+/**
+ * 安装技能：逐个复制，补缺不覆盖
+ */
+function installSkills(skillsSource, skillsDest, logFile) {
+  if (!fs.existsSync(skillsSource)) return [];
+
+  if (!fs.existsSync(skillsDest)) {
+    fs.mkdirSync(skillsDest, { recursive: true });
+  }
+
+  const skillDirs = fs.readdirSync(skillsSource);
+  const results = [];
+
+  for (const dir of skillDirs) {
+    const srcSkill = path.join(skillsSource, dir);
+    const destSkill = path.join(skillsDest, dir);
+    const meta = readMeta(srcSkill);
+    const version = meta ? meta.version : "?";
+
+    if (!fs.existsSync(destSkill)) {
+      copyDirSync(srcSkill, destSkill);
+      appendLog(logFile, "SKILL", `${dir} (${version}) → installed`);
+      results.push({ name: dir, version, action: "installed" });
+    } else {
+      const destMeta = readMeta(destSkill);
+      const needUpdate = meta && destMeta && meta.version !== destMeta.version;
+
+      if (needUpdate) {
+        const bakName = `${dir}.bak.${backupTimestamp()}`;
+        const bakPath = path.join(skillsDest, bakName);
+        copyDirSync(destSkill, bakPath);
+        fs.rmSync(destSkill, { recursive: true, force: true });
+        copyDirSync(srcSkill, destSkill);
+        appendLog(logFile, "SKILL", `${dir} (${destMeta.version} → ${meta.version}) → updated`);
+        results.push({ name: dir, version: meta.version, action: "updated" });
+      } else {
+        appendLog(logFile, "SKILL", `${dir} (${version}) → skipped (exists)`);
+        results.push({ name: dir, version, action: "skipped" });
+      }
+    }
+  }
+
+  return results;
+}
+
+/**
+ * 安装 settings.json，深度合并
+ */
+function installSettings(sourceDir, destDir, logFile) {
+  const settingsSource = path.join(sourceDir, "settings.json");
+  const settingsDest = path.join(destDir, "settings.json");
+  const localSource = path.join(sourceDir, "settings.local.json");
+  const localDest = path.join(destDir, "settings.local.json");
+
+  for (const { src, dest, name } of [
+    { src: settingsSource, dest: settingsDest, name: "settings.json" },
+    { src: localSource, dest: localDest, name: "settings.local.json" },
+  ]) {
+    if (!fs.existsSync(src)) continue;
+
+    if (fs.existsSync(dest)) {
+      const userData = JSON.parse(fs.readFileSync(dest, "utf-8"));
+      const pkgData = JSON.parse(fs.readFileSync(src, "utf-8"));
+      const merged = deepMerge(userData, pkgData);
+      fs.writeFileSync(dest, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+      appendLog(logFile, "SETTINGS", `${name} merged`);
+    } else {
+      fs.copyFileSync(src, dest);
+      appendLog(logFile, "SETTINGS", `${name} created`);
+    }
+  }
+}
+
+/**
+ * 获取包内的技能列表（带元信息）
+ */
+function getPackageSkills(packageDir) {
+  const skillsSource = path.join(packageDir, ".claude", "skills");
+  if (!fs.existsSync(skillsSource)) return [];
+
+  return fs.readdirSync(skillsSource).map((name) => {
+    const meta = readMeta(path.join(skillsSource, name));
+    return {
+      name,
+      version: meta ? meta.version : "?",
+      description: meta ? meta.description : "",
+      tags: meta ? meta.tags : [],
+    };
+  });
+}
+
+/**
+ * 获取用户已安装的技能及其 settings 中的 enabled 状态
+ */
+function getUserSkills(claudeDest) {
+  const skillsDest = path.join(claudeDest, "skills");
+  if (!fs.existsSync(skillsDest)) return [];
+
+  const settingsPath = path.join(claudeDest, "settings.json");
+  let settings = {};
+  if (fs.existsSync(settingsPath)) {
+    try {
+      settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+    } catch {
+      settings = {};
+    }
+  }
+
+  const skillConfigs = settings.skills || {};
+
+  return fs.readdirSync(skillsDest).map((name) => {
+    const meta = readMeta(path.join(skillsDest, name));
+    const config = skillConfigs[name] || {};
+    return {
+      name,
+      version: meta ? meta.version : "?",
+      description: meta ? meta.description : config.description || "",
+      tags: meta ? meta.tags : [],
+      enabled: config.enabled !== false,
+    };
+  });
+}
+
+module.exports = {
+  timestamp,
+  backupTimestamp,
+  appendLog,
+  backupDir,
+  copyDirSync,
+  deepMerge,
+  readMeta,
+  installSkills,
+  installSettings,
+  getPackageSkills,
+  getUserSkills,
+};