create-dwy 0.17.0 → 0.17.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # create-dwy
 
+## 0.17.1
+
+### Patch Changes
+
+- `dwy --help` 正式列出 `dwy skills install` / `dwy skills --help`，不再标成隐藏命令。`dwy skills` 无参数时打印 skills 子命令说明。
+
+---
+
 ## 0.17.0
 
 ### Minor Changes

package/bin/index.js

@@ -5,36 +5,40 @@ import { fileURLToPath } from 'url'
 import { dirname, resolve } from 'path'
 import { syncAll } from '../src/sync-all.js'
 import { installSkills } from '../src/skills-install.js'
+import { buildHelpText, buildSkillsHelpText } from '../src/cli-help.js'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
 const pkg = JSON.parse(readFileSync(resolve(__dirname, '..', 'package.json'), 'utf-8'))
 const argv = process.argv.slice(2)
 
+/** 是否请求帮助（含 -h / --help / help） */
+function wantsHelp(args) {
+  return args.includes('--help') || args.includes('-h') || args[0] === 'help'
+}
+
 function printHelp() {
-  const lines = [
-    `dwy ${pkg.version}`,
-    '',
-    'Usage:',
-    '  dwy               交互同步：先选完整/仅 Skills，末步可选全局目录',
-    '  dwy --help        显示本说明',
-    '  dwy -h            显示本说明',
-    '  dwy --version     显示当前版本',
-    '  dwy -V            显示当前版本',
-    '',
-    '以下为隐藏命令（向后兼容保留，日常无需手动调用）：',
-    '  dwy sync          同上的别名',
-    '  dwy skills install  强制刷新全局外部 skill',
-    '',
-  ]
-  console.log(lines.join('\n'))
+  console.log(buildHelpText(pkg.version))
+}
+
+function printSkillsHelp() {
+  console.log(buildSkillsHelpText())
 }
 
-if (argv.includes('--help') || argv.includes('-h') || argv[0] === 'help') {
+if (argv[0] === 'skills') {
+  const rest = argv.slice(1)
+  if (rest.length === 0 || wantsHelp(rest) || rest[0] === 'help') {
+    printSkillsHelp()
+  } else if (rest[0] === 'install') {
+    await installSkills()
+  } else {
+    console.error(`未知命令: dwy skills ${rest.join(' ')}`)
+    printSkillsHelp()
+    process.exitCode = 1
+  }
+} else if (wantsHelp(argv)) {
   printHelp()
 } else if (argv.includes('--version') || argv.includes('-V')) {
   console.log(pkg.version)
-} else if (argv[0] === 'skills' && argv[1] === 'install') {
-  await installSkills()
 } else if (argv.length === 0 || argv[0] === 'sync') {
   await syncAll()
 } else {

package/package.json

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

package/src/cli-help.js

@@ -0,0 +1,44 @@
+/**
+ * dwy 命令行帮助文案。
+ * 已实现的入口必须出现在这里；禁止把可用命令藏进「隐藏」段。
+ */
+
+/**
+ * 主帮助：`dwy --help`。
+ * version 来自 package.json，调用方传入，避免本模块读盘。
+ *
+ * @param {string} version
+ */
+export function buildHelpText(version) {
+  return [
+    `dwy ${version}`,
+    '',
+    'Usage:',
+    '  dwy                  交互同步：选范围（完整/仅 Skills）、平台、skill 落点',
+    '  dwy sync             同上',
+    '  dwy skills install   强制刷新全局外部 skill 到 ~/.dwy/skills',
+    '  dwy skills --help    显示 skills 子命令',
+    '  dwy --help           显示本说明',
+    '  dwy -h               显示本说明',
+    '  dwy --version        显示当前版本',
+    '  dwy -V               显示当前版本',
+    '',
+    'Skills:',
+    '  dwy skills install   按清单安装/覆盖更新 pm-skills、superpowers（一台机一份）',
+    '',
+  ].join('\n')
+}
+
+/**
+ * skills 子命令帮助：`dwy skills` / `dwy skills --help`。
+ */
+export function buildSkillsHelpText() {
+  return [
+    'dwy skills',
+    '',
+    'Usage:',
+    '  dwy skills install   强制刷新全局外部 skill 到 ~/.dwy/skills',
+    '  dwy skills --help    显示本说明',
+    '',
+  ].join('\n')
+}