cardbuddy 0.19.3 → 0.21.0

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

@@ -13,8 +13,11 @@
 import { createSyncMiddleware, createPreviewMiddleware, createLoginCredentialsMiddleware } from './cardSync.js'
 import { createPublishMiddleware } from './cardPublish.js'
 import { createCardVersionMiddleware } from './cardVersion.js'
+import { createCardHistoryMiddleware } from './cardHistoryRemote.js'
+import { createCardPublishVersionsMiddleware } from './cardPublishVersions.js'
 import { createSliceUploadMiddleware } from './sliceUpload.js'
 import { createCardFilesMiddleware, refreshCardList } from './cardFiles.js'
+import { createExportMiddleware } from './cardExport.js'
 import { createSaveMiddleware } from './cardSave.js'
 import { createImportMetaMiddleware } from './cardImportMeta.js'
 import { createHistoryMiddleware } from './cardHistory.js'
@@ -46,10 +49,13 @@ export {
   createLoginCredentialsMiddleware,
   createPublishMiddleware,
   createCardVersionMiddleware,
+  createCardHistoryMiddleware,
+  createCardPublishVersionsMiddleware,
   createSliceUploadMiddleware,
   createCardFilesMiddleware,
   createSaveMiddleware,
   createImportMetaMiddleware,
+  createExportMiddleware,
   createHistoryMiddleware,
   createValidateMiddleware,
   createRenderStatusMiddleware,
@@ -98,12 +104,22 @@ export function mountCoreMiddlewares(app, { root, viteServer = null, upstream =
   // 卡片来源 tab 的「远端最新版本」查询（只读）：GET /__card-version/:id 取 IDC10004 的 maxVersion，
   // 复用 finmall-card-sync 的 fetchCardLatestVersion，与发布/同步/保存共用同一后台 FinMall 会话。
   app.use(createCardVersionMiddleware({ root }))
+  // 「卡片历史记录」tab 的远端版本时间线（只读）：GET /__card-history/:cardCode 取 IDC10013 的
+  // schemaValueList（新→旧，含预览图 / 变更标签），复用 finmall-card-sync 的 fetchCardHistory。
+  app.use(createCardHistoryMiddleware({ root }))
+  // 「导入信息」tab「发布版本记录」弹框的数据源（只读）：GET /__card-publish-versions/:cardCode
+  // 取 IDC10004 的 versionList（新→旧，版本号 / 平台 / 发布状态 / 发布时间），滚动到底懒加载下一页。
+  app.use(createCardPublishVersionsMiddleware({ root }))
   // 切图上传（顶栏「远端 → 切图上传」）：把当前卡引用的 src/slices 切图传到 FinMall 图片库，
   // 写 src/slices/manifest.json 映射并把卡片里的 /slices/ 引用改写为 @filestore/ 线上地址。
   // 仅在用户点击时触发，没有任何自动上传路径。
   app.use(createSliceUploadMiddleware({ root }))
   app.use(createCardFilesMiddleware({ root, notify }))
   app.use(createSaveMiddleware({ root }))
+  // 卡片导出（编辑器「网格预览 → 勾选 → 导出」）：产物契约见 server/core/cardExport.js 头注释
+  // 与 docs/卡片导出产物逆向分析与导出功能.md；previewSchema 经 viteServer.ssrLoadModule 复用
+  // 编辑器同源 buildPreview，故本中间件需要 viteServer（无则退化为 schema 原样序列化）。
+  app.use(createExportMiddleware({ root, viteServer, upstream }))
   app.use(createHistoryMiddleware({ root }))
   app.use(createValidateMiddleware({ root }))
   app.use(createRenderStatusMiddleware({ root, viteServer }))

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

@@ -212,6 +212,52 @@ headers: token / iCIFID / eCIFID = localStorage._sessionId（只在页面上下
 | CLI 跑完进程不退出 | 已修：CLI 末尾显式 `process.exit`（后台 Chrome 的 CDP 连接会挂住事件循环）；Chrome 进程本身按约定常驻不关 |
 | 想撤销改写 | `git checkout -- src/cards/<id>/`；清单里的地址仍有效，重跑一次即可再改写回来 |
 
+## 卡片预览图上传（推送成功后自动，`IDC10014.do`）
+
+编辑器顶栏「远端 → 推送」走 `POST /__save`（`saveCardToRemote`）。**推送成功后**，服务端会用无头
+Chrome 渲染当前卡片（`server/core/screenshot.js → generateCardCover`：透明底、与卡片实际渲染尺寸
+1:1 的 PNG），再把这张图作为**远端列表预览图**上传（`uploadCardPreview` → `IDC10014.do`），
+使 FinMall 卡片列表的缩略图与刚推上去的内容一致。
+
+| 项 | 值 |
+|---|---|
+| 触发点 | 仅 `/__save` 成功后，一个请求内完成（前端 `saveToRemote` 已带 2.5s 自保存抑制） |
+| 总预算 | 45s（`CARDBUDDY_PUSH_PREVIEW_TIMEOUT_MS`）；到点放弃等待，响应带 `preview.error` |
+| 开关 | `CARDBUDDY_PUSH_PREVIEW=0` 关闭（远端图片库维护时避免每条推送多等一次失败） |
+| 失败语义 | **best-effort**：日志 + 响应 `preview:{ok:false,error,message}`，推送本身的成功结论不变 |
+
+### 接口契约（`IDC10014.do`，取自线上编辑器抓包）
+
+```
+POST {baseUrl}/ubomp-web/IDC10014.do          # 注意：sassAppId/Workspace 走表单，不是查询串
+Content-Type: multipart/form-data
+  cardId          = 10000363                  # 数字型 cardId（= schema.pageId）
+  file            = <二进制 PNG>               # filename = <cardId>.png
+  sassAppId       = <FINMALL_APP_ID>
+  sassWorkspaceId = <FINMALL_WORKSPACE_ID>
+headers: token = localStorage._sessionId（只在页面上下文内读取，不出页面）
+```
+
+与切图上传（`CC0000.do`）的四点差异，改动时别混用：①字段是 `cardId` + `file`（**没有** `fileName`
+纯文本字段）；②`sassAppId/Workspace` 在表单里；③filename 固定 `<cardId>.png`（抓包里该 part 的
+Content-Type 是 `application/octet-stream`，照抄）；④鉴权头只有 `token`。
+
+响应判定按 FinMall 通用信封做**宽松**处理（`parsePreviewUploadResponse`）：空响应体视为成功；
+非 JSON 非空（网关 HTML 错误页）报错；`header.errorCode` 与 `body.errorCode` **逐个**检查
+（不能用 `a || b` 短路——`header.errorCode='0'` 会把 body 的业务错误盖掉）；成功时尽力取
+`body.picUrl | previewUrl | imageUrl | filePath | url`，取不到不影响「上传成功」。命中
+`BLEC0006` 等会话失效特征时自动清 session 重登并重试一次（与同步 / 切图同一套自愈）。
+
+### 两条刻意的「不做」
+
+- **不写本地预览图**：不覆盖 `src/cards/<id>/<id>.png`。截图+上传耗时可能超过前端 2.5s 自保存
+  抑制窗口，写盘会触发 watcher 的 `cards-changed`，误弹「卡片已在编辑器外被修改」；本地封面仍由
+  顶栏「预览图」按钮（`POST /__card-image/<id>`）显式生成——单一触发点。
+- **不参与同步 / 发布**：拉取方向由远端 `picUrl` 覆盖本地封面；「卡片发布」只上线版本，不改预览图。
+
+> 截图渲染的是**磁盘态** schema，故前端 `saveToRemote` 在有未保存编辑（`historyDirty`）时会先
+> 落盘再推送（与「切图上传」同一处置口径），否则会截到上一版布局。
+
 ## 变量与数据规则
 
 编辑器变量面板是 `schema.dictionary.inputParams[]` 的 UI 呈现：