create-dwy 0.29.0 → 0.31.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # create-dwy
 
+## [0.31.0] - 2026-11-09
+
+### Added
+
+- Codex 中由 dwy 同步的 Hook 执行时显示带 `dwy` 前缀的功能说明，便于识别来源。模板详情见 ai-tools 0.36.1。
+
+---
+
+## [0.30.0] - 2026-11-08
+
+### Added
+
+- 支持通过 `dwy source` 查看、设置或清除本地模板来源，优先使用本地仓库或模板目录；本地不可用时回退 GitHub。
+
+---
+
 ## [0.29.0] - 2026-11-08
 
 ### Added

package/bin/index.js

@@ -7,6 +7,7 @@ import { runDwy, migrateSkills } from '../src/sync-all.js'
 import { refreshSharedSkills } from '../src/skill-store.js'
 import { selfUpgrade } from '../src/self-upgrade.js'
 import { buildHelpText } from '../src/cli-help.js'
+import { manageTemplateSource } from '../src/template-source.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'))
@@ -25,8 +26,8 @@ if (wantsHelp(argv)) {
   printHelp()
 } else if (argv.includes('--version') || argv.includes('-V')) {
   console.log(pkg.version)
-} else if (['upgrade', 'refresh', 'migrate'].includes(argv[0])) {
-  if (argv.length > 1) {
+} else if (['upgrade', 'refresh', 'migrate', 'source'].includes(argv[0])) {
+  if (argv.length > (argv[0] === 'source' ? 2 : 1)) {
     console.error(`未知命令: dwy ${argv.join(' ')}`)
     printHelp()
     process.exitCode = 1
@@ -35,6 +36,7 @@ if (wantsHelp(argv)) {
       if (argv[0] === 'upgrade') await selfUpgrade()
       if (argv[0] === 'refresh') await refreshSharedSkills()
       if (argv[0] === 'migrate') await migrateSkills()
+      if (argv[0] === 'source') await manageTemplateSource(argv[1])
     } catch (error) {
       console.error(error.message)
       process.exitCode = 1

package/package.json

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

package/src/cli-help.js

@@ -19,6 +19,7 @@ export function buildHelpText(version) {
     '  dwy upgrade    升级到 npm 最新正式版，并刷新共享 Skills',
     '  dwy refresh    用最新模板刷新已安装的共享 Skills',
     '  dwy migrate    一键迁移老项目已有的托管 Skills，原目录先备份',
+    '  dwy source [路径|--clear]  查看、设置或清除本地模板路径',
     '  dwy --help     显示本说明',
     '  dwy --version  显示版本',
     '',
@@ -75,7 +76,8 @@ export function buildHelpText(version) {
     'Hooks 的模板更新仍需执行 dwy sync；已有会话缓存的 Skill 可能需要重新加载。',
     '',
     '模板更新：',
-    '  同步从 GitHub develop 获取模板；离线优先使用缓存，无有效缓存时使用随包模板。',
+    '  dwy source 路径 设置本地仓库或模板路径；dwy source --clear 恢复远端。',
+    '  本地不可用时从 GitHub develop 获取；离线优先使用缓存，无有效缓存时使用随包模板。',
     '  DWY_TEMPLATE_SOURCE_DIR 开发覆盖优先；设置后直接使用指定本地模板。',
     '  Skills 新增或变更不需要 CLI 发版；dwy upgrade 更新 CLI 程序。',
     '',

package/src/sync-codex.js

@@ -282,6 +282,7 @@ export function buildCodexHooksJson(manifests, selectedHookNames, global, config
       command: global
         ? globalHookCommand(configDir, manifest.name)
         : `bash "$(git rev-parse --show-toplevel)/.codex/hooks/${manifest.name}"`,
+      ...(manifest.statusMessage ? { statusMessage: manifest.statusMessage } : {}),
       ...(manifest.timeout ? { timeout: manifest.timeout } : {}),
     })
     grouped.set(key, hooks)

package/src/template-source.js

@@ -34,6 +34,45 @@ async function validateTemplates(directory) {
   }
 }
 
+async function localTemplateDirectory(localPath) {
+  const repositoryTemplates = path.join(localPath, ...TEMPLATE_PATH)
+  const directory = await fs.pathExists(repositoryTemplates) ? repositoryTemplates : localPath
+  await validateTemplates(directory)
+  return directory
+}
+
+/** 查看或设置本机模板来源；无参数查看，--clear 恢复远端来源。 */
+export async function manageTemplateSource(value, { homeDir = os.homedir() } = {}) {
+  const root = process.env.DWY_HOME || path.join(homeDir, '.dwy')
+  const file = path.join(root, 'template-source.json')
+  const config = await fs.readJson(file).catch(error => {
+    if (error.code === 'ENOENT') return {}
+    throw error
+  })
+  if (!config || typeof config !== 'object' || Array.isArray(config)) throw new Error('模板来源配置不是有效对象')
+  if (value === undefined) {
+    console.log(config.localPath ? `本地模板路径：${config.localPath}` : '未配置本地模板路径，将使用 GitHub。')
+  } else {
+    if (value === '--clear') {
+      delete config.localPath
+    } else {
+      const localPath = path.resolve(value)
+      await localTemplateDirectory(localPath)
+      config.localPath = localPath
+    }
+    await fs.ensureDir(root)
+    const temporary = path.join(root, `.template-source-config-${randomUUID()}`)
+    try {
+      await fs.writeJson(temporary, config, { spaces: 2, flag: 'wx' })
+      await fs.rename(temporary, file)
+    } finally {
+      await fs.remove(temporary)
+    }
+    console.log(config.localPath ? `已设置本地模板路径：${config.localPath}` : '已清除本地模板路径，将使用 GitHub。')
+  }
+  if (process.env.DWY_TEMPLATE_SOURCE_DIR) console.warn('当前 DWY_TEMPLATE_SOURCE_DIR 优先于本地模板配置。')
+}
+
 async function validateTree(directory) {
   for (const entry of await fs.readdir(directory, { withFileTypes: true })) {
     if (entry.isSymbolicLink()) throw new Error(`模板不能包含软链接：${entry.name}`)
@@ -199,7 +238,7 @@ async function refreshTemplates(root, cache, repositoryUrl) {
 
 /**
  * 从固定公开仓库更新用户模板缓存；只读取已验证的目录，不执行模板脚本。
- * 显式目录优先；DWY_HOME 优先于注入 homeDir，更新失败保留缓存，无有效缓存才用随包模板。
+ * 显式目录优先，其次用户配置的本地模板；更新失败保留缓存，无有效缓存才用随包模板。
  */
 export async function resolveTemplateSource({ homeDir = os.homedir(), repository = REMOTE } = {}) {
   const explicitSourceDir = process.env.DWY_TEMPLATE_SOURCE_DIR
@@ -210,6 +249,22 @@ export async function resolveTemplateSource({ homeDir = os.homedir(), repository
     return explicitSourceDir
   }
   const root = process.env.DWY_HOME || path.join(homeDir, '.dwy')
+  try {
+    const config = await fs.readJson(path.join(root, 'template-source.json'))
+    if (typeof config?.localPath !== 'string' || !path.isAbsolute(config.localPath)) {
+      throw new Error('localPath 必须是绝对路径')
+    }
+    const localTemplates = await localTemplateDirectory(config.localPath)
+    console.log(`使用本地模板：${localTemplates}（会读取本地未提交的修改）`)
+    const date = await git(['show', '-s', '--format=%cI', 'HEAD'], localTemplates).catch(() => '未知')
+    console.log(`本地仓库最近提交时间：${date}`)
+    return localTemplates
+  } catch (error) {
+    if (error.code !== 'ENOENT') console.warn(`本地模板配置或目录不可用（${error.message}）；回退 GitHub。`)
+    else if (error.path !== path.join(root, 'template-source.json')) {
+      console.warn('本地模板目录不存在；回退 GitHub。')
+    }
+  }
   const cache = path.join(root, 'template-source')
   const progress = process.stdout.isTTY ? spinner() : null
   progress?.start('正在检查 AI 模板更新，首次获取可能较慢')

package/templates/ai-tools/CHANGELOG.md

@@ -1,5 +1,11 @@
 # ai-tools 内部版本
 
+## 0.36.1 - 2026-11-09
+
+### Changed
+
+- `hook-manifests/hooks.json` 为三个 Codex Hook 添加带 dwy 前缀的执行状态说明。
+
 ## 0.36.0 - 2026-11-08
 
 ### Changed

package/templates/ai-tools/VERSION

@@ -1 +1 @@
-0.36.0
+0.36.1

package/templates/ai-tools/hook-manifests/hooks.json

@@ -4,6 +4,7 @@
     "event": "PreToolUse",
     "matcher": "Bash",
     "platforms": ["claude", "codex"],
+    "statusMessage": "dwy：检查提交中的敏感信息",
     "timeout": 30
   },
   {
@@ -11,6 +12,7 @@
     "event": "PreToolUse",
     "matcher": "Bash",
     "platforms": ["claude", "codex"],
+    "statusMessage": "dwy：检查提交命令中的反引号",
     "timeout": 30
   },
   {
@@ -18,6 +20,7 @@
     "event": "PreToolUse",
     "matcher": "Bash",
     "platforms": ["claude", "codex"],
+    "statusMessage": "dwy：检查提交信息中的 AI 签名",
     "timeout": 30
   }
 ]