create-component-template-cli 1.0.1 → 1.0.2

package/AGENTS.md

@@ -4,7 +4,7 @@ This file provides guidance to Codex (Codex.ai/code) when working with code in t
 
 ## Project Overview
 
-**create-vue-component-template** (CLI command: `cvct`) — a CLI scaffolding tool that generates Vue component directory structures with predefined templates. Published to npm as a global CLI utility.
+**create-vue-component-template-cli** (CLI command: `cvct`) — a CLI scaffolding tool that generates Vue component directory structures with predefined templates. Published to npm as a global CLI utility.
 
 ## Commands
 

package/CHANGELOG.md

@@ -1,4 +1,10 @@
-# create-vue-component-template
+# create-vue-component-template-cli
+
+## 1.0.2
+
+### Patch Changes
+
+- npx cctc 运行命令更改
 
 ## 1.0.1
 

package/CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-**create-vue-component-template** (CLI command: `cvct`) — a CLI scaffolding tool that generates Vue component directory structures with predefined templates. Published to npm as a global CLI utility.
+**create-vue-component-template-cli** (CLI command: `cvct`) — a CLI scaffolding tool that generates Vue component directory structures with predefined templates. Published to npm as a global CLI utility.
 
 ## Commands
 

package/README.md

@@ -1,11 +1,19 @@
-# create-vue-component-template
+# create-component-template-cli
 
 一个用于快速创建 Vue 3 + TypeScript + Sass 组件骨架的 CLI 工具。
 
-## 用法
+## 使用方式
 
 ```bash
-# 交互模式
+# 通过包名直接执行（适合 npm / npx 用户）
+npx create-component-template-cli --version
+npx create-component-template-cli
+
+# 通过短命令执行
+npx cvct --version
+npx cvct
+
+# 本地开发调试
 node bin/cli.mjs
 
 # 非交互模式
@@ -14,7 +22,7 @@ node bin/cli.mjs --name=MyComponent --rootPath=src/components/platform
 # 指定业务模板类型
 node bin/cli.mjs --name=MyComponent --rootPath=src/components/platform --templateType=single-pick
 
-# 指定 index.vue 的 Vue 风格
+# 指定 index.vue 的 Vue 写法
 node bin/cli.mjs --name=MyComponent --rootPath=src/components/platform --templateType=multiple-pick --vueTemplateType=normal
 ```
 

package/bin/cli.mjs

