mdk-skills 2.4.19 → 2.4.21

package/scripts/web-ui/server/routes/source.js

@@ -6,21 +6,25 @@ const { buildContext } = require("../context");
 
 const ctx = buildContext(utils);
 
+async function pathExists(p) {
+  try { await fs.promises.access(p); return true; } catch { return false; }
+}
+
 function register(router) {
 
   // ----------------------------------------------------------------
   // GET /api/status — 当前状态总览
   // ----------------------------------------------------------------
   router.get("/api/status", async (req, res) => {
-    const settings = ctx.readSettings();
-    const userSkills = core.getUserSkills(ctx.claudeDest);
-    const pkgSkills = ctx.skillsSource ? core.getPackageSkills(ctx.skillsSource) : [];
-    const profiles = ctx.skillsSource ? ctx.loadProfiles() : null;
+    const settings = await ctx.readSettings();
+    const userSkills = await core.getUserSkills(ctx.claudeDest);
+    const pkgSkills = ctx.skillsSource ? await core.getPackageSkills(ctx.skillsSource) : [];
+    const profiles = ctx.skillsSource ? await ctx.loadProfiles() : null;
     const activeProfile = profiles?.find(
       (p) => p.id === settings._active_profile,
     );
     const enabledCount = userSkills.filter((s) => s.enabled).length;
-    const mdExists = fs.existsSync(path.join(ctx.projectRoot, "CLAUDE.md"));
+    const mdExists = await pathExists(path.join(ctx.projectRoot, "CLAUDE.md"));
     return utils.sendJSON(res, {
       pkgSkills,
       enabledCount,
@@ -37,7 +41,7 @@ function register(router) {
   // GET /api/source — 获取技能目录信息
   // ----------------------------------------------------------------
   router.get("/api/source", async (req, res) => {
-    const settings = ctx.readSettings();
+    const settings = await ctx.readSettings();
     const sourcePath = settings._skill_source || null;
 
     let needsInit = false;
@@ -45,17 +49,17 @@ function register(router) {
     const missingSkillDocs = [];
     if (sourcePath) {
       const claudeDir = path.join(sourcePath, ".claude");
-      if (fs.existsSync(claudeDir)) {
-        if (!fs.existsSync(path.join(claudeDir, "profiles.json"))) {
+      if (await pathExists(claudeDir)) {
+        if (!(await pathExists(path.join(claudeDir, "profiles.json")))) {
           missingConfig.push("profiles.json");
         }
-        if (!fs.existsSync(path.join(claudeDir, "settings.json"))) {
+        if (!(await pathExists(path.join(claudeDir, "settings.json")))) {
           missingConfig.push("settings.json");
         }
         const skillsDir = path.join(claudeDir, "skills");
-        if (fs.existsSync(skillsDir)) {
-          for (const name of core.listSkillDirs(skillsDir)) {
-            if (!fs.existsSync(path.join(skillsDir, name, "SKILL.md"))) {
+        if (await pathExists(skillsDir)) {
+          for (const name of await core.listSkillDirs(skillsDir)) {
+            if (!(await pathExists(path.join(skillsDir, name, "SKILL.md")))) {
               missingSkillDocs.push(name);
             }
           }
@@ -70,8 +74,8 @@ function register(router) {
     if (sourcePath) {
       const skillsDir = path.join(sourcePath, ".claude", "skills");
       readmeStatus = {
-        root: fs.existsSync(path.join(sourcePath, "README.md")),
-        skills: fs.existsSync(path.join(skillsDir, "README.md")),
+        root: await pathExists(path.join(sourcePath, "README.md")),
+        skills: await pathExists(path.join(skillsDir, "README.md")),
       };
     }
 
@@ -93,25 +97,25 @@ function register(router) {
     const repoPath = body.path;
     if (!repoPath) return utils.sendJSON(res, { error: "缺少目录路径" }, 400);
     const resolved = path.resolve(repoPath);
-    if (!fs.existsSync(path.join(resolved, ".claude", "skills"))) {
+    if (!(await pathExists(path.join(resolved, ".claude", "skills")))) {
       return utils.sendJSON(
         res,
         { error: `路径 "${resolved}" 下没有 .claude/skills/` },
         400,
       );
     }
-    const settings = ctx.readSettings();
+    const settings = await ctx.readSettings();
     settings._skill_source = resolved;
-    ctx.writeSettings(settings);
+    await ctx.writeSettings(settings);
     // 复制 CLAUDE.md（不存在才装）
     const mdSource = path.join(resolved, "CLAUDE.md");
     const mdDest = path.join(ctx.projectRoot, "CLAUDE.md");
-    if (fs.existsSync(mdSource) && !fs.existsSync(mdDest)) {
-      fs.copyFileSync(mdSource, mdDest);
+    if (await pathExists(mdSource) && !(await pathExists(mdDest))) {
+      await fs.promises.copyFile(mdSource, mdDest);
     }
 
     // 清理幽灵技能引用
-    const cleanResult = utils.cleanGhostSkills(resolved);
+    const cleanResult = await utils.cleanGhostSkills(resolved);
     if (cleanResult.removed.length > 0) {
       console.log(`[清理幽灵技能] ${cleanResult.removed.join(", ")}`);
     }
@@ -124,12 +128,12 @@ function register(router) {
   // POST /api/source/clear — 清除技能目录
   // ----------------------------------------------------------------
   router.post("/api/source/clear", async (req, res) => {
-    const settings = ctx.readSettings();
+    const settings = await ctx.readSettings();
     if (!settings._skill_source) {
       return utils.sendJSON(res, { error: "当前未设置技能目录" }, 400);
     }
     delete settings._skill_source;
-    ctx.writeSettings(settings);
+    await ctx.writeSettings(settings);
     ctx.refreshSource();
     return utils.sendJSON(res, { ok: true });
   });
@@ -138,34 +142,34 @@ function register(router) {
   // POST /api/source/sync — 同步到本地源
   // ----------------------------------------------------------------
   router.post("/api/source/sync", async (req, res) => {
-    const settings = ctx.readSettings();
+    const settings = await ctx.readSettings();
     const sourcePath = settings._skill_source;
     if (!sourcePath) return utils.sendJSON(res, { error: "尚未绑定技能源" }, 400);
-    if (!fs.existsSync(path.join(sourcePath, ".claude"))) {
+    if (!(await pathExists(path.join(sourcePath, ".claude")))) {
       return utils.sendJSON(res, { error: "绑定的路径已失效" }, 400);
     }
 
     const repoClaude = path.join(sourcePath, ".claude");
-    core.backupDir(repoClaude);
+    await core.backupDir(repoClaude);
 
     // 技能反推
     const repoSkills = path.join(sourcePath, ".claude", "skills");
-    if (!fs.existsSync(repoSkills))
-      fs.mkdirSync(repoSkills, { recursive: true });
-    if (fs.existsSync(ctx.skillsDest)) {
-      for (const name of core.listSkillDirs(ctx.skillsDest)) {
+    if (!(await pathExists(repoSkills)))
+      await fs.promises.mkdir(repoSkills, { recursive: true });
+    if (await pathExists(ctx.skillsDest)) {
+      for (const name of await core.listSkillDirs(ctx.skillsDest)) {
         const src = path.join(ctx.skillsDest, name);
         const dest = path.join(repoSkills, name);
-        if (fs.existsSync(dest))
-          utils.safeRmSync(dest, name);
-        utils.copyDirSync(src, dest);
+        if (await pathExists(dest))
+          await utils.safeRm(dest, name);
+        await utils.copyDir(src, dest);
       }
     }
 
     // profiles.json 反推
     const projectProfiles = path.join(ctx.claudeDest, "profiles.json");
-    if (fs.existsSync(projectProfiles)) {
-      fs.copyFileSync(
+    if (await pathExists(projectProfiles)) {
+      await fs.promises.copyFile(
         projectProfiles,
         path.join(sourcePath, ".claude", "profiles.json"),
       );
@@ -175,7 +179,7 @@ function register(router) {
     const cleanSettings = { ...settings };
     delete cleanSettings._skill_source;
     delete cleanSettings._active_profile;
-    fs.writeFileSync(
+    await fs.promises.writeFile(
       path.join(sourcePath, ".claude", "settings.json"),
       JSON.stringify(cleanSettings, null, 2) + "\n",
       "utf-8",
@@ -183,8 +187,8 @@ function register(router) {
 
     // CLAUDE.md 反推
     const projectMd = path.join(ctx.projectRoot, "CLAUDE.md");
-    if (fs.existsSync(projectMd)) {
-      fs.copyFileSync(projectMd, path.join(sourcePath, "CLAUDE.md"));
+    if (await pathExists(projectMd)) {
+      await fs.promises.copyFile(projectMd, path.join(sourcePath, "CLAUDE.md"));
     }
 
     return utils.sendJSON(res, { ok: true });
@@ -194,7 +198,7 @@ function register(router) {
   // POST /api/source/init — 初始化本地源骨架文件
   // ----------------------------------------------------------------
   router.post("/api/source/init", async (req, res) => {
-    const settings = ctx.readSettings();
+    const settings = await ctx.readSettings();
     const sourcePath = settings._skill_source;
     if (!sourcePath) return utils.sendJSON(res, { error: "未绑定本地源" }, 400);
 
@@ -206,8 +210,8 @@ function register(router) {
     const created = { profiles: false, settings: false, metaFiles: 0 };
 
     // 1. profiles.json
-    if (!fs.existsSync(profilesPath)) {
-      fs.writeFileSync(
+    if (!(await pathExists(profilesPath))) {
+      await fs.promises.writeFile(
         profilesPath,
         JSON.stringify(
           {
@@ -230,8 +234,8 @@ function register(router) {
     }
 
     // 2. settings.json
-    if (!fs.existsSync(settingsPath)) {
-      fs.writeFileSync(
+    if (!(await pathExists(settingsPath))) {
+      await fs.promises.writeFile(
         settingsPath,
         JSON.stringify({ skills: {}, always_apply_skills: [] }, null, 2) + "\n",
         "utf-8",
@@ -240,20 +244,20 @@ function register(router) {
     }
 
     // 3. 每个 skill 目录的 .meta.json
-    if (fs.existsSync(skillsDir)) {
-      for (const name of core.listSkillDirs(skillsDir)) {
+    if (await pathExists(skillsDir)) {
+      for (const name of await core.listSkillDirs(skillsDir)) {
         const skillDir = path.join(skillsDir, name);
         const metaPath = path.join(skillDir, ".meta.json");
-        if (!fs.existsSync(metaPath)) {
-          utils.writeSkillMeta(skillDir, false);
+        if (!(await pathExists(metaPath))) {
+          await utils.writeSkillMeta(skillDir, false);
           created.metaFiles++;
         }
       }
     }
 
     const readmeStatus = {
-      root: fs.existsSync(path.join(sourcePath, "README.md")),
-      skills: fs.existsSync(path.join(skillsDir, "README.md")),
+      root: await pathExists(path.join(sourcePath, "README.md")),
+      skills: await pathExists(path.join(skillsDir, "README.md")),
     };
 
     return utils.sendJSON(res, { ok: true, ...created, readmeStatus });

package/scripts/web-ui/server/utils.js

@@ -4,6 +4,12 @@ const crypto = require("crypto");
 const os = require("os");
 const core = require("../../core");
 
+// ===================== 异步路径检查 =====================
+
+async function pathExists(p) {
+  try { await fs.promises.access(p); return true; } catch { return false; }
+}
+
 // ===================== HTTP 工具 =====================
 
 function sendJSON(res, data, status = 200) {
@@ -25,14 +31,13 @@ function parseBody(req) {
   });
 }
 
-// ===================== 文件系统 =====================
+// ===================== 文件系统（异步）======================
 
 // 安全删除目录/文件，处理 Windows 文件锁定（EBUSY）
-// 返回 { removed: boolean, reason?: 'not_found' | 'locked' | 'error', message?: string }
-function safeRmSync(dir, label) {
-  if (!fs.existsSync(dir)) return { removed: false, reason: "not_found" };
+async function safeRm(dir, label) {
+  if (!(await pathExists(dir))) return { removed: false, reason: "not_found" };
   try {
-    fs.rmSync(dir, { recursive: true, force: true });
+    await fs.promises.rm(dir, { recursive: true, force: true });
     return { removed: true };
   } catch (err) {
     if (err.code === "EBUSY") {
@@ -44,42 +49,30 @@ function safeRmSync(dir, label) {
   }
 }
 
-// 手动递归拷贝目录
-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);
-    }
-  }
-}
-
-// npx skills 会在系统临时目录留下 skills-* 工作目录，统一清理
-function cleanNpxTemp() {
+// 清理 npx 临时目录
+async function cleanNpxTemp() {
   const tmp = os.tmpdir();
-  for (const name of fs.readdirSync(tmp)) {
+  let names;
+  try { names = await fs.promises.readdir(tmp); } catch { return; }
+  for (const name of names) {
     if (/^skills-[A-Za-z0-9]+$/.test(name)) {
       const p = path.join(tmp, name);
-      try { fs.rmSync(p, { recursive: true, force: true }); } catch {}
+      try { await fs.promises.rm(p, { recursive: true, force: true }); } catch {}
     }
   }
 }
 
 // Windows 下获取可用盘符
-function getWindowsDrives() {
+async function getWindowsDrives() {
   const drives = [];
   for (let i = 65; i <= 90; i++) {
     const letter = String.fromCharCode(i);
     const root = letter + ":\\";
     try {
-      if (fs.existsSync(root)) {
+      if (await pathExists(root)) {
         drives.push({ name: root, isDir: true });
       }
-    } catch { /* 无权限访问的盘符跳过 */ }
+    } catch {}
   }
   return drives;
 }
@@ -131,35 +124,40 @@ function parseSkillsFindOutput(stdout) {
 
 // ===================== 指纹 & 元信息 =====================
 
-// 计算技能目录的文件指纹（基于所有文件内容 md5），用于检测是否有真实变更
-function calcSkillFingerprint(dir) {
-  if (!fs.existsSync(dir)) return "";
+// 计算技能目录的文件指纹（MD5，排除 .meta.json）
+async function calcSkillFingerprint(dir) {
+  if (!(await pathExists(dir))) return "";
   const hash = crypto.createHash("md5");
-  const walk = (d) => {
-    for (const item of fs.readdirSync(d).sort()) {
+  const walk = async (d) => {
+    let items;
+    try { items = await fs.promises.readdir(d); } catch { return; }
+    items.sort();
+    for (const item of items) {
       const p = path.join(d, item);
       if (item === ".meta.json") continue;
-      const stat = fs.statSync(p);
+      let stat;
+      try { stat = await fs.promises.stat(p); } catch { continue; }
       if (stat.isDirectory()) {
-        walk(p);
+        await walk(p);
       } else {
         hash.update(item);
-        hash.update(fs.readFileSync(p));
+        const content = await fs.promises.readFile(p);
+        hash.update(content);
       }
     }
   };
-  walk(dir);
+  await walk(dir);
   return hash.digest("hex");
 }
 
-// 统一写入技能元信息
-function writeSkillMeta(dest, wasUpdated) {
-  const fm = core.parseFrontmatter(dest);
+// 写入技能元信息（异步版）
+async function writeSkillMeta(dest, wasUpdated) {
+  const fm = await core.parseFrontmatter(dest);
   if (!fm) return;
   const metaPath = path.join(dest, ".meta.json");
   let oldMeta = {};
-  if (fs.existsSync(metaPath)) {
-    try { oldMeta = JSON.parse(fs.readFileSync(metaPath, "utf-8")); } catch {}
+  if (await pathExists(metaPath)) {
+    try { oldMeta = JSON.parse(await fs.promises.readFile(metaPath, "utf-8")); } catch {}
   }
   const hasUpstream = !!fm.version;
   const meta = {
@@ -174,24 +172,24 @@ function writeSkillMeta(dest, wasUpdated) {
   } else {
     meta._updateCount = oldMeta._updateCount || 0;
   }
-  fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2) + "\n", "utf-8");
+  await fs.promises.writeFile(metaPath, JSON.stringify(meta, null, 2) + "\n", "utf-8");
 }
 
 // ===================== 幽灵技能清理 =====================
 
-function cleanGhostSkills(sourcePath) {
+async function cleanGhostSkills(sourcePath) {
   const claudeDir = path.join(sourcePath, ".claude");
   const skillsDir = path.join(claudeDir, "skills");
-  if (!fs.existsSync(skillsDir)) return { cleaned: false, reason: "skills 目录不存在" };
+  if (!(await pathExists(skillsDir))) return { cleaned: false, reason: "skills 目录不存在" };
 
-  const actualSkills = fs.existsSync(skillsDir) ? core.listSkillDirs(skillsDir) : [];
+  const actualSkills = await pathExists(skillsDir) ? await core.listSkillDirs(skillsDir) : [];
   const skillSet = new Set(actualSkills);
   const cleaned = { profiles: 0, alwaysApply: 0, settings: 0, removed: [] };
 
   const profilesPath = path.join(claudeDir, "profiles.json");
-  if (fs.existsSync(profilesPath)) {
+  if (await pathExists(profilesPath)) {
     try {
-      const profilesData = JSON.parse(fs.readFileSync(profilesPath, "utf-8"));
+      const profilesData = JSON.parse(await fs.promises.readFile(profilesPath, "utf-8"));
       let changed = false;
       for (const profile of profilesData.profiles || []) {
         if (!profile.skills || !Array.isArray(profile.skills)) continue;
@@ -204,15 +202,15 @@ function cleanGhostSkills(sourcePath) {
       }
       if (changed) {
         cleaned.profiles++;
-        fs.writeFileSync(profilesPath, JSON.stringify(profilesData, null, 2) + "\n", "utf-8");
+        await fs.promises.writeFile(profilesPath, JSON.stringify(profilesData, null, 2) + "\n", "utf-8");
       }
     } catch {}
   }
 
   const settingsPathInRepo = path.join(claudeDir, "settings.json");
-  if (fs.existsSync(settingsPathInRepo)) {
+  if (await pathExists(settingsPathInRepo)) {
     try {
-      const settings = JSON.parse(fs.readFileSync(settingsPathInRepo, "utf-8"));
+      const settings = JSON.parse(await fs.promises.readFile(settingsPathInRepo, "utf-8"));
       let changed = false;
       if (Array.isArray(settings.always_apply_skills)) {
         const filtered = settings.always_apply_skills.filter((s) => {
@@ -233,7 +231,7 @@ function cleanGhostSkills(sourcePath) {
       }
       if (changed) {
         cleaned.settings++;
-        fs.writeFileSync(settingsPathInRepo, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+        await fs.promises.writeFile(settingsPathInRepo, JSON.stringify(settings, null, 2) + "\n", "utf-8");
       }
     } catch {}
   }
@@ -242,17 +240,23 @@ function cleanGhostSkills(sourcePath) {
 }
 
 module.exports = {
+  // HTTP
   sendJSON,
   parseBody,
-  safeRmSync,
-  copyDirSync,
+  // 文件系统
+  pathExists,
+  safeRm,
+  copyDir: core.copyDir,
   cleanNpxTemp,
   getWindowsDrives,
+  // 技能解析
   stripAnsi,
   escapeShellArg,
   parseInstallCount,
   parseSkillsFindOutput,
+  // 指纹 & 元信息
   calcSkillFingerprint,
   writeSkillMeta,
+  // 幽灵清理
   cleanGhostSkills,
 };

package/scripts/web-ui/server.js

@@ -8,6 +8,7 @@ const fs = require("fs");
 
 const { Router } = require("./server/router");
 const utils = require("./server/utils");
+const { refreshSource } = require("./server/context");
 
 // ===================== 路由注册 =====================
 
@@ -71,14 +72,30 @@ function startProduction(distDir) {
     }
     const urlPath = req.url === "/" ? "/index.html" : req.url.split("?")[0];
     const filePath = path.join(distDir, urlPath);
-    if (fs.existsSync(filePath) && fs.statSync(filePath).isFile()) {
-      const ext = path.extname(filePath);
-      res.writeHead(200, { "Content-Type": MIME_TYPES[ext] || "application/octet-stream" });
-      res.end(fs.readFileSync(filePath));
-    } else {
-      res.writeHead(200, { "Content-Type": "text/html" });
-      res.end(fs.readFileSync(path.join(distDir, "index.html")));
-    }
+
+    fs.stat(filePath, (err, stat) => {
+      if (!err && stat.isFile()) {
+        const ext = path.extname(filePath);
+        res.writeHead(200, { "Content-Type": MIME_TYPES[ext] || "application/octet-stream" });
+        const stream = fs.createReadStream(filePath);
+        stream.pipe(res);
+        stream.on("error", () => { res.end(); });
+      } else {
+        // SPA fallback: 返回 index.html
+        const indexPath = path.join(distDir, "index.html");
+        fs.stat(indexPath, (err2, stat2) => {
+          if (err2) {
+            res.writeHead(404);
+            res.end("Not Found");
+            return;
+          }
+          res.writeHead(200, { "Content-Type": "text/html" });
+          const stream = fs.createReadStream(indexPath);
+          stream.pipe(res);
+          stream.on("error", () => { res.end(); });
+        });
+      }
+    });
   });
   server.listen(3344, () => {
     console.log(`\n  🖥️  mdk-skills Web UI`);
@@ -120,12 +137,19 @@ async function startDev() {
 
 // ===================== 启动 =====================
 
-const distDir = path.join(__dirname, "dist");
-if (fs.existsSync(distDir)) {
-  startProduction(distDir);
-} else {
-  startDev().catch((err) => {
-    console.error("启动失败:", err);
-    process.exit(1);
-  });
+async function start() {
+  await refreshSource();
+  const distDir = path.join(__dirname, "dist");
+  let stats;
+  try { stats = await fs.promises.stat(distDir); } catch {}
+  if (stats) {
+    startProduction(distDir);
+  } else {
+    await startDev();
+  }
 }
+
+start().catch((err) => {
+  console.error("启动失败:", err);
+  process.exit(1);
+});