create-dwy 0.25.1 → 0.25.3

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # create-dwy
 
+## [0.25.3] - 2026-11-06
+
+### Patch Changes
+
+- 修复项目中全局 Skills 禁选后，已启用分类 Tab 失去颜色区分的问题。包含项目已勾选或全局已启用 Skills 的非当前分类保持青色，当前分类保持青色底；禁选逻辑和可勾选项计数保持不变。
+- 补充部分／全部全局覆盖状态以及真实交互输出的颜色回归。
+
+---
+
+## [0.25.2] - 2026-11-06
+
+### Patch Changes
+
+- 恢复 AI 模板随 CLI 包分发，移除启动时的远端 Git 检查、下载和模板缓存读取，避免运行 `dwy` 长时间等待。Skills 变更通过发布 CLI 交付，`dwy refresh` 从当前包内模板刷新已安装副本；保留显式开发目录覆盖。
+- 补齐普通项目交互的全局 Skills 禁选：有效全局入口已覆盖的条目标注“全局已启用”，禁止重复勾选；末步新增其他 CLI 时只补缺失入口，保留已有全局内容。
+- 保留范围优先、CLI 末尾选择、全局规范与 Hooks 跳页以及升级后的实际版本校验。
+
+---
+
 ## [0.25.1] - 2026-11-06
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.25.1",
+  "version": "0.25.3",
   "description": "项目脚手架与多平台 AI 配置同步工具",
   "type": "module",
   "bin": {

package/src/cli-help.js

@@ -17,7 +17,7 @@ export function buildHelpText(version) {
     '  dwy            选择范围、配置和 CLI，预览清单后同步',
     '  dwy sync       同上',
     '  dwy upgrade    升级到 npm 最新正式版，并刷新共享 Skills',
-    '  dwy refresh    用最新模板刷新已安装的共享 Skills，无需升级 CLI',
+    '  dwy refresh    用当前 CLI 包内模板刷新已安装的共享 Skills',
     '  dwy migrate    一键迁移老项目已有的托管 Skills，原目录先备份',
     '  dwy --help     显示本说明',
     '  dwy --version  显示版本',
@@ -59,16 +59,16 @@ export function buildHelpText(version) {
     '用户主目录不能作为项目范围同步，请选择全局或进入项目目录。',
     '关闭选项只移除当前范围托管内容；项目操作不移除全局配置。',
     'Skills 副本集中在 ~/.dwy/skills；项目和全局使用目录链接，同平台全局入口优先。',
-    '项目 Skills 全部适用平台均有全局入口时显示「全局已启用」，不能重复勾选。',
-    '部分平台已有全局入口时仍可选，只为缺少全局入口的平台安装项目链接。',
+    '项目 Skills 全部适用平台均有有效全局入口时显示「全局已启用」，不能重复勾选。',
+    '部分平台已有有效全局入口时仍可选，只为缺少全局入口的平台安装项目链接。',
     'Hooks 与 Skills 独立；整组管理，项目仅安装缺少有效全局注册的 Hooks。',
     '全局 Hook 的脚本与对应事件、matcher、完整命令注册均有效时，项目禁止重复安装。',
-    '任一适用 CLI 已有 dwy 全局通用规范时，项目继承并清理重复基线；最终 CLI 中缺失的全局规范需补齐。',
+    '任一适用 CLI 已有 dwy 全局通用规范时，项目继承并清理重复基线；其他 CLI 缺失的全局规范另选全局范围补齐。',
     '手写 AGENTS.md 本身不算全局已安装；通用规范与 Rules 共用文件但独立管理。',
     '移除通用规范仅删除基线块；项目 Rules 独立管理，保留手写内容。',
     '全局启用会明确列出当前项目重复项清理；全局移除不会自动向项目补装。',
     '项目同步只清理项目重复入口，不改写有效全局提供者；真实目录先备份。',
-    '确认前仅可更新模板缓存；确认后才改项目／全局配置，并刷新所选共享 Skills。',
+    '确认前不改项目／全局配置或已安装共享内容；确认后才同步配置，并刷新所选共享 Skills。',
     '由有效全局入口提供的 Skills 不借项目同步改写；全部已安装副本用 dwy refresh 更新。',
     'sync / migrate 脚本接口仍须显式指定范围。',
     '产品流程缺失的外部依赖也列入清单，确认后联网补齐，已有内容保留。',
@@ -77,10 +77,9 @@ export function buildHelpText(version) {
     'Rules / Hooks 的模板更新仍需执行 dwy sync；已有会话缓存的 Skill 可能需要重新加载。',
     '',
     '模板更新：',
-    '  固定公开仓库 https://github.com/danweiyuancircle/dwy-ai-experience.git 的 master 分支 dwy-cli/templates/ai-tools。',
-    '  DWY_TEMPLATE_SOURCE_DIR 开发覆盖优先；远端模板缓存在 ~/.dwy/template-source。',
-    '  未变更只检查 commit；离线保留有效缓存，无有效缓存时回退包内模板并提示。',
-    '  新增 Skills 只需更新模板分发分支，无需发布 CLI；dwy upgrade 更新程序。',
+    '  模板随 CLI 包分发，启动不联网检查模板。',
+    '  DWY_TEMPLATE_SOURCE_DIR 开发覆盖优先；未设置时读取当前 CLI 的 dwy-cli/templates/ai-tools。',
+    '  Skills 新增或变更需要 CLI 发版；dwy upgrade 更新程序与包内模板。',
     '',
   ].join('\n')
 }

package/src/sync-all.js

@@ -279,8 +279,7 @@ export async function syncAll({
     unionSets(...platforms.map(platform => platform === 'cursor' && type === 'rules' ? cursorRules : existing[platform][type]))]))
   const defaults = buildSelectionDefaultsFromSyncState(current, targetState, platforms)
   for (const type of ['skills', 'rules', 'hooks']) defaults[type] = unionSets(defaults[type], current[type])
-  // CLI 尚未选择时允许勾选所有 Skills；最终计划按实际 CLI 去重，避免提前禁用其他 CLI 所需条目。
-  const choices = platformsOverride && !global && contentTypes.includes('skills')
+  const choices = !global && contentTypes.includes('skills')
     ? { ...scans, skills: await projectSkillChoices(scans.skills, platforms, { homeDir, codexHome }) } : scans
   const selected = selectedOverride
     ? { skills: selectedOverride.skills || [], rules: selectedOverride.rules || [], hooks: [], commands: [] }
@@ -324,6 +323,8 @@ export async function syncAll({
     platforms = await selectPlatforms(targetRoot, scope, platforms)
     if (platforms === null) { console.log(chalk.yellow('已取消同步。')); return }
   }
+  // 禁选的全局 Skills 仍处于启用状态；末步新增 CLI 时只补缺失入口，已有全局源保持原样。
+  if (!selectedOverride && !global) selected.skills.push(...choices.skills.filter(skill => skill.disabled))
   const options = contentOptions(scope, platforms)
   if (mainFlow) contentTypes = contentTypes.filter(type => options.some(option => option.value === type))
   const stale = staleEntries(scans, targetState, existing, platforms)

package/src/sync-plan.js

@@ -39,7 +39,7 @@ export async function projectSkillChoices(skills, platforms, { homeDir, codexHom
     const disabled = applicable.length > 0 && covered.length === applicable.length
     const missing = applicable.filter(platform => !covered.includes(platform))
     const status = disabled ? '全局已启用' : covered.length ? `${missing.map(p => PLATFORM_LABELS[p]).join('、')} 可安装到项目` : ''
-    return { ...skill, disabled, label: status ? `${skill.name}（${status}）` : skill.name,
+    return { ...skill, disabled, inherited: covered.length > 0, label: status ? `${skill.name}（${status}）` : skill.name,
       description: [covered.length ? `全局已提供：${covered.map(p => PLATFORM_LABELS[p]).join('、')}` : '', skill.description].filter(Boolean).join('；') }
   }))
 }

package/src/sync.js

@@ -2,9 +2,8 @@ import fs from 'fs-extra'
 import path from 'path'
 import { isCancel } from '@clack/prompts'
 import { tabMultiselect } from './tab-multiselect.js'
-import { chalk } from './utils.js'
+import { chalk, PACKAGE_ROOT } from './utils.js'
 import { linkSkill, ensureSharedSkills, removeSkillEntry } from './skill-store.js'
-import { resolveTemplateSource } from './template-source.js'
 
 const CATEGORIES = [
   { key: 'skills', label: 'Skills' },
@@ -199,6 +198,7 @@ export function buildCategoryTabs(items, type) {
       label: item.label || item.name,
       description: item.description,
       disabled: item.disabled,
+      inherited: item.inherited,
       type,
     })
   }
@@ -391,9 +391,14 @@ async function syncSettings(sourceDir, targetDir, selectedHookNames, global, sta
   return 1
 }
 
-/** 解析模板源并检查公开模板更新；调用方可注入 homeDir 隔离用户缓存。 */
-export async function resolveSourceDir(options) {
-  return resolveTemplateSource(options)
+/** 只读取当前 CLI 的随包模板；开发时允许显式覆盖，不联网检查更新。 */
+export async function resolveSourceDir() {
+  const override = process.env.DWY_TEMPLATE_SOURCE_DIR
+  const sourceDir = override || path.join(PACKAGE_ROOT, 'templates', 'ai-tools')
+  if (!await fs.pathExists(sourceDir)) {
+    throw new Error(override ? `DWY_TEMPLATE_SOURCE_DIR not found: ${override}` : 'ai-tools templates not found in package')
+  }
+  return sourceDir
 }
 
 /** 同步 Claude Skills 与 Hooks；基线和项目 Rules 由总同步入口分别处理。 */

package/src/tab-multiselect.js

@@ -264,7 +264,7 @@ class TabMultiSelectPrompt extends Prompt {
 }
 
 /**
- * 画 Tab 栏。当前 Tab 反底；有勾选的其它 Tab 用青色，空的变暗。
+ * 当前 Tab 反底；项目已勾选或全局已启用的分类用青色，不把禁选状态当成未启用。
  *
  * @param {string[]} segments
  * @param {number} activeIndex
@@ -284,7 +284,7 @@ function renderTabBar(segments, activeIndex, win, tabs, selectedValues) {
     const { selected } = tabSelectionStats(tabs[i], set)
     if (i === activeIndex) {
       parts.push(styleText(['bgCyan', 'black'], ` ${text} `))
-    } else if (selected > 0) {
+    } else if (selected > 0 || tabs[i].options.some(option => option.inherited)) {
       parts.push(styleText('cyan', text))
     } else {
       parts.push(styleText('dim', text))

package/src/template-source.js

@@ -1,218 +0,0 @@
-import fs from 'fs-extra'
-import os from 'node:os'
-import path from 'node:path'
-import { execFile } from 'node:child_process'
-import { promisify } from 'node:util'
-import { randomUUID } from 'node:crypto'
-import { spinner } from '@clack/prompts'
-import { PACKAGE_ROOT } from './utils.js'
-
-const execFileAsync = promisify(execFile)
-const REMOTE = 'https://github.com/danweiyuancircle/dwy-ai-experience.git'
-const TEMPLATE_PATH = ['dwy-cli', 'templates', 'ai-tools']
-const REVISION_FILE = '.dwy-source-revision'
-
-async function statEntry(file) {
-  return fs.lstat(file).catch(error => {
-    if (error.code === 'ENOENT') return null
-    throw error
-  })
-}
-
-async function requireDirectory(directory) {
-  const stat = await fs.lstat(directory)
-  if (!stat.isDirectory() || stat.isSymbolicLink()) throw new Error(`模板目录不能是软链接或文件：${directory}`)
-}
-
-async function validateTemplates(directory) {
-  await requireDirectory(directory)
-  await validateTree(directory)
-  for (const name of ['skills', 'rules', 'hooks']) await requireDirectory(path.join(directory, name))
-  const baseline = path.join(directory, 'AGENTS.md')
-  if (!(await fs.lstat(baseline)).isFile() || !(await fs.readFile(baseline, 'utf8')).trim()) {
-    throw new Error('模板缺少有效 AGENTS.md')
-  }
-}
-
-async function validateTree(directory) {
-  for (const entry of await fs.readdir(directory, { withFileTypes: true })) {
-    if (entry.isSymbolicLink()) throw new Error(`模板不能包含软链接：${entry.name}`)
-    if (entry.isDirectory()) await validateTree(path.join(directory, entry.name))
-  }
-}
-
-async function deadLockExists(lockPath) {
-  const stat = await statEntry(lockPath)
-  if (!stat) return false
-  if (!stat.isFile()) throw new Error(`模板锁无效，保留原文件：${lockPath}`)
-  const owner = await fs.readFile(lockPath, 'utf8').catch(error => {
-    if (error.code === 'ENOENT') return null
-    throw error
-  })
-  if (owner === null) return false
-  const pid = Number(owner.trim())
-  if (!/^[1-9]\d*\s*$/.test(owner) || !Number.isSafeInteger(pid) || pid > 2147483647) {
-    throw new Error(`模板锁无效，保留原文件：${lockPath}`)
-  }
-  try {
-    process.kill(pid, 0)
-  } catch (error) {
-    if (error.code === 'ESRCH') return true
-    if (error.code !== 'EPERM') throw error
-  }
-  throw new Error(`进程 ${pid} 正在更新模板，保留现有锁。`)
-}
-
-async function acquireLock(lockPath, candidate) {
-  while (true) {
-    try {
-      await fs.link(candidate, lockPath)
-      return
-    } catch (error) {
-      if (error.code !== 'EEXIST') throw error
-    }
-    if (!await deadLockExists(lockPath)) continue
-    // 回收也须互斥，避免两个进程删掉对方的新锁；回收中断时按同一协议恢复。
-    const recovery = `${lockPath}.recovery`
-    await acquireLock(recovery, candidate)
-    try {
-      if (await deadLockExists(lockPath)) await fs.unlink(lockPath)
-      try {
-        await fs.link(candidate, lockPath)
-        return
-      } catch (error) {
-        if (error.code !== 'EEXIST') throw error
-      }
-    } finally {
-      await fs.unlink(recovery)
-    }
-  }
-}
-
-async function git(args, cwd) {
-  try {
-    const { stdout } = await execFileAsync('git', ['-c', 'core.hooksPath=/dev/null', ...args], {
-      cwd,
-      // 不加载用户安装的 hooks 或过滤器，避免检出远端内容时执行脚本。
-      env: { ...process.env, GIT_TERMINAL_PROMPT: '0', GIT_CONFIG_NOSYSTEM: '1', GIT_CONFIG_GLOBAL: '/dev/null' },
-      // 首次检出要获取整套模板，不能沿用轻量版本检查的短超时。
-      timeout: ['clone', 'checkout', 'fetch', 'reset'].includes(args[0]) ? 300000 : 15000,
-      maxBuffer: 1024 * 1024,
-    })
-    return stdout.trim()
-  } catch (error) {
-    throw new Error(`Git 获取模板失败（${error.code || error.signal}）`)
-  }
-}
-
-async function refreshTemplates(root, cache) {
-  await fs.ensureDir(root)
-  await requireDirectory(root)
-  const lockPath = path.join(root, 'template-source.lock')
-  const candidate = path.join(root, `.template-source-lock-${randomUUID()}`)
-  await fs.writeFile(candidate, `${process.pid}\n`, { flag: 'wx' })
-  try {
-    await acquireLock(lockPath, candidate)
-  } finally {
-    await fs.unlink(candidate)
-  }
-  let staging
-  const previous = path.join(root, '.template-source.previous')
-  try {
-    if (await statEntry(cache)) await requireDirectory(cache)
-    if (await statEntry(previous)) {
-      await validateTemplates(previous)
-      if (await statEntry(cache)) {
-        await validateTemplates(cache)
-        await fs.remove(previous)
-      } else {
-        await fs.rename(previous, cache)
-      }
-    }
-    const revision = (await git(['ls-remote', '--exit-code', REMOTE, 'refs/heads/master'], root)).split(/\s/)[0]
-    if (!/^[a-f\d]{40,64}$/.test(revision)) throw new Error('远端 master 版本无效')
-    if (await statEntry(cache)) {
-      try {
-        await validateTemplates(cache)
-        if ((await fs.readFile(path.join(cache, REVISION_FILE), 'utf8')).trim() === revision) return
-      } catch {
-        // 本地缓存不完整时重新获取，不能只凭版本标记跳过内容校验。
-      }
-    }
-    staging = await fs.mkdtemp(path.join(root, '.template-source-'))
-    const storedRepository = path.join(root, 'template-repository')
-    const reuse = !!await statEntry(storedRepository)
-    const repository = reuse ? storedRepository : path.join(staging, 'repository')
-    if (reuse) {
-      await requireDirectory(repository)
-      await requireDirectory(path.join(repository, '.git'))
-      await git(['fetch', '--depth=1', '--filter=blob:none', REMOTE, 'master'], repository)
-      await git(['reset', '--hard', 'FETCH_HEAD'], repository)
-    } else {
-      await git(['clone', '--depth=1', '--filter=blob:none', '--no-checkout', '--single-branch',
-        '--branch', 'master', REMOTE, repository], staging)
-      await git(['sparse-checkout', 'set', '--cone', TEMPLATE_PATH.join('/')], repository)
-      await git(['checkout', '--force', 'master'], repository)
-    }
-    let candidate = repository
-    for (const segment of TEMPLATE_PATH) {
-      candidate = path.join(candidate, segment)
-      await requireDirectory(candidate)
-    }
-    await validateTemplates(candidate)
-    const next = path.join(staging, 'templates')
-    await fs.copy(candidate, next)
-    await fs.writeFile(path.join(next, REVISION_FILE), await git(['rev-parse', 'HEAD'], repository))
-    if (!reuse) await fs.rename(repository, storedRepository)
-    const hadCache = !!await statEntry(cache)
-    if (hadCache) await fs.rename(cache, previous)
-    try {
-      await fs.rename(next, cache)
-    } catch (error) {
-      if (hadCache) await fs.rename(previous, cache)
-      throw error
-    }
-    if (hadCache) await fs.remove(previous)
-  } finally {
-    try {
-      if (staging) await fs.remove(staging)
-    } finally {
-      await fs.unlink(lockPath)
-    }
-  }
-}
-
-/**
- * 从固定公开仓库更新用户模板缓存；只读取已验证的目录，不执行模板脚本。
- * 显式目录优先；DWY_HOME 优先于注入 homeDir，更新失败保留缓存，无有效缓存才用随包模板。
- */
-export async function resolveTemplateSource({ homeDir = os.homedir() } = {}) {
-  const explicitSourceDir = process.env.DWY_TEMPLATE_SOURCE_DIR
-  if (explicitSourceDir) {
-    if (!await fs.pathExists(explicitSourceDir)) {
-      throw new Error(`DWY_TEMPLATE_SOURCE_DIR not found: ${explicitSourceDir}`)
-    }
-    return explicitSourceDir
-  }
-  const root = process.env.DWY_HOME || path.join(homeDir, '.dwy')
-  const cache = path.join(root, 'template-source')
-  const progress = process.stdout.isTTY ? spinner() : null
-  progress?.start('正在检查 AI 模板更新，首次获取可能较慢')
-  try {
-    await refreshTemplates(root, cache)
-    progress?.stop('AI 模板已就绪')
-    return cache
-  } catch (error) {
-    progress?.stop('模板更新未完成，正在检查本地来源')
-    try {
-      await validateTemplates(cache)
-    } catch {
-      const bundled = path.join(PACKAGE_ROOT, 'templates', 'ai-tools')
-      await validateTemplates(bundled)
-      console.warn(`模板更新失败（${error.message}）；无有效缓存，回退随包模板。`)
-      return bundled
-    }
-    console.warn(`模板更新失败（${error.message}）；继续使用本地缓存。`)
-    return cache
-  }
-}