@@ -16,7 +16,7 @@ function printVersion() {
 
 function printHelp() {
   console.log(`
-cvct - Vue 组件模板生成器 (create-vue-component-template)
+cvct - Vue 组件模板生成器 (create-vue-component-template-cli)
 
 用法:
   cvct [选项]

package/docs/2026-05-11T12-35-00-npx/346/211/247/350/241/214/345/205/245/345/217/243/344/277/256/345/244/215/2026-05-11T12-35-00-npx/346/211/247/350/241/214/345/205/245/345/217/243/344/277/256/345/244/215-/345/256/236/346/226/275/346/226/271/346/241/210.md

@@ -0,0 +1,66 @@
+# npx 执行入口修复-实施方案
+
+## 1. 问题描述
+
+用户在发包成功后执行 `npx create-component-template-cli`，终端报错：
+
+```text
+'cvct' 不是内部或外部命令，也不是可运行的程序或批处理文件。
+```
+
+但执行 `npx cvct` 可以正常输出版本号。
+
+## 2. 原因分析
+
+当前包的 `package.json` 只声明了一个可执行入口：
+
+```text
+bin:
+  cvct -> bin/cli.mjs
+```
+
+这会导致：
+
+1. 用户如果明确执行 `npx cvct`，npm 能找到对应的可执行文件。
+2. 用户如果执行 `npx create-component-template-cli`，npm 在 Windows 环境下不会自动把包名映射成 `cvct`，从而出现命令不存在。
+
+## 3. 实施方案
+
+### 3.1 修复入口映射
+
+在 `package.json` 中同时声明两个可执行名称，并都指向同一个入口文件：
+
+```text
+bin:
+  cvct -> bin/cli.mjs
+  create-component-template-cli -> bin/cli.mjs
+```
+
+### 3.2 更新使用文档
+
+在 README 中明确说明两种推荐调用方式：
+
+```text
+npx create-component-template-cli
+npx cvct
+```
+
+这样做的原因是：
+
+1. 包名调用方式更符合用户直觉。
+2. 短命令调用方式更适合高频使用。
+
+## 4. 验证方案
+
+使用以下命令做闭环验证：
+
+```text
+步骤 1：验证本地入口文件仍可正常输出版本
+步骤 2：验证 npx cvct --version 可以执行
+步骤 3：验证 npx create-component-template-cli --version 可以执行
+步骤 4：验证 npm pack 后产物包含 bin/cli.mjs 与双 bin 映射
+```
+
+## 5. 风险说明
+
+本次修改只涉及包元数据与说明文档，不改变模板生成逻辑，业务风险较低。

package/docs/2026-05-11T12-35-00-npx/346/211/247/350/241/214/345/205/245/345/217/243/344/277/256/345/244/215/2026-05-11T12-35-00-npx/346/211/247/350/241/214/345/205/245/345/217/243/344/277/256/345/244/215-/346/200/235/350/267/257/346/226/207/346/241/243.md

@@ -0,0 +1,69 @@
+# npx 执行入口修复-思路文档
+
+## 1. 排查思路
+
+这次问题表面上看是“命令找不到”，但需要先区分是以下哪一层出了问题：
+
+1. 包没有成功发布。
+2. 发布包里缺少 `bin/cli.mjs`。
+3. `package.json` 的 `bin` 字段配置错误。
+4. `npx` 调用的命令名和实际暴露的 bin 名不一致。
+
+## 2. 实际排查过程
+
+### 2.1 先看本地源码
+
+确认 `package.json` 中存在：
+
+```text
+name = create-component-template-cli
+bin.cvct = bin/cli.mjs
+```
+
+说明源码只暴露了 `cvct` 这个命令。
+
+### 2.2 再看打包产物
+
+通过 `npm pack` 检查 tarball 内容，确认 `bin/cli.mjs` 已被打进包里。
+
+这一步的意义是：
+
+1. 排除“发包漏文件”。
+2. 证明运行时报错不是因为入口脚本缺失。
+
+### 2.3 再看线上元数据
+
+通过 `npm view create-component-template-cli ...` 查看线上元数据，确认线上 `bin` 仍然只有 `cvct`。
+
+### 2.4 最后做最小复现
+
+复现结果：
+
+```text
+npx cvct --version                           -> 成功
+npx create-component-template-cli --version -> 失败
+```
+
+这说明真正的问题不是 CLI 代码本身，而是可执行命令别名不完整。
+
+## 3. 为什么这样修
+
+最小改动方案是直接补一个与包名同名的 bin 映射，而不是改动 `bin/cli.mjs` 的执行逻辑。
+
+原因：
+
+1. 问题发生在 npm 命令解析阶段，不在业务代码阶段。
+2. 增加包名别名不会影响已有用户继续使用 `cvct`。
+3. 兼容“记包名”和“记短命令”两类用户习惯。
+
+## 4. 伪代码示意
+
+```text
+if user_run_by_package_name:
+  resolve bin["create-component-template-cli"]
+
+if user_run_by_short_name:
+  resolve bin["cvct"]
+
+both -> execute "bin/cli.mjs"
+```

package/docs/2026-05-11T12-35-00-npx/346/211/247/350/241/214/345/205/245/345/217/243/344/277/256/345/244/215/2026-05-11T12-35-00-npx/346/211/247/350/241/214/345/205/245/345/217/243/344/277/256/345/244/215-/346/200/273/347/273/223/346/226/207/346/241/243.md

@@ -0,0 +1,27 @@
+# npx 执行入口修复-总结文档
+
+## 本次完成内容
+
+1. 定位了 `npx create-component-template-cli` 报错的根因。
+2. 在 `package.json` 中新增了 `create-component-template-cli -> bin/cli.mjs` 的 bin 映射。
+3. 保留了原有 `cvct -> bin/cli.mjs` 的短命令入口，避免兼容性回退。
+4. 重写 README 的使用说明，补充了包名调用方式与短命令调用方式。
+5. 完成了本地命令验证与打包产物验证。
+
+## 当前版本收益
+
+1. 用户可以直接执行 `npx create-component-template-cli`，调用方式和包名保持一致。
+2. 老用户仍可继续执行 `npx cvct`，不会受到影响。
+3. 文档说明更完整，后续排障成本更低。
+
+## 目前不足
+
+1. README 之外的其他文档（如 AGENTS/CLAUDE 中的示例）仍以本地 `node bin/cli.mjs` 为主，没有单独强调包名执行方式。
+2. 仓库当前没有自动化测试覆盖“npx/发布后入口解析”这个场景，未来仍可能出现回归。
+3. 打包产物目前包含较多与发布无关的文件，后续可以考虑通过 `files` 字段进一步收敛 npm 包体积。
+
+## 后续建议
+
+1. 发一个补丁版本，把新的 bin 映射发布到 npm。
+2. 增加一个发布前校验脚本，自动验证 tarball 中的 `bin` 配置和入口文件是否完整。
+3. 视情况补充 `files` 字段，减少无关文件进入 npm 包。

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "create-component-template-cli",
-  "description": "create-vue-component-template,A CLI tool for creating standardized Vue 3 + TypeScript + Sass public component templates.",
-  "version": "1.0.1",
+  "description": "create-vue-component-template-cli,A CLI tool for creating standardized Vue 3 + TypeScript + Sass public component templates.",
+  "version": "1.0.2",
   "type": "module",
   "publishConfig": {
     "access": "public"
   },
   "bin": {
-    "cvct": "bin/cli.mjs"
+    "cctc": "bin/cli.mjs",
+    "create-component-template-cli": "bin/cli.mjs"
   },
   "access": "public",
   "dependencies": {