cardbuddy 0.24.0 → 0.25.1

package/dist/preview-editor/index.html

@@ -8,7 +8,7 @@
     <link rel="icon" type="image/png" sizes="16x16" href="/assets/favicon-16-Cg6Nrosk.png" />
     <link rel="icon" type="image/png" sizes="32x32" href="/assets/favicon-32-B_1744sp.png" />
     <link rel="apple-touch-icon" sizes="180x180" href="/assets/apple-touch-icon-BQcES9QK.png" />
-    <script type="module" crossorigin src="/assets/index-BumNBo-n.js"></script>
+    <script type="module" crossorigin src="/assets/index-B6NhNlBx.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-MWKPP9nd.css">
   </head>
   <body>

package/dist/skills-upgrade.js

@@ -18,12 +18,16 @@
  *   交互环境外（非 TTY）无法确认时，必须带 --force 才能升级，否则明确拒绝并提示（不再
  *   静默跳过、假装升级成功）。
  * 标志：--force/-y 跳过确认直接覆盖；--prune 额外删除 ORPHAN；--dry-run 只报告不落盘。
+ * 依赖检查：升级后探测 skills/ 内 package.json 声明的依赖能否从工程解析，缺失的
+ *   显式给出 `npm install <pkg>` 补装指引（升级不自动装依赖——是否动工程 node_modules
+ *   由用户决定；解析探测与脚本运行时的 Node 解析链一致）。
  * 同步后写 skills/.synced-from = 当前装包版本，供下次 drift 检测与启动提示。
  */
 import fs from 'node:fs'
 import path from 'node:path'
 import readline from 'node:readline/promises'
 import { fileURLToPath } from 'node:url'
+import { createRequire } from 'node:module'
 import chalk from 'chalk'
 import { loadConfig } from './config.js'
 
@@ -75,6 +79,38 @@ function walkFiles(dir, base = dir, out = []) {
   return out
 }
 
