mdk-skills 2.2.9 → 2.2.11

package/scripts/core.js

@@ -109,6 +109,17 @@ function deepMerge(userObj, pkgObj) {
   return result;
 }
 
+/**
+ * 列出技能目录下的有效技能目录（排除非目录项和隐藏目录）
+ */
+function listSkillDirs(skillsPath) {
+  if (!fs.existsSync(skillsPath)) return [];
+  return fs.readdirSync(skillsPath).filter((name) => {
+    const fullPath = path.join(skillsPath, name);
+    return fs.statSync(fullPath).isDirectory() && !name.startsWith(".");
+  });
+}
+
 /**
  * 读取技能目录下的 .meta.json，没有则返回 null
  */
@@ -134,7 +145,7 @@ function installSkills(skillsSource, skillsDest, logFile) {
     fs.mkdirSync(skillsDest, { recursive: true });
   }
 
-  const skillDirs = fs.readdirSync(skillsSource);
+  const skillDirs = listSkillDirs(skillsSource);
   const results = [];
 
   for (const dir of skillDirs) {
@@ -202,9 +213,7 @@ function installSettings(sourceDir, destDir, logFile) {
  */
 function getPackageSkills(packageDir) {
   const skillsSource = path.join(packageDir, ".claude", "skills");
-  if (!fs.existsSync(skillsSource)) return [];
-
-  return fs.readdirSync(skillsSource).map((name) => {
+  return listSkillDirs(skillsSource).map((name) => {
     const meta = readMeta(path.join(skillsSource, name));
     return {
       name,
@@ -250,7 +259,7 @@ function getUserSkills(claudeDest) {
 
   const skillConfigs = settings.skills || {};
 
-  return fs.readdirSync(skillsDest).map((name) => {
+  return listSkillDirs(skillsDest).map((name) => {
     const meta = readMeta(path.join(skillsDest, name));
     const config = skillConfigs[name] || {};
     return {
@@ -270,6 +279,7 @@ module.exports = {
   backupDir,
   copyDirSync,
   deepMerge,
+  listSkillDirs,
   readMeta,
   installSkills,
   installSettings,

package/scripts/web-ui/server.js

@@ -95,9 +95,7 @@ function loadProfiles() {
 
 // 应用场景
 function applyProfile(profile) {
-  const pkgSkills = fs.existsSync(pkgSkillsSource)
-    ? fs.readdirSync(pkgSkillsSource)
-    : [];
+  const pkgSkills = core.listSkillDirs(pkgSkillsSource);
   const settings = readSettings();
 
   let selected;
@@ -153,6 +151,13 @@ function applyProfile(profile) {
     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,
@@ -168,7 +173,7 @@ function installSelectedSkills(selectedNames) {
     fs.mkdirSync(skillsDest, { recursive: true });
   }
 
-  const allPkgSkills = fs.readdirSync(pkgSkillsSource);
+  const allPkgSkills = core.listSkillDirs(pkgSkillsSource);
   let installedCount = 0;
 
   for (const name of allPkgSkills) {
@@ -200,6 +205,13 @@ function installSelectedSkills(selectedNames) {
   }
   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 };
 }
 
@@ -286,6 +298,50 @@ async function handleApi(req, res) {
       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();
@@ -411,12 +467,40 @@ async function handleApi(req, res) {
       });
     }
 
-    // GET /api/source — 获取本地源信息
+    // 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;
+        }
+      }
+
       return sendJSON(res, {
-        connected: !!settings._skill_source,
-        path: settings._skill_source || null,
+        connected: !!sourcePath,
+        path: sourcePath,
+        needsInit,
       });
     }
 
@@ -436,6 +520,13 @@ async function handleApi(req, res) {
       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 });
     }
@@ -469,7 +560,7 @@ async function handleApi(req, res) {
       if (!fs.existsSync(repoSkills))
         fs.mkdirSync(repoSkills, { recursive: true });
       if (fs.existsSync(skillsDest)) {
-        for (const name of fs.readdirSync(skillsDest)) {
+        for (const name of core.listSkillDirs(skillsDest)) {
           const src = path.join(skillsDest, name);
           const dest = path.join(repoSkills, name);
           if (fs.existsSync(dest))
@@ -506,6 +597,80 @@ async function handleApi(req, res) {
       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++;
+          }
+        }
+      }
+
+      return sendJSON(res, { ok: true, ...created });
+    }
+
     // GET /api/diagnose — 健康检查
     if (method === "GET" && pathname === "/api/diagnose") {
       const results = [];

package/scripts/web-ui/src/App.vue

@@ -1,7 +1,7 @@
 <template>
   <n-message-provider>
     <n-notification-provider>
-      <n-config-provider :theme="theme">
+      <n-config-provider :theme="theme" :locale="zhCN" :date-locale="dateZhCN">
         <n-layout class="app-layout">
           <!-- 导航栏 -->
           <n-layout-header class="app-header" bordered>
@@ -37,11 +37,12 @@
 <script setup>
 import { h, ref, onMounted, computed } from "vue";
 import { useRouter, useRoute } from "vue-router";
-import { NIcon } from "naive-ui";
+import { NIcon, zhCN, dateZhCN } from "naive-ui";
 import {
   AppsOutline,
   SwapHorizontalOutline,
   CogOutline,
+  DocumentTextOutline,
 } from "@vicons/ionicons5";
 import StatusBar from "./components/StatusBar.vue";
 import { getStatus } from "./api/skills";
@@ -69,6 +70,11 @@ const menuOptions = [
     key: "Settings",
     icon: () => h(NIcon, null, { default: () => h(CogOutline) }),
   },
+  {
+    label: "CLAUDE.md",
+    key: "ClaudeMd",
+    icon: () => h(NIcon, null, { default: () => h(DocumentTextOutline) }),
+  },
 ];
 
 const activeKey = ref(route.name || "Dashboard");

package/scripts/web-ui/src/api/skills.js

@@ -78,6 +78,26 @@ export function syncSource() {
   return request("/source/sync", { method: "POST" });
 }
 
+export function initSource() {
+  return request("/source/init", { method: "POST" });
+}
+
 export function diagnose() {
   return request("/diagnose");
 }
+
+export function getReadme() {
+  return request("/readme");
+}
+
+export function getSkillsReadme() {
+  return request("/skills-readme");
+}
+
+export function getClaudeMd() {
+  return request("/claudemd");
+}
+
+export function getSkillReadme(name) {
+  return request("/skills/" + encodeURIComponent(name) + "/readme");
+}

package/scripts/web-ui/src/components/SkillCard.vue

@@ -1,11 +1,13 @@
 <template>
-  <n-card class="skill-card" :title="skill.name" size="small">
+  <n-card class="skill-card" :title="skill.name" size="small" @click="emit('click')">
     <template #header-extra>
-      <n-switch
-        :value="skill.enabled"
-        :loading="loading"
-        @update:value="onToggle"
-      />
+      <span @click.stop>
+        <n-switch
+          :value="skill.enabled"
+          :loading="loading"
+          @update:value="onToggle"
+        />
+      </span>
     </template>
     <div class="skill-meta">
       <span class="skill-version">v{{ skill.version }}</span>
@@ -26,7 +28,7 @@ const props = defineProps({
   skill: { type: Object, required: true },
 });
 
-const emit = defineEmits(["refresh"]);
+const emit = defineEmits(["refresh", "click"]);
 const message = useMessage();
 const loading = ref(false);
 
@@ -49,6 +51,12 @@ async function onToggle(value) {
 <style scoped>
 .skill-card {
   margin-bottom: 12px;
+  cursor: pointer;
+  transition: box-shadow 0.2s;
+}
+
+.skill-card:hover {
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.08);
 }
 
 .skill-meta {
@@ -69,4 +77,4 @@ async function onToggle(value) {
   color: #666;
   margin: 0;
 }
-</style>
+</style>

package/scripts/web-ui/src/components/StatusBar.vue

@@ -19,7 +19,7 @@
       </span>
     </div>
     <div class="status-divider" />
-    <div class="status-item">
+    <div class="status-item clickable" @click="$router.push({ name: 'ClaudeMd' })">
       <n-icon size="18" :color="data.hasClaudeMd ? '#18a058' : '#d03050'">
         <DocumentTextOutline />
       </n-icon>
@@ -58,6 +58,14 @@ defineProps({
   color: #555;
 }
 
+.status-item.clickable {
+  cursor: pointer;
+}
+
+.status-item.clickable:hover {
+  color: #2080f0;
+}
+
 .status-divider {
   width: 1px;
   height: 20px;

package/scripts/web-ui/src/main.js

@@ -2,6 +2,7 @@ import { createApp } from "vue";
 import naive from "naive-ui";
 import App from "./App.vue";
 import router from "./router";
+import "highlight.js/styles/github.css";
 
 const app = createApp(App);
 app.use(naive);

package/scripts/web-ui/src/router/index.js

@@ -2,11 +2,13 @@ import { createRouter, createWebHistory } from "vue-router";
 import Dashboard from "../views/Dashboard.vue";
 import SceneSwitch from "../views/SceneSwitch.vue";
 import Settings from "../views/Settings.vue";
+import ReadmeView from "../views/ReadmeView.vue";
 
 const routes = [
   { path: "/", name: "Dashboard", component: Dashboard, meta: { title: "仪表盘" } },
   { path: "/scenes", name: "Scenes", component: SceneSwitch, meta: { title: "场景切换" } },
   { path: "/settings", name: "Settings", component: Settings, meta: { title: "设置" } },
+  { path: "/readme", name: "ClaudeMd", component: ReadmeView, meta: { title: "CLAUDE.md" } },
 ];
 
 export default createRouter({

package/scripts/web-ui/src/styles/main.css

@@ -57,3 +57,99 @@ html, body, #app {
   width: 100%;
   margin: 0 auto;
 }
+
+/* ---------- markdown 渲染样式 ---------- */
+
+.markdown-content {
+  line-height: 1.7;
+  font-size: 14px;
+  color: #333;
+  word-wrap: break-word;
+}
+
+.markdown-content h1 { font-size: 22px; font-weight: 700; margin: 20px 0 12px; padding-bottom: 8px; border-bottom: 1px solid #eee; }
+.markdown-content h2 { font-size: 18px; font-weight: 700; margin: 18px 0 10px; padding-bottom: 6px; border-bottom: 1px solid #eee; }
+.markdown-content h3 { font-size: 16px; font-weight: 600; margin: 16px 0 8px; }
+.markdown-content h4 { font-size: 14px; font-weight: 600; margin: 14px 0 6px; }
+.markdown-content h5, .markdown-content h6 { font-size: 13px; font-weight: 600; margin: 12px 0 6px; }
+
+.markdown-content p { margin: 8px 0; }
+.markdown-content ul, .markdown-content ol { margin: 8px 0; padding-left: 24px; }
+.markdown-content li { margin: 4px 0; }
+.markdown-content blockquote {
+  margin: 10px 0;
+  padding: 8px 16px;
+  border-left: 4px solid #2080f0;
+  background: #f0f7ff;
+  color: #555;
+}
+.markdown-content blockquote p { margin: 4px 0; }
+
+.markdown-content a { color: #2080f0; text-decoration: none; }
+.markdown-content a:hover { text-decoration: underline; }
+
+.markdown-content hr { margin: 16px 0; border: none; border-top: 1px solid #e0e0e0; }
+
+.markdown-content table { width: 100%; border-collapse: collapse; margin: 12px 0; font-size: 13px; }
+.markdown-content th, .markdown-content td {
+  padding: 8px 12px;
+  border: 1px solid #e0e0e0;
+  text-align: left;
+}
+.markdown-content th { background: #f5f7fa; font-weight: 600; }
+.markdown-content tr:nth-child(even) td { background: #fafafa; }
+
+.markdown-content img { max-width: 100%; border-radius: 4px; margin: 8px 0; }
+
+.markdown-content code {
+  font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
+  font-size: 13px;
+  padding: 2px 6px;
+  background: #f0f0f0;
+  border-radius: 3px;
+  color: #d63384;
+}
+
+.markdown-content pre {
+  margin: 12px 0;
+  padding: 0;
+  border-radius: 6px;
+  overflow: hidden;
+  border: 1px solid #e8e8e8;
+  position: relative;
+}
+
+.markdown-content pre code {
+  display: block;
+  padding: 14px 16px;
+  background: #f8f9fa;
+  color: #333;
+  font-size: 13px;
+  line-height: 1.5;
+  overflow-x: auto;
+  tab-size: 2;
+}
+
+.markdown-content pre .copy-btn {
+  position: absolute;
+  top: 6px;
+  right: 6px;
+  padding: 3px 8px;
+  font-size: 11px;
+  color: #999;
+  background: #fff;
+  border: 1px solid #e0e0e0;
+  border-radius: 4px;
+  cursor: pointer;
+  opacity: 0;
+  transition: opacity 0.2s;
+}
+
+.markdown-content pre:hover .copy-btn {
+  opacity: 1;
+}
+
+.markdown-content pre .copy-btn:hover {
+  color: #2080f0;
+  border-color: #2080f0;
+}