create-dwy 0.22.0 → 0.23.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # create-dwy
 
+## [0.23.0] - 2026-11-02
+
+### Minor Changes
+
+- 同步改为「范围 → 平台 → 本次处理内容 → 逐项选择 → 清单确认」。默认只选 Skills；项目 Rules、全局通用规范和 Hooks 必须显式选择，未选择的类型及其记录保持原样。全局不提供 Cursor。
+- 默认勾选只读取当前范围及所选平台。项目 Skills 全部适用平台已有有效全局入口时显示“全局已启用”并禁用重复勾选；部分平台覆盖时只为缺少入口的平台安装。
+- 确认页和执行共用操作清单，列出共享副本、入口、旧项清理、配置和同步记录。项目去重只备份或移除项目入口，不改写全局提供者；用户主目录及其别名不能作为项目范围同步。
+- `sync` / `migrate` 只准备缺失或损坏的共享副本，已有内容由 `refresh` / `upgrade` 刷新。产品流程的外部依赖补装也纳入确认清单，只拉取缺失内容并保留已有副本。
+- 全局 Codex Hooks 遵循自定义 `CODEX_HOME`，命令路径正确引用空格和单引号；同步保留个人配置，补充平台兼容、取消无写入和真实终端交互回归。
+
+---
+
 ## [0.22.0] - 2026-11-02
 
 ### Minor Changes

package/package.json

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

package/src/cli-help.js

