cardbuddy 0.22.0 → 0.23.0

package/dist/preview-editor/index.html

@@ -8,8 +8,8 @@
     <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-CPpLZZyi.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CU8zVA2P.css">
+    <script type="module" crossorigin src="/assets/index-C7N5n_qW.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-7RzNd7tf.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/skills-upgrade.js

@@ -5,7 +5,7 @@
  * 运行时 skillPaths 解析「项目 skills/ 优先于包内快照」（server/core/skillPaths.js），
  * 故只 `npm i cardbuddy@latest` 不会更新工程里的 skills 副本——必须显式拉一次。本命令
  * 就是为这个场景而生，且**只动 skills/**，绝不碰 .env.cb / package.json / README.md
- * （那是 `init --force` 的危险面，可能冲掉端口 / FinMall 配置 / AI 网关占位）。
+ * （那是 `init --force` 的危险面，可能冲掉端口 / 远端配置 / AI 网关占位）。
  *
  * 行为模型（upgrade = 显式要把新版带进来，「有差异 = 应当覆盖」，不做好坏判定）：
  *   ADDED    源有、目标无        → 复制（安全）

package/dist/standalone.js

@@ -9,7 +9,7 @@
  *     - /__events（SSE）实时推送 cards-changed（替代 Vite HMR）
  *     - 内嵌 Vite middlewareMode 实例，仅为 render-status / node-models 提供 ssrLoadModule
  *
- * 仅绑定 127.0.0.1；FinMall 凭据只在本机，公网前端永不接触。
+ * 仅绑定 127.0.0.1；远端凭据只在本机，公网前端永不接触。
  */
 import http from 'node:http'
 import https from 'node:https'
