@wang121ye/skillmanager 0.0.4 → 0.0.6

package/README.md

@@ -30,6 +30,21 @@ skillmanager webui
 skillmanager webui --concurrency 1
 ```
 
+### 缓存自动刷新（避免“只看到旧的 skills”）
+
+为避免第三方用户忘记更新缓存，`skillmanager` 在扫描来源仓库时会检查本地缓存是否落后于远端：
+
+- 如果检测到缓存落后，默认会**自动重新拉取**最新仓库。
+- 如需手动控制，可使用 `--force-refresh` 强制刷新，或设置 `SKILLMANAGER_AUTO_REFRESH=0` 关闭自动刷新。
+
+示例：
+
+```bash
+skillmanager webui --force-refresh
+skillmanager install --force-refresh
+skillmanager update --force-refresh
+```
+
 ## 安装与使用
 
 ### 全局安装（推荐）
@@ -56,6 +71,15 @@ npx @wang121ye/skillmanager install
 skillmanager install
 ```
 
+### 命令行交互式选择（类似 openskills）
+
+默认 `skillmanager install` 会进入交互式选择（按来源分组）。支持：
+- 空格选择/取消
+- a 全选，i 反选
+- h 顶部，e 底部
+- [ / ] 切换分组
+- Esc 退出，Enter 确认
+
 ### 2) 安装时启用 Web UI 选择（默认全选，可批量全选/全不选/反选/搜索）
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wang121ye/skillmanager",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Cross-platform agent skill manager (bootstrap + optional Web UI selection) built on top of openskills.",
   "keywords": [
     "skillmanager",
@@ -45,6 +45,7 @@
     "gray-matter": "^4.0.3",
     "openskills": "^1.5.0",
     "simple-git": "^3.27.0",
-    "undici": "^6.23.0"
+    "undici": "^6.23.0",
+    "yoctocolors-cjs": "^2.1.3"
   }
 }

package/src/cli.js

