create-dwy 0.25.0 → 0.25.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # create-dwy
 
+## [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
+
+- 修复 `dwy upgrade` 查询官方源却从滞后镜像安装 `latest`，实际仍是旧版却显示升级成功的问题。查询与安装使用同一 registry，并固定查询所得的正式版本，不修改用户的镜像配置。
+- 安装后检查当前 PATH 中实际执行的 `dwy --version`，版本一致才刷新共享 Skills 并报告成功；刷新失败单独报错。补充旧版入口、真实子进程回读和 registry 输入校验回归。
+
+---
+
 ## [0.25.0] - 2026-11-06
 
 ### Minor Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-dwy",
-  "version": "0.25.0",
+  "version": "0.25.2",
   "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/self-upgrade.js

@@ -4,15 +4,36 @@
  * 源码目录 / 非全局安装拒绝执行，避免把仓库工作树覆盖成 npm 包。
  */
 
-import { spawn } from 'node:child_process'
+import { execFile, spawn } from 'node:child_process'
 import { readFileSync } from 'node:fs'
 import path from 'node:path'
+import { promisify } from 'node:util'
 import { PACKAGE_ROOT, chalk } from './utils.js'
 
 /** npm 包名，bin 是 dwy */
 export const PACKAGE_NAME = 'create-dwy'
 
 const DEFAULT_REGISTRY = 'https://registry.npmjs.org/'