@@ -494,7 +494,7 @@ export async function startServer(userConfig = {}) {
   // <pkg>/dist/vendored/skills/... 里，推出来的是包内快照目录，UI/ 产物会写进 node_modules
   // （0.14.1 的 route_input 事故）。技能层的 AI 工具与 skill_exec 子进程都继承本进程 env。
   if (!process.env.DSL_CARD_PROJECT_ROOT) process.env.DSL_CARD_PROJECT_ROOT = config.root
-  // upstream（FINMALL_BASE_URL）透传给资源代理中间件，使其能回源 FinMall 取站内资源
+  // upstream（PLATFORM_BASE_URL）透传给资源代理中间件，使其能回源远端取站内资源
   mountCoreMiddlewares(app, {
     root: config.root,
     viteServer: vite,

package/dist/vendored/card-editor/runtime/adapter.js

@@ -7,7 +7,7 @@
  * 全局正则替换。别名表取自 /ubomp-h5-sub/js/main.js。
  */
 
-// 前后分离后，站内资源统一经「本地开发服务（8787）」的资源代理回源 FinMall。
+// 前后分离后，站内资源统一经「本地开发服务（8787）」的资源代理回源远端。
 // 这里引入 resolveApiBase，把本地化出的站内路径改写为指向 8787 的绝对 URL，
 // 修复部署态（静态编辑器 + 本机 8787，无 Vite）资源缺失的问题。
 import { resolveApiBase } from '@/api.js'
@@ -25,16 +25,15 @@ const URL_PREFIX_ALIAS = {
  * 卡片 data.json 里有不少写死的完整 CDN 地址，直接请求会跨域也吃不到本地缓存。
  * 统一改写成同源路径，交给 vite 的资源代理中间件。
  *
- * 域名不硬编码：从 .env.cb 的 FINMALL_BASE_URL 读取（vite 以
- * envPrefix FINMALL_ 暴露到 import.meta.env），未配置时回退 UAT 域名。
+ * 域名不硬编码：从 .env.cb 的 PLATFORM_BASE_URL 读取（vite 以
+ * envPrefix PLATFORM_ 暴露到 import.meta.env）。未配置时不改写任何 host，
+ * 让这些绝对地址原样请求（资源代理仍会回源），避免误把相对路径截成空串。
  */
-const BASE_URL = import.meta.env.FINMALL_BASE_URL || 'https://uat-pkg.finmall.com'
-const BASE_HOST = BASE_URL.replace(/^https?:/, '') // '//uat-pkg.finmall.com'
-const ABSOLUTE_ASSET_HOSTS = [...new Set([
-  BASE_URL,
-  BASE_URL.replace(/^https:/, 'http:'),
-  BASE_HOST,
-])]
+const BASE_URL = import.meta.env.PLATFORM_BASE_URL || ''
+const BASE_HOST = BASE_URL ? BASE_URL.replace(/^https?:/, '') : ''
+const ABSOLUTE_ASSET_HOSTS = BASE_URL
+  ? [...new Set([BASE_URL, BASE_URL.replace(/^https:/, 'http:'), BASE_HOST])]
+  : []
 
 function toLocalAssetUrl(url) {
   if (typeof url !== 'string' || !url) return url
@@ -82,7 +81,7 @@ export default class Adapter {
    * - `@` 开头的站内别名（如 `@filestore/x`）：走 URL_PREFIX_ALIAS 替换 + 绝对 host 截取，
    *   转成同源站内路径，交给本地资源代理回源。
    *
-   * 历史实现里 toLocalAssetUrl 对所有入参（含 http 图链）都截取 FinMall 等 host，导致
+   * 历史实现里 toLocalAssetUrl 对所有入参（含 http 图链）都截取远端等 host，导致
    * 背景图 / 图片一旦命中这些 host 就被剥掉域名、改走本地代理，与「远程地址原样直连」的预期不符。
    */
   doReplaceUrl(url) {

package/dist/vendored/mcp/client.mjs

@@ -3,9 +3,10 @@ import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { dirname, resolve } from 'node:path'
 import { listCards, readCardFiles, writeCardFiles, renameCard } from '../server/core/cardFiles.js'
+import { findNodeByComponentId } from '../server/core/cardDigest.js'
 import { validateCard, resolvePython, scriptPath } from '../server/core/cardValidate.js'
 import { listSnapshots, saveSnapshot, HISTORY_DIR } from '../server/core/cardHistory.js'
-import { devApiBase } from '../tools/finmall-env.mjs'
+import { devApiBase } from '../tools/platform-env.mjs'
 
 /**
  * MCP 薄 HTTP 客户端：只封装对 dev server（端口见 .env.cb 的 CARDBUDDY_DEV_PORT）的请求，不复制任何业务逻辑。
@@ -13,7 +14,7 @@ import { devApiBase } from '../tools/finmall-env.mjs'
  * 降级策略（与 tools/card-check.mjs 一致）：
  * - list / read / write / validate：dev server 未启动（fetch 抛连接错误）时，
  *   降级为直接读盘 / 写盘 / 跑 Python —— 复用 server/* 导出的同一份实现，避免漂移。
- * - render_status / sync / save：依赖 dev server 与 FinMall 登录态，不支持离线降级；
+ * - render_status / sync / save：依赖 dev server 与远端登录态，不支持离线降级；
  *   screenshot 在 dev server 未启动时降级到独立离线渲染器。
  */
 
@@ -101,13 +102,13 @@ async function httpPost(p, body) {
   return { status: res.status, buf, text, json, contentType: res.headers.get('content-type') || '' }
 }
 
-// 需要 FinMall 登录态的远端工具：提示语要额外说明「且已登录 FinMall」。
+// 需要远端登录态的远端工具：提示语要额外说明「且已登录远端」。
 const REMOTE_TOOLS = new Set(['card_sync', 'card_save', 'card_slice_upload'])
 
 const DEV_REQUIRED = (tool) => ({
   source: null,
   error: 'dev-server-required',
-  message: `${tool} 需要 dev server 已启动（npm run dev）${REMOTE_TOOLS.has(tool) ? ' 且已登录 FinMall' : ''}。本工具不支持离线降级。`,
+  message: `${tool} 需要 dev server 已启动（npm run dev）${REMOTE_TOOLS.has(tool) ? ' 且已登录远端' : ''}。本工具不支持离线降级。`,
 })
 
 // ---- card_list ----
@@ -122,16 +123,52 @@ export async function cardList() {
 }
 
 // ---- card_read ----
-export async function cardRead(id) {
+/**
+ * 读单卡。
+ *
+ * `node` 给定 componentId 时**只返回该子树**（附带真实 JSON 路径与祖先链）——
+ * 大卡（实测最大 239KB / 167 节点）整份读一次就会吃满工具结果档位，
+ * 而「结构摘要 → 定向取一棵子树」才是正常读法（见 server/core/cardDigest.js）。
+ */
+export async function cardRead(id, { node = '' } = {}) {
+  let payload = null
+  let source = 'local'
   try {
     const { status, json } = await httpGet(`/__card/${encodeURIComponent(id)}`)
-    if (status === 200 && json) return { source: 'http', ...json }
+    if (status === 200 && json) {
+      payload = json
+      source = 'http'
+    }
   } catch {
     /* 降级 */
   }
-  const r = readCardFiles(ROOT, id)
-  if (!r) return { source: 'local', error: 'card not found', id }
-  return { source: 'local', ...r }
+  if (!payload) {
+    const r = readCardFiles(ROOT, id)
+    if (!r) return { source: 'local', error: 'card not found', id }
+    payload = r
+  }
+  if (!node) return { source, ...payload }
+
+  const found = findNodeByComponentId(payload.schema, node)
+  if (!found) {
+    return {
+      source,
+      error: 'component not found',
+      id,
+      node,
+      hint: '先用 card_read 不带 node 看结构图（tree 段），或 card_grep 按文案/类名定位；节点树在 view.components[] / view.slots[].components[]',
+    }
+  }
+  return {
+    source,
+    mode: 'node',
+    id,
+    componentId: node,
+    path: found.path,
+    depth: found.depth,
+    ancestors: found.ancestors.map((a) => `${a.cid || a.cls}@${a.path}`),
+    node: found.node,
+  }
 }
 
 // ---- card_write（闭环收口：写前自动留历史快照，写完自动校验）----
@@ -458,7 +495,7 @@ export async function cardScreenshot(id, { format = 'json', width = 390 } = {})
   }
 }
 
-// ---- card_sync（需 dev server + FinMall 登录态）----
+// ---- card_sync（需 dev server + 远端登录态）----
 export async function cardSync({ cardCode } = {}) {
   try {
     const { status, json } = await httpPost('/__sync', { cardCode })
@@ -470,7 +507,7 @@ export async function cardSync({ cardCode } = {}) {
   return DEV_REQUIRED('card_sync')
 }
 
-// ---- card_save（需 dev server + FinMall 登录态）----
+// ---- card_save（需 dev server + 远端登录态）----
 export async function cardSave({ schema, code, skeletonScreen } = {}) {
   try {
     const { status, json } = await httpPost('/__save', { schema, code, skeletonScreen })
@@ -482,8 +519,8 @@ export async function cardSave({ schema, code, skeletonScreen } = {}) {
   return DEV_REQUIRED('card_save')
 }
 
-// ---- card_slice_upload（需 dev server + FinMall 登录态）----
-// 切图上传只按单卡范围执行：端点内部复用 finmall-card-sync 的 uploadSlices({ cardId })，
+// ---- card_slice_upload（需 dev server + 远端登录态）----
+// 切图上传只按单卡范围执行：端点内部复用 platform-card-sync 的 uploadSlices({ cardId })，
 // 上传 src/slices 里该卡引用的图并把 schema/data 的 /slices/ 引用改写为 @filestore/ 线上地址。
 export async function sliceUpload({ cardId, force } = {}) {
   try {

package/dist/vendored/mcp/tools.mjs

@@ -22,10 +22,16 @@ export const TOOLS = [
   {
     name: 'card_read',
     description:
-      '读取单张卡片的 schema.json（组件树/属性/样式/事件）与 data.json（输入参数默认值）。优先走 GET /__card/:id；未启动 dev server 时降级为直接读盘。',
+      '读取单张卡片的 schema.json（组件树/属性/样式/事件）与 data.json（输入参数默认值）。优先走 GET /__card/:id；未启动 dev server 时降级为直接读盘。大卡（数百 KB）服务端会返回**结构图**（全部节点身份 + 主文本 + 参数表）而不是整份 JSON——据此定位后，用 node:"<componentId>" 定向读该子树（含完整 style/properties），比整卡小一个数量级。',
     inputSchema: {
       type: 'object',
-      properties: { id: { type: 'string', description: '卡片 id，对应 src/cards/<id>' } },
+      properties: {
+        id: { type: 'string', description: '卡片 id，对应 src/cards/<id>' },
+        node: {
+          type: 'string',
+          description: '可选：只返回该 componentId 的子树（含真实 JSON 路径与祖先链）。配合结构图的 tree 段使用',
+        },
+      },
       required: ['id'],
     },
   },
@@ -84,7 +90,7 @@ export const TOOLS = [
   {
     name: 'card_node_models',
     description:
-      '读取单卡的「可编辑字段结构树」（Task #5 暴露的 Property-tree 模型，对应 dev server 的 GET /__node-models/:id）。返回每个节点的 {componentId, className, properties, style, directives, eventactions, components}，其中每个字段含 itemKey/itemName/itemType/itemValue/itemValueFrom/itemTypeRange/options(iParamList|iTypeList)/children——AI 无需解析 raw DSL + component-meta 即可知道「某节点有哪些可改字段、各自类型与枚举」。⚠️ 该模型是只读视图，改卡仍走 card_write（整体替换）；必须 dev server 已启动（npm run dev），不支持离线降级。',
+      '读取单卡的「可编辑字段结构树」（Task #5 暴露的 Property-tree 模型，对应 dev server 的 GET /__node-models/:id）。返回每个节点的 {componentId, className, properties, style, directives, eventactions, components}，其中每个字段含 itemKey/itemName/itemType/itemValue/itemValueFrom/itemTypeRange/options(iParamList|iTypeList)/children——AI 无需解析 raw DSL + component-meta 即可知道「某节点有哪些可改字段、各自类型与枚举」。⚠️ 该模型是只读视图；改卡走 card_patch（按 @componentId 点路径最小写），不要 card_write 整包重写。本工具适合「查某节点有哪些可改字段、枚举候选是什么」，定位节点本身用 card_read 的结构图更省。必须 dev server 已启动（npm run dev），不支持离线降级。',
     inputSchema: {
       type: 'object',
       properties: { id: { type: 'string', description: '卡片 id，对应 src/cards/<id>' } },
@@ -108,7 +114,7 @@ export const TOOLS = [
   {
     name: 'card_sync',
     description:
-      '经已登录的 FinMall 浏览器会话从远端拉取最新卡片写回 src/cards（复用 finmall-card-sync）。必须 dev server 已启动且已登录 FinMall，不支持离线降级。',
+      '经已登录的远端浏览器会话从远端拉取最新卡片写回 src/cards（复用 platform-card-sync）。必须 dev server 已启动且已登录远端，不支持离线降级。',
     inputSchema: {
       type: 'object',
       properties: { cardCode: { type: 'string', description: '指定卡片 code；留空=同步全部' } },
@@ -118,7 +124,7 @@ export const TOOLS = [
   {
     name: 'card_save',
     description:
-      '把当前卡片 schema 经已登录浏览器写回 FinMall（IDC10010.do）。必须 dev server 已启动且已登录 FinMall，不支持离线降级。',
+      '把当前卡片 schema 经已登录浏览器写回远端（IDC10010.do）。必须 dev server 已启动且已登录远端，不支持离线降级。',
     inputSchema: {
       type: 'object',
       properties: {
@@ -132,7 +138,7 @@ export const TOOLS = [
   {
     name: 'card_slice_upload',
     description:
-      '把指定卡片引用的本地切图（src/slices）经已登录浏览器上传到 FinMall 图片库（CC0000.do），写「本地文件 ↔ 线上地址」映射 src/slices/manifest.json，并把该卡 schema.json / data.json 里的 "/slices/<name>" 引用改写为返回的 @filestore/… 线上地址。按 sha256 判重：内容未变的切图直接复用已有地址不重复上传；本地切图真源保留不动。**仅按需调用，不存在自动上传**——推送版本 / 出真机预览前，若卡片仍引用 /slices/ 就先跑本工具，否则线上卡片取不到图。必须 dev server 已启动且已登录 FinMall，不支持离线降级。',
+      '把指定卡片引用的本地切图（src/slices）经已登录浏览器上传到远端图片库（CC0000.do），写「本地文件 ↔ 线上地址」映射 src/slices/manifest.json，并把该卡 schema.json / data.json 里的 "/slices/<name>" 引用改写为返回的 @filestore/… 线上地址。按 sha256 判重：内容未变的切图直接复用已有地址不重复上传；本地切图真源保留不动。**仅按需调用，不存在自动上传**——推送版本 / 出真机预览前，若卡片仍引用 /slices/ 就先跑本工具，否则线上卡片取不到图。必须 dev server 已启动且已登录远端，不支持离线降级。',
     inputSchema: {
       type: 'object',
       properties: {
@@ -240,7 +246,7 @@ export async function dispatch(name, args = {}) {
     case 'card_list':
       return client.cardList()
     case 'card_read':
-      return client.cardRead(args.id)
+      return client.cardRead(args.id, { node: args.node })
     case 'card_write':
       return client.cardWrite(args.id, { schema: args.schema, data: args.data }, { verify: args.verify !== false })
     case 'card_validate':