@@ -30,6 +30,7 @@ async function main() {
     .option('--dry-run', '仅打印将执行的内容，不实际安装', false)
     .option('--concurrency <n>', '选择模式下的并发扫描数（默认：3）', '3')
     .option('--profile <name>', '选择配置名（默认：来自 config 或 SKILLMANAGER_PROFILE 环境变量）')
+    .option('--force-refresh', '强制刷新来源仓库缓存（重新拉取）', false)
     .action(async (opts) => {
       await bootstrap(opts);
     });
@@ -44,6 +45,7 @@ async function main() {
     .option('--output <path>', '作用：sync 输出文件路径（默认：AGENTS.md）')
     .option('--no-sync', '作用：不执行 openskills sync（仅安装/卸载，不更新 AGENTS.md）', false)
     .option('--concurrency <n>', '作用：install 模式下并发拉取/扫描来源仓库，提高速度（默认：3）', '3')
+    .option('--force-refresh', '强制刷新来源仓库缓存（重新拉取）', false)
     .action(async (opts) => {
       await webui(opts);
     });
@@ -64,6 +66,7 @@ async function main() {
     .option('--no-sync', '跳过 openskills sync', false)
     .option('--profile <name>', '按 profile 选择集更新（会重新安装选中的 skills）')
     .option('--concurrency <n>', '选择模式下的并发扫描数（默认：3）', '3')
+    .option('--force-refresh', '强制刷新来源仓库缓存（重新拉取）', false)
     .action(async (opts) => {
       await update(opts);
     });

package/src/commands/bootstrap.js

@@ -3,7 +3,7 @@ const { ensureDir } = require('../lib/fs');
 const { loadSourcesManifest } = require('../lib/manifest');
 const { ensureRepo } = require('../lib/git');
 const { scanSkillsInRepo } = require('../lib/scan');
-const { loadProfile } = require('../lib/profiles');
+const { loadProfile, saveProfile } = require('../lib/profiles');
 const { mapWithConcurrency } = require('../lib/concurrency');
 const { getEffectiveDefaultProfile } = require('../lib/config');
 const path = require('path');
@@ -11,6 +11,7 @@ const os = require('os');
 const { installSourceRef, syncAgents } = require('../lib/openskills');
 const { installFromLocalSkillDir } = require('../lib/local-install');
 const { warnPrereqs } = require('../lib/prereqs');
+const { promptSkillSelection } = require('../lib/cli-select');
 
 
 function uniq(arr) {
@@ -28,47 +29,9 @@ async function bootstrap(opts) {
 
   const profileName = opts?.profile || (await getEffectiveDefaultProfile());
   const existing = await loadProfile({ profilesDir: paths.profilesDir, profileName });
-
-  const wantsSelection = existing?.selectedSkillIds && Array.isArray(existing.selectedSkillIds);
   const globalInstall = !!opts?.global;
   const universal = !!opts?.universal;
 
-  if (!wantsSelection) {
-    // Default path: install everything from each enabled source via openskills directly.
-    // This avoids repo scanning and matches “bootstrap 安装所有 skills”的默认体验。
-    // eslint-disable-next-line no-console
-    console.log(`将从 ${enabledSources.length} 个来源安装（global=${globalInstall}, universal=${universal}）…`);
-
-    if (opts?.dryRun) {
-      // eslint-disable-next-line no-console
-      console.log('\n--dry-run 已启用：将安装以下来源（不执行安装）');
-      for (const s of enabledSources) {
-        const ref = s.openskillsRef || s.repo;
-        // eslint-disable-next-line no-console
-        console.log(`- ${s.name || s.id}  (${ref || 'missing-ref'})`);
-      }
-      // eslint-disable-next-line no-console
-      console.log('\n完成（dry-run）。');
-      return;
-    }
-
-    for (const s of enabledSources) {
-      const ref = s.openskillsRef || s.repo;
-      if (!ref) continue;
-      // eslint-disable-next-line no-console
-      console.log(`\n==> Installing source: ${s.name || s.id}  (${ref})`);
-      await installSourceRef({ ref, globalInstall, universal });
-    }
-
-    if (opts?.sync !== false) {
-      await syncAgents({ output: opts?.output, cwd: process.cwd() });
-    }
-
-    // eslint-disable-next-line no-console
-    console.log('\n完成。');
-    return;
-  }
-
   // Selection path: clone repos + scan SKILL.md, then install selected skill dirs.
   const concurrency = Number(opts?.concurrency || process.env.SKILLMANAGER_CONCURRENCY || 3);
   // eslint-disable-next-line no-console
@@ -77,7 +40,7 @@ async function bootstrap(opts) {
   const skillsById = new Map();
   const perSource = await mapWithConcurrency(enabledSources, concurrency, async (s) => {
     try {
-      const repoDir = await ensureRepo({ reposDir: paths.reposDir, source: s });
+      const repoDir = await ensureRepo({ reposDir: paths.reposDir, source: s, forceRefresh: !!opts?.forceRefresh });
       const skills = await scanSkillsInRepo({
         sourceId: s.id,
         sourceName: s.name || s.id,
@@ -103,7 +66,18 @@ async function bootstrap(opts) {
       ? existing.selectedSkillIds
       : allSkills.map((s) => s.id);
 
-  // 交互式选择已迁移到：skillmanager webui（mode=install）
+  const chosen = await promptSkillSelection({
+    title: `skillmanager install · profile=${profileName}`,
+    skills: allSkills,
+    initialSelectedIds: selectedIds
+  });
+  if (chosen == null) {
+    // eslint-disable-next-line no-console
+    console.log('已取消（未执行安装）。');
+    return;
+  }
+  selectedIds = chosen;
+  await saveProfile({ profilesDir: paths.profilesDir, profileName, selectedSkillIds: selectedIds });
 
   selectedIds = uniq(selectedIds).filter((id) => skillsById.has(id));
 

package/src/commands/uninstall.js

@@ -4,6 +4,7 @@ const fsp = require('fs/promises');
 
 const { listInstalledSkills } = require('../lib/installed');
 const { syncAgents } = require('../lib/openskills');
+const { promptSkillSelection } = require('../lib/cli-select');
 
 function resolveTargetDir({ globalInstall, universal }) {
   const folder = universal ? '.agent/skills' : '.claude/skills';
@@ -18,10 +19,35 @@ async function uninstall(opts, skillNames) {
   const installed = await listInstalledSkills(targetDir);
   const installedByName = new Map(installed.map((s) => [s.name, s]));
 
-  let toRemove = Array.isArray(skillNames) ? skillNames.filter(Boolean) : [];
+  if (installed.length === 0) {
+    // eslint-disable-next-line no-console
+    console.log(`未检测到可卸载的 skill。目标目录：${targetDir}`);
+    return;
+  }
 
+  let toRemove = [];
   if (opts?.all) {
     toRemove = installed.map((s) => s.name);
+  } else {
+    const initialSelected = Array.isArray(skillNames) ? skillNames.filter(Boolean) : [];
+    const chosen = await promptSkillSelection({
+      title: 'skillmanager uninstall',
+      skills: installed.map((s) => ({
+        id: s.name,
+        sourceId: 'installed',
+        sourceName: 'Installed',
+        name: s.name,
+        description: s.description,
+        skillDir: s.skillDir
+      })),
+      initialSelectedIds: initialSelected
+    });
+    if (chosen == null) {
+      // eslint-disable-next-line no-console
+      console.log('已取消（未执行卸载）。');
+      return;
+    }
+    toRemove = chosen;
   }
 
   toRemove = Array.from(new Set(toRemove)).filter((n) => installedByName.has(n));
@@ -29,14 +55,6 @@ async function uninstall(opts, skillNames) {
   if (toRemove.length === 0) {
     // eslint-disable-next-line no-console
     console.log(`未选择任何可卸载的 skill。目标目录：${targetDir}`);
-    // eslint-disable-next-line no-console
-    console.log('用法：');
-    // eslint-disable-next-line no-console
-    console.log('  - skillmanager webui --mode uninstall');
-    // eslint-disable-next-line no-console
-    console.log('  - skillmanager uninstall <skill1> <skill2>');
-    // eslint-disable-next-line no-console
-    console.log('  - skillmanager uninstall --all');
     return;
   }
 

package/src/commands/update.js

@@ -53,7 +53,7 @@ async function update(opts) {
   const skillsById = new Map();
   const perSource = await mapWithConcurrency(enabledSources, concurrency, async (s) => {
     try {
-      const repoDir = await ensureRepo({ reposDir: paths.reposDir, source: s });
+      const repoDir = await ensureRepo({ reposDir: paths.reposDir, source: s, forceRefresh: !!opts?.forceRefresh });
       const skills = await scanSkillsInRepo({
         sourceId: s.id,
         sourceName: s.name || s.id,

package/src/commands/webui.js

@@ -91,7 +91,7 @@ async function webui(opts) {
   const skillsById = new Map();
   const perSource = await mapWithConcurrency(enabledSources, concurrency, async (s) => {
     try {
-      const repoDir = await ensureRepo({ reposDir: paths.reposDir, source: s });
+      const repoDir = await ensureRepo({ reposDir: paths.reposDir, source: s, forceRefresh: !!opts?.forceRefresh });
       const skills = await scanSkillsInRepo({
         sourceId: s.id,
         sourceName: s.name || s.id,

package/src/lib/cli-select.js

@@ -0,0 +1,200 @@
+const {
+  createPrompt,
+  useState,
+  useKeypress,
+  usePagination,
+  usePrefix,
+  isUpKey,
+  isDownKey,
+  isSpaceKey,
+  isEnterKey
+} = require('@inquirer/core');
+const colors = require('yoctocolors-cjs');
+
+function groupSkills(skills) {
+  const bySource = new Map();
+  for (const skill of skills) {
+    const key = skill.sourceName || skill.sourceId || 'unknown';
+    if (!bySource.has(key)) bySource.set(key, []);
+    bySource.get(key).push(skill);
+  }
+  for (const [key, list] of bySource.entries()) {
+    list.sort((a, b) => a.name.localeCompare(b.name));
+    bySource.set(key, list);
+  }
+  return Array.from(bySource.entries()).sort((a, b) => a[0].localeCompare(b[0]));
+}
+
+function buildItems(skills) {
+  const grouped = groupSkills(skills);
+  const items = [];
+  let groupIndex = 0;
+  for (const [sourceName, list] of grouped) {
+    items.push({ type: 'separator', label: `-- ${sourceName} --`, groupIndex });
+    for (const skill of list) {
+      items.push({
+        type: 'choice',
+        id: skill.id,
+        name: skill.name,
+        description: skill.description || '',
+        groupIndex
+      });
+    }
+    groupIndex += 1;
+  }
+  return items;
+}
+
+function getSelectableIndexes(items) {
+  const indexes = [];
+  for (let i = 0; i < items.length; i++) {
+    if (items[i].type === 'choice') indexes.push(i);
+  }
+  return indexes;
+}
+
+function findNextSelectable(items, startIndex, direction) {
+  const step = direction >= 0 ? 1 : -1;
+  for (let i = startIndex + step; i >= 0 && i < items.length; i += step) {
+    if (items[i].type === 'choice') return i;
+  }
+  return null;
+}
+
+function findGroupStart(items, groupIndex) {
+  for (let i = 0; i < items.length; i++) {
+    if (items[i].type === 'choice' && items[i].groupIndex === groupIndex) return i;
+  }
+  return null;
+}
+
+const promptSkillSelection = createPrompt((config, done) => {
+  const items = buildItems(config.skills || []);
+  const selectableIndexes = getSelectableIndexes(items);
+  const firstSelectable = selectableIndexes[0] ?? 0;
+  const lastSelectable = selectableIndexes[selectableIndexes.length - 1] ?? 0;
+  const [activeIndex, setActiveIndex] = useState(firstSelectable);
+  const [status, setStatus] = useState('idle');
+  const [selectedSet, setSelectedSet] = useState(
+    new Set(Array.isArray(config.initialSelectedIds) ? config.initialSelectedIds : [])
+  );
+
+  const moveToIndex = (idx) => {
+    if (idx == null) return;
+    if (items[idx]?.type !== 'choice') return;
+    setActiveIndex(idx);
+  };
+
+  const moveBy = (dir) => {
+    const next = findNextSelectable(items, activeIndex, dir);
+    if (next != null) {
+      setActiveIndex(next);
+      return;
+    }
+    // loop to start/end
+    setActiveIndex(dir > 0 ? firstSelectable : lastSelectable);
+  };
+
+  const moveGroup = (dir) => {
+    const currentGroup = items[activeIndex]?.groupIndex ?? 0;
+    const maxGroup = Math.max(0, ...items.map((i) => i.groupIndex ?? 0));
+    const nextGroup = dir > 0 ? (currentGroup + 1 > maxGroup ? 0 : currentGroup + 1) : currentGroup - 1 < 0 ? maxGroup : currentGroup - 1;
+    moveToIndex(findGroupStart(items, nextGroup));
+  };
+
+  const toggleActive = () => {
+    const item = items[activeIndex];
+    if (!item || item.type !== 'choice') return;
+    const next = new Set(selectedSet);
+    if (next.has(item.id)) next.delete(item.id);
+    else next.add(item.id);
+    setSelectedSet(next);
+  };
+
+  const selectAll = () => {
+    const next = new Set(selectedSet);
+    for (const idx of selectableIndexes) next.add(items[idx].id);
+    setSelectedSet(next);
+  };
+
+  const invertAll = () => {
+    const next = new Set();
+    for (const idx of selectableIndexes) {
+      const id = items[idx].id;
+      if (!selectedSet.has(id)) next.add(id);
+    }
+    setSelectedSet(next);
+  };
+
+  useKeypress((key) => {
+    const keyName = key?.name || key?.sequence;
+    if (isUpKey(key)) return moveBy(-1);
+    if (isDownKey(key)) return moveBy(1);
+    if (isSpaceKey(key)) return toggleActive();
+    if (isEnterKey(key)) {
+      setStatus('done');
+      return done(Array.from(selectedSet));
+    }
+    if (keyName === 'escape') {
+      setStatus('done');
+      return done(null);
+    }
+    if (keyName === 'a') return selectAll();
+    if (keyName === 'i') return invertAll();
+    if (keyName === 'h') return moveToIndex(firstSelectable);
+    if (keyName === 'e') return moveToIndex(lastSelectable);
+    if (keyName === '[') return moveGroup(-1);
+    if (keyName === ']') return moveGroup(1);
+  });
+
+  const prefix = usePrefix({ status });
+  const titleText = config.title || config.message || 'Select skills to install';
+  const total = selectableIndexes.length;
+  const selected = selectedSet.size;
+  const counter = colors.dim(`${selected} / ${total} selected`);
+  const message = `${colors.bold(titleText)}  ${counter}`;
+  const activeItem = items[activeIndex];
+  const desc =
+    activeItem?.type === 'choice' && activeItem.description
+      ? `\n${colors.yellow(activeItem.description.trim())}`
+      : '';
+
+  const page = usePagination({
+    items,
+    active: activeIndex,
+    pageSize: config.pageSize || 18,
+    loop: false,
+    renderItem: ({ item, index, isActive }) => {
+      if (item.type === 'separator') {
+        return `\n  ${colors.bold(colors.cyan(item.label))}`;
+      }
+      const cursor = isActive ? colors.cyan('>') : ' ';
+      const isChecked = selectedSet.has(item.id);
+      const dot = isChecked ? colors.green('●') : colors.dim('○');
+      const label = isChecked ? colors.green(item.name) : isActive ? colors.white(item.name) : colors.dim(item.name);
+      return `${cursor} ${dot} ${label}`;
+    }
+  });
+
+  const help =
+    '\n' +
+    colors.dim('↑↓ 选择 · 空格 勾选 · a 全选 · i 反选 · h 顶部 · e 底部 · [ ] 切组 · Esc 退出 · ⏎ 确认');
+
+  if (status === 'done') {
+    return `${prefix} ${colors.bold(titleText)}  ${colors.green(`✔ ${selected} skills selected`)}`;
+  }
+
+  return `${prefix} ${message}\n${page}${desc}${help}`;
+});
+
+async function promptSkillSelectionWrapper({ title, skills, initialSelectedIds }) {
+  const chosen = await promptSkillSelection({
+    title,
+    skills,
+    initialSelectedIds
+  });
+  if (chosen == null) return null;
+  return Array.isArray(chosen) ? chosen : [];
+}
+
+module.exports = { promptSkillSelection: promptSkillSelectionWrapper };

package/src/lib/git.js

@@ -10,7 +10,53 @@ function sleep(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
 
-async function ensureRepo({ reposDir, source }) {
+function isTruthy(value) {
+  const v = String(value || '').trim().toLowerCase();
+  return v === '1' || v === 'true' || v === 'yes' || v === 'on';
+}
+
+function shouldAutoRefreshCache() {
+  // 默认开启自动刷新（发现远端更新时自动重新拉取）
+  // 如需关闭：SKILLMANAGER_AUTO_REFRESH=0
+  if (process.env.SKILLMANAGER_AUTO_REFRESH != null) {
+    return isTruthy(process.env.SKILLMANAGER_AUTO_REFRESH);
+  }
+  return true;
+}
+
+async function getLocalHead(repoGit) {
+  try {
+    const out = await repoGit.revparse(['HEAD']);
+    return String(out || '').trim() || null;
+  } catch {
+    return null;
+  }
+}
+
+async function getRemoteHead(repoGit) {
+  try {
+    const out = await repoGit.raw(['ls-remote', 'origin', 'HEAD']);
+    const first = String(out || '').trim().split(/\s+/)[0];
+    return first || null;
+  } catch {
+    return null;
+  }
+}
+
+async function isRepoStale(repoGit) {
+  const [localHead, remoteHead] = await Promise.all([getLocalHead(repoGit), getRemoteHead(repoGit)]);
+  if (!localHead || !remoteHead) return false;
+  return localHead !== remoteHead;
+}
+
+async function cloneRepo({ git, repoUrl, repoDir, cloneArgs }) {
+  await rmDir(repoDir);
+  await ensureDir(repoDir);
+  await git.clone(repoUrl, repoDir, cloneArgs);
+  return repoDir;
+}
+
+async function ensureRepo({ reposDir, source, forceRefresh = false }) {
   if (!source?.repo) {
     throw new Error(`Invalid source repo for ${source?.id || '<unknown>'}`);
   }
@@ -20,14 +66,12 @@ async function ensureRepo({ reposDir, source }) {
 
   const gitDir = path.join(repoDir, '.git');
   const git = simpleGit();
+  const cloneArgs = ['--depth', '1', '--single-branch', '--filter=blob:none'];
 
   if (!(await fileExists(gitDir))) {
-    const cloneArgs = ['--depth', '1', '--single-branch', '--filter=blob:none'];
     for (let attempt = 1; attempt <= 3; attempt++) {
       try {
-        await rmDir(repoDir);
-        await ensureDir(repoDir);
-        await git.clone(source.repo, repoDir, cloneArgs);
+        await cloneRepo({ git, repoUrl: source.repo, repoDir, cloneArgs });
         return repoDir;
       } catch (err) {
         await rmDir(repoDir);
@@ -50,6 +94,26 @@ async function ensureRepo({ reposDir, source }) {
   } catch {
     // ignore ff-only failures (e.g. detached HEAD) — user can clean manually
   }
+
+  // 如果缓存仓库落后于远端，自动重新拉取（可用 env 关闭）
+  try {
+    const stale = await isRepoStale(repoGit);
+    if (stale) {
+      const shouldRefresh = forceRefresh || shouldAutoRefreshCache();
+      if (shouldRefresh) {
+        // eslint-disable-next-line no-console
+        console.warn(`检测到缓存仓库落后于远端：${source.id}，正在重新拉取最新版本…`);
+        return await cloneRepo({ git, repoUrl: source.repo, repoDir, cloneArgs });
+      }
+      // eslint-disable-next-line no-console
+      console.warn(`检测到缓存仓库落后于远端：${source.id}。可使用 --force-refresh 或设置 SKILLMANAGER_AUTO_REFRESH=1。`);
+    }
+  } catch {
+    // eslint-disable-next-line no-console
+    console.warn(
+      `提示：无法检查远端版本（可能网络/权限问题），缓存可能过期。可使用 --force-refresh 强制刷新，或删除 ${repoDir} 后重试。`
+    );
+  }
   return repoDir;
 }