cardbuddy 0.24.0 → 0.25.0

package/README.md

@@ -249,7 +249,7 @@ DSL_DEV_HTTPS=1 cardbuddy
 | `GET /__node-models/:id` | 自包含 + 内嵌 Vite SSR | 节点 Property 树模型 |
 | `GET /__import-meta/:id` | 自包含 | 导入侧车元数据 |
 | `GET /__history` | 自包含 | 编辑历史 |
-| `GET /__screenshot/:id` | 自包含（需 Playwright + 系统 Chrome）| 无头截图 |
+| `GET /__screenshot/:id` | 自包含（需 playwright-core + 系统 Chrome）| 无头截图 |
 | `GET /__events` (SSE) | 自包含 | `cards-changed` 实时推送 |
 | `POST /__code-bridge` | 自包含 | 代码桥：代码写临时 js 并拉起外部编辑器，返回 `{ id, file }` |
 | `GET /__code-bridge/:id` | 自包含 | 代码桥：拉取外部保存后的最新代码（LF 归一） |
@@ -292,7 +292,7 @@ DSL_DEV_HTTPS=1 cardbuddy
 3. 包内快照 `dist/vendored/skills/` —— 随 npm 包发布的全量技能库，没跑 `init` 也能只读兜底。
 
 > 远端能力（同步 / 保存 / 切图上传）还需要 `.env.cb` 里的 `PLATFORM_BASE_URL` 等配置，
-> 以及 `playwright`（本包 optionalDependency，默认会装）与一次远端登录。
+> 以及 `playwright-core`（本包普通依赖，`npm install` 即带上；免浏览器下载，浏览器走系统 Chrome）与一次远端登录。
 > 写入类文件（凭据等）**永远落项目根**，不会写进 `node_modules`。
 
 ---

package/dist/init.js

@@ -251,8 +251,9 @@ npx cardbuddy skills upgrade --dry-run  # 先看会动哪些文件（四类：
 
 ## 远端能力（可选）
 
-同步 / 保存 / 切图上传需要已登录的远端会话与 \`playwright\`
-（cardbuddy 的 optionalDependency，装包时默认会装）。凭据只落在本机
+同步 / 保存 / 切图上传需要已登录的远端会话与 \`playwright-core\`
+（本工程 devDependencies 与 cardbuddy 依赖均已显式声明，\`npm install\` 即带上；
+它是免浏览器下载的纯 JS API 包，浏览器走系统 Chrome + CDP）。凭据只落在本机
 \`skills/platform-session-navigator/.local/credentials.json\`，已被 .gitignore 忽略。
 `
 }
@@ -281,6 +282,12 @@ function projectPackageJson(projectName, version) {
         },
         devDependencies: {
           cardbuddy: `^${version}`,
+          // 远端同步技能脚本（platform_login.mjs 等）运行时必需。
+          // 必须是普通依赖显式声明：曾经的 playwright 是 cardbuddy 的
+          // optionalDependency，postinstall 下载浏览器失败时被 npm 静默跳过，
+          // 运行脚本才报 Cannot find package。playwright-core 免浏览器下载
+          //（浏览器走系统 Chrome + CDP），普通依赖安装失败会在 npm install 期直接报错。
+          'playwright-core': '^1.62.1',
         },
       },
       null,