mdk-skills 2.2.22 → 2.2.23

package/scripts/web-ui/server.js

@@ -1,860 +1,1013 @@
-const fs = require("fs");
-const path = require("path");
-const { createServer: createViteServer } = require("vite");
-const vue = require("@vitejs/plugin-vue");
-const core = require("../core");
-
-// ---------- 路径（与 cli.js 保持一致） ----------
-
-const projectRoot = (() => {
-  try {
-    return fs.realpathSync.native(process.cwd());
-  } catch {
-    return process.cwd();
-  }
-})();
-const packageDir = path.join(__dirname, "..", "..");
-let skillsSource = core.getSkillsSource(projectRoot, packageDir);
-const claudeDest = path.join(projectRoot, ".claude");
-const skillsDest = path.join(claudeDest, "skills");
-const settingsPath = path.join(claudeDest, "settings.json");
-let pkgSkillsSource = path.join(skillsSource, ".claude", "skills");
-
-// 连接/断开本地源后刷新技能源路径
-function refreshSource() {
-  skillsSource = core.getSkillsSource(projectRoot, packageDir);
-  pkgSkillsSource = path.join(skillsSource, ".claude", "skills");
-}
-
-// ---------- 工具函数 ----------
-
-function readSettings() {
-  if (!fs.existsSync(settingsPath))
-    return { skills: {}, always_apply_skills: [] };
-  try {
-    return JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
-  } catch {
-    return { skills: {}, always_apply_skills: [] };
-  }
-}
-
-function writeSettings(settings) {
-  if (!fs.existsSync(claudeDest)) {
-    fs.mkdirSync(claudeDest, { recursive: true });
-  }
-  fs.writeFileSync(
-    settingsPath,
-    JSON.stringify(settings, null, 2) + "\n",
-    "utf-8",
-  );
-}
-
-function sendJSON(res, data, status = 200) {
-  res.writeHead(status, { "Content-Type": "application/json" });
-  res.end(JSON.stringify(data));
-}
-
-function parseBody(req) {
-  return new Promise((resolve) => {
-    let body = "";
-    req.on("data", (chunk) => (body += chunk));
-    req.on("end", () => {
-      try {
-        resolve(JSON.parse(body));
-      } catch {
-        resolve({});
-      }
-    });
-  });
-}
-
-// 手动递归拷贝目录
-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);
-    }
-  }
-}
-
-// 读取 profiles.json
-function loadProfiles() {
-  const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
-  if (!fs.existsSync(profilesPath)) return null;
-  try {
-    return JSON.parse(fs.readFileSync(profilesPath, "utf-8")).profiles;
-  } catch {
-    return null;
-  }
-}
-
-// 应用场景
-function applyProfile(profile) {
-  const pkgSkills = core.listSkillDirs(pkgSkillsSource);
-  const settings = readSettings();
-
-  let selected;
-  if (profile.skills === null) {
-    return { selected: [], message: "自定义场景，不做自动切换" };
-  } else if (profile.skills.length === 0) {
-    selected = [];
-  } else {
-    selected = profile.skills.filter((s) => pkgSkills.includes(s));
-  }
-
-  // 安装/删除技能
-  if (!fs.existsSync(skillsDest)) {
-    fs.mkdirSync(skillsDest, { recursive: true });
-  }
-  for (const name of pkgSkills) {
-    const src = path.join(pkgSkillsSource, name);
-    const dest = path.join(skillsDest, name);
-    if (selected.includes(name)) {
-      if (!fs.existsSync(dest)) {
-        try {
-          copyDirSync(src, dest);
-        } catch (err) {
-          console.error(`安装技能 "${name}" 失败:`, err.message);
-        }
-      }
-    } else {
-      if (fs.existsSync(dest)) {
-        fs.rmSync(dest, { recursive: true, force: true });
-      }
-    }
-  }
-
-  // 更新 settings
-  if (!settings.skills) settings.skills = {};
-  for (const name of pkgSkills) {
-    const enabled = selected.includes(name);
-    if (!settings.skills[name]) settings.skills[name] = {};
-    settings.skills[name].enabled = enabled;
-  }
-
-  if (profile.always_apply) {
-    settings.always_apply_skills = profile.always_apply;
-  }
-
-  settings._active_profile = profile.id;
-  writeSettings(settings);
-
-  // 复制 profiles.json
-  const profilesSource = path.join(skillsSource, ".claude", "profiles.json");
-  const profilesDest = path.join(claudeDest, "profiles.json");
-  if (fs.existsSync(profilesSource)) {
-    fs.copyFileSync(profilesSource, profilesDest);
-  }
-
-  // 复制 CLAUDE.md（不存在才装）
-  const mdSource = path.join(skillsSource, "CLAUDE.md");
-  const mdDest = path.join(projectRoot, "CLAUDE.md");
-  if (fs.existsSync(mdSource) && !fs.existsSync(mdDest)) {
-    fs.copyFileSync(mdSource, mdDest);
-  }
-
-  return {
-    selected,
-    enabled: selected.length,
-    disabled: pkgSkills.length - selected.length,
-  };
-}
-
-// 安装勾选的技能
-function installSelectedSkills(selectedNames) {
-  if (!fs.existsSync(pkgSkillsSource)) return { installed: 0 };
-
-  if (!fs.existsSync(skillsDest)) {
-    fs.mkdirSync(skillsDest, { recursive: true });
-  }
-
-  const allPkgSkills = core.listSkillDirs(pkgSkillsSource);
-  let installedCount = 0;
-
-  for (const name of allPkgSkills) {
-    const src = path.join(pkgSkillsSource, name);
-    const dest = path.join(skillsDest, name);
-
-    if (selectedNames.includes(name)) {
-      if (!fs.existsSync(dest)) {
-        try {
-          copyDirSync(src, dest);
-          installedCount++;
-        } catch (err) {
-          console.error(`安装技能 "${name}" 失败:`, err.message);
-        }
-      }
-    } else {
-      if (fs.existsSync(dest)) {
-        fs.rmSync(dest, { recursive: true, force: true });
-      }
-    }
-  }
-
-  const settings = readSettings();
-  if (!settings.skills) settings.skills = {};
-  for (const name of allPkgSkills) {
-    const enabled = selectedNames.includes(name);
-    if (!settings.skills[name]) settings.skills[name] = {};
-    settings.skills[name].enabled = enabled;
-  }
-  writeSettings(settings);
-
-  // 复制 CLAUDE.md（不存在才装）
-  const mdSource = path.join(skillsSource, "CLAUDE.md");
-  const mdDest = path.join(projectRoot, "CLAUDE.md");
-  if (fs.existsSync(mdSource) && !fs.existsSync(mdDest)) {
-    fs.copyFileSync(mdSource, mdDest);
-  }
-
-  return { installed: installedCount };
-}
-
-// ---------- API 路由 ----------
-
-async function handleApi(req, res) {
-  const url = new URL(req.url, `http://${req.headers.host || "localhost"}`);
-  const pathname = url.pathname;
-  const method = req.method;
-
-  // CORS & 防缓存
-  res.setHeader("Access-Control-Allow-Origin", "*");
-  res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
-  res.setHeader("Access-Control-Allow-Headers", "Content-Type");
-  res.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
-
-  if (method === "OPTIONS") {
-    res.writeHead(204);
-    res.end();
-    return;
-  }
-
-  try {
-    // GET /api/skills — 获取所有技能列表（含启用状态），同时清理已失效的技能
-    if (method === "GET" && pathname === "/api/skills") {
-      const pkgSkills = core.getPackageSkills(skillsSource);
-      const pkgNames = new Set(pkgSkills.map((s) => s.name));
-      const userSkills = core.getUserSkills(claudeDest);
-      // 清理：源目录已删除的技能，项目中也一并移除
-      let cleaned = false;
-      for (const us of userSkills) {
-        if (!pkgNames.has(us.name)) {
-          const dest = path.join(skillsDest, us.name);
-          if (fs.existsSync(dest)) {
-            fs.rmSync(dest, { recursive: true, force: true });
-            cleaned = true;
-          }
-        }
-      }
-      if (cleaned) {
-        const settings = readSettings();
-        for (const name of Object.keys(settings.skills || {})) {
-          if (!pkgNames.has(name)) delete settings.skills[name];
-        }
-        writeSettings(settings);
-      }
-      const refreshed = core.getUserSkills(claudeDest);
-      const userMap = new Map(refreshed.map((s) => [s.name, s]));
-      const result = pkgSkills.map((s) => ({
-        ...s,
-        enabled: userMap.has(s.name) ? userMap.get(s.name).enabled : false,
-        installed: userMap.has(s.name),
-      }));
-      return sendJSON(res, result);
-    }
-
-    // POST /api/skills/toggle — 开关技能（启用时自动安装）
-    if (method === "POST" && pathname === "/api/skills/toggle") {
-      const body = await parseBody(req);
-      const { name, enabled } = body;
-      if (!name) return sendJSON(res, { error: "缺少技能名" }, 400);
-      if (enabled) {
-        const src = path.join(pkgSkillsSource, name);
-        const dest = path.join(skillsDest, name);
-        if (fs.existsSync(src) && !fs.existsSync(dest)) {
-          copyDirSync(src, dest);
-        }
-      }
-      const settings = readSettings();
-      if (!settings.skills) settings.skills = {};
-      if (!settings.skills[name]) settings.skills[name] = {};
-      settings.skills[name].enabled = !!enabled;
-      writeSettings(settings);
-      return sendJSON(res, { ok: true, name, enabled: !!enabled });
-    }
-
-    // POST /api/skills/install — 自定义勾选安装
-    if (method === "POST" && pathname === "/api/skills/install") {
-      const body = await parseBody(req);
-      const { selected } = body;
-      if (!Array.isArray(selected))
-        return sendJSON(res, { error: "参数错误" }, 400);
-      const result = installSelectedSkills(selected);
-      return sendJSON(res, { ok: true, ...result });
-    }
-
-    // GET /api/readme — 获取根目录 README.md
-    if (method === "GET" && pathname === "/api/readme") {
-      const p = path.join(skillsSource, "README.md");
-      const content = fs.existsSync(p) ? fs.readFileSync(p, "utf-8") : null;
-      return sendJSON(res, { content, found: !!content });
-    }
-
-    // GET /api/skills-readme — 获取技能目录 README.md
-    if (method === "GET" && pathname === "/api/skills-readme") {
-      const p = path.join(skillsSource, ".claude", "skills", "README.md");
-      const content = fs.existsSync(p) ? fs.readFileSync(p, "utf-8") : null;
-      return sendJSON(res, { content, found: !!content });
-    }
-
-    // GET /api/claudemd — 获取 CLAUDE.md 内容
-    if (method === "GET" && pathname === "/api/claudemd") {
-      const paths = [
-        path.join(skillsSource, "CLAUDE.md"),
-        path.join(projectRoot, "CLAUDE.md"),
-      ];
-      let content = null;
-      for (const p of paths) {
-        if (fs.existsSync(p)) {
-          content = fs.readFileSync(p, "utf-8");
-          break;
-        }
-      }
-      return sendJSON(res, { content, found: !!content });
-    }
-
-    // GET /api/skills/:name/readme — 获取技能的 SKILL.md
-    const readmeMatch = pathname.match(/^\/api\/skills\/([^/]+)\/readme$/);
-    if (method === "GET" && readmeMatch) {
-      const name = readmeMatch[1];
-      const skillDir = path.join(skillsDest, name);
-      const altDir = path.join(pkgSkillsSource, name);
-      const readmePath = [
-        path.join(skillDir, "SKILL.md"),
-        path.join(altDir, "SKILL.md"),
-      ].find((p) => fs.existsSync(p));
-      const content = readmePath ? fs.readFileSync(readmePath, "utf-8") : null;
-      return sendJSON(res, { content, found: !!readmePath });
-    }
-
-    // GET /api/profiles — 获取场景列表（含只读状态）
-    if (method === "GET" && pathname === "/api/profiles") {
-      const profiles = loadProfiles();
-      const settings = readSettings();
-      return sendJSON(res, {
-        profiles: profiles || [],
-        activeProfile: settings._active_profile || null,
-        readonly: !settings._skill_source,
-      });
-    }
-
-    // POST /api/profiles/apply — 应用场景
-    if (method === "POST" && pathname === "/api/profiles/apply") {
-      const body = await parseBody(req);
-      const { profileId } = body;
-      if (!profileId) return sendJSON(res, { error: "缺少场景 ID" }, 400);
-      const profiles = loadProfiles();
-      const profile = profiles?.find((p) => p.id === profileId);
-      if (!profile)
-        return sendJSON(res, { error: "场景不存在: " + profileId }, 404);
-      const result = applyProfile(profile);
-      return sendJSON(res, { ok: true, ...result });
-    }
-
-    // POST /api/profiles/save — 新增/编辑场景（仅本地源模式）
-    if (method === "POST" && pathname === "/api/profiles/save") {
-      const body = await parseBody(req);
-      const settings = readSettings();
-      if (!settings._skill_source)
-        return sendJSON(res, { error: "npm 模式下不可编辑场景" }, 403);
-
-      const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
-      let data = { version: 1, profiles: [] };
-      if (fs.existsSync(profilesPath)) {
-        try {
-          data = JSON.parse(fs.readFileSync(profilesPath, "utf-8"));
-        } catch {}
-      }
-
-      const { id, name, description, skills, always_apply } = body;
-      if (!name) return sendJSON(res, { error: "场景名称不能为空" }, 400);
-
-      if (id) {
-        const index = data.profiles.findIndex((p) => p.id === id);
-        if (index === -1) return sendJSON(res, { error: "场景不存在" }, 404);
-        data.profiles[index] = {
-          ...data.profiles[index],
-          name,
-          description: description || "",
-          skills: skills || [],
-          always_apply: always_apply || [],
-        };
-      } else {
-        const newId = "profile_" + Date.now().toString(36);
-        data.profiles.push({
-          id: newId,
-          name,
-          description: description || "",
-          skills: skills || [],
-          always_apply: always_apply || [],
-        });
-      }
-
-      fs.writeFileSync(profilesPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
-
-      // 同步到项目 .claude
-      const projectProfilesPath = path.join(claudeDest, "profiles.json");
-      fs.writeFileSync(projectProfilesPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
-
-      return sendJSON(res, { ok: true, profiles: data.profiles });
-    }
-
-    // POST /api/profiles/delete — 删除场景（仅本地源模式）
-    if (method === "POST" && pathname === "/api/profiles/delete") {
-      const body = await parseBody(req);
-      const settings = readSettings();
-      if (!settings._skill_source)
-        return sendJSON(res, { error: "npm 模式下不可编辑场景" }, 403);
-
-      const { id } = body;
-      if (!id) return sendJSON(res, { error: "缺少场景 ID" }, 400);
-      if (id === "custom")
-        return sendJSON(res, { error: "不能删除内置场景" }, 403);
-
-      const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
-      if (!fs.existsSync(profilesPath))
-        return sendJSON(res, { error: "场景文件不存在" }, 404);
-
-      const data = JSON.parse(fs.readFileSync(profilesPath, "utf-8"));
-      const index = data.profiles.findIndex((p) => p.id === id);
-      if (index === -1) return sendJSON(res, { error: "场景不存在" }, 404);
-
-      data.profiles.splice(index, 1);
-      fs.writeFileSync(profilesPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
-
-      // 同步到项目 .claude
-      const projectProfilesPath = path.join(claudeDest, "profiles.json");
-      fs.writeFileSync(projectProfilesPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
-
-      return sendJSON(res, { ok: true });
-    }
-
-    // GET /api/status — 当前状态总览
-    if (method === "GET" && pathname === "/api/status") {
-      const settings = readSettings();
-      const userSkills = core.getUserSkills(claudeDest);
-      const pkgSkills = core.getPackageSkills(skillsSource);
-      const profiles = loadProfiles();
-      const activeProfile = profiles?.find(
-        (p) => p.id === settings._active_profile,
-      );
-      const enabledCount = userSkills.filter((s) => s.enabled).length;
-      const mdExists = fs.existsSync(path.join(projectRoot, "CLAUDE.md"));
-      return sendJSON(res, {
-        pkgSkills,
-        enabledCount,
-        totalCount: pkgSkills.length,
-        activeProfile: activeProfile
-          ? { id: activeProfile.id, name: activeProfile.name }
-          : null,
-        sourcePath: settings._skill_source || null,
-        hasClaudeMd: mdExists,
-      });
-    }
-
-    // GET /api/source — 获取本地源信息（含初始化检测）
-    if (method === "GET" && pathname === "/api/source") {
-      const settings = readSettings();
-      const sourcePath = settings._skill_source || null;
-
-      let needsInit = false;
-      if (sourcePath) {
-        const claudeDir = path.join(sourcePath, ".claude");
-        if (fs.existsSync(claudeDir)) {
-          // 检查 profiles.json
-          const hasProfiles = fs.existsSync(path.join(claudeDir, "profiles.json"));
-          // 检查 settings.json
-          const hasSettings = fs.existsSync(path.join(claudeDir, "settings.json"));
-          // 检查每个 skill 目录的 .meta.json
-          const skillsDir = path.join(claudeDir, "skills");
-          let allMeta = true;
-          if (fs.existsSync(skillsDir)) {
-            for (const name of core.listSkillDirs(skillsDir)) {
-              if (!fs.existsSync(path.join(skillsDir, name, ".meta.json"))) {
-                allMeta = false;
-                break;
-              }
-            }
-          }
-          needsInit = !hasProfiles || !hasSettings || !allMeta;
-        } else {
-          needsInit = true;
-        }
-      }
-
-      // README.md 缺失状态（独立于骨架文件）
-      let readmeStatus = null;
-      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")),
-        };
-      }
-
-      return sendJSON(res, {
-        connected: !!sourcePath,
-        path: sourcePath,
-        needsInit,
-        readmeStatus,
-      });
-    }
-
-    // POST /api/source/connect — 绑定本地源
-    if (method === "POST" && pathname === "/api/source/connect") {
-      const body = await parseBody(req);
-      const repoPath = body.path;
-      if (!repoPath) return sendJSON(res, { error: "缺少仓库路径" }, 400);
-      const resolved = path.resolve(repoPath);
-      if (!fs.existsSync(path.join(resolved, ".claude", "skills"))) {
-        return sendJSON(
-          res,
-          { error: `路径 "${resolved}" 下没有 .claude/skills/` },
-          400,
-        );
-      }
-      const settings = readSettings();
-      settings._skill_source = resolved;
-      writeSettings(settings);
-      // 复制 CLAUDE.md（不存在才装）
-      const mdSource = path.join(resolved, "CLAUDE.md");
-      const mdDest = path.join(projectRoot, "CLAUDE.md");
-      if (fs.existsSync(mdSource) && !fs.existsSync(mdDest)) {
-        fs.copyFileSync(mdSource, mdDest);
-      }
-
-      refreshSource();
-      return sendJSON(res, { ok: true, path: resolved });
-    }
-
-    // POST /api/source/disconnect — 解绑本地源
-    if (method === "POST" && pathname === "/api/source/disconnect") {
-      const settings = readSettings();
-      if (!settings._skill_source) {
-        return sendJSON(res, { error: "当前未绑定任何技能源" }, 400);
-      }
-      delete settings._skill_source;
-      writeSettings(settings);
-      refreshSource();
-      return sendJSON(res, { ok: true });
-    }
-
-    // POST /api/source/sync — 同步到本地源
-    if (method === "POST" && pathname === "/api/source/sync") {
-      const settings = readSettings();
-      const sourcePath = settings._skill_source;
-      if (!sourcePath) return sendJSON(res, { error: "尚未绑定技能源" }, 400);
-      if (!fs.existsSync(path.join(sourcePath, ".claude"))) {
-        return sendJSON(res, { error: "绑定的路径已失效" }, 400);
-      }
-
-      const repoClaude = path.join(sourcePath, ".claude");
-      core.backupDir(repoClaude);
-
-      // 技能反推
-      const repoSkills = path.join(sourcePath, ".claude", "skills");
-      if (!fs.existsSync(repoSkills))
-        fs.mkdirSync(repoSkills, { recursive: true });
-      if (fs.existsSync(skillsDest)) {
-        for (const name of core.listSkillDirs(skillsDest)) {
-          const src = path.join(skillsDest, name);
-          const dest = path.join(repoSkills, name);
-          if (fs.existsSync(dest))
-            fs.rmSync(dest, { recursive: true, force: true });
-          copyDirSync(src, dest);
-        }
-      }
-
-      // profiles.json 反推
-      const projectProfiles = path.join(claudeDest, "profiles.json");
-      if (fs.existsSync(projectProfiles)) {
-        fs.copyFileSync(
-          projectProfiles,
-          path.join(sourcePath, ".claude", "profiles.json"),
-        );
-      }
-
-      // settings.json 反推
-      const cleanSettings = { ...settings };
-      delete cleanSettings._skill_source;
-      delete cleanSettings._active_profile;
-      fs.writeFileSync(
-        path.join(sourcePath, ".claude", "settings.json"),
-        JSON.stringify(cleanSettings, null, 2) + "\n",
-        "utf-8",
-      );
-
-      // CLAUDE.md 反推
-      const projectMd = path.join(projectRoot, "CLAUDE.md");
-      if (fs.existsSync(projectMd)) {
-        fs.copyFileSync(projectMd, path.join(sourcePath, "CLAUDE.md"));
-      }
-
-      return sendJSON(res, { ok: true });
-    }
-
-    // POST /api/source/init — 初始化本地源骨架文件（缺啥补啥）
-    if (method === "POST" && pathname === "/api/source/init") {
-      const settings = readSettings();
-      const sourcePath = settings._skill_source;
-      if (!sourcePath) return sendJSON(res, { error: "未绑定本地源" }, 400);
-
-      const claudeDir = path.join(sourcePath, ".claude");
-      const skillsDir = path.join(claudeDir, "skills");
-      const profilesPath = path.join(claudeDir, "profiles.json");
-      const settingsPath = path.join(claudeDir, "settings.json");
-
-      const created = { profiles: false, settings: false, metaFiles: 0 };
-
-      // 1. profiles.json
-      if (!fs.existsSync(profilesPath)) {
-        fs.writeFileSync(
-          profilesPath,
-          JSON.stringify(
-            {
-              version: 1,
-              profiles: [
-                {
-                  id: "custom",
-                  name: "自定义技能组合",
-                  description: "自由勾选技能项，按需个性化配置",
-                  skills: null,
-                },
-              ],
-            },
-            null,
-            2,
-          ) + "\n",
-          "utf-8",
-        );
-        created.profiles = true;
-      }
-
-      // 2. settings.json
-      if (!fs.existsSync(settingsPath)) {
-        fs.writeFileSync(
-          settingsPath,
-          JSON.stringify({ skills: {}, always_apply_skills: [] }, null, 2) + "\n",
-          "utf-8",
-        );
-        created.settings = true;
-      }
-
-      // 3. 每个 skill 目录的 .meta.json
-      if (fs.existsSync(skillsDir)) {
-        for (const name of core.listSkillDirs(skillsDir)) {
-          const skillDir = path.join(skillsDir, name);
-          const metaPath = path.join(skillDir, ".meta.json");
-          if (!fs.existsSync(metaPath)) {
-            fs.writeFileSync(
-              metaPath,
-              JSON.stringify(
-                {
-                  version: "1.0.0",
-                  description: name,
-                  tags: [],
-                },
-                null,
-                2,
-              ) + "\n",
-              "utf-8",
-            );
-            created.metaFiles++;
-          }
-        }
-      }
-
-      // README.md 缺失状态
-      const readmeStatus = {
-        root: fs.existsSync(path.join(sourcePath, "README.md")),
-        skills: fs.existsSync(path.join(skillsDir, "README.md")),
-      };
-
-      return sendJSON(res, { ok: true, ...created, readmeStatus });
-    }
-
-    // POST /api/readme/create — 创建 README.md 文档
-    if (method === "POST" && pathname === "/api/readme/create") {
-      const body = await parseBody(req);
-      const settings = readSettings();
-      const sourcePath = settings._skill_source;
-      if (!sourcePath) return sendJSON(res, { error: "未绑定本地源" }, 400);
-
-      const { root, skills, projectName, teamName } = body;
-      const name = projectName || "我的技能仓库";
-      const team = teamName || "未设定";
-      const created = [];
-      const skipped = [];
-
-      // 获取技能列表
-      const skillsDir = path.join(sourcePath, ".claude", "skills");
-      const skillNames = fs.existsSync(skillsDir)
-        ? core.listSkillDirs(skillsDir)
-        : [];
-      const skillsList = skillNames.length
-        ? skillNames.map((s) => `- \`${s}\``).join("\n")
-        : "<!-- 暂无技能 -->";
-
-      // 根目录 README.md
-      if (root) {
-        const rootPath = path.join(sourcePath, "README.md");
-        if (!fs.existsSync(rootPath)) {
-          const tmpl = `# ${name}
-
-> 维护团队：${team}
-
-## 简介
-
-<!--
-在这里写这个技能仓库的简介。
-
-示例：
-本仓库包含面向 mdk-engineer 的前端开发技能集，涵盖 Vue3 组件开发、Chrome DevTools 使用、性能优化等方向。
--->
-
-## 技能列表
-
-${skillsList}
-
-## 使用方式
-
-本仓库通过 mdk-skills 管理技能，连接本地源后即可在 Web UI 中查看和安装技能。
-
-## License
-
-<!-- 许可证信息 -->
-`;
-          fs.writeFileSync(rootPath, tmpl, "utf-8");
-          created.push("README.md");
-        } else {
-          skipped.push("README.md");
-        }
-      }
-
-      // skills/README.md
-      if (skills) {
-        const skillsReadmePath = path.join(skillsDir, "README.md");
-        if (!fs.existsSync(skillsReadmePath)) {
-          const tmpl = `# 技能说明
-
-## 快速开始
-
-<!--
-安装 mdk-skills 后连接本仓库，即可在 Web UI 中查看所有技能。
--->
-
-## 场景建议
-
-<!--
-这里可以写哪些技能适合一起使用，不同开发场景下的推荐组合。
-
-示例：
-- 日常开发：启用代码格式化、ESLint 校验、Git 辅助
-- 性能优化：启用 Lighthouse、Bundle Analysis
--->
-
-## 注意事项
-
-<!--
-技能使用过程中的注意事项。
--->
-`;
-          fs.writeFileSync(skillsReadmePath, tmpl, "utf-8");
-          created.push("skills/README.md");
-        } else {
-          skipped.push("skills/README.md");
-        }
-      }
-
-      return sendJSON(res, { ok: true, created, skipped });
-    }
-
-    // GET /api/diagnose — 健康检查
-    if (method === "GET" && pathname === "/api/diagnose") {
-      const results = [];
-      const pkgSkills = core.getPackageSkills(skillsSource);
-      for (const skill of pkgSkills) {
-        const skillDir = path.join(skillsDest, skill.name);
-        const issues = [];
-        if (!fs.existsSync(skillDir)) {
-          issues.push("未安装");
-        } else {
-          const metaPath = path.join(skillDir, ".meta.json");
-          if (!fs.existsSync(metaPath)) {
-            issues.push("缺少 .meta.json");
-          } else {
-            try {
-              const meta = JSON.parse(fs.readFileSync(metaPath, "utf-8"));
-              if (!meta.version) issues.push("版本号缺失");
-            } catch {
-              issues.push(".meta.json 格式错误");
-            }
-          }
-        }
-        results.push({
-          name: skill.name,
-          healthy: issues.length === 0,
-          issues,
-        });
-      }
-      return sendJSON(res, results);
-    }
-
-    // 404
-    sendJSON(res, { error: "Not Found: " + pathname }, 404);
-  } catch (err) {
-    console.error("API 错误:", err);
-    sendJSON(res, { error: err.message }, 500);
-  }
-}
-
-// ---------- 启动 ----------
-
-async function startUI() {
-  const vite = await createViteServer({
-    root: __dirname,
-    server: { port: 3344, open: false },
-    plugins: [
-      vue(),
-      {
-        name: "api-routes",
-        configureServer(viteServer) {
-          viteServer.middlewares.use((req, res, next) => {
-            if (req.url.startsWith("/api")) {
-              handleApi(req, res);
-            } else {
-              next();
-            }
-          });
-        },
-      },
-    ],
-  });
-
-  await vite.listen();
-  const port = vite.config.server.port;
-  console.log(`\n  🖥️  mdk-skills Web UI`);
-  console.log(`  ─────────────────────`);
-  console.log(`  地址: http://localhost:${port}\n`);
-  console.log(`  按 Ctrl+C 停止服务\n`);
-}
-
-startUI().catch((err) => {
-  console.error("启动失败:", err);
-  process.exit(1);
-});
+const fs = require("fs");
+const path = require("path");
+const http = require("http");
+const { execSync } = require("child_process");
+const os = require("os");
+const core = require("../core");
+
+// ---------- 路径（与 cli.js 保持一致） ----------
+
+const projectRoot = (() => {
+  try {
+    return fs.realpathSync.native(process.cwd());
+  } catch {
+    return process.cwd();
+  }
+})();
+const packageDir = path.join(__dirname, "..", "..");
+let skillsSource = core.getSkillsSource(projectRoot, packageDir);
+const claudeDest = path.join(projectRoot, ".claude");
+const skillsDest = path.join(claudeDest, "skills");
+const settingsPath = path.join(claudeDest, "settings.json");
+let pkgSkillsSource = path.join(skillsSource, ".claude", "skills");
+
+// 连接/断开本地源后刷新技能源路径
+function refreshSource() {
+  skillsSource = core.getSkillsSource(projectRoot, packageDir);
+  pkgSkillsSource = path.join(skillsSource, ".claude", "skills");
+}
+
+// ---------- 工具函数 ----------
+
+function readSettings() {
+  if (!fs.existsSync(settingsPath))
+    return { skills: {}, always_apply_skills: [] };
+  try {
+    return JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+  } catch {
+    return { skills: {}, always_apply_skills: [] };
+  }
+}
+
+function writeSettings(settings) {
+  if (!fs.existsSync(claudeDest)) {
+    fs.mkdirSync(claudeDest, { recursive: true });
+  }
+  fs.writeFileSync(
+    settingsPath,
+    JSON.stringify(settings, null, 2) + "\n",
+    "utf-8",
+  );
+}
+
+function sendJSON(res, data, status = 200) {
+  res.writeHead(status, { "Content-Type": "application/json" });
+  res.end(JSON.stringify(data));
+}
+
+function parseBody(req) {
+  return new Promise((resolve) => {
+    let body = "";
+    req.on("data", (chunk) => (body += chunk));
+    req.on("end", () => {
+      try {
+        resolve(JSON.parse(body));
+      } catch {
+        resolve({});
+      }
+    });
+  });
+}
+
+// 手动递归拷贝目录
+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);
+    }
+  }
+}
+
+// 读取 profiles.json
+function loadProfiles() {
+  const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
+  if (!fs.existsSync(profilesPath)) return null;
+  try {
+    return JSON.parse(fs.readFileSync(profilesPath, "utf-8")).profiles;
+  } catch {
+    return null;
+  }
+}
+
+// 应用场景
+function applyProfile(profile) {
+  const pkgSkills = core.listSkillDirs(pkgSkillsSource);
+  const settings = readSettings();
+
+  let selected;
+  if (profile.skills === null) {
+    return { selected: [], message: "自定义场景，不做自动切换" };
+  } else if (profile.skills.length === 0) {
+    selected = [];
+  } else {
+    selected = profile.skills.filter((s) => pkgSkills.includes(s));
+  }
+
+  // 安装/删除技能
+  if (!fs.existsSync(skillsDest)) {
+    fs.mkdirSync(skillsDest, { recursive: true });
+  }
+  for (const name of pkgSkills) {
+    const src = path.join(pkgSkillsSource, name);
+    const dest = path.join(skillsDest, name);
+    if (selected.includes(name)) {
+      if (!fs.existsSync(dest)) {
+        try {
+          copyDirSync(src, dest);
+        } catch (err) {
+          console.error(`安装技能 "${name}" 失败:`, err.message);
+        }
+      }
+    } else {
+      if (fs.existsSync(dest)) {
+        fs.rmSync(dest, { recursive: true, force: true });
+      }
+    }
+  }
+
+  // 更新 settings
+  if (!settings.skills) settings.skills = {};
+  for (const name of pkgSkills) {
+    const enabled = selected.includes(name);
+    if (!settings.skills[name]) settings.skills[name] = {};
+    settings.skills[name].enabled = enabled;
+  }
+
+  if (profile.always_apply) {
+    settings.always_apply_skills = profile.always_apply;
+  }
+
+  settings._active_profile = profile.id;
+  writeSettings(settings);
+
+  // 复制 profiles.json
+  const profilesSource = path.join(skillsSource, ".claude", "profiles.json");
+  const profilesDest = path.join(claudeDest, "profiles.json");
+  if (fs.existsSync(profilesSource)) {
+    fs.copyFileSync(profilesSource, profilesDest);
+  }
+
+  // 复制 CLAUDE.md（不存在才装）
+  const mdSource = path.join(skillsSource, "CLAUDE.md");
+  const mdDest = path.join(projectRoot, "CLAUDE.md");
+  if (fs.existsSync(mdSource) && !fs.existsSync(mdDest)) {
+    fs.copyFileSync(mdSource, mdDest);
+  }
+
+  return {
+    selected,
+    enabled: selected.length,
+    disabled: pkgSkills.length - selected.length,
+  };
+}
+
+// 安装勾选的技能
+function installSelectedSkills(selectedNames) {
+  if (!fs.existsSync(pkgSkillsSource)) return { installed: 0 };
+
+  if (!fs.existsSync(skillsDest)) {
+    fs.mkdirSync(skillsDest, { recursive: true });
+  }
+
+  const allPkgSkills = core.listSkillDirs(pkgSkillsSource);
+  let installedCount = 0;
+
+  for (const name of allPkgSkills) {
+    const src = path.join(pkgSkillsSource, name);
+    const dest = path.join(skillsDest, name);
+
+    if (selectedNames.includes(name)) {
+      if (!fs.existsSync(dest)) {
+        try {
+          copyDirSync(src, dest);
+          installedCount++;
+        } catch (err) {
+          console.error(`安装技能 "${name}" 失败:`, err.message);
+        }
+      }
+    } else {
+      if (fs.existsSync(dest)) {
+        fs.rmSync(dest, { recursive: true, force: true });
+      }
+    }
+  }
+
+  const settings = readSettings();
+  if (!settings.skills) settings.skills = {};
+  for (const name of allPkgSkills) {
+    const enabled = selectedNames.includes(name);
+    if (!settings.skills[name]) settings.skills[name] = {};
+    settings.skills[name].enabled = enabled;
+  }
+  writeSettings(settings);
+
+  // 复制 CLAUDE.md（不存在才装）
+  const mdSource = path.join(skillsSource, "CLAUDE.md");
+  const mdDest = path.join(projectRoot, "CLAUDE.md");
+  if (fs.existsSync(mdSource) && !fs.existsSync(mdDest)) {
+    fs.copyFileSync(mdSource, mdDest);
+  }
+
+  return { installed: installedCount };
+}
+
+// ---------- API 路由 ----------
+
+async function handleApi(req, res) {
+  const url = new URL(req.url, `http://${req.headers.host || "localhost"}`);
+  const pathname = url.pathname;
+  const method = req.method;
+
+  // CORS & 防缓存
+  res.setHeader("Access-Control-Allow-Origin", "*");
+  res.setHeader("Access-Control-Allow-Methods", "GET, POST, PATCH, DELETE, OPTIONS");
+  res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+  res.setHeader("Cache-Control", "no-cache, no-store, must-revalidate");
+
+  if (method === "OPTIONS") {
+    res.writeHead(204);
+    res.end();
+    return;
+  }
+
+  try {
+    // GET /api/skills — 获取所有技能列表（含启用状态），同时清理已失效的技能
+    if (method === "GET" && pathname === "/api/skills") {
+      const pkgSkills = core.getPackageSkills(skillsSource);
+      const pkgNames = new Set(pkgSkills.map((s) => s.name));
+      const userSkills = core.getUserSkills(claudeDest);
+      // 清理：源目录已删除的技能，项目中也一并移除
+      let cleaned = false;
+      for (const us of userSkills) {
+        if (!pkgNames.has(us.name)) {
+          const dest = path.join(skillsDest, us.name);
+          if (fs.existsSync(dest)) {
+            fs.rmSync(dest, { recursive: true, force: true });
+            cleaned = true;
+          }
+        }
+      }
+      if (cleaned) {
+        const settings = readSettings();
+        for (const name of Object.keys(settings.skills || {})) {
+          if (!pkgNames.has(name)) delete settings.skills[name];
+        }
+        writeSettings(settings);
+      }
+      const refreshed = core.getUserSkills(claudeDest);
+      const userMap = new Map(refreshed.map((s) => [s.name, s]));
+      const result = pkgSkills.map((s) => ({
+        ...s,
+        enabled: userMap.has(s.name) ? userMap.get(s.name).enabled : false,
+        installed: userMap.has(s.name),
+      }));
+      return sendJSON(res, result);
+    }
+
+    // POST /api/skills/toggle — 开关技能（启用时自动安装）
+    if (method === "POST" && pathname === "/api/skills/toggle") {
+      const body = await parseBody(req);
+      const { name, enabled } = body;
+      if (!name) return sendJSON(res, { error: "缺少技能名" }, 400);
+      if (enabled) {
+        const src = path.join(pkgSkillsSource, name);
+        const dest = path.join(skillsDest, name);
+        if (fs.existsSync(src) && !fs.existsSync(dest)) {
+          copyDirSync(src, dest);
+        }
+      }
+      const settings = readSettings();
+      if (!settings.skills) settings.skills = {};
+      if (!settings.skills[name]) settings.skills[name] = {};
+      settings.skills[name].enabled = !!enabled;
+      writeSettings(settings);
+      return sendJSON(res, { ok: true, name, enabled: !!enabled });
+    }
+
+    // POST /api/skills/install — 自定义勾选安装
+    if (method === "POST" && pathname === "/api/skills/install") {
+      const body = await parseBody(req);
+      const { selected } = body;
+      if (!Array.isArray(selected))
+        return sendJSON(res, { error: "参数错误" }, 400);
+      const result = installSelectedSkills(selected);
+      return sendJSON(res, { ok: true, ...result });
+    }
+    // POST /api/skills/pull — 从远程仓库拉取技能
+    if (method === "POST" && pathname === "/api/skills/pull") {
+      const body = await parseBody(req);
+      const url = (body.url || "").trim();
+      if (!url) return sendJSON(res, { error: "请输入仓库地址" }, 400);
+      const tmpDir = path.join(os.tmpdir(), "mdk-pull-" + Date.now());
+      try {
+        execSync("git clone --depth 1 \"" + url + "\" \"" + tmpDir + "\"", {
+          stdio: "pipe",
+          timeout: 120000,
+        });
+      } catch {
+        if (fs.existsSync(tmpDir)) fs.rmSync(tmpDir, { recursive: true, force: true });
+        return sendJSON(res, { error: "仓库克隆失败，请检查地址是否正确" }, 400);
+      }
+      let skillsDir = null;
+      const claudeSkills = path.join(tmpDir, ".claude", "skills");
+      const skills = path.join(tmpDir, "skills");
+      if (fs.existsSync(claudeSkills)) {
+        skillsDir = claudeSkills;
+      } else if (fs.existsSync(skills)) {
+        skillsDir = skills;
+      }
+      if (!skillsDir) {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+        return sendJSON(res, { error: "仓库中未找到 .claude/skills 或 skills 目录" }, 400);
+      }
+      const imported = [];
+      const skipped = [];
+      const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+        const skillPath = path.join(skillsDir, entry.name);
+        if (fs.existsSync(path.join(skillPath, "SKILL.md"))) {
+          const dest = path.join(pkgSkillsSource, entry.name);
+          if (fs.existsSync(dest)) {
+            fs.rmSync(dest, { recursive: true, force: true });
+          }
+          fs.cpSync(skillPath, dest, { recursive: true });
+          const fm = core.parseFrontmatter(dest);
+          if (fm) {
+            fs.writeFileSync(path.join(dest, ".meta.json"), JSON.stringify({
+              version: fm.version || "1.0.0",
+              description: fm.description || "",
+              tags: fm.tags || [],
+            }, null, 2) + "\n", "utf-8");
+          }
+          imported.push(entry.name);
+        } else {
+          skipped.push(entry.name);
+        }
+      }
+      fs.rmSync(tmpDir, { recursive: true, force: true });
+      if (imported.length === 0) {
+        return sendJSON(res, { error: "未找到有效的技能（目录需包含 SKILL.md）", skipped }, 400);
+      }
+      return sendJSON(res, { ok: true, imported, skipped });
+    }
+
+    // GET /api/readme — 获取根目录 README.md
+    if (method === "GET" && pathname === "/api/readme") {
+      const p = path.join(skillsSource, "README.md");
+      const content = fs.existsSync(p) ? fs.readFileSync(p, "utf-8") : null;
+      return sendJSON(res, { content, found: !!content });
+    }
+
+    // GET /api/skills-readme — 获取技能目录 README.md
+    if (method === "GET" && pathname === "/api/skills-readme") {
+      const p = path.join(skillsSource, ".claude", "skills", "README.md");
+      const content = fs.existsSync(p) ? fs.readFileSync(p, "utf-8") : null;
+      return sendJSON(res, { content, found: !!content });
+    }
+
+    // GET /api/claudemd — 获取 CLAUDE.md 内容
+    if (method === "GET" && pathname === "/api/claudemd") {
+      const paths = [
+        path.join(skillsSource, "CLAUDE.md"),
+        path.join(projectRoot, "CLAUDE.md"),
+      ];
+      let content = null;
+      for (const p of paths) {
+        if (fs.existsSync(p)) {
+          content = fs.readFileSync(p, "utf-8");
+          break;
+        }
+      }
+      return sendJSON(res, { content, found: !!content });
+    }
+
+    // GET /api/skills/:name/readme — 获取技能的 SKILL.md
+    const readmeMatch = pathname.match(/^\/api\/skills\/([^/]+)\/readme$/);
+    if (method === "GET" && readmeMatch) {
+      const name = readmeMatch[1];
+      const skillDir = path.join(skillsDest, name);
+      const altDir = path.join(pkgSkillsSource, name);
+      const readmePath = [
+        path.join(skillDir, "SKILL.md"),
+        path.join(altDir, "SKILL.md"),
+      ].find((p) => fs.existsSync(p));
+      const content = readmePath ? fs.readFileSync(readmePath, "utf-8") : null;
+      return sendJSON(res, { content, found: !!readmePath });
+    }
+
+    // PATCH /api/skills/:name/meta — 更新技能元信息
+    const metaMatch = pathname.match(/^\/api\/skills\/([^/]+)\/meta$/);
+    if (method === "PATCH" && metaMatch) {
+      const name = metaMatch[1];
+      const skillDir = path.join(pkgSkillsSource, name);
+      if (!fs.existsSync(skillDir)) {
+        return sendJSON(res, { error: "技能不存在" }, 404);
+      }
+      const metaPath = path.join(skillDir, ".meta.json");
+      let meta = {};
+      if (fs.existsSync(metaPath)) {
+        try { meta = JSON.parse(fs.readFileSync(metaPath, "utf-8")); } catch {}
+      }
+      const body = await parseBody(req);
+      if (body.version !== undefined) meta.version = String(body.version);
+      if (body.description !== undefined) meta.description = String(body.description);
+      if (body.tags !== undefined) {
+        meta.tags = Array.isArray(body.tags) ? body.tags.filter((t) => typeof t === "string") : [];
+      }
+      fs.writeFileSync(metaPath, JSON.stringify(meta, null, 2) + "\n", "utf-8");
+      return sendJSON(res, { ok: true, meta });
+    }
+
+    // DELETE /api/skills/:name — 删除技能（源目录 + 项目目录）
+    const deleteMatch = pathname.match(/^\/api\/skills\/([^/]+)$/);
+    if (method === "DELETE" && deleteMatch) {
+      const name = deleteMatch[1];
+      const sourceDir = path.join(pkgSkillsSource, name);
+      const destDir = path.join(skillsDest, name);
+      let deleted = [];
+
+      if (fs.existsSync(sourceDir)) {
+        fs.rmSync(sourceDir, { recursive: true, force: true });
+        deleted.push("源目录");
+      }
+      if (fs.existsSync(destDir)) {
+        fs.rmSync(destDir, { recursive: true, force: true });
+        deleted.push("项目目录");
+      }
+
+      // 清理 settings 中的启用状态
+      const settings = readSettings();
+      if (settings.skills && settings.skills[name] !== undefined) {
+        delete settings.skills[name];
+        writeSettings(settings);
+      }
+
+      if (deleted.length === 0) {
+        return sendJSON(res, { error: "技能不存在" }, 404);
+      }
+      return sendJSON(res, { ok: true, name, deleted });
+    }
+
+    // GET /api/profiles — 获取场景列表（含只读状态）
+    if (method === "GET" && pathname === "/api/profiles") {
+      const profiles = loadProfiles();
+      const settings = readSettings();
+      return sendJSON(res, {
+        profiles: profiles || [],
+        activeProfile: settings._active_profile || null,
+        readonly: !settings._skill_source,
+      });
+    }
+
+    // POST /api/profiles/apply — 应用场景
+    if (method === "POST" && pathname === "/api/profiles/apply") {
+      const body = await parseBody(req);
+      const { profileId } = body;
+      if (!profileId) return sendJSON(res, { error: "缺少场景 ID" }, 400);
+      const profiles = loadProfiles();
+      const profile = profiles?.find((p) => p.id === profileId);
+      if (!profile)
+        return sendJSON(res, { error: "场景不存在: " + profileId }, 404);
+      const result = applyProfile(profile);
+      return sendJSON(res, { ok: true, ...result });
+    }
+
+    // POST /api/profiles/save — 新增/编辑场景（仅本地源模式）
+    if (method === "POST" && pathname === "/api/profiles/save") {
+      const body = await parseBody(req);
+      const settings = readSettings();
+      if (!settings._skill_source)
+        return sendJSON(res, { error: "npm 模式下不可编辑场景" }, 403);
+
+      const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
+      let data = { version: 1, profiles: [] };
+      if (fs.existsSync(profilesPath)) {
+        try {
+          data = JSON.parse(fs.readFileSync(profilesPath, "utf-8"));
+        } catch {}
+      }
+
+      const { id, name, description, skills, always_apply } = body;
+      if (!name) return sendJSON(res, { error: "场景名称不能为空" }, 400);
+
+      if (id) {
+        const index = data.profiles.findIndex((p) => p.id === id);
+        if (index === -1) return sendJSON(res, { error: "场景不存在" }, 404);
+        data.profiles[index] = {
+          ...data.profiles[index],
+          name,
+          description: description || "",
+          skills: skills || [],
+          always_apply: always_apply || [],
+        };
+      } else {
+        const newId = "profile_" + Date.now().toString(36);
+        data.profiles.push({
+          id: newId,
+          name,
+          description: description || "",
+          skills: skills || [],
+          always_apply: always_apply || [],
+        });
+      }
+
+      fs.writeFileSync(profilesPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+
+      // 同步到项目 .claude
+      const projectProfilesPath = path.join(claudeDest, "profiles.json");
+      fs.writeFileSync(projectProfilesPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+
+      return sendJSON(res, { ok: true, profiles: data.profiles });
+    }
+
+    // POST /api/profiles/delete — 删除场景（仅本地源模式）
+    if (method === "POST" && pathname === "/api/profiles/delete") {
+      const body = await parseBody(req);
+      const settings = readSettings();
+      if (!settings._skill_source)
+        return sendJSON(res, { error: "npm 模式下不可编辑场景" }, 403);
+
+      const { id } = body;
+      if (!id) return sendJSON(res, { error: "缺少场景 ID" }, 400);
+      if (id === "custom")
+        return sendJSON(res, { error: "不能删除内置场景" }, 403);
+
+      const profilesPath = path.join(skillsSource, ".claude", "profiles.json");
+      if (!fs.existsSync(profilesPath))
+        return sendJSON(res, { error: "场景文件不存在" }, 404);
+
+      const data = JSON.parse(fs.readFileSync(profilesPath, "utf-8"));
+      const index = data.profiles.findIndex((p) => p.id === id);
+      if (index === -1) return sendJSON(res, { error: "场景不存在" }, 404);
+
+      data.profiles.splice(index, 1);
+      fs.writeFileSync(profilesPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+
+      // 同步到项目 .claude
+      const projectProfilesPath = path.join(claudeDest, "profiles.json");
+      fs.writeFileSync(projectProfilesPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+
+      return sendJSON(res, { ok: true });
+    }
+
+    // GET /api/status — 当前状态总览
+    if (method === "GET" && pathname === "/api/status") {
+      const settings = readSettings();
+      const userSkills = core.getUserSkills(claudeDest);
+      const pkgSkills = core.getPackageSkills(skillsSource);
+      const profiles = loadProfiles();
+      const activeProfile = profiles?.find(
+        (p) => p.id === settings._active_profile,
+      );
+      const enabledCount = userSkills.filter((s) => s.enabled).length;
+      const mdExists = fs.existsSync(path.join(projectRoot, "CLAUDE.md"));
+      return sendJSON(res, {
+        pkgSkills,
+        enabledCount,
+        totalCount: pkgSkills.length,
+        activeProfile: activeProfile
+          ? { id: activeProfile.id, name: activeProfile.name }
+          : null,
+        sourcePath: settings._skill_source || null,
+        hasClaudeMd: mdExists,
+      });
+    }
+
+    // GET /api/source — 获取本地源信息（含初始化检测）
+    if (method === "GET" && pathname === "/api/source") {
+      const settings = readSettings();
+      const sourcePath = settings._skill_source || null;
+
+      let needsInit = false;
+      const missingConfig = [];
+      const missingSkillDocs = [];
+      if (sourcePath) {
+        const claudeDir = path.join(sourcePath, ".claude");
+        if (fs.existsSync(claudeDir)) {
+          if (!fs.existsSync(path.join(claudeDir, "profiles.json"))) {
+            missingConfig.push("profiles.json");
+          }
+          if (!fs.existsSync(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"))) {
+                missingSkillDocs.push(name);
+              }
+            }
+          }
+          needsInit = missingConfig.length > 0 || missingSkillDocs.length > 0;
+        } else {
+          needsInit = true;
+        }
+      }
+
+      // README.md 缺失状态（独立于骨架文件）
+      let readmeStatus = null;
+      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")),
+        };
+      }
+
+      return sendJSON(res, {
+        connected: !!sourcePath,
+        path: sourcePath,
+        needsInit,
+        missingConfig,
+        missingSkillDocs,
+        readmeStatus,
+      });
+    }
+
+    // POST /api/source/connect — 绑定本地源
+    if (method === "POST" && pathname === "/api/source/connect") {
+      const body = await parseBody(req);
+      const repoPath = body.path;
+      if (!repoPath) return sendJSON(res, { error: "缺少仓库路径" }, 400);
+      const resolved = path.resolve(repoPath);
+      if (!fs.existsSync(path.join(resolved, ".claude", "skills"))) {
+        return sendJSON(
+          res,
+          { error: `路径 "${resolved}" 下没有 .claude/skills/` },
+          400,
+        );
+      }
+      const settings = readSettings();
+      settings._skill_source = resolved;
+      writeSettings(settings);
+      // 复制 CLAUDE.md（不存在才装）
+      const mdSource = path.join(resolved, "CLAUDE.md");
+      const mdDest = path.join(projectRoot, "CLAUDE.md");
+      if (fs.existsSync(mdSource) && !fs.existsSync(mdDest)) {
+        fs.copyFileSync(mdSource, mdDest);
+      }
+
+      refreshSource();
+      return sendJSON(res, { ok: true, path: resolved });
+    }
+
+    // POST /api/source/disconnect — 解绑本地源
+    if (method === "POST" && pathname === "/api/source/disconnect") {
+      const settings = readSettings();
+      if (!settings._skill_source) {
+        return sendJSON(res, { error: "当前未绑定任何技能源" }, 400);
+      }
+      delete settings._skill_source;
+      writeSettings(settings);
+      refreshSource();
+      return sendJSON(res, { ok: true });
+    }
+
+    // POST /api/source/sync — 同步到本地源
+    if (method === "POST" && pathname === "/api/source/sync") {
+      const settings = readSettings();
+      const sourcePath = settings._skill_source;
+      if (!sourcePath) return sendJSON(res, { error: "尚未绑定技能源" }, 400);
+      if (!fs.existsSync(path.join(sourcePath, ".claude"))) {
+        return sendJSON(res, { error: "绑定的路径已失效" }, 400);
+      }
+
+      const repoClaude = path.join(sourcePath, ".claude");
+      core.backupDir(repoClaude);
+
+      // 技能反推
+      const repoSkills = path.join(sourcePath, ".claude", "skills");
+      if (!fs.existsSync(repoSkills))
+        fs.mkdirSync(repoSkills, { recursive: true });
+      if (fs.existsSync(skillsDest)) {
+        for (const name of core.listSkillDirs(skillsDest)) {
+          const src = path.join(skillsDest, name);
+          const dest = path.join(repoSkills, name);
+          if (fs.existsSync(dest))
+            fs.rmSync(dest, { recursive: true, force: true });
+          copyDirSync(src, dest);
+        }
+      }
+
+      // profiles.json 反推
+      const projectProfiles = path.join(claudeDest, "profiles.json");
+      if (fs.existsSync(projectProfiles)) {
+        fs.copyFileSync(
+          projectProfiles,
+          path.join(sourcePath, ".claude", "profiles.json"),
+        );
+      }
+
+      // settings.json 反推
+      const cleanSettings = { ...settings };
+      delete cleanSettings._skill_source;
+      delete cleanSettings._active_profile;
+      fs.writeFileSync(
+        path.join(sourcePath, ".claude", "settings.json"),
+        JSON.stringify(cleanSettings, null, 2) + "\n",
+        "utf-8",
+      );
+
+      // CLAUDE.md 反推
+      const projectMd = path.join(projectRoot, "CLAUDE.md");
+      if (fs.existsSync(projectMd)) {
+        fs.copyFileSync(projectMd, path.join(sourcePath, "CLAUDE.md"));
+      }
+
+      return sendJSON(res, { ok: true });
+    }
+
+    // POST /api/source/init — 初始化本地源骨架文件（缺啥补啥）
+    if (method === "POST" && pathname === "/api/source/init") {
+      const settings = readSettings();
+      const sourcePath = settings._skill_source;
+      if (!sourcePath) return sendJSON(res, { error: "未绑定本地源" }, 400);
+
+      const claudeDir = path.join(sourcePath, ".claude");
+      const skillsDir = path.join(claudeDir, "skills");
+      const profilesPath = path.join(claudeDir, "profiles.json");
+      const settingsPath = path.join(claudeDir, "settings.json");
+
+      const created = { profiles: false, settings: false, metaFiles: 0 };
+
+      // 1. profiles.json
+      if (!fs.existsSync(profilesPath)) {
+        fs.writeFileSync(
+          profilesPath,
+          JSON.stringify(
+            {
+              version: 1,
+              profiles: [
+                {
+                  id: "custom",
+                  name: "自定义技能组合",
+                  description: "自由勾选技能项，按需个性化配置",
+                  skills: null,
+                },
+              ],
+            },
+            null,
+            2,
+          ) + "\n",
+          "utf-8",
+        );
+        created.profiles = true;
+      }
+
+      // 2. settings.json
+      if (!fs.existsSync(settingsPath)) {
+        fs.writeFileSync(
+          settingsPath,
+          JSON.stringify({ skills: {}, always_apply_skills: [] }, null, 2) + "\n",
+          "utf-8",
+        );
+        created.settings = true;
+      }
+
+      // 3. 每个 skill 目录的 .meta.json（优先从 SKILL.md frontmatter 读取）
+      if (fs.existsSync(skillsDir)) {
+        for (const name of core.listSkillDirs(skillsDir)) {
+          const skillDir = path.join(skillsDir, name);
+          const metaPath = path.join(skillDir, ".meta.json");
+          if (!fs.existsSync(metaPath)) {
+            const fm = core.parseFrontmatter(skillDir);
+            const meta = {
+              version: fm?.version || "1.0.0",
+              description: fm?.description || name,
+              tags: fm?.tags || [],
+            };
+            fs.writeFileSync(
+              metaPath,
+              JSON.stringify(meta, null, 2) + "\n",
+              "utf-8",
+            );
+            created.metaFiles++;
+          }
+        }
+      }
+
+      // README.md 缺失状态
+      const readmeStatus = {
+        root: fs.existsSync(path.join(sourcePath, "README.md")),
+        skills: fs.existsSync(path.join(skillsDir, "README.md")),
+      };
+
+      return sendJSON(res, { ok: true, ...created, readmeStatus });
+    }
+
+    // POST /api/readme/create — 创建 README.md 文档
+    if (method === "POST" && pathname === "/api/readme/create") {
+      const body = await parseBody(req);
+      const settings = readSettings();
+      const sourcePath = settings._skill_source;
+      if (!sourcePath) return sendJSON(res, { error: "未绑定本地源" }, 400);
+
+      const { root, skills, projectName, teamName } = body;
+      const name = projectName || "我的技能仓库";
+      const team = teamName || "未设定";
+      const created = [];
+      const skipped = [];
+
+      // 获取技能列表
+      const skillsDir = path.join(sourcePath, ".claude", "skills");
+      const skillNames = fs.existsSync(skillsDir)
+        ? core.listSkillDirs(skillsDir)
+        : [];
+      const skillsList = skillNames.length
+        ? skillNames.map((s) => `- \`${s}\``).join("\n")
+        : "<!-- 暂无技能 -->";
+
+      // 根目录 README.md
+      if (root) {
+        const rootPath = path.join(sourcePath, "README.md");
+        if (!fs.existsSync(rootPath)) {
+          const tmpl = `# ${name}
+
+> 维护团队：${team}
+
+## 简介
+
+<!--
+在这里写这个技能仓库的简介。
+
+示例：
+本仓库包含面向 mdk-engineer 的前端开发技能集，涵盖 Vue3 组件开发、Chrome DevTools 使用、性能优化等方向。
+-->
+
+## 技能列表
+
+${skillsList}
+
+## 使用方式
+
+本仓库通过 mdk-skills 管理技能，连接本地源后即可在 Web UI 中查看和安装技能。
+
+## License
+
+<!-- 许可证信息 -->
+`;
+          fs.writeFileSync(rootPath, tmpl, "utf-8");
+          created.push("README.md");
+        } else {
+          skipped.push("README.md");
+        }
+      }
+
+      // skills/README.md
+      if (skills) {
+        const skillsReadmePath = path.join(skillsDir, "README.md");
+        if (!fs.existsSync(skillsReadmePath)) {
+          const tmpl = `# 技能说明
+
+## 快速开始
+
+<!--
+安装 mdk-skills 后连接本仓库，即可在 Web UI 中查看所有技能。
+-->
+
+## 场景建议
+
+<!--
+这里可以写哪些技能适合一起使用，不同开发场景下的推荐组合。
+
+示例：
+- 日常开发：启用代码格式化、ESLint 校验、Git 辅助
+- 性能优化：启用 Lighthouse、Bundle Analysis
+-->
+
+## 注意事项
+
+<!--
+技能使用过程中的注意事项。
+-->
+`;
+          fs.writeFileSync(skillsReadmePath, tmpl, "utf-8");
+          created.push("skills/README.md");
+        } else {
+          skipped.push("skills/README.md");
+        }
+      }
+
+      return sendJSON(res, { ok: true, created, skipped });
+    }
+
+    // GET /api/diagnose — 健康检查
+    if (method === "GET" && pathname === "/api/diagnose") {
+      const results = [];
+      const pkgSkills = core.getPackageSkills(skillsSource);
+      for (const skill of pkgSkills) {
+        const skillDir = path.join(skillsDest, skill.name);
+        const issues = [];
+        if (!fs.existsSync(skillDir)) {
+          issues.push("未安装");
+        } else {
+          if (!fs.existsSync(path.join(skillDir, "SKILL.md"))) {
+            issues.push("缺少 SKILL.md");
+          } else if (!core.parseFrontmatter(skillDir)) {
+            issues.push("SKILL.md frontmatter 格式异常");
+          }
+          // .meta.json 为可选项，缺失不报错
+        }
+        results.push({
+          name: skill.name,
+          healthy: issues.length === 0,
+          issues,
+        });
+      }
+      return sendJSON(res, results);
+    }
+
+    // 404
+    sendJSON(res, { error: "Not Found: " + pathname }, 404);
+  } catch (err) {
+    console.error("API 错误:", err);
+    sendJSON(res, { error: err.message }, 500);
+  }
+}
+
+// ---------- 启动 ----------
+
+const MIME_TYPES = {
+  ".html": "text/html",
+  ".js": "application/javascript",
+  ".css": "text/css",
+  ".png": "image/png",
+  ".jpg": "image/jpeg",
+  ".svg": "image/svg+xml",
+  ".ico": "image/x-icon",
+  ".json": "application/json",
+  ".woff2": "font/woff2",
+  ".woff": "font/woff",
+};
+
+function startProduction(distDir) {
+  const server = http.createServer((req, res) => {
+    if (req.url.startsWith("/api")) {
+      handleApi(req, res);
+      return;
+    }
+    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")));
+    }
+  });
+  server.listen(3344, () => {
+    console.log(`\n  🖥️  mdk-skills Web UI`);
+    console.log(`  ─────────────────────`);
+    console.log(`  地址: http://localhost:3344\n`);
+    console.log(`  按 Ctrl+C 停止服务\n`);
+  });
+}
+
+async function startDev() {
+  const { createServer: createViteServer } = require("vite");
+  const vue = require("@vitejs/plugin-vue");
+  const vite = await createViteServer({
+    root: __dirname,
+    server: { port: 3344, open: false },
+    plugins: [
+      vue(),
+      {
+        name: "api-routes",
+        configureServer(viteServer) {
+          viteServer.middlewares.use((req, res, next) => {
+            if (req.url.startsWith("/api")) {
+              handleApi(req, res);
+            } else {
+              next();
+            }
+          });
+        },
+      },
+    ],
+  });
+  await vite.listen();
+  const port = vite.config.server.port;
+  console.log(`\n  🖥️  mdk-skills Web UI`);
+  console.log(`  ─────────────────────`);
+  console.log(`  地址: http://localhost:${port}\n`);
+  console.log(`  按 Ctrl+C 停止服务\n`);
+}
+
+// 自动选择模式：有构建产物就走生产模式，否则走 Vite dev
+const distDir = path.join(__dirname, "dist");
+if (fs.existsSync(distDir)) {
+  startProduction(distDir);
+} else {
+  startDev().catch((err) => {
+    console.error("启动失败:", err);
+    process.exit(1);
+  });
+}