@@ -14,7 +14,7 @@ export function buildHelpText(version) {
     `dwy ${version}`,
     '',
     '用法：',
-    '  dwy            全局更新通用基线，项目注入所选 Rules；Skills / Hooks 可选位置',
+    '  dwy            选择范围、平台和处理内容，预览清单后同步',
     '  dwy sync       同上',
     '  dwy upgrade    升级到 npm 最新正式版，并刷新共享 Skills',
     '  dwy refresh    用当前 CLI 模板刷新已安装的共享 Skills',
@@ -23,20 +23,23 @@ export function buildHelpText(version) {
     '  dwy --version  显示版本',
     '',
     '同步步骤：',
-    '  1. 选择 Skills，再选择 Rules；按分类逐项勾选。',
-    '  2. 选择 Skills / Hooks 写入当前项目或全局，再选择平台。',
-    '  3. 查看更新、删除项，确认后才写入；取消不写文件。',
-    '  通用基线默认写入所选 CLI 的全局入口；所选 Rules 写入项目根 AGENTS.md。',
-    '  Hooks 按平台自动同步，无需选择；Commands 不参与同步。',
+    '  1. 选择同步范围：当前项目或全局。',
+    '  2. 选择该范围支持的平台；全局不提供 Cursor。',
+    '  3. 选择本次处理内容，默认只选 Skills；未选择的类型保持原样。',
+    '     项目：Skills、项目 Rules、Hooks；全局：Skills、全局通用规范、Hooks。',
+    '     内容选项按平台能力过滤。Hooks 选中类型后按平台自动处理。',
+    '  4. 逐项选择 Skills / 项目 Rules；全局通用规范显示摘要。',
+    '  5. 查看写入、备份和清理清单，确认后执行；取消不写文件。',
+    '  Commands 不参与同步。',
     '',
     '交互按键：',
     '  Skills / Rules：←/→ 切分类，↑/↓ 移动，Space 勾选，a 全选／清空当前分类。',
-    '  位置 / 平台：↑/↓ 移动；平台用 Space 勾选，可输入关键字筛选。',
+    '  范围 / 平台 / 内容：↑/↓ 移动；多选用 Space 勾选，可输入关键字筛选。',
     '  Enter 确认当前步骤，Esc 或 Ctrl+C 取消。',
     '',
     '常见用法：',
-    '  同步当前项目：cd your-project 后执行 dwy，在位置步骤选择「当前项目」。',
-    '  同步全局 Skills / Hooks：在项目目录执行 dwy，在位置步骤选择「全局」。',
+    '  同步当前项目：cd your-project 后执行 dwy，选择「当前项目」及本次处理内容。',
+    '  同步全局：执行 dwy，选择「全局」及 Skills、全局通用规范或 Hooks。',
     '  更新或调整配置：再次执行 dwy sync，检查勾选项，再确认同步。',
     '  更新 CLI：dwy upgrade（全局安装时可用；更新后执行 dwy --version 查看版本）。',
     '  迁移老项目：cd your-project 后执行 dwy migrate，无需重新勾选。',
@@ -49,9 +52,15 @@ export function buildHelpText(version) {
     '  OpenCode：全局 ~/.config/opencode/AGENTS.md；项目根 AGENTS.md；当前不支持 Hooks。',
     '  Cursor：仅项目 Rules；全局规则在 Cursor 设置中管理。',
     '',
-    '同步仅处理所选平台；基线固定全局、Rules 固定项目，位置选择只影响 Skills / Hooks。',
-    '取消已勾选的托管项会在确认后删除，保留手写内容。',
+    '同步仅处理当前范围、所选平台和内容；未选择的类型及其记录保持原样。',
+    '用户主目录不能作为项目范围同步，请选择全局或进入项目目录。',
+    '取消已有勾选会在确认后移除当前范围的托管入口；不勾选整个类型则不处理。',
     'Skills 副本集中在 ~/.dwy/skills；项目和全局使用目录链接，同平台全局入口优先。',
+    '项目 Skills 全部适用平台均有全局入口时显示「全局已启用」，不能重复勾选。',
+    '部分平台已有全局入口时仍可选，只为缺少全局入口的平台安装项目链接。',
+    '项目同步只清理项目重复入口，不改全局提供者；真实目录先备份。',
+    'sync / migrate 仅准备缺失或损坏副本，不刷新已有共享内容；refresh / upgrade 才刷新。',
+    '产品流程缺失的外部依赖也列入清单，确认后联网补齐，已有内容保留。',
     '旧真实目录备份到同步根的 .dwy/skill-backups；个人 Skills、Rules、Hooks 不参与 migrate。',
     '旧项目首次需执行 dwy migrate；迁移后无需逐项目刷新 Skills。',
     'Rules / Hooks 的模板更新仍需执行 dwy sync；已有会话缓存的 Skill 可能需要重新加载。',

package/src/skill-store.js

@@ -20,6 +20,21 @@ async function readInstalledNames(homeDir) {
   return names
 }
 
+/** 仅为缺失或损坏的 Skill 准备共享副本；已有有效内容只登记，不随入口同步刷新。 */
+export async function ensureSharedSkills({ skills, homeDir = os.homedir() }) {
+  const sources = []
+  for (const skill of skills) {
+    validateName(skill.name)
+    const cached = path.join(homeDir, '.dwy', 'skills', skill.name)
+    const stat = await fs.stat(path.join(cached, 'SKILL.md')).catch(error => {
+      if (['ENOENT', 'ENOTDIR', 'ELOOP'].includes(error.code)) return null
+      throw error
+    })
+    sources.push(stat?.isFile() ? { ...skill, sourcePath: cached } : skill)
+  }
+  return prepareSharedSkills({ skills: sources, homeDir })
+}
+
 /**
  * 将包内 Skills 准备到稳定用户目录，返回指向共享副本的条目。
  * 同一用户的刷新互斥；完整副本准备失败时不替换旧内容。外部 Skills 缓存不纳入本模块清单。

package/src/skills-install.js

@@ -71,24 +71,54 @@ async function shallowCloneTag(repoUrl, tag, destDir) {
   await runGit(['clone', '--depth', '1', '--branch', tag, repoUrl, destDir])
 }
 
-// 安装/更新全部外部 skill 到 ~/.dwy/skills/。再次运行即覆盖式更新。
-export async function installSkills() {
-  const targetDir = getGlobalSkillsDir()
-  await fs.ensureDir(targetDir)
+async function validExternalSkill(dest) {
+  const stat = await fs.stat(path.join(dest, 'SKILL.md')).catch(error => {
+    if (['ENOENT', 'ENOTDIR', 'ELOOP'].includes(error.code)) return null
+    throw error
+  })
+  return Boolean(stat?.isFile())
+}
 
-  const tmpRoot = path.join(os.tmpdir(), `dwy-skills-${process.pid}`)
-  await fs.ensureDir(tmpRoot)
+async function missingExternalSources(targetDir) {
+  const sources = []
+  for (const [name, source] of Object.entries(SKILL_SOURCES)) {
+    const skills = {}
+    for (const [skill, repoPath] of Object.entries(source.skills)) {
+      if (!await validExternalSkill(path.join(targetDir, skill))) skills[skill] = repoPath
+    }
+    if (Object.keys(skills).length) sources.push([name, { ...source, skills }])
+  }
+  return sources
+}
 
-  const versions = {}
+/** 只读列出产品流程缺失的外部依赖；确认后再联网补齐，已有副本不刷新。 */
+export async function planMissingExternalSkills(targetDir) {
+  const sources = await missingExternalSources(targetDir)
+  const paths = sources.flatMap(([, source]) => Object.keys(source.skills).map(name => path.join(targetDir, name)))
+  for (const [, source] of sources) {
+    const license = path.join(targetDir, source.licenseDest)
+    if (!await fs.pathExists(license)) paths.push(license)
+  }
+  if (sources.length) paths.push(path.join(targetDir, 'VERSIONS.json'))
+  return { paths, run: () => installSkillSources(sources, targetDir, true) }
+}
+
+async function installSkillSources(sources, targetDir, missingOnly) {
+  if (sources.length === 0) return
+  const versionsFile = path.join(targetDir, 'VERSIONS.json')
+  const previous = missingOnly && await fs.pathExists(versionsFile) ? await fs.readJson(versionsFile) : {}
+  const versions = { ...previous.versions }
+  await fs.ensureDir(targetDir)
+  const tmpRoot = await fs.mkdtemp(path.join(os.tmpdir(), 'dwy-skills-'))
   try {
-    for (const [sourceName, src] of Object.entries(SKILL_SOURCES)) {
+    for (const [sourceName, src] of sources) {
       console.log(chalk.gray(`拉取 ${sourceName} @ ${src.tag} ...`))
       const repoDir = path.join(tmpRoot, sourceName)
       await shallowCloneTag(src.repo, src.tag, repoDir)
 
       // 搬 LICENSE（MIT 要求保留原版权声明）
       const licenseSrc = path.join(repoDir, src.licenseFile)
-      if (await fs.pathExists(licenseSrc)) {
+      if (await fs.pathExists(licenseSrc) && (!missingOnly || !await fs.pathExists(path.join(targetDir, src.licenseDest)))) {
         await fs.copy(licenseSrc, path.join(targetDir, src.licenseDest), { overwrite: true })
       }
 
@@ -96,6 +126,7 @@ export async function installSkills() {
       for (const [skillName, repoPath] of Object.entries(src.skills)) {
         const from = path.join(repoDir, repoPath)
         const to = path.join(targetDir, skillName)
+        if (missingOnly && await validExternalSkill(to)) continue
         if (!await fs.pathExists(from)) {
           throw new Error(`${sourceName} @ ${src.tag} 内未找到 ${repoPath}（仓库结构可能变了）`)
         }
@@ -109,8 +140,8 @@ export async function installSkills() {
     // 写版本清单 + 清单指纹，供查看与后续更新比对。
     // manifest_hash 变化（cli 加了 skill / 改了 tag）→ 下次 ensureSkillsInstalled 触发重装。
     await fs.writeJson(
-      path.join(targetDir, 'VERSIONS.json'),
-      { manifest_hash: computeManifestHash(), versions },
+      versionsFile,
+      { manifest_hash: missingOnly ? previous.manifest_hash : computeManifestHash(), versions },
       { spaces: 2 },
     )
     console.log(chalk.green(`\n✓ 外部 skill 已安装到 ${targetDir}`))
@@ -119,6 +150,11 @@ export async function installSkills() {
   }
 }
 
+/** 兼容显式安装调用：更新固定清单中的全部外部 Skills。 */
+export async function installSkills() {
+  return installSkillSources(Object.entries(SKILL_SOURCES), getGlobalSkillsDir(), false)
+}
+
 // 全局 skill 是否已就绪（VERSIONS.json 存在）。
 export async function skillsInstalled() {
   return fs.pathExists(path.join(getGlobalSkillsDir(), 'VERSIONS.json'))