+/**
+ * 收集 skills/ 内各 package.json 声明的依赖中「从其所在目录无法解析」的包名。
+ * 技能脚本运行时按 Node 规则从脚本位置向上找 node_modules（先 skill 自身，再工程根），
+ * 这里用 createRequire 从该 package.json 所在目录模拟同一解析链；解析不到的即缺口——
+ * 升级只拷文件不装依赖，缺口必须显式提示用户补装（0.83.x 事故的教训：
+ * playwright 曾是 optional 依赖静默缺失，脚本运行时才报 Cannot find package）。
+ * @param {string} destSkills 工程内 skills/ 目录
+ * @returns {string[]} 形如 "playwright-core（platform-session-navigator/scripts/package.json）"
+ */
+function collectMissingSkillDeps(destSkills) {
+  const missing = []
+  for (const rel of walkFiles(destSkills)) {
+    if (path.posix.basename(rel) !== 'package.json') continue
+    const pkgPath = path.join(destSkills, rel)
+    let deps
+    try {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'))
+      deps = { ...pkg.dependencies, ...pkg.devDependencies }
+    } catch {
+      continue
+    }
+    for (const name of Object.keys(deps)) {
+      try {
+        createRequire(path.join(pkgPath, 'index.js')).resolve(name)
+      } catch {
+        missing.push(`${name}（${rel}）`)
+      }
+    }
+  }
+  return missing
+}
+
 /**
  * 比对源/目标技能树（内容比对）。
  * @returns {{ added:string[], same:string[], modified:string[], orphan:string[] }}
@@ -153,6 +189,25 @@ export async function runSkillsUpgrade({
   const warn = (m) => say(chalk.yellow(`• ${m}`))
   const dim = (m) => say(chalk.dim(`• ${m}`))
 
+  // 依赖在位检查（升级只同步文件、不装依赖，但必须把缺口显式暴露出来）：
+  // 逐个解析 skills/ 内 package.json 声明的依赖，解析不到的给出补装命令。
+  const reportDeps = () => {
+    let missing
+    try {
+      missing = collectMissingSkillDeps(destSkills)
+    } catch {
+      return
+    }
+    if (!missing.length) {
+      dim('技能依赖在位：skills/ 内 package.json 声明的依赖均可从工程解析')
+      return
+    }
+    const names = [...new Set(missing.map((m) => m.slice(0, m.indexOf('（'))))]
+    warn(`⚠ 检测到 ${missing.length} 个技能依赖无法解析（新版本技能可能带来新依赖）：`)
+    for (const m of missing) say(chalk.yellow(`    ${m}`))
+    say(chalk.yellow(`  请在工程根执行：npm install ${names.join(' ')}`))
+  }
+
   if (dryRun) say(chalk.yellow('（dry-run：只报告将要做的事，不落盘）'))
 
   if (!src || !fs.existsSync(src)) {
@@ -169,6 +224,7 @@ export async function runSkillsUpgrade({
 
   if (!diff.added.length && !diff.modified.length && !diff.orphan.length && fs.existsSync(destSkills)) {
     dim(`skills 已是最新（cardbuddy@${version}，无新增 / 修改 / 孤儿）`)
+    reportDeps()
     return 0
   }
 
@@ -240,6 +296,9 @@ export async function runSkillsUpgrade({
     }
   }
 
+  // 依赖在位检查（dry-run 也报，作为升级后的预期状态）
+  reportDeps()
+
   // 汇总
   log('')
   say(chalk.green(dryRun ? 'dry-run 完成（未落盘）' : 'skills 升级完成'))

package/dist/vendored/server/core/browser.js

@@ -35,8 +35,11 @@ let chromiumMod = null
 
 /** 取（惰性启动的）单例浏览器；启动失败会把 browserPromise 复位并抛出 */
 async function getBrowser() {
-  // 动态 import playwright：避免其进入 vite.config 加载图（见文件头注释）
-  if (!chromiumMod) chromiumMod = await import('playwright')
+  // 动态 import playwright-core：避免其进入 vite.config 加载图（见文件头注释）。
+  // 用 playwright-core 而非 playwright：浏览器走系统 Chrome（channel: 'chrome'），
+  // 只需 JS API；playwright 的 postinstall 浏览器下载作为 optional 依赖失败时会被
+  // npm 静默跳过，导致 vendored 发布态运行时报 Cannot find package（0.83.x 事故）。
+  if (!chromiumMod) chromiumMod = await import('playwright-core')
   if (!browserPromise) {
     browserPromise = chromiumMod.chromium
       .launch({ channel: 'chrome', headless: true })
@@ -98,9 +101,9 @@ function serialize(task) {
 
 /**
  * 打开卡片渲染页（chrome=off 纯净模式）并等待首帧稳定。
- * @param {import('playwright').BrowserContext} context
+ * @param {import('playwright-core').BrowserContext} context
  * @param {string} id 卡片 id
- * @returns {Promise<{ page: import('playwright').Page, screen: import('playwright').ElementHandle | null }>}
+ * @returns {Promise<{ page: import('playwright-core').Page, screen: import('playwright-core').ElementHandle | null }>}
  */
 async function openCardScreen(context, id) {
   const page = await context.newPage()

package/dist/vendored/server/core/flameCompile/client.js

@@ -238,17 +238,19 @@ function convertDirectives(component, template, warnings) {
   const extend = bucket.extend && typeof bucket.extend === 'object' ? bucket.extend : {}
   bucket.extend = extend
 
+  // 可见时写空串而非 'block'：display 由样式类决定（.ce_row/.ce_column 为 flex），
+  // 内联 block 会盖掉 flex，导致 justify/align 失效（同 h5.js applyDirectives 注释）。
   const expression = conditionMap.expression
   if (hasText(expression)) {
-    if (showType === '01') extend.display = `(${expression}) ? 'block' : 'none'`
-    else if (showType === '02') extend.display = `(${expression}) ? 'none' : 'block'`
+    if (showType === '01') extend.display = `(${expression}) ? '' : 'none'`
+    else if (showType === '02') extend.display = `(${expression}) ? 'none' : ''`
     return
   }
 
   if (Array.isArray(conditionMap.group) && conditionMap.group.length > 0) {
     const expr = convertCondition(conditionMap.group)
-    if (showType === '01') extend.display = `${expr} ? 'block' : 'none'`
-    else if (showType === '02') extend.display = `${expr} ? 'none' : 'block'`
+    if (showType === '01') extend.display = `${expr} ? '' : 'none'`
+    else if (showType === '02') extend.display = `${expr} ? 'none' : ''`
     return
   }
 

package/dist/vendored/server/core/flameCompile/common.js

@@ -116,6 +116,51 @@ export function collectProps(properties = []) {
 
 const IDENT_RE = /^[A-Za-z0-9_$]+$/
 
+/* ------------------------ fastjson / HashMap 键序 ------------------------ */
+
+/** Java String.hashCode */
+function javaStringHash(text) {
+  let h = 0
+  for (let i = 0; i < text.length; i++) h = (Math.imul(31, h) + text.charCodeAt(i)) | 0
+  return h
+}
+
+/** HashMap 的扰动函数：h ^ (h >>> 16) */
+function hashSpread(h) {
+  return (h ^ (h >>> 16)) >>> 0
+}
+
+/** 按元素个数推算 HashMap 表容量（默认 16，负载因子 0.75，翻倍扩容） */
+function hashCapacity(size) {
+  let cap = 16
+  while (size > cap * 0.75) cap *= 2
+  return cap
+}
+
+/**
+ * 复现 Java HashMap 的迭代顺序
+ *
+ * 平台产物里的 JSON 由 fastjson 的 `JSONObject`（底层 HashMap）序列化，键序是**哈希桶顺序**
+ * 而不是插入顺序。产物只用于「替换线上文件」时，键序语义上无所谓；但只要希望与平台产物
+ * 逐字节一致（便于 diff 对拍），就必须复现这个顺序。
+ *
+ * 规则：cap = 16 起按 0.75 负载因子扩容；桶下标 = (h ^ h>>>16) & (cap-1)；
+ * 按下标升序输出，同桶内保持插入顺序。
+ */
+export function javaHashMapOrder(value) {
+  if (Array.isArray(value)) return value.map(javaHashMapOrder)
+  if (!value || typeof value !== 'object') return value
+  const entries = Object.entries(value)
+  const cap = hashCapacity(entries.length)
+  return entries
+    .map(([k, v], i) => ({ k, v: javaHashMapOrder(v), i, bucket: hashSpread(javaStringHash(k)) & (cap - 1) }))
+    .sort((a, b) => a.bucket - b.bucket || a.i - b.i)
+    .reduce((acc, x) => {
+      acc[x.k] = x.v
+      return acc
+    }, {})
+}
+
 /**
  * JS 对象字面量的键名写法（平台口径）
  *
@@ -143,7 +188,7 @@ export function convertPropsH5(properties = []) {
         parts.push(`${key}:${convertPropsH5(prop.children)}`)
       } else if (prop.list && prop.list.length > 0) {
         const groups = prop.list.map((g) => convertPropsH5(g))
-        parts.push(`${key}:[${groups.join(',')}]`)
+        parts.push(`${key}: [${groups.join(',')}]`)
       } else {
         parts.push(`${key}:${JSON.stringify(prop.itemValue)}`)
       }
@@ -161,7 +206,7 @@ export function convertPropsH5(properties = []) {
 /**
  * `$foo` → `s.$foo`
  *
- * 平台卡片状态挂在上下文实例的 `state` 上（生成代码里 `var s = c.state`），
+ * 平台卡片状态挂在上下文实例的 `s` 上（生成代码里 `var s = c.s`，ExpressionState），
  * 所以表达式里的 `$x` 必须改写为 `s.$x`。
  * 字符串字面量（'…' / "…" / `…`）内部的 `$` 不得改写。
  *

package/dist/vendored/server/core/flameCompile/h5.js

@@ -14,7 +14,8 @@
  * 元素组件通过 `this.getElement('Text')` 取宿主 elements 注册表。
  *
  * 关键契约（照抄平台侧，改动会直接导致真机渲染空白）：
- *   - 数据挂在 `s = c.state`，表达式里的 `$foo` 已改写为 `s.$foo`；
+ *   - 数据挂在 `s = c.s`（ExpressionState，提供 $key / $$），表达式里的 `$foo` 已改写为 `s.$foo`；
+ *     不能用 `c.state` —— 那是 MethodState，只有平铺键名，`s.$foo` 会一律求值为 undefined；
  *   - `data` 里必须同时给 defaultState / state / n（n 是刷新因子，模板里靠它触发重算）；
  *   - watch.data 重新合并 state，宿主下发新数据时才能刷新；
  *   - 每个事件的实现体被搬到 methods 里，on 只留转发（避免闭包捕获旧 state）。
@@ -27,6 +28,7 @@ import {
   convertPropsClient,
   convertPropsH5,
   hasText,
+  javaHashMapOrder,
   jsKey,
   pickVarProps,
 } from './common.js'
@@ -89,8 +91,12 @@ export function createH5Compiler(card, { warnings = [] } = {}) {
   for (const child of card.components) slot.components.push(convertComponent(child))
 
   function convertComponent(component) {
+    const desc = elementOf(component.className)
     const layer = {
-      id: component.componentId,
+      // 列表 / 网格在平台侧会先被客户端编译改写成 `<cardCode>_sub_<componentId>`（共享同一份
+      // CardModel，H5 编译在其后，于是把这个改写后的 id 带进了 ref）。此处等价复现：
+      // 只影响容器自身的 ref，循环项内部的组件 id 保持原样。
+      id: desc.isNewTemplate ? `${card.code}_sub_${component.componentId}` : component.componentId,
       name: component.className,
       style: {},
       props: convertPropsH5(component.properties),
@@ -148,8 +154,12 @@ export function createH5Compiler(card, { warnings = [] } = {}) {
       return
     }
 
-    if (showType === '01') layer.style.display = `(${expression}) ? 'block' : 'none'`
-    else if (showType === '02') layer.style.display = `(${expression}) ? 'none' : 'block'`
+    // 可见时不能写死 `block`：布局元素的 display 由样式类决定（`.ce_row`/`.ce_column`
+    // 是 flex），内联 `display:block` 会盖掉 flex → justifyContent/alignItems 全失效。
+    // accountCreditedlist 的「更多转账伙伴」行就是被它压成 block，文字靠左 + 图标换行被裁掉。
+    // 空串等价于 v-show 的「显隐只切 none」——清掉内联值，恢复原生 display。
+    if (showType === '01') layer.style.display = `(${expression}) ? '' : 'none'`
+    else if (showType === '02') layer.style.display = `(${expression}) ? 'none' : ''`
   }
 
   /**
@@ -190,9 +200,16 @@ export function createH5Compiler(card, { warnings = [] } = {}) {
       const fn = constProps.function
       const code = fn && typeof fn === 'object' ? fn.code : null
       const compiled = fn && typeof fn === 'object' ? fn.compiled : null
-      // 平台侧优先用 compiled（ES5 转译版），缺失才回退手写 code
-      if (hasText(compiled)) return compiled
+      // 取 code 优先，compiled 只作兜底 —— 与编辑器预览（RenderTree.actionCode）和
+      // 运行时（preview 的 actionCode，`code || compiled`）保持同一优先级。
+      //
+      // 反过来（compiled 优先）会让「编辑器里改好、导出产物还是旧的」：两者是双份数据，
+      // compiled 是平台侧某次转译留下的快照，编辑器改 code 时它不会跟着变（SetCode 只覆写 code；
+      // ai-chat 的自动同步也只在「原本就同步」时生效）。实例：account 的 onMeasured 标题脚本，
+      // code 已是左对齐 `600 17px` / 浅绿 #D8F5E8 / x=0，compiled 仍停在居中的 `bold 16px` /
+      // #B9D0FA / x=canvas.width/2，产物跑旧版，标题位置与配色全错。
       if (hasText(code)) return code
+      if (hasText(compiled)) return compiled
       warnings.push(`事件 ${eventAction.eventKey} 的 customAction 缺少 code，已跳过`)
       return ''
     }
@@ -241,9 +258,9 @@ export function createH5Compiler(card, { warnings = [] } = {}) {
       const code = scopeSlots
         .map(
           (s) =>
-            `${jsKey(s.slotKey)}:function(_sd_){return (function(c){var s = c.state; return [${s.components
+            `${jsKey(s.slotKey)}:function(_sd_){return (function(c){var s = c.s; return [${s.components
               .map(serializeComponent)
-              .join(',')}]})(new CC(_vm,_sd_,c))}`
+              .join(',')}]})(new CC(_vm,_sd_,c)) }`
         )
         .join(',')
       options.push(`scopedSlots:{${code}}`)
@@ -271,7 +288,9 @@ export function createH5Compiler(card, { warnings = [] } = {}) {
     "var CC = this.getObject('context');" +
     'var e = this.getElement;' +
     'var c = new CC(this,this);' +
-    'var s = c.state;' +
+    // 必须是 c.s（ExpressionState，提供 $key / $$ 读取），不能用 c.state（MethodState，只有平铺键名）。
+    // 平台 Context 里两者并存：s 走表达式读、state 走方法写。写成 c.state 会让所有 s.$xxx 求值为 undefined。
+    'var s = c.s;' +
     'var n = this.n;' +
     `return ${components.map(serializeComponent).join('')}` +
     '}'
@@ -286,7 +305,8 @@ export function createH5Compiler(card, { warnings = [] } = {}) {
   parts.push('props:{data:{type:Object,default:function(){ return {} }}}')
 
   const dataCode = [
-    `defaultState:${JSON.stringify(defaultState)}`,
+    // 键序按 Java HashMap 桶序输出：与平台产物逐字节一致（语义等价，仅便于 diff 对拍）
+    `defaultState:${JSON.stringify(javaHashMapOrder(defaultState))}`,
     'state:{}',
     'n:0',
   ].join(',')

package/dist/vendored/skills/dsl-card-generator/references/generation_pitfalls.md

@@ -169,7 +169,7 @@ node skills/dsl-card-generator/scripts/render_card.mjs --id <id> --width 375 --o
 ```js
 // 仅当需要自定义页面交互/逐样式断言且宿主 dev server(5180) 已启动时使用；
 // 本 skill 的离线 render_card.mjs 不提供任意页面交互，复制 skill 到其他项目后该配方按需自建。
-import { chromium } from 'playwright';
+import { chromium } from 'playwright-core';
 const ts = Date.now();
 const url = `http://localhost:5180/?card=<id>&t=${ts}`;
 const browser = await chromium.launch({ channel: 'chrome', args: ['--no-sandbox'] });

package/dist/vendored/skills/mbank-design-gen/tools/screenshot.mjs

@@ -2,7 +2,8 @@
 // MBank mockup 截图工具：把 375×812 的 mockup HTML 导出为 750×1624 @2x PNG。
 // 用法：node <skill>/tools/screenshot.mjs <input.html> [output.png] [--full]
 //   --full  整页截图（长页 mockup 用；默认 812pt 视口截断）
-// 依赖 playwright（仓库根 node_modules 已装；本脚本从自身位置向上解析）。
+// 依赖 playwright-core（免浏览器下载的纯 JS API，从自身位置向上解析）。
+// 浏览器优先走系统 Chrome（channel: 'chrome'，仓库约定），未找到时才尝试内置浏览器。
 import { createRequire } from 'node:module';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -10,7 +11,15 @@ import { pathToFileURL } from 'node:url';
 
 const here = dirname(fileURLToPath(import.meta.url));
 const require = createRequire(import.meta.url);
-const { chromium } = require('playwright');
+let chromium;
+try {
+  ({ chromium } = require('playwright-core'));
+} catch {
+  console.error(
+    '[screenshot] 缺少依赖 playwright-core：请在本工程根执行 npm install（cardbuddy 依赖会带上），或手动 npm i playwright-core。',
+  );
+  process.exit(1);
+}
 
 const args = process.argv.slice(2);
 const full = args.includes('--full');
@@ -22,15 +31,14 @@ if (!input) {
 }
 const output = positional[1] || input.replace(/\.html$/i, '') + '.png';
 
-// 优先用 Playwright 自带浏览器；未下载（ms-playwright 缓存为空）时回退系统 Chrome，
-// 与仓库「Playwright + 系统 Chrome 验证」约定一致，避免强依赖 npx playwright install。
+// 优先用系统 Chrome（channel: 'chrome'，仓库约定）；不可用时回退内置浏览器。
 let browser;
 try {
-  browser = await chromium.launch();
+  browser = await chromium.launch({ channel: 'chrome' });
 } catch (err) {
   if (!/Executable doesn't exist/.test(String(err?.message ?? err))) throw err;
-  console.error('[screenshot] 未找到 Playwright 内置浏览器，回退系统 Chrome');
-  browser = await chromium.launch({ channel: 'chrome' });
+  console.error('[screenshot] 未找到系统 Chrome，回退 Playwright 内置浏览器');
+  browser = await chromium.launch();
 }
 const page = await browser.newPage({
   viewport: { width: 375, height: 812 },

package/dist/vendored/skills/platform-card-sync/scripts/api_batch_sync.mjs

@@ -29,10 +29,18 @@ const scriptDir = path.dirname(fileURLToPath(import.meta.url));
 const skillDir = path.resolve(scriptDir, '..');
 // skill now lives under <repo-root>/skills/<name>: repo root is two levels up from skillDir
 const workspace = path.resolve(skillDir, '..', '..');
-// 与 platform_login.mjs 保持一致的解析方式：用裸标识符让 Node 从项目根 node_modules 解析
-// playwright。原硬编码路径指向 .workbuddy/skills/platform-session-navigator/scripts/node_modules
-// （该 node_modules 是已失效的断链符号链接），导致「Cannot find module」报错。
-const { chromium } = await import('playwright');
+// 与 platform_login.mjs 保持一致的解析方式：用裸标识符让 Node 从项目根 node_modules 解析。
+// 用 playwright-core（免浏览器下载的纯 JS API）：浏览器走系统 Chrome + CDP，
+// 不需要 playwright 自带浏览器；playwright 作为 optional 依赖安装失败时会被 npm
+// 静默跳过，导致运行时报 Cannot find package（0.83.x 事故）。
+let chromium;
+try {
+  ({ chromium } = await import('playwright-core'));
+} catch {
+  throw new Error(
+    '缺少依赖 playwright-core：请在本工程根执行 npm install（cardbuddy 依赖会带上 playwright-core），或手动 npm i playwright-core。',
+  );
+}
 
 // 统一日志美化（容错：缺 server/core/logger 时回退极简实现，保证 demo / 老项目不崩）。
 // 实时项目与 build 后的 dist/server-core 均含该模块；demo 等缺少 server/ 目录的场景走 fallback。

package/dist/vendored/skills/platform-session-navigator/scripts/package-lock.json

@@ -8,22 +8,7 @@
       "name": "platform-session-navigator-scripts",
       "version": "1.0.0",
       "dependencies": {
-        "playwright": "^1.62.1"
-      }
-    },
-    "node_modules/playwright": {
-      "version": "1.64.1",
-      "resolved": "https://registry.npmmirror.com/playwright/-/playwright-1.64.1.tgz",
-      "integrity": "sha512-HCrVhHr5QQuwYoswEUGTb7gGp522yflbv/ST8nF4sFWGuLjQCt17Q/EubpGGSNKYn1tsTCPZxqHhHCfVURu7UA==",
-      "license": "Apache-2.0",
-      "dependencies": {
-        "playwright-core": "1.64.1"
-      },
-      "bin": {
-        "playwright": "cli.js"
-      },
-      "engines": {
-        "node": ">=20"
+        "playwright-core": "^1.62.1"
       }
     },
     "node_modules/playwright-core": {

package/dist/vendored/skills/platform-session-navigator/scripts/package.json

@@ -3,8 +3,8 @@
   "version": "1.0.0",
   "private": true,
   "type": "module",
-  "description": "Playwright-based 远端 UAT auto-login scripts",
+  "description": "playwright-core-based 远端自动登录脚本（纯 JS API，浏览器走系统 Chrome + CDP）",
   "dependencies": {
-    "playwright": "^1.62.1"
+    "playwright-core": "^1.62.1"
   }
 }

package/dist/vendored/skills/platform-session-navigator/scripts/platform_login.mjs

@@ -1,4 +1,15 @@
-import { chromium } from "playwright";
+// 依赖只取 playwright 的 JS API（浏览器由本脚本 spawn 系统 Chrome + connectOverCDP 连接，
+// 不需要 playwright 自带浏览器），因此用免下载的 playwright-core：它是 cardbuddy 与工程
+// devDependencies 里的普通依赖，npm install 即落地；不用 playwright（postinstall 下载
+// 数百 MB 浏览器，作为 optionalDependency 安装失败时会被 npm 静默跳过，错误延迟到运行时）。
+let chromium;
+try {
+  ({ chromium } = await import("playwright-core"));
+} catch {
+  throw new Error(
+    "缺少依赖 playwright-core：请在本工程根执行 npm install（cardbuddy 依赖会带上 playwright-core），或手动 npm i playwright-core。",
+  );
+}
 import { readFile, writeFile, mkdir } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { spawn } from "node:child_process";

package/dist/vendored/skills/platform-session-navigator/scripts/session-manager.mjs

@@ -58,7 +58,7 @@ let _sessionCache = null; // { browser, login, at }
  * @param {object} [options]
  * @param {number} [options.debugPort=SYNC_PORT]
  * @param {boolean} [options.headless=true]
- * @returns {Promise<{ browser: import('playwright').Browser, login: object }>}
+ * @returns {Promise<{ browser: import('playwright-core').Browser, login: object }>}
  */
 export async function ensurePlatformSession({ debugPort = SYNC_PORT, headless = true } = {}) {
   // 热路径：进程内缓存未过期且 CDP 仍连通 → 直接复用（跳过 runPlatformLogin 的

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cardbuddy",
-  "version": "0.24.0",
+  "version": "0.25.1",
   "description": "Local dev service for the CardBuddy card editor — decouples card CRUD (sync/save/validate/render-status/screenshot) from the static public editor, so the editor can be deployed to any static host while each developer runs a local service against their own card source.",
   "type": "module",
   "bin": {
@@ -30,14 +30,12 @@
     "codejar": "^4.3.0",
     "connect": "^3.7.0",
     "dotenv": "^18.0.9",
+    "playwright-core": "^1.62.1",
     "pngjs": "^7.0.0",
     "prismjs": "^1.30.0",
     "qrcode": "^1.5.4",
     "selfsigned": "^4.0.1",
     "vite": "^8.2.0",
     "vue": "^3.5.40"
-  },
-  "optionalDependencies": {
-    "playwright": "^1.62.1"
   }
 }