cli-blueprint 0.2.5 → 1.0.0

package/README.md

@@ -96,14 +96,32 @@ node install.mjs install
 ```
 更新：`git pull && node install.mjs update`（install/update 会对比已装版本与 cli.tax 最新版本并提示）。
 
-### 更新感知（check）
-安装器写入 `install-meta.json`（来源/版本/时间）到每个 skill 目录；SKILL.md 注入版本横幅，
-IDE 每次读取即可见版本与更新入口。主动检查：
+### 更新感知（自动升级 + check）
+
+**自动升级**：每次发布新版本到 npm / cli.tax 后，已安装用户只需重跑一次安装命令，
+安装器会自动对比本地已装版本与远端最新版本，**有新版本直接覆盖升级到最新**（无需先卸载）：
+
+```bash
+npx cli-blueprint@latest install     # 自动拉取最新并覆盖升级（blueprint/calctool/swarm）
+node install.mjs install             # 源码方式同理
+```
+升级时输出 `⤴ 已更新 <skill> 旧版本 → 新版本`。
+
+**静默自动更新（--silent / --yes）**：不想看到任何安装/升级输出，直接覆盖到最新：
+```bash
+npx cli-blueprint@latest install --silent   # 静默升级，无任何提示
+node install.mjs install --yes              # 源码方式静默升级
+```
+
+**主动检查（check）**：不确定是否有新版本时，可随时主动检查（不写盘）：
 ```bash
 node install.mjs check               # 遍历本机已装 IDE，对比 cli.tax 最新版本
-npx cli-blueprint@latest check       # 单包检查（calctool 同理）
+npx cli-blueprint@latest check       # 单包检查（calctool / swarm 同理）
 ```
 
+安装器写入 `install-meta.json`（来源/版本/时间）到每个 skill 目录；SKILL.md 注入版本横幅，
+IDE 每次读取即可见当前版本与更新命令。
+
 ### 方式 C：直接用 clitaxio（只装单个 IDE，作为对照）
 ```bash
 npx clitaxio@latest install wvz6zmRWmX

package/install.mjs

@@ -128,7 +128,7 @@ async function listSkills() {
   return skills.sort()
 }
 
-async function syncOne(name, targetRoot, { remove = false } = {}) {
+async function syncOne(name, targetRoot, { remove = false, silent = false } = {}) {
   const dest = join(targetRoot, name)
   if (remove) {
     if (existsSync(dest)) { await rm(dest, { recursive: true, force: true }); print(`  ✓ 已移除 ${name} ← ${targetRoot}`) }
@@ -148,6 +148,7 @@ async function syncOne(name, targetRoot, { remove = false } = {}) {
     await writeMeta(dest, { ...srcMeta, installedAt: new Date().toISOString() })
   }
   const upgrade = destMeta && srcMeta && destMeta.version && srcMeta.version && destMeta.version !== srcMeta.version
+  if (silent) return
   if (upgrade) {
     print(`  ⤴ 已更新 ${name} ${destMeta.version} → ${srcMeta.version} → ${dest}`)
   } else {
@@ -155,12 +156,12 @@ async function syncOne(name, targetRoot, { remove = false } = {}) {
   }
 }
 
-async function syncAll(targetRoot, { remove = false, reportUpdated } = {}) {
+async function syncAll(targetRoot, { remove = false, reportUpdated, silent = false } = {}) {
   const skills = await listSkills()
   if (!remove) await mkdir(targetRoot, { recursive: true })
   for (const s of skills) {
     const before = reportUpdated ? readMeta(join(targetRoot, s)) : null
-    await syncOne(s, targetRoot, { remove })
+    await syncOne(s, targetRoot, { remove, silent })
     if (reportUpdated && before && before.version) {
       const after = readMeta(join(targetRoot, s))
       if (after && after.version && after.version !== before.version) reportUpdated(1)
@@ -398,18 +399,21 @@ if (cmd === 'list') {
   const skills = await listSkills()
   if (!skills.length) { print('skills/ 目录为空，无法安装'); process.exit(1) }
   if (rest.includes('--agents') && !targets.some((t) => t.path === AGENTS.path)) targets.push(AGENTS)
-  print(`将安装 ${skills.length} 个 skills → ${targets.length} 个目标`)
+  const silent = rest.includes('--silent') || rest.includes('--yes')
+  if (!silent) print(`将安装 ${skills.length} 个 skills → ${targets.length} 个目标`)
   let updated = 0
   for (const t of targets) {
-    print(`[${t.label}] ${t.path}`)
-    await syncAll(t.path, { reportUpdated: (n) => { updated += n } })
+    if (!silent) print(`[${t.label}] ${t.path}`)
+    await syncAll(t.path, { reportUpdated: (n) => { updated += n }, silent })
   }
   if (rest.includes('--agents')) {
     print('⚠ 已安装到共享 ~/.agents/skills：该目录会被 Codex/Gemini/Zed/OpenCode/Cursor 等同时扫描，同一 skill 可能被重复发现。')
   }
-  print('完成。各 IDE 会自动发现各自用户级根中的新目录（可立即在新会话中调用）。')
-  if (updated) {
-    print(`提示：${updated} 个 skill 有更新。以后可用 node install.mjs check 检查新版本。`)
+  if (!silent) {
+    print('完成。各 IDE 会自动发现各自用户级根中的新目录（可立即在新会话中调用）。')
+    if (updated) {
+      print(`提示：${updated} 个 skill 有更新。以后可用 node install.mjs check 检查新版本。`)
+    }
   }
 } else if (cmd === 'check') {
   const targets = parseTargets(rest)

package/package.json

@@ -1,11 +1,27 @@
 {
   "name": "cli-blueprint",
-  "version": "0.2.5",
-  "description": "Blueprint + Calctool + Swarm 多 IDE 安装器：从 cli.tax 自动拉取并分发到本机所有已装 IDE（Codex/DSH/Claude/Cursor/…）。支持 check 更新检测。",
+  "version": "1.0.0",
+  "description": "Blueprint + Calctool + Swarm 多 IDE 安装器：从 cli.tax 自动拉取并分发到本机所有已装 IDE。支持 check 更新检测与 --silent 静默升级。",
   "type": "module",
-  "bin": { "cli-blueprint": "install.mjs" },
-  "files": ["install.mjs", "sources.json", "skills"],
-  "engines": { "node": ">=18" },
+  "bin": {
+    "cli-blueprint": "install.mjs"
+  },
+  "files": [
+    "install.mjs",
+    "sources.json",
+    "skills"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
   "license": "MIT",
-  "keywords": ["blueprint", "skill", "cli.tax", "clitax", "codex", "agent", "installer"]
-}
+  "keywords": [
+    "blueprint",
+    "skill",
+    "cli.tax",
+    "clitax",
+    "codex",
+    "agent",
+    "installer"
+  ]
+}

package/skills/calctool/install-meta.json

@@ -1,7 +1,7 @@
 {
   "source": "KKyA6xljUX",
   "slug": "calctool",
-  "version": "v0.3.0",
+  "version": "v0.4.0",
   "endpoint": "https://cli.tax/api/public/skills/KKyA6xljUX",
   "installedAt": "2026-08-17T00:00:00.000Z"
 }

package/skills/swarm/install-meta.json

@@ -1,7 +1,7 @@
 {
   "source": "zj7fTPVh4p",
   "slug": "swarm",
-  "version": "v0.1.0",
+  "version": "v0.2.0",
   "endpoint": "https://cli.tax/api/public/skills/zj7fTPVh4p",
   "installedAt": "2026-08-17T00:00:00.000Z"
 }