cardbuddy 0.12.1 → 0.12.2

package/README.md

@@ -59,6 +59,12 @@ npm run preview                 # 本地服务(8787) + 内置编辑器前端 +
 > 本命令取代了 dsl-card 仓库里旧的 `npm run gen:demo`：脚手架随 npm 包发布，无需检出仓库，
 > 且版本天然与所装 `cardbuddy` 一致（旧方案生成的 `demo/` 会随主干漂移）。
 
+> ⚠️ **`npx cardbuddy init` 卡住不退、目录里只多了个 `.cache/`？** 本机装着 0.12.0 之前的
+> 全局旧版：`npx` 优先命中全局 bin，而旧版没有 `init` 子命令，会把 `init` 当无关参数忽略、
+> 转而启动常驻开发服务（于是既不退、也不脚手架）。用 `npm ls -g cardbuddy` 核对版本，
+> 再 `npm i -g cardbuddy@latest` 升级，或 `npm uninstall -g cardbuddy` 让 npx 每次自行拉取。
+> 0.12.0 起 CLI 对未知子命令会直接报错退出，不再静默起服务。
+
 ---
 
 ## Preview 模式（本地独立调试）
@@ -101,7 +107,7 @@ cardbuddy --preview          # 等价短参 -p
 | `EDITOR_URL` | `http://127.0.0.1:5180` | 截图自访问的编辑器实例地址（默认指向本地编辑器）。写入 `.env` 即可持久化。 |
 | `DSL_DEV_TOKEN` | _(空)_ | 可选鉴权令牌；开启后请求须带 `x-dev-token` 头。默认仅靠 `127.0.0.1` 绑定（不暴露局域网）。 |
 | `DSL_DEV_HTTPS` | `0` | 设为 `1` 启用自签 HTTPS（兜底旧 Safari / 企业策略的混合内容拦截）。 |
-| `DSL_EDITOR_SRC` | _(空)_ | 内核开发用：指向本地编辑器 `preview/` 源码，绕过 vendored 快照调试。 |
+| `DSL_EDITOR_SRC` | _(空)_ | 内核开发用：指向本地编辑器 `card-editor/` 源码，绕过 vendored 快照调试。 |
 | `DSL_DEV_PREVIEW` | `0` | 设为 `1` 等价于 `--preview`：同端口托管打包后的编辑器前端并自动打开浏览器。 |
 | `DSL_PREVIEW_ROOT` | _(空)_ | 自定义 preview 前端构建产物目录（默认包内 `dist/preview-editor/`，回退 `cwd/dist`）。 |
 | `DSL_EDITOR_CMD` | _(空)_ | 代码桥外部编辑器命令（如 `code` / `cursor` / 带参数整串），按 shell 语义执行并追加临时文件路径；缺省按平台拉起 VSCode（mac `open -a`、win `cmd /s /c "code"`、linux `code`），CLI 缺失再回退 `vscode://` 协议。 |
@@ -214,17 +220,17 @@ DSL_DEV_HTTPS=1 cardbuddy
 
 ## 本地开发（编辑器 + 本地服务）
 
-本仓库既是「卡片编辑器平台」的源码，也是 `cardbuddy` 的源码。下面说明怎么在本地开发**编辑器本身**（即 `preview/` 前端与 `server/core/` 后端）。
+本仓库既是「卡片编辑器平台」的源码，也是 `cardbuddy` 的源码。下面说明怎么在本地开发**编辑器本身**（即 `card-editor/` 前端与 `server/core/` 后端）。
 
 ### 关键区别：同域（dev）vs 跨域（生产）
 
-`npm run dev` 能"免费"工作，是因为 `preview/api.js` 的 `resolveApiBase()` 在 `import.meta.env.DEV` 为真时**走同源**（第 3 条回退），而**这条同源路径在生产里不存在**——`build` 产物的 `DEV=false`，生产永远依赖「编辑器配好 8787 地址 + 跨源调用本地服务」。
+`npm run dev` 能"免费"工作，是因为 `card-editor/api.js` 的 `resolveApiBase()` 在 `import.meta.env.DEV` 为真时**走同源**（第 3 条回退），而**这条同源路径在生产里不存在**——`build` 产物的 `DEV=false`，生产永远依赖「编辑器配好 8787 地址 + 跨源调用本地服务」。
 
 所以本地开发分两条互补的路径：
 
 | 命令 | 编辑器来源 | 后端来源 | 用途 |
 | --- | --- | --- | --- |
-| `npm run dev` | `preview/` 源码（Vite dev + HMR，5180） | `cardbuddy` 服务（8787，由 `tools/dev.mjs` 同起） | 日常改编辑器 / 卡片 |
+| `npm run dev` | `card-editor/` 源码（Vite dev + HMR，5180） | `cardbuddy` 服务（8787，由 `tools/dev.mjs` 同起） | 日常改编辑器 / 卡片 |
 | `npm run dev:prod` | `dist/` **构建产物**（`vite preview`） | `cardbuddy` 服务（8787） | 部署前权威跨域 smoke test（最贴近生产） |
 | 部署公网 | `dist/` 静态托管（CDN） | 用户本机起 8787 | 生产环境 |
 
@@ -266,7 +272,7 @@ npm run dev:prod
 
 | 你改的文件 | `npm run dev` | `npm run dev:prod` |
 | --- | --- | --- |
-| `preview/**`（Vue 组件 / runtime / 样式） | ✅ Vite HMR 即时 | ⚠️ 需重跑 `npm run dev:prod`（build 产物，无 HMR） |
+| `card-editor/**`（Vue 组件 / runtime / 样式） | ✅ Vite HMR 即时 | ⚠️ 需重跑 `npm run dev:prod`（build 产物，无 HMR） |
 | `src/cards/*.json`（卡片内容） | ✅ `cards-changed` watcher 自动重载 | ✅ 8787 SSE 推送自动重载 |
 | `server/core/**`（后端中间件） | ⚠️ 需**重启** Vite | ⚠️ 需**重启** 8787 服务 |
 | `vite.config.mjs` / 插件配置 | ⚠️ 需重启 Vite | ⚠️ 需重跑 `npm run dev:prod`（重新 build） |

package/dist/config.js

@@ -88,12 +88,12 @@ export function loadConfig(env = process.env) {
     portTakeover,
     // 迷你仓库快照根（发布态 = dist/vendored）
     vendorRoot,
-    // 内嵌 Vite 的 SSR 根：build 阶段按「SSR 模块闭包」从 preview/ 精选复制（components/* +
+    // 内嵌 Vite 的 SSR 根：build 阶段按「SSR 模块闭包」从 card-editor/ 精选复制（components/* +
     // runtime/* + meta/* + 被引用的少量 assets + api.js），不含编辑器 UI（App.vue / styles /
     // fidelity）—— 那些只存在于已构建好的 preview-editor 静态产物里。
-    vendoredRuntimeDir: path.join(vendorRoot, 'preview'),
-    // 仓库内开发回退：从仓库根运行时（cwd=仓库根）能直接命中 preview/，无需先 build。
-    repoPreviewDir: path.resolve(process.cwd(), 'preview'),
+    vendoredRuntimeDir: path.join(vendorRoot, 'card-editor'),
+    // 仓库内开发回退：从仓库根运行时（cwd=仓库根）能直接命中 card-editor/，无需先 build。
+    repoEditorDir: path.resolve(process.cwd(), 'card-editor'),
     // 包内技能快照（build 阶段从仓库 skills/ 全量内联，排除 .local / node_modules / __pycache__）：
     // 既是运行时的只读回退，也是 `cardbuddy init` 释放到项目根的源。
     vendoredSkillsDir,