@wang121ye/skillmanager 0.0.4 → 0.0.5

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
+```
+
 ## 安装与使用
 
 ### 全局安装（推荐）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wang121ye/skillmanager",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Cross-platform agent skill manager (bootstrap + optional Web UI selection) built on top of openskills.",
   "keywords": [
     "skillmanager",

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

@@ -77,7 +77,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,

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/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;
 }