cli-calctool 0.3.4 → 1.0.1

package/install.mjs

@@ -1,442 +0,0 @@
-#!/usr/bin/env node
-/**
- * dsh-skillpack — 多 IDE 通用 skill 插件包安装器
- *
- * 从本包 `skills/` 目录同步一组 skill 到全世界各 IDE/编码 agent 的 skills 根目录。
- * 每个子目录（含 SKILL.md + skill.json）即一个 skill；新增/删除子目录后重跑即可扩展。
- *
- * 设计原则：
- *   - 内置「全世界已知 IDE 的 skills 安装位置表」（IDES，官方文档核实）；
- *   - 默认「自动匹配」：检测本机真实安装的 IDE（which 命令 / 应用路径 / 配置文件），
- *     只装给已安装的 IDE，让每个 IDE 自己识别需要的 skill；--all 才全量安装；
- *   - 每个 IDE 装到它自己的专属用户级根 → IDE 内部唯一、IDE 之间互不重复；
- *   - 跨工具互操作标准 ~/.agents/skills（agentskills.io）默认跳过——它会被多个工具
- *     同时扫描（Codex 新约定/Gemini/Zed/OpenCode/Cursor/Antigravity），装进去会被重复发现；
- *     需要时用 --agents 显式开启（会打印警告）；
- *   - --ide / --skip 精确控制；新增 IDE 只需在 IDES 表加一行。
- *
- * 更新感知：
- *   - pull 时把 cli.tax 返回的 version 写入 skills/<slug>/install-meta.json；
- *   - install / update 时对比「已安装版本」与「远端最新版本」，有新版本会提示；
- *   - check 子命令：遍历本机已装 IDE 的 skill 目录，对比远端最新版本并报告更新。
- *
- * 用法:
- *   node install.mjs pull                  # 从 sources.json（cli.tax）拉取全部 skill 到 skills/
- *   node install.mjs install               # 自动匹配：只装本机已安装的 IDE（推荐）
- *                                          #   skills/ 为空时自动先 pull；--pull 强制重新拉取
- *   node install.mjs install --all         # 装到所有已知 IDE（不管是否安装）
- *   node install.mjs install --ide codex   # 仅安装到指定 IDE（可重复: --ide codex --ide dsh）
- *   node install.mjs install --skip cursor # 自动匹配但跳过指定 IDE（可重复）
- *   node install.mjs install --project     # 额外安装到当前项目的项目级根（每个选中 IDE 一个）
- *   node install.mjs install --agents      # 额外安装到共享 ~/.agents/skills（警告）
- *   node install.mjs install --target /abs/path    # 仅自定义目录
- *   node install.mjs update                # 同 install（幂等覆盖）
- *   node install.mjs check                 # 检查已安装 skill 是否有新版本（对比 cli.tax）
- *   node install.mjs uninstall             # 从相同目标移除本包安装的 skills
- *   node install.mjs list                  # 列出本包包含的 skills
- *   node install.mjs ides                  # 列出已知 IDE 及本机检测结果
- *
- * 作为 npm 包发布后:  npx dsh-skillpack@latest install
- */
-import { cp, mkdir, readdir, rm, writeFile } from 'node:fs/promises'
-import { existsSync, readFileSync, readdirSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { join, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { spawnSync } from 'node:child_process'
-
-const __dirname = fileURLToPath(new URL('.', import.meta.url))
-const SKILLS_SRC = join(__dirname, 'skills')
-
-const HOME = homedir()
-const CWD = process.cwd()
-
-/** 每个 skill 安装/拉取时的版本元数据文件名（IDE 目录与 skills/ 内都会写） */
-const INSTALL_META = 'install-meta.json'
-
-/**
- * 全世界已知 IDE/编码 agent 的 skills 安装位置表（官方文档核实，2026-08）。
- *   key:     命令行标识
- *   label:   显示名
- *   detect:  安装探测规则数组（任一命中即视为已安装）：
- *              { cmd: 'codex' }               —— which 命令存在
- *              { app: '/Applications/X.app' } —— 应用路径存在
- *              { file: '~/.codex/config.toml' } —— 配置文件存在（确认真实安装，非本工具创建）
- *   user:    用户级 skills 根（默认安装目标，每个 IDE 一份）
- *   project: 项目级 skills 根（--project 时使用）
- *   doc:     官方文档 URL
- * 新增 IDE 只需在此加一行，其余逻辑自动生效。
- */
-const IDES = [
-  // OpenAI / Anthropic / Google 系
-  { key: 'codex', label: 'Codex CLI', detect: [{ cmd: 'codex' }, { file: join(HOME, '.codex', 'config.toml') }], user: join(HOME, '.codex', 'skills'), project: join(CWD, '.codex', 'skills'), doc: 'https://developers.openai.com/codex/skills', note: '新官方约定 ~/.agents/skills；此处用旧约定 ~/.codex/skills（skill-installer 仍默认写入），避免共享根重复' },
-  { key: 'dsh', label: 'DSH', detect: [{ file: join(HOME, '.dsh', 'settings.yaml') }, { file: join(HOME, '.dsh', '.credentials.yaml') }], user: join(HOME, '.dsh', 'skills'), project: join(CWD, '.dsh', 'skills'), doc: 'https://github.com/deepseek-ai/Harness', note: 'skill-filesystem 扫描 ~/.dsh/skills + ~/.agents/skills' },
-  { key: 'claude', label: 'Claude Code', detect: [{ cmd: 'claude' }, { file: join(HOME, '.claude', 'settings.json') }, { dir: join(HOME, '.claude') }], user: join(HOME, '.claude', 'skills'), project: join(CWD, '.claude', 'skills'), doc: 'https://code.claude.com/docs/en/skills', note: '含父目录向上扫描至 repo root；monorepo 子目录生效' },
-  { key: 'gemini', label: 'Gemini CLI', detect: [{ cmd: 'gemini' }, { file: join(HOME, '.gemini', 'settings.json') }], user: join(HOME, '.gemini', 'skills'), project: join(CWD, '.gemini', 'skills'), doc: 'https://geminicli.com/docs/cli/skills/', note: '别名 .agents/skills 优先级更高（此处用专属根避免共享冲突）' },
-  { key: 'antigravity', label: 'Google Antigravity', detect: [{ cmd: 'antigravity' }, { app: '/Applications/Antigravity.app' }], user: join(HOME, '.gemini', 'antigravity', 'skills'), project: join(CWD, '.agents', 'skills'), doc: 'https://antigravity.google/docs/ide/skills', note: 'workspace 级固定用 .agents/skills（需 --agents 才装项目级）' },
-
-  // 编辑器 / VS Code 生态
-  { key: 'cursor', label: 'Cursor', detect: [{ cmd: 'cursor' }, { app: '/Applications/Cursor.app' }, { file: join(HOME, '.cursor', 'cursor.db') }], user: join(HOME, '.cursor', 'skills'), project: join(CWD, '.cursor', 'skills'), doc: 'https://cursor.com/help/customization/skills.md', note: '兼容加载 .claude/.codex/.agents/skills' },
-  { key: 'cline', label: 'Cline', detect: [{ cmd: 'cline' }, { dir: join(HOME, '.cline') }], user: join(HOME, '.cline', 'skills'), project: join(CWD, '.cline', 'skills'), doc: 'https://cline.bot/blog/cline-3-48-0-skills-and-websearch-make-cline-smarter', note: '全局优先于项目' },
-  { key: 'roo', label: 'Roo Code', detect: [{ cmd: 'roo' }, { dir: join(HOME, '.roo') }], user: join(HOME, '.roo', 'skills'), project: join(CWD, '.roo', 'skills'), doc: 'https://docs.roocode.com/features/skills', note: '项目覆盖全局，模式级覆盖通用' },
-  { key: 'kilo', label: 'Kilo Code', detect: [{ cmd: 'kilo' }, { dir: join(HOME, '.kilo') }], user: join(HOME, '.kilo', 'skills'), project: join(CWD, '.kilo', 'skills'), doc: 'https://kilo.ai/docs/customize/skills', note: 'kilo.jsonc 可配 skills.paths/urls；另默认加载 .agents/skills' },
-  { key: 'windsurf', label: 'Windsurf', detect: [{ cmd: 'windsurf' }, { app: '/Applications/Windsurf.app' }], user: join(HOME, '.codeium', 'windsurf', 'skills'), project: join(CWD, '.windsurf', 'skills'), doc: 'https://docs.windsurf.com/windsurf/cascade/skills', note: '全局 ~/.codeium/windsurf/skills，workspace .windsurf/skills' },
-  { key: 'copilot', label: 'VS Code / Copilot', detect: [{ cmd: 'copilot' }, { app: '/Applications/Visual Studio Code.app' }, { file: join(HOME, '.copilot', 'accounts.json') }], user: join(HOME, '.copilot', 'skills'), project: join(CWD, '.github', 'skills'), doc: 'https://code.visualstudio.com/docs/agent-customization/agent-skills', note: 'workspace .github/skills + .claude/skills；user ~/.copilot/skills + ~/.claude/skills' },
-  { key: 'trae', label: 'Trae', detect: [{ cmd: 'trae' }, { app: '/Applications/Trae.app' }, { dir: join(HOME, '.trae-cn') }], user: join(HOME, '.trae-cn', 'skills'), project: join(CWD, '.trae', 'skills'), doc: 'https://docs.trae.cn/work_skills', note: '国内版 ~/.trae-cn/skills；国际版用户级未确认；另有 .trae/rules' },
-
-  // CLI agent
-  { key: 'qwen', label: 'Qwen Code', detect: [{ cmd: 'qwen' }, { file: join(HOME, '.qwen', 'settings.json') }], user: join(HOME, '.qwen', 'skills'), project: join(CWD, '.qwen', 'skills'), doc: 'https://qwenlm.github.io/qwen-code-docs/users/features/skills/', note: '模型自动调用；/learn 生成到项目 .qwen/skills' },
-  { key: 'opencode', label: 'OpenCode', detect: [{ cmd: 'opencode' }, { dir: join(HOME, '.config', 'opencode') }], user: join(HOME, '.config', 'opencode', 'skills'), project: join(CWD, '.opencode', 'skills'), doc: 'https://github.com/anomalyco/opencode/blob/main/packages/web/src/content/docs/skills.mdx', note: '兼容 .claude/skills 与 .agents/skills' },
-  { key: 'zed', label: 'Zed', detect: [{ cmd: 'zed' }, { app: '/Applications/Zed.app' }], user: join(HOME, '.agents', 'skills'), project: join(CWD, '.agents', 'skills'), doc: 'https://zed.dev/docs/ai/skills', note: '官方即用 .agents/skills 标准根，仅 --agents 时安装（避免默认触碰共享根）', agentsOnly: true },
-  // Amazon Q Developer：官方确认无 SKILL.md skills 机制（能力目录为 ~/.aws/amazonq/cli-agents/），故不入表
-]
-
-// 跨工具互操作标准根（默认跳过；--agents 显式开启）
-const AGENTS = { label: '共享 agents 级 (.agents/skills 标准)', path: join(HOME, '.agents', 'skills') }
-
-function print(line = '') { process.stdout.write(`${line}\n`) }
-
-/** 探测 IDE 是否真实安装（which 命令 / 应用路径 / 配置文件，任一命中即已安装） */
-function isIdeInstalled(ide) {
-  for (const probe of ide.detect) {
-    if (probe.cmd !== undefined) {
-      const r = spawnSync('which', [probe.cmd], { stdio: 'ignore' })
-      if (r.status === 0) return true
-    }
-    if (probe.app !== undefined && existsSync(probe.app)) return true
-    if (probe.file !== undefined && existsSync(probe.file)) return true
-    if (probe.dir !== undefined) {
-      // 目录存在且包含非 skills 的真实内容（避免本安装器创建的 skills 子目录误判）
-      try {
-        const entries = readdirSync(probe.dir)
-        if (entries.some((e) => e !== 'skills' && e !== '.git')) return true
-      } catch { /* 目录不存在或不可读，忽略 */ }
-    }
-  }
-  return false
-}
-
-async function listSkills() {
-  if (!existsSync(SKILLS_SRC)) return []
-  const entries = await readdir(SKILLS_SRC, { withFileTypes: true })
-  const skills = []
-  for (const e of entries) {
-    if (!e.isDirectory()) continue
-    const skillDir = join(SKILLS_SRC, e.name)
-    if (existsSync(join(skillDir, 'SKILL.md'))) skills.push(e.name)
-  }
-  return skills.sort()
-}
-
-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}`) }
-    return
-  }
-  await mkdir(dest, { recursive: true })
-  const sourceDir = join(SKILLS_SRC, name)
-  const destMeta = readMeta(dest) // 覆盖前读取旧版本
-  await cp(sourceDir, dest, { recursive: true, force: true })
-  const srcMeta = readMeta(sourceDir)
-  // 安装时注入版本横幅到 SKILL.md（IDE 每次读取即见版本与更新入口）
-  if (srcMeta?.version) {
-    const installedSkillMd = readFileSync(join(dest, 'SKILL.md'), 'utf8')
-    await writeFile(join(dest, 'SKILL.md'), injectVersionBanner(installedSkillMd, srcMeta.version, name))
-  }
-  if (srcMeta) {
-    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 {
-    print(`  ✓ 已安装 ${name} → ${dest}${srcMeta?.version ? `（${srcMeta.version}）` : ''}`)
-  }
-}
-
-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, silent })
-    if (reportUpdated && before && before.version) {
-      const after = readMeta(join(targetRoot, s))
-      if (after && after.version && after.version !== before.version) reportUpdated(1)
-    }
-  }
-}
-
-/** 解析目标列表：--target / --ide / --skip / 默认（全部已知 IDE） */
-function parseTargets(args) {
-  const flags = args.filter((a) => a.startsWith('--'))
-
-  const targetFlag = args.indexOf('--target')
-  if (targetFlag !== -1) {
-    const p = args[targetFlag + 1]
-    if (!p) { print('--target 需要一个绝对路径'); process.exit(1) }
-    return [{ label: '自定义', path: resolve(p) }]
-  }
-
-  const selected = []
-  const withProject = flags.includes('--project')
-
-  // 显式 --ide（可重复）
-  const ideKeys = []
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--ide') {
-      const k = args[i + 1]
-      if (!k) { print('--ide 需要一个 IDE key（如 codex）'); process.exit(1) }
-      ideKeys.push(k)
-      i++
-    }
-  }
-  if (ideKeys.length) {
-    for (const k of ideKeys) {
-      const ide = IDES.find((x) => x.key === k)
-      if (!ide) { print(`未知 IDE: ${k}（可用: ${IDES.map((x) => x.key).join(', ')}）`); process.exit(1) }
-      selected.push({ label: `${ide.label} 用户级`, path: ide.user })
-      if (withProject) selected.push({ label: `${ide.label} 项目级`, path: ide.project })
-    }
-    return selected
-  }
-
-  // --skip（排除某些 IDE）
-  const skipped = []
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === '--skip') {
-      const k = args[i + 1]
-      if (!k) { print('--skip 需要一个 IDE key（如 cursor）'); process.exit(1) }
-      skipped.push(k)
-      i++
-    }
-  }
-
-  // 默认：自动匹配——只装本机真实安装的 IDE；--all 则装全部已知 IDE。
-  const wantAgents = flags.includes('--agents')
-  const wantAll = flags.includes('--all')
-  for (const ide of IDES) {
-    if (skipped.includes(ide.key)) continue
-    // agentsOnly（如 Zed）：仅 --agents 时安装，默认不触碰共享根
-    if (ide.agentsOnly && !wantAgents) continue
-    // 默认只装检测到已安装的 IDE；--all 忽略检测
-    if (!wantAll && !isIdeInstalled(ide)) continue
-    selected.push({ label: `${ide.label} 用户级`, path: ide.user })
-    if (withProject) selected.push({ label: `${ide.label} 项目级`, path: ide.project })
-  }
-  if (!selected.length) {
-    print('未检测到任何已安装的 IDE；可用 --all 安装全部已知 IDE，或 --ide <key> 指定。')
-    process.exit(1)
-  }
-  return selected
-}
-
-const [cmd, ...rest] = process.argv.slice(2)
-
-/** 读取 skill 目录的 install-meta.json（没有则返回 null） */
-function readMeta(skillDir) {
-  const p = join(skillDir, INSTALL_META)
-  if (!existsSync(p)) return null
-  try { return JSON.parse(readFileSync(p, 'utf8')) } catch { return null }
-}
-
-/** 写入 skill 目录的 install-meta.json（来源/版本/时间/地址） */
-async function writeMeta(skillDir, meta) {
-  await writeFile(join(skillDir, INSTALL_META), `${JSON.stringify(meta, null, 2)}\n`)
-}
-
-/** 在 SKILL.md frontmatter 之后注入版本横幅：IDE 每次读取即见版本与更新命令 */
-function injectVersionBanner(skillMd, version, slug) {
-  if (!skillMd || !version) return skillMd
-  const banner = `<!-- cli-${slug}-installer: version ${version} · 检查更新见 install-meta.json / npx cli-${slug}@latest check -->\n`
-  if (skillMd.startsWith('---')) {
-    const end = skillMd.indexOf('\n---', 3)
-    if (end !== -1) {
-      return `${skillMd.slice(0, end + 5)}\n\n${banner}${skillMd.slice(end + 5).replace(/^\n+/, '')}`
-    }
-  }
-  return `${banner}${skillMd}`
-}
-
-/** 从 cli.tax 拉取一个 skill 到 skills/<slug>/（覆盖本地副本） */
-async function pullSkill(source) {
-  const url = source.endpoint.replace('{code}', source.code)
-  const resp = await fetch(url)
-  if (!resp.ok) {
-    print(`  ✗ 拉取失败 ${source.slug}（${url} → HTTP ${resp.status}）`)
-    return false
-  }
-  const data = await resp.json()
-  const dir = join(SKILLS_SRC, data.slug || source.slug)
-  await mkdir(dir, { recursive: true })
-  await writeFile(join(dir, 'SKILL.md'), data.skillMd)
-  await writeFile(join(dir, 'skill.json'), data.skillJson)
-  const previous = readMeta(dir)
-  await writeMeta(dir, {
-    source: source.code,
-    slug: data.slug || source.slug,
-    version: data.version ?? '',
-    endpoint: url,
-    installedAt: new Date().toISOString(),
-  })
-  const changed = previous && previous.version && previous.version !== data.version
-  if (changed) {
-    print(`  ⤴ 已更新 ${data.displayName} ${previous.version} → ${data.version ?? ''} → skills/${data.slug}/`)
-  } else {
-    print(`  ✓ 已拉取 ${data.displayName} ${data.version ?? ''} → skills/${data.slug}/`)
-  }
-  return true
-}
-
-/** 从 cli.tax 拉取单个 skill 的最新元数据（check 用，不写盘） */
-async function fetchLatestMeta(source) {
-  const url = source.endpoint.replace('{code}', source.code)
-  try {
-    const resp = await fetch(url)
-    if (!resp.ok) return null
-    const data = await resp.json()
-    return {
-      source: source.code,
-      slug: data.slug || source.slug,
-      version: data.version ?? '',
-      displayName: data.displayName ?? data.slug ?? source.slug,
-      endpoint: url,
-    }
-  } catch {
-    return null
-  }
-}
-
-/** check：遍历已安装目标的 skill 目录，对比远端最新版本，报告更新 */
-async function checkUpdates(targets) {
-  const sources = loadSources()
-  if (!sources.length) {
-    print('⚠ sources.json 无源，无法检查更新。')
-    return 1
-  }
-  let found = 0
-  for (const t of targets) {
-    print(`[${t.label}] ${t.path}`)
-    if (!existsSync(t.path)) { print('  · 未安装'); continue }
-    const entries = (await readdir(t.path, { withFileTypes: true }).catch(() => []))
-      .filter((e) => e.isDirectory())
-    if (!entries.length) { print('  · 无已安装 skill'); continue }
-    for (const e of entries) {
-      const skillDir = join(t.path, e.name)
-      const local = readMeta(skillDir)
-      const source = sources.find((s) => (s.slug === e.name)
-        || (local && local.source === s.code))
-      if (!source) continue
-      const remote = await fetchLatestMeta(source)
-      if (!remote) { print(`  · ${e.name}：远端查询失败，跳过`); continue }
-      if (!local || !local.version) {
-        print(`  · ${e.name}：本地无版本记录（旧安装），远端最新 ${remote.version} —— 运行 install 补齐`)
-        found++
-      } else if (local.version === remote.version) {
-        print(`  ✓ ${e.name} 已是最新（${remote.version}）`)
-      } else {
-        print(`  ⤴ ${e.name} 有新版本 ${local.version} → ${remote.version} —— 运行 install 更新`)
-        found++
-      }
-    }
-  }
-  if (found) {
-    print(`\n发现 ${found} 个 skill 可更新。执行: node install.mjs install`)
-  } else {
-    print('\n全部已是最新。')
-  }
-  return 0
-}
-
-/** 读取 sources.json 中的源列表 */
-function loadSources() {
-  const p = join(__dirname, 'sources.json')
-  if (!existsSync(p)) return []
-  try {
-    const raw = readFileSync(p, 'utf8')
-    return JSON.parse(raw).cliTax ?? []
-  } catch {
-    print('⚠ sources.json 解析失败，忽略源。')
-    return []
-  }
-}
-
-/** 拉取全部源；失败不影响本地已有 skills */
-async function pullAllSources() {
-  const sources = loadSources()
-  if (!sources.length) return false
-  print(`从 cli.tax 拉取 ${sources.length} 个 skill 源:`)
-  let ok = 0
-  for (const s of sources) { if (await pullSkill(s)) ok++ }
-  print(`拉取完成（${ok}/${sources.length}）。`)
-  return ok > 0
-}
-
-if (cmd === 'list') {
-  const skills = await listSkills()
-  print(`本包包含 ${skills.length} 个 skills:`)
-  for (const s of skills) print(`  - ${s}`)
-} else if (cmd === 'ides') {
-  print(`已知 IDE 及本机检测结果（共 ${IDES.length} 个）:`)
-  for (const ide of IDES) {
-    const installed = isIdeInstalled(ide)
-    print(`  ${installed ? '✓' : '·'} ${ide.key.padEnd(11)} ${ide.label.padEnd(20)} ${ide.user}`)
-  }
-  print(`  · agents     共享 agents 级  ${AGENTS.path}（默认跳过，--agents 开启）`)
-  print('默认 install 只装 ✓ 标记的 IDE；--all 装全部。')
-} else if (cmd === 'pull') {
-  const ok = await pullAllSources()
-  if (ok) print('已更新 skills/ 目录；可用 git add/commit 提交到仓库。')
-  process.exit(ok ? 0 : 1)
-} else if (cmd === 'install' || cmd === 'update') {
-  // 自动拉取：--pull 强制拉取；skills/ 为空时也自动拉取
-  if (rest.includes('--pull') || !existsSync(SKILLS_SRC) || (await readdir(SKILLS_SRC).catch(() => [])).length === 0) {
-    await pullAllSources()
-  }
-  const targets = parseTargets(rest)
-  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)
-  const silent = rest.includes('--silent') || rest.includes('--yes')
-  if (!silent) print(`将安装 ${skills.length} 个 skills → ${targets.length} 个目标`)
-  let updated = 0
-  for (const t of targets) {
-    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 可能被重复发现。')
-  }
-  if (!silent) {
-    print('完成。各 IDE 会自动发现各自用户级根中的新目录（可立即在新会话中调用）。')
-    if (updated) {
-      print(`提示：${updated} 个 skill 有更新。以后可用 node install.mjs check 检查新版本。`)
-    }
-  }
-} else if (cmd === 'check') {
-  const targets = parseTargets(rest)
-  if (rest.includes('--agents') && !targets.some((t) => t.path === AGENTS.path)) targets.push(AGENTS)
-  process.exitCode = await checkUpdates(targets)
-} else if (cmd === 'uninstall') {
-  const targets = parseTargets(rest)
-  if (rest.includes('--agents') && !targets.some((t) => t.path === AGENTS.path)) targets.push(AGENTS)
-  for (const t of targets) {
-    print(`[${t.label}] ${t.path}`)
-    await syncAll(t.path, { remove: true })
-  }
-  print('完成。')
-} else {
-  print(`用法:
-  node install.mjs install [--all|--ide <key>|--skip <key>|--project|--agents|--pull|--target <dir>]
-  node install.mjs pull
-  node install.mjs update
-  node install.mjs check
-  node install.mjs uninstall
-  node install.mjs list
-  node install.mjs ides
-
-  npm 安装后（npx cli-blueprint@latest / npx cli-calctool@latest）用法相同。`)
-  process.exit(1)
-}

package/skills/blueprint/SKILL.md

@@ -1,47 +0,0 @@
----
-name: blueprint
-description: '把一个目标编译为可执行、可验证、可追溯的工程蓝图（确定性检查节点/依赖/验收标准/合同）。Compile one goal into an executable, verifiable, traceable engineering blueprint with deterministic checks. Превращает цель в исполняемый, проверяемый инженерный план с узлами, зависимостями, критериями приёмки и валидацией.'
----
-
-# Blueprint Skill
-
-Endpoint: https://cli.tax/wvz6zmRWmX
-Request schema: blueprint.skill.request/1.0
-Response schema: blueprint.skill.response/1.0
-
-## Request envelope
-
-POST JSON to the endpoint with an `input` wrapper:
-
-```json
-{
-  "input": {
-    "schemaVersion": "blueprint.skill.request/1.0",
-    "requestId": "<unique-id>",
-    "operation": "<operation>",
-    "input": {}
-  }
-}
-```
-
-## Operations
-
-- `capabilities`: discover the operation list, per-operation inputs, and the recommended next step.
-- `help`: return the usage guide, operation catalog, and request examples.
-- `intake`: return the questions the IDE must ask the user before building the Blueprint.
-- `validate`: deterministically validate a Blueprint object conforming to `blueprint.ir/1.0`.
-- `compile-inline`: validate and compile a Blueprint, returning the generated artifacts inline.
-
-## Required flow
-
-1. Call `capabilities` first and read the returned `nextStep`.
-2. Call `intake` and ask the user the returned questions one at a time, waiting for each answer.
-3. Do not compile a Blueprint until all required questions are answered.
-4. Build a Blueprint conforming to `blueprint.ir/1.0`, then call `validate`.
-5. Fix every validation finding until the report is green, then call `compile-inline` and save the artifacts.
-
-## Safety rules
-
-- Never send credentials, model keys, provider endpoints, or personal secrets inside the request envelope or `input`.
-- The response `status` must be `succeeded`; a `failed` response is an error, not a result.
-- Public responses never prove that code was developed, tested, or deployed.

package/skills/blueprint/install-meta.json

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

package/skills/blueprint/skill.json

@@ -1,10 +0,0 @@
-{
-  "name": "blueprint",
-  "displayName": "Blueprint",
-  "description": "Blueprint 是一个跨工具的工程规划 CLI，把明确目标编译为可执行、可追溯、可验收的全站工程蓝图，并通过确定性规则检查每个节点、分支、合同、任务与验收闭环。默认由当前 IDE 的多智能体协同推演，也可连接用户自行安装的本地 Hermes；平台不托管模型密钥。",
-  "schemaVersion": "cli.request/1.0",
-  "endpoint": "https://cli.tax/wvz6zmRWmX",
-  "method": "POST",
-  "version": "v0.4.0",
-  "type": "Skill"
-}

package/skills/calctool/install-meta.json

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

package/skills/calctool/platform-template/README.md

@@ -1,74 +0,0 @@
-# calctool 平台模板
-
-由 calctool 生成的**可运行计算工具**工程模板（配置驱动、框架不变）。
-
-## 一键运行
-
-```bash
-npm install        # 或 pnpm install / yarn install（环境自动适配）
-npm run dev        # 启动开发服务器 http://localhost:5173
-```
-
-## 结构
-
-```
-├── src/
-│   ├── main.tsx                    # 入口（Ant Design X ConfigProvider）
-│   ├── App.tsx                     # 应用壳（录入/指标卡/链路/报告/授权 五页）
-│   ├── engine-definition.json      # ★ 引擎定义 + 链路（改这里 = 改工具，框架不动）
-│   ├── engine/
-│   │   ├── evaluate.ts             # JSON AST + decimal.js 确定性求值
-│   │   └── (recompute.ts 依赖图增量重算，按需扩展)
-│   ├── pipeline.ts                 # ★ 链路编排（联通节点，非单页孤岛）
-│   ├── authz.ts                    # ★ 授权管理（首次使用同意 + 逐能力授权，一次授权持久化）
-│   └── store.ts                    # 存储层（localStorage，可换 sqlite）
-├── vite.config.ts
-└── package.json
-```
-
-## 整套工具（联通节点，非单页孤岛）
-
-工具由**联通节点**组成，数据流在节点间流动：
-
-```
-录入/导入 → 数据校验 → 确定性计算 → 数据存储 → 指标卡/报告
-                                    ↘ 自动化（可选）
-```
-
-- 改动指标/公式：只改 `engine-definition.json`，链路自动感知
-- 新增能力：在 `pipeline.ts` 加节点（如导入、导出、告警），页面无需改
-- 页面「链路」Tab 可视化每个节点及其上下游，改工具时定位影响范围
-
-## 授权与消耗提示
-
-1. **首次使用总提示**：打开工具时弹窗告知"可能调用其他技能辅助、可能增加消耗"，同意后持久化不再提示（可按工具分别记录）
-2. **逐能力授权**：实际调用外部能力（Blueprint/搜索/模型/存储/自动化）前询问，一次授权永久记住
-3. **授权管理页**：随时查看已授权能力、撤销授权
-
-
-## 改指标/公式（需求变更，框架不变）
-
-编辑 `src/engine-definition.json`：
-
-```json
-{
-  "fields": [{ "key": "visitors", "label": "访客数", "type": "integer", "unit": "人" }],
-  "formulas": [
-    { "key": "conversionRate", "label": "转化率",
-      "expression": { "op": "safeDivide", "args": [{ "ref": "orders" }, { "ref": "visitors" }] } }
-  ]
-}
-```
-
-保存即热更新——**不用改任何代码**。
-
-## 公式运算符（详见 formula-dsl.md）
-
-`add / sub / mul / div（除零报错）/ safeDivide（除零回退）/ percentOf / round / if / ref / lit`
-
-## 环境适配
-
-- Node ≥18：全功能（可换 better-sqlite3 持久化）
-- Node 16：兼容（sql.js WASM）
-- Node <16：建议只用 L0 配置预览
-- 包管理器：npm/pnpm/yarn 命令自动适配

package/skills/calctool/platform-template/index.html

@@ -1,12 +0,0 @@
-<!doctype html>
-<html lang="zh-CN">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>calctool 计算工具</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
-  </body>
-</html>

package/skills/calctool/platform-template/package.json

@@ -1,26 +0,0 @@
-{
-  "name": "calctool-tool",
-  "version": "1.0.0",
-  "private": true,
-  "type": "module",
-  "description": "calctool 生成的可运行计算工具（配置驱动，Ant Design X + decimal.js）",
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc -b && vite build",
-    "preview": "vite preview",
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "antd": "^6.0.0",
-    "@ant-design/x": "^2.9.0",
-    "decimal.js": "^10.4.3",
-    "lucide-react": "^0.469.0"
-  },
-  "devDependencies": {
-    "@vitejs/plugin-react": "^4.3.4",
-    "typescript": "^5.6.0",
-    "vite": "^6.0.0"
-  }
-}