cardbuddy 0.13.3 → 0.14.1

package/dist/vendored/skills/dsl-card-generator/scripts/spec_tree.mjs

@@ -32,7 +32,7 @@ import fs from 'node:fs'
 import path from 'node:path'
 
 function parseArgs(argv) {
-  const out = { spec: '', card: 1, maxDepth: 0, compact: false, json: false, denoise: true }
+  const out = { spec: '', card: 1, maxDepth: 0, compact: false, json: false, denoise: true, listCards: '', uiDir: '' }
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i]
     if (a === '--spec') out.spec = argv[++i] || ''
@@ -41,6 +41,7 @@ function parseArgs(argv) {
     else if (a === '--compact') out.compact = true
     else if (a === '--no-denoise') out.denoise = false
     else if (a === '--json') out.json = true
+    else if (a === '--list-cards') { out.listCards = 'on'; out.uiDir = argv[++i] || '' }
     else if (a === '-h' || a === '--help') {
       console.log(`Usage: node spec_tree.mjs --spec <spec.json> [--card 1] [--max-depth 0] [--compact] [--no-denoise] [--json]
   --spec        spec.json 路径
@@ -48,17 +49,109 @@ function parseArgs(argv) {
   --max-depth   最大显示深度（0=不限）
   --compact     极简模式（仅类型+名称，不显示样式）
   --no-denoise  关闭去噪（默认开：剥离 #tmp- 前缀、无语义编组名→_group、折叠单子节点组、合并连续相同兄弟）
-  --json        输出几何重建树 JSON`)
+  --json        输出几何重建树 JSON
+  --list-cards <UI目录>  扫描 UI 产物目录，列出每个画板下的卡片清单（序号 画板.卡片）`)
       process.exit(0)
     }
   }
-  if (!out.spec) {
+  if (!out.spec && !out.listCards) {
     console.error('缺少 --spec 参数')
     process.exit(1)
   }
   return out
 }
 
+/* ── 列卡片清单：扫描 UI 产物目录，按「画板序号.卡片序号」展开 ────── */
+// 一个画板（spec.json）可能含多张卡片（cards[]）。传统清单只列画板序号，
+// 多卡画板缺子选择项导致用户无法指定具体哪张卡。本函数把每个画板按其内
+// 卡片数展开为「画板序号 . 卡片序号」（如画板有 2 张卡则输出 1.1 和 1.2），
+// 同一画板共享一张预览图（artboard.png），单卡画板退化为「画板序号 . 1」。
+function listCardEntries(uiDir) {
+  const dir = path.resolve(uiDir)
+  if (!fs.existsSync(dir)) {
+    console.error(`UI 目录不存在: ${dir}`)
+    process.exit(1)
+  }
+
+  // 当前目录自身可能就是单画板产物（spec.json + card-N.png 直接在 uiDir 下）
+  const ownSpec = path.join(dir, 'spec.json')
+  // 收集所有含 spec.json 的画板目录（平铺 UI/<画板>/ 或分片 UI/<稿>/<画板>/）
+  const boardDirs = []
+  if (fs.existsSync(ownSpec)) {
+    boardDirs.push({ dir: dir, name: path.basename(dir) })
+  }
+  const topEntries = fs.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory())
+  for (const te of topEntries) {
+    const subDir = path.join(dir, te.name)
+    const ownSpec = path.join(subDir, 'spec.json')
+    if (fs.existsSync(ownSpec)) {
+      boardDirs.push({ dir: subDir, name: te.name })
+    } else {
+      // 分片模式：UI/<稿名>/<画板>/
+      const inner = fs.readdirSync(subDir, { withFileTypes: true }).filter((e) => e.isDirectory())
+      for (const ie of inner) {
+        const innerSpec = path.join(subDir, ie.name, 'spec.json')
+        if (fs.existsSync(innerSpec)) boardDirs.push({ dir: path.join(subDir, ie.name), name: te.name + '/' + ie.name })
+      }
+    }
+  }
+
+  // 尝试从 manifest.json 取画板序号（order 字段，1 起）；无 manifest 则按目录顺序
+  let canvasOrder = null
+  const manifestPath = path.join(dir, 'manifest.json')
+  if (fs.existsSync(manifestPath)) {
+    try {
+      const mf = JSON.parse(fs.readFileSync(manifestPath, 'utf8'))
+      if (Array.isArray(mf.canvases)) canvasOrder = mf.canvases
+    } catch (e) { /* manifest 损坏，退化为目录序 */ }
+  }
+
+  const entries = []
+  let boardSeq = 0
+  for (const bd of boardDirs) {
+    boardSeq += 1
+    // 如果 manifest 有 order，优先用 order；否则用递增序
+    let order = boardSeq
+    if (canvasOrder) {
+      // 全局 manifest 的 order 是与导出画板顺序对齐的（可能从 1 也可能从 27 起）
+      const match = canvasOrder.find((c) => c.name === bd.name || bd.name.endsWith('/' + c.name))
+      if (match) order = match.order || boardSeq
+    } else {
+      // 无全局 manifest 时用连续递增（1, 2, 3...），避免跳号
+      order = boardSeq
+    }
+
+    let spec
+    try { spec = JSON.parse(fs.readFileSync(path.join(bd.dir, 'spec.json'), 'utf8')) } catch (e) { continue }
+    const cards = Array.isArray(spec.cards) ? spec.cards : []
+    const cardCount = cards.length || 1
+
+    // 预览图：同一画板共享一张 artboard.png（或 card-1.png 作降级）
+    let preview = path.join(bd.dir, 'artboard.png')
+    if (!fs.existsSync(preview)) {
+      preview = path.join(bd.dir, 'card-1.png')
+      if (!fs.existsSync(preview)) preview = null
+    }
+
+    for (let ci = 0; ci < cardCount; ci += 1) {
+      const cardImg = path.join(bd.dir, `card-${ci + 1}.png`)
+      entries.push({
+        seq: `${order}.${ci + 1}`,
+        boardName: spec.canvas || bd.name,
+        boardDir: bd.dir,
+        boardSeq: order,
+        cardIndex: ci + 1,
+        cardCount,
+        cardImg: fs.existsSync(cardImg) ? cardImg : null,
+        preview,
+        cardRect: cards[ci] ? cards[ci].rect : null,
+        trainingEligible: cards[ci] ? cards[ci].trainingEligible : undefined,
+        artboardType: spec.artboardType || undefined,
+      })
+    }
+  }
+  return entries
+}
 /* ── 几何重建：从扁平 elements 用矩形包含关系建树 ────────────── */
 // 父 = 最小面积、且完全包含子 rect 的元素（严格父：面积必须更大）。
 function reconstructFromElements(elements) {
@@ -263,6 +356,38 @@ function renderTree(nodes, depth, maxDepth, compact, prefix, isLast, lines) {
 /* ── 主流程 ─────────────────────────────────────────────────── */
 function main() {
   const args = parseArgs(process.argv.slice(2))
+
+  // ── --list-cards 模式：扫描 UI 产物目录，按「画板序号.卡片序号」列出全量清单 ──
+  if (args.listCards === 'on') {
+    if (!args.uiDir) {
+      console.error('--list-cards 需要指定 UI 产物目录（如 UI/<稿名> 或 UI/）')
+      process.exit(1)
+    }
+    const entries = listCardEntries(args.uiDir)
+    if (!entries.length) {
+      console.error('该目录下未找到任何含 spec.json 的画板')
+      process.exit(1)
+    }
+
+    // 统计画板数与卡片数
+    const boardSeqs = [...new Set(entries.map((e) => e.boardSeq))]
+    console.log(`# 画板 ${boardSeqs.length} 个 → 卡片 ${entries.length} 张（序号 画板.卡片）`)
+    console.log('')
+
+    entries.forEach((e) => {
+      const multiTag = e.cardCount > 1 ? ` (${e.cardCount} 张卡)` : ''
+      const rectTag = e.cardRect ? ` [${e.cardRect.width || 0}x${e.cardRect.height || 0}]` : ''
+      const typeTag = e.artboardType ? ` type=${e.artboardType}` : ''
+      console.log(`${e.seq}. ${e.boardName}${typeTag}${multiTag}${rectTag}`)
+      if (e.cardImg) console.log(`  图: ${e.cardImg}`)
+      else if (e.preview) console.log(`  图: ${e.preview} (共享画板预览图，无单独 card-${e.cardIndex}.png)`)
+      else console.log(`  图: （预览图缺失）`)
+      console.log(`  spec: ${path.join(e.boardDir, 'spec.json')} --card ${e.cardIndex}`)
+    })
+    console.log('')
+    console.log('# 全部')
+    return
+  }
   const specPath = path.resolve(args.spec)
   if (!fs.existsSync(specPath)) {
     console.error(`spec.json 不存在: ${specPath}`)

package/dist/vendored/skills/dsl-card-generator/scripts/validate_schema.py

@@ -206,6 +206,27 @@ def load_meta():
 # ---------------------------------------------------------------------------
 # Helpers
 # ---------------------------------------------------------------------------
+def cid_tag(cid):
+    """组件定位标记：消息末尾的 " #<componentId>"，前端渲染成可点链接，点一下就在画布 /
+    结构树里选中该节点（校验结论直接变成「可操作」，不用人再去树里翻）。
+
+    为什么不用 depth[i]：check_components 递归时按「单个子节点」下钻
+    （check_components([child], depth + 1)），嵌套层的 i 恒为 0，光看 "depth 2[0]"
+    根本不知道是哪个节点；componentId 全卡唯一，是唯一稳定的定位键。缺失时不打标记，
+    前端退回纯文本，不影响校验结论本身。
+    """
+    return f" #{cid}" if cid else ""
+
+
+def tag_messages(messages, start, tag):
+    """给 messages[start:] 新产生的消息统一补定位标记（幂等：已带同一标记的不重复追加）。"""
+    if not tag:
+        return
+    for k in range(start, len(messages)):
+        if not messages[k].endswith(tag):
+            messages[k] = f"{messages[k]}{tag}"
+
+
 def check_value_from(item, owner, errors, warnings):
     """itemValueFrom 缺失/空串 → 运行时静默丢弃该属性（致命），升级为 ERROR。
 
@@ -372,6 +393,8 @@ def check_components(components, errors, warnings, depth=0, style_ids=None, seen
             errors.append(f"Component at depth {depth}[{i}] is not an object")
             continue
 
+        # 本组件自身产生的消息（含各 helper 内部追加的）统一挂定位标记：见 cid_tag()
+        err_mark, warn_mark = len(errors), len(warnings)
         cn = comp.get("className", "")
         if not cn:
             errors.append(f"Component at depth {depth}[{i}] missing 'className'")
@@ -407,6 +430,11 @@ def check_components(components, errors, warnings, depth=0, style_ids=None, seen
                 errors.append(f"Property '{pk}' in '{cn}' at depth {depth}[{i}] has itemValueFrom="
                               f"'{prop.get('itemValueFrom')}' but no itemDefaultValue")
 
+        # 到这里为止都是「本组件自身」的问题，统一挂上定位标记；子组件的消息由下面递归时
+        # 各自挂自己的标记，不能被父级污染（否则点一下会选到父节点）
+        tag_messages(errors, err_mark, cid_tag(cid))
+        tag_messages(warnings, warn_mark, cid_tag(cid))
+
         # Slots / children
         if cn in CONTAINER_TYPES or cn == "Select":
             slots = comp.get("slots", [])

package/dist/vendored/skills/finmall-card-sync/SKILL.md

@@ -10,7 +10,7 @@ description: 通过 API 把 FinMall UAT 卡片列表项纯接口同步进本工
 ## 前置条件
 
 1. 先使用 `finmall-session-navigator` 打开并鉴权卡片列表页。
-2. 保持已启动的 Chrome 以远程调试模式运行（端口由 `FINMALL_CDP_PORT` 配置，默认 `9222`）。
+2. 保持已启动的 Chrome 以远程调试模式运行（端口由 `CARDBUDDY_CDP_PORT` 配置，默认 `9222`）。
 3. 确保 `skills/finmall-session-navigator/scripts/node_modules/playwright` 存在；本 skill 复用该依赖。
 
 ## 环境配置

package/dist/vendored/skills/finmall-session-navigator/SKILL.md

@@ -23,7 +23,7 @@ description: 使用 Playwright 独立启动 Chrome，自动登录 FinMall UAT
 | `FINMALL_BASE_URL` | 服务域名 | `https://uat-pkg.finmall.com` |
 | `FINMALL_APP_ID` | 应用 ID | `100042` |
 | `FINMALL_WORKSPACE_ID` | 工作空间 ID | `dev` |
-| `FINMALL_CDP_PORT` | Chrome 调试端口 | `9222` |
+| `CARDBUDDY_CDP_PORT` | Chrome 调试端口 | `9222` |
 
 切换环境（如生产/测试）只需修改 `.env.cb.local`，无需改动代码。
 

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

@@ -16,7 +16,7 @@ const LOCAL_DIR = path.resolve(SCRIPT_DIR, "..", ".local");
 // 避免两个 Chrome 实例争用同一 user-data-dir 的锁。
 const SYNC_BROWSER_DATA_DIR = path.join(LOCAL_DIR, "sync-browser-data");
 // 后台会话专用调试端口，与手动导航器端口隔离（手动可见、自动无界面互不干扰）。
-// 取值走统一配置链：process.env FINMALL_SYNC_CDP_PORT > .env.cb(.local) > 内置默认。
+// 取值走统一配置链：process.env CARDBUDDY_SYNC_CDP_PORT > .env.cb(.local) > 内置默认。
 const SYNC_PORT = finmallConfig.syncCdpPort;
 
 // 排除 localhost 代理：本机若设了 HTTP_PROXY，Node 侧 connectOverCDP 走代理会

package/dist/vendored/skills/shared/finmall-config.mjs

@@ -60,8 +60,8 @@ const defaults = {
   FINMALL_BASE_URL: 'https://uat-pkg.finmall.com',
   FINMALL_APP_ID: '100042',
   FINMALL_WORKSPACE_ID: 'dev',
-  FINMALL_CDP_PORT: '9222',
-  FINMALL_SYNC_CDP_PORT: '9333',
+  CARDBUDDY_CDP_PORT: '9222',
+  CARDBUDDY_SYNC_CDP_PORT: '9333',
 }
 
 const envFile = parseEnvFile(path.join(PROJECT_ROOT, '.env.cb'))
@@ -77,8 +77,8 @@ for (const key of Object.keys(defaults)) {
 const baseUrl = merged.FINMALL_BASE_URL.replace(/\/+$/, '')
 const appId = merged.FINMALL_APP_ID
 const workspaceId = merged.FINMALL_WORKSPACE_ID
-const cdpPort = Number(merged.FINMALL_CDP_PORT) || 9222
-const syncCdpPort = Number(merged.FINMALL_SYNC_CDP_PORT) || 9333
+const cdpPort = Number(merged.CARDBUDDY_CDP_PORT) || 9222
+const syncCdpPort = Number(merged.CARDBUDDY_SYNC_CDP_PORT) || 9333
 
 export const finmallConfig = {
   /** 服务域名（无尾斜杠） */

package/dist/vendored/skills/sketch-spec-to-card/SKILL.md

@@ -14,7 +14,7 @@ description: 读取 Sketch MeaXure 标注导出（index.html + preview/ + assets
 输入是**多画板**设计稿且用户**没有在同一条消息里指定画板**时，**第一件事是选画板，不是跑管线**：
 
 1. `python3 scripts/parse_meaxure.py --src <导出目录> --list` 机械取全量画板；
-2. 按 **`1..n` 编号列出（序号 1 起，每行 `序号. 画板名 — 类型 / 状态`）+ 末尾一项 `全部`**；**每个画板行下面紧跟它自己那张预览图的绝对路径**（`图: <绝对路径>`；`parse_meaxure.py --list` 与门禁 exit-4 输出已机械逐行配图，取值优先 `UI/<稿>/<画板>/artboard.png` → 导出 `preview/<slug>.png`），**缺图该行显式写 `图: （预览图缺失）`**——**禁止把所有预览图统一堆在清单末尾**（部分缺图时序号与图会错位）；环境支持弹选项（有 `request_user_input` 工具）就优先弹选择，否则直接输出清单；
+2. 按 **`1..n` 编号列出（序号 1 起，每行 `序号. 画板名 — 类型 / 状态`）+ 末尾一项 `全部`**；**每个画板行下面紧跟它自己那张预览图的绝对路径**（`图: <绝对路径>`；`parse_meaxure.py --list` 与门禁 exit-4 输出已机械逐行配图，取值优先 `UI/<稿>/<画板>/artboard.png` → 导出 `preview/<slug>.png`），**缺图该行显式写 `图: （预览图缺失）`**——**禁止把所有预览图统一堆在清单末尾**（部分缺图时序号与图会错位）；**直接输出清单**——编辑器助手没有弹选项工具（不存在 `request_user_input`，不要去调用或寻找），一律「列出清单 + 一句提问后停下等用户回序号」；
 3. 一句纯文本提问（「请回复要处理的画板序号，或回复 `全部`」）后**停止输出、结束本轮等回复**；
 4. 拿到回复才继续：序号 k → `--indices <k-1>`；`全部` → `--scope-all`（UI 产物全量跑；产卡时视为显式批量授权）。
 
@@ -74,7 +74,7 @@ UI/
 ## 2. 工作流
 1. **解析**：`scripts/parse_meaxure.py` 从 `index.html` 提取 `let data={...}` JSON（括号配平后 `json.loads`），遍历全部画板，视觉驱动检测卡片区域 → 裁切聚焦图 → 序列化要素，生成 `manifest.json` + 各画板 `spec.json`/`card-*.png`/`slices/`；同时检测 JSAPI 交互控件（密码/验证码/toast/二次确认）与 Flex 布局。系统 chrome 由 `vision.py` 几何阈值排除（见 §4）。
 2. **选画板（硬门禁，先于解析/生成）**：先 `parse_meaxure.py --src <导出目录> --list` **机械列出全量画板**，按 **`1..n` 编号（1 起）+ 末尾 `全部`** 交给用户，**停止输出等回复**后才跑管线。**「UI 产物允许全量生成」= 用户可以回答 `全部`（此时加 `--scope-all` 整份导出全跑，素材可复用），不是 Agent 可以默认全量**——用户消息里没指定画板时，**包括「生成产物 / 前处理」在内的任何请求都必须先过本门禁**；**禁止**自行挑画板、**禁止**替用户选「全部」、**禁止**批量产卡、**禁止**「先建一张看看」。下游卡片生成仍以用户指定的单个画板 / 单个 UI 产物为单位（铁律见 `dsl-card-generator/references/rules.md §十三`，机械卡点见门禁 0）。
-   - **选择交互（固定流程）**：① 把全量画板按 **`1..n` 编号列出**（序号 **1 起**，每行 `序号. 画板名 — 类型 / 状态`，**行下紧跟该画板自己的预览图绝对路径，缺图标缺失，禁止堆末尾**）+ 末尾追加一项 **`全部`**（清单是完整选项池，不得只列节选）。② **当前环境支持弹选项（有 `request_user_input` 工具）→ 优先弹选择**：选项放最具代表性的 2 个画板 + `全部`（每题上限 3 项，客户端自动追加 Other），问题文案写明「其余画板在 Other 里填清单序号或画板名」；返回空答案不反复追问，降级到 ③。③ **不支持弹选项**（Default / CLI 非交互）→ 一句纯文本提问（如「请回复要处理的画板序号，或回复 `全部`」）后**停止输出、结束本轮等用户回序号**，不得在同一轮顺手产卡。④ 回 `全部` = 整份导出全量跑 UI 产物（**允许**）；回单个序号 = 只跑该画板，并作为下游产卡的目标画板。转给用户时把每行图绝对路径**逐条内联成 Markdown 图片**看图选（与序号一一对应）；系统级选择弹窗不可实现（Codex 无原生弹窗控件），②③ 即等价物。
+   - **选择交互（固定流程）**：① 把全量画板按 **`1..n` 编号列出**（序号 **1 起**，每行 `序号. 画板名 — 类型 / 状态`，**行下紧跟该画板自己的预览图绝对路径，缺图标缺失，禁止堆末尾**）+ 末尾追加一项 **`全部`**（清单是完整选项池，不得只列节选）。② **仅当工具清单里确实列有原生弹窗工具时才用**：选项放最具代表性的 2 个画板 + `全部`（每题上限 3 项，客户端自动追加 Other），问题文案写明「其余画板在 Other 里填清单序号或画板名」；返回空答案不反复追问，降级到 ③。**编辑器助手没有这个工具**（不存在 `request_user_input`），不要去调用或寻找，直接走 ③。③ **默认路径**→ 一句纯文本提问（如「请回复要处理的画板序号，或回复 `全部`」）后**停止输出、结束本轮等用户回序号**，不得在同一轮顺手产卡。④ 回 `全部` = 整份导出全量跑 UI 产物（**允许**）；回单个序号 = 只跑该画板，并作为下游产卡的目标画板。转给用户时把每行图绝对路径**逐条内联成 Markdown 图片**看图选（与序号一一对应）；系统级选择弹窗不可实现（Codex 无原生弹窗控件），③ 即等价物。
    - **清单来源与序号对齐**：已前处理的稿读 `UI/<稿名>/manifest.json` 的 `canvases[]`（`order` 1 起 / `name` / `artboardType` / `status`）与 `clusters.json` 的 `cards[]`（`cardKey` / `pageId` / `stateNames` / `recommendedBase`）；`--list` 与门禁清单**展示统一 1 起**，用户回的序号 k 传 `--indices` 时 **-1（0 起）**。`overlay_dialog` 画板标注「不产卡」（补到父卡事件）。同卡多状态时选择单位是 **cardKey**，未指定状态用 `recommendedBase` 并告知。
    - `--only` 名称子串 / `--indices` 序号 / `--sample N` 是**用户指定后的范围裁剪**；`--sample` 抽样只是取代表性素材，**不等于用户已选定要产卡的画板**。
 3. **生成文档**：`scripts/build_prompt.py`（或 `--build` 一步式）由 `spec.json` 生成 `prompt.md` + `spec.md`（含列表检测、渐变/字体/flex 样式、JSAPI 交互）。

package/dist/vendored/skills/sketch-spec-to-card/scripts/parse_meaxure.py

@@ -32,6 +32,7 @@ parse_meaxure.py — 解析 Sketch MeaXure 标注导出，视觉驱动生成「
   python parse_meaxure.py --build                         # 一步式（含 build_prompt）
 """
 import argparse
+import hashlib
 import json
 import math
 import os
@@ -1245,6 +1246,17 @@ def mark_missing_slice_elements(spec, preview_path, asset_index, asset_root=None
         defects.append(defect)
         return defect
 
+    # 裁切产物按内容 sha256 去重（同一图标在多个位置/多次缺失时被反复裁 → 字节级重复副本）。
+    # 索引含 crop_dir 里既有的裁切图（跨轮次复用）；命中即复用既有文件名，不新写一份。
+    crop_sha_index = {}
+    if crop_dir:
+        crop_dir.mkdir(parents=True, exist_ok=True)
+        for existing in crop_dir.glob("*.png"):
+            try:
+                crop_sha_index[hashlib.sha256(existing.read_bytes()).hexdigest()] = existing.name
+            except OSError:
+                continue
+
     def crop_from_artboard(element, defect):
         rect = element.get("rect") or {}
         width = float(rect.get("width", 0))
@@ -1259,16 +1271,31 @@ def mark_missing_slice_elements(spec, preview_path, asset_index, asset_root=None
             round(width),
             round(height),
         )
+        part = crop_dir / (filename + ".part")
         try:
             png_utils.crop_png(
                 preview_path,
                 (float(rect.get("x", 0)), float(rect.get("y", 0)), width, height),
-                crop_dir / filename,
+                part,
                 scale,
             )
-            defect["resolution"] = "artboard-crop"
+            data = part.read_bytes()
+            sha = hashlib.sha256(data).hexdigest()
+            twin = crop_sha_index.get(sha)
+            if twin:
+                part.unlink(missing_ok=True)
+                filename = twin
+                defect["resolution"] = "artboard-crop-reused"
+            else:
+                os.replace(part, crop_dir / filename)
+                crop_sha_index[sha] = filename
+                defect["resolution"] = "artboard-crop"
             defect["cropSlice"] = filename
         except (OSError, ValueError):
+            try:
+                part.unlink(missing_ok=True)
+            except OSError:
+                pass
             return
 
     for element in spec.get("elements") or []:

package/dist/vendored/tools/finmall-env.mjs

@@ -32,7 +32,7 @@ function parseEnvFile(file) {
  * @param {string} [root] 项目根（含 .env.cb）；默认 process.cwd()
  * @returns {{
  *   FINMALL_BASE_URL:string, FINMALL_APP_ID:string, FINMALL_WORKSPACE_ID:string,
- *   FINMALL_CDP_PORT:number, FINMALL_DEV_PORT:number, FINMALL_EDITOR_PATH:string
+ *   CARDBUDDY_CDP_PORT:number, CARDBUDDY_DEV_PORT:number, FINMALL_EDITOR_PATH:string
  * }}
  */
 export function loadFinmallEnv(root = process.cwd()) {
@@ -48,9 +48,9 @@ export function loadFinmallEnv(root = process.cwd()) {
     /** 工作空间标识 */
     FINMALL_WORKSPACE_ID: env.FINMALL_WORKSPACE_ID || 'dev',
     /** Chrome 远程调试端口（connectOverCDP 用） */
-    FINMALL_CDP_PORT: Number(env.FINMALL_CDP_PORT || 9222),
+    CARDBUDDY_CDP_PORT: Number(env.CARDBUDDY_CDP_PORT || 9222),
     /** 本地 dev server 监听端口（vite / 截图 / MCP / 各类工具默认连此端口） */
-    FINMALL_DEV_PORT: Number(env.FINMALL_DEV_PORT || 5180),
+    CARDBUDDY_DEV_PORT: Number(env.CARDBUDDY_DEV_PORT || 5180),
     /** 远端编辑器 Web 访问别名（站点下挂载路径，部署到别的目录时改这里） */
     FINMALL_EDITOR_PATH: (env.FINMALL_EDITOR_PATH || '/ubomp-h5-sub').replace(/\/+$/, ''),
   }
@@ -62,8 +62,8 @@ const d = loadFinmallEnv(process.cwd())
 export const FINMALL_BASE_URL = d.FINMALL_BASE_URL
 export const FINMALL_APP_ID = d.FINMALL_APP_ID
 export const FINMALL_WORKSPACE_ID = d.FINMALL_WORKSPACE_ID
-export const FINMALL_CDP_PORT = d.FINMALL_CDP_PORT
-export const FINMALL_DEV_PORT = d.FINMALL_DEV_PORT
+export const CARDBUDDY_CDP_PORT = d.CARDBUDDY_CDP_PORT
+export const CARDBUDDY_DEV_PORT = d.CARDBUDDY_DEV_PORT
 export const FINMALL_EDITOR_PATH = d.FINMALL_EDITOR_PATH
 
 /**
@@ -73,7 +73,7 @@ export const FINMALL_EDITOR_PATH = d.FINMALL_EDITOR_PATH
  * @returns {string}
  */
 export function devApiBase(host = '127.0.0.1') {
-  return `http://${host}:${FINMALL_DEV_PORT}`
+  return `http://${host}:${CARDBUDDY_DEV_PORT}`
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cardbuddy",
-  "version": "0.13.3",
+  "version": "0.14.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": {