+const execFileAsync = promisify(execFile)
+
+function upgradeRegistry() {
+  const value = process.env.npm_config_registry || DEFAULT_REGISTRY
+  let registry
+  try {
+    registry = new URL(value)
+  } catch {
+    throw new Error('npm_config_registry 必须是有效的 HTTP(S) registry 地址')
+  }
+  if (process.platform === 'win32' && /[&|<>^%!"()\r\n]/.test(value + registry.href)) {
+    throw new Error('npm_config_registry 含 Windows 命令解释器不支持的字符')
+  }
+  if (!['http:', 'https:'].includes(registry.protocol) || registry.search || registry.hash) {
+    throw new Error('npm_config_registry 必须是无查询参数及片段的 HTTP(S) registry 地址')
+  }
+  // 原生 fetch 不支持 URL 凭据，直接传入会在错误消息里泄露原地址。
+  if (registry.username || registry.password) throw new Error('npm_config_registry 不支持 URL 内嵌凭据')
+  return registry.href.replace(/\/?$/, '/')
+}
 
 /**
  * 比较 a、b 两个三段版本号。a>b 返回 1，相等 0，a<b -1。
@@ -49,17 +70,18 @@ export function detectInstaller(pkgRoot) {
 }
 
 /**
- * 构造升级命令。一律钉 @latest，不用 @next/@beta。
+ * 固定本轮查询到的正式版本及 registry，避免安装器的镜像 latest 滞后导致降回旧包。
  *
  * @param {'npm' | 'pnpm' | 'yarn' | 'bun' | 'unknown'} installer
+ * @param {string} version 来自已校验的正式版本查询结果
  * @returns {[string, string[]] | null}
  */
-export function buildUpgradeCommand(installer) {
-  const spec = `${PACKAGE_NAME}@latest`
-  if (installer === 'pnpm') return ['pnpm', ['add', '-g', spec]]
-  if (installer === 'yarn') return ['yarn', ['global', 'add', spec]]
-  if (installer === 'bun') return ['bun', ['add', '-g', spec]]
-  if (installer === 'npm') return ['npm', ['install', '-g', spec]]
+export function buildUpgradeCommand(installer, version) {
+  const spec = `${PACKAGE_NAME}@${version}`, registry = `--registry=${upgradeRegistry()}`
+  if (installer === 'pnpm') return ['pnpm', ['add', '-g', spec, registry]]
+  if (installer === 'yarn') return ['yarn', ['global', 'add', spec, registry]]
+  if (installer === 'bun') return ['bun', ['add', '-g', spec, registry]]
+  if (installer === 'npm') return ['npm', ['install', '-g', spec, registry]]
   return null
 }
 
@@ -79,16 +101,17 @@ function readCurrentVersion(pkgRoot = PACKAGE_ROOT) {
  * @param {typeof fetch} [fetchFn]
  */
 export async function fetchLatestVersion(fetchFn = globalThis.fetch) {
-  const registry = (process.env.npm_config_registry || DEFAULT_REGISTRY).replace(/\/?$/, '/')
+  const registry = upgradeRegistry()
   const url = `${registry}${PACKAGE_NAME}/latest`
   const response = await fetchFn(url, { headers: { Accept: 'application/json', 'User-Agent': 'create-dwy' } })
   if (!response.ok) {
-    throw new Error(`查询最新版本失败：${url} HTTP ${response.status}`)
+    const { origin, pathname } = new URL(url)
+    throw new Error(`查询最新版本失败：${origin}${pathname} HTTP ${response.status}`)
   }
   const body = await response.json()
   const version = body?.version
-  if (!version || typeof version !== 'string') {
-    throw new Error(`npm latest 未返回 version：${url}`)
+  if (typeof version !== 'string' || !/^\d+\.\d+\.\d+$/.test(version)) {
+    throw new Error('npm latest 未返回有效的正式 version')
   }
   return version
 }
@@ -114,6 +137,15 @@ function runSpawn(cmd, args) {
   })
 }
 
+async function readActiveVersion() {
+  const { stdout } = await execFileAsync('dwy', ['--version'], {
+    shell: process.platform === 'win32', timeout: 10000,
+  })
+  const version = stdout.trim()
+  if (!/^\d+\.\d+\.\d+$/.test(version)) throw new Error('无法从当前 PATH 中的 dwy 读取有效版本')
+  return version
+}
+
 /**
  * 执行自升级。返回结构化结果供测试断言；失败抛错。
  *
@@ -122,17 +154,18 @@ function runSpawn(cmd, args) {
  * @param {string} [opts.pkgRoot]
  * @param {() => Promise<string>} [opts.fetchLatest]
  * @param {(cmd: string, args: string[]) => Promise<void>} [opts.runCommand]
+ * @param {() => Promise<string>} [opts.readInstalledVersion] 回读 PATH 中实际将用于刷新的 CLI 版本
  */
 export async function selfUpgrade({
   currentVersion,
   pkgRoot = PACKAGE_ROOT,
   fetchLatest = fetchLatestVersion,
   runCommand = runSpawn,
+  readInstalledVersion = readActiveVersion,
 } = {}) {
   const current = currentVersion || readCurrentVersion(pkgRoot)
   const installer = detectInstaller(pkgRoot)
-  const command = buildUpgradeCommand(installer)
-  if (!command) {
+  if (installer === 'unknown') {
     throw new Error(
       `当前不是全局安装的 ${PACKAGE_NAME}（路径 ${pkgRoot}），无法自升级。请先 npm i -g ${PACKAGE_NAME}，或在源码仓 git pull。`,
     )
@@ -140,25 +173,30 @@ export async function selfUpgrade({
 
   const latest = await fetchLatest()
   const cmp = compareVersions(current, latest)
-  if (cmp === 0) {
-    await runCommand('dwy', ['refresh'])
-    console.log(chalk.green(`已是最新正式版 ${current}`))
-    return { status: 'up-to-date', current, latest, installer }
-  }
   if (cmp > 0) {
     console.log(chalk.yellow(`当前 ${current} 新于 npm latest ${latest}，不降级`))
     return { status: 'newer-local', current, latest, installer }
   }
 
-  const [cmd, args] = command
-  console.log(chalk.blue(`升级 ${PACKAGE_NAME} ${current} → ${latest}`))
-  console.log(chalk.gray(`  ${cmd} ${args.join(' ')}`))
-  await runCommand(cmd, args)
+  if (cmp < 0) {
+    const [cmd, args] = buildUpgradeCommand(installer, latest)
+    console.log(chalk.blue(`升级 ${PACKAGE_NAME} ${current} → ${latest}`))
+    console.log(chalk.gray(`  ${cmd} ${args.join(' ')}`))
+    await runCommand(cmd, args)
+  }
+  const installed = await readInstalledVersion()
+  if (installed !== latest) {
+    throw new Error(`升级未生效：目标 ${latest}，当前 PATH 中 dwy --version 为 ${installed}；未刷新共享 Skills。请检查全局安装路径与 registry。`)
+  }
   try {
     // 必须启动新安装的 CLI；pnpm 升级后旧进程的模块路径仍可能指向旧版本。
     await runCommand('dwy', ['refresh'])
   } catch (error) {
-    throw new Error(`CLI 已安装新版本，但共享 Skills 刷新失败：${error.message}`, { cause: error })
+    throw new Error(`CLI ${installed} 已就绪，但共享 Skills 刷新失败：${error.message}`, { cause: error })
+  }
+  if (cmp === 0) {
+    console.log(chalk.green(`已是最新正式版 ${installed}`))
+    return { status: 'up-to-date', current, latest, installer }
   }
   console.log(chalk.green(`已升级到 ${latest}`))
   return { status: 'upgraded', current, latest, installer }

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.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' },
@@ -391,9 +390,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/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
-  }
-}