cardbuddy 0.17.0 → 0.18.0

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

@@ -58,6 +58,46 @@ export function mergeServerTurn(chatDir, cardId, msg) {
   return writeHistory(chatDir, cardId, kept)
 }
 
+/**
+ * 浏览器 POST 整表时的「合并校对」：服务端已按 turnId 写过权威消息，这里只补浏览器独有的东西。
+ *
+ * 铁律：**已收尾的回合，服务端那份永远赢** —— 不是「客户端自认不是权威才丢」，而是
+ * 「只要盘上已有该 turnId 的权威消息，客户端同 turnId 的任何副本一律丢弃」。
+ *
+ * 为什么不能用 `!m.serverAuthored` 当条件（2026-10-09 实测修掉的缺陷）：
+ * 客户端 `revive()` 会把 `serverAuthored: true` 还原到内存消息上，`serialize()` 又原样写回。
+ * 于是浏览器 POST 上来的副本**也带着 serverAuthored=true**，旧条件
+ * `srvTurns.has(turnId) && !m.serverAuthored` 永远为假 → 副本被 `put()` 按 id 覆盖权威消息。
+ * 而 `serialize()` 是**有损白名单**（刻意剥掉 base64 截图 / 流式态），于是这次覆盖必然丢字段。
+ * 现场：greetingRecommend 第一回合 usage（缓存命中率）与 17 条 toolCall 的 truncated 全部消失，
+ * 摘要条退化成「未提供」、工具行不再显示截断提示。**服务端日志里数据是全的** ——
+ * 说明不是采集问题，是落盘被覆盖。
+ *
+ * @param {any[]} stored 已落盘的消息（服务端权威侧）
+ * @param {any[]} incoming 浏览器 POST 上来的整表
+ * @returns {any[]} 合并结果，按 ts 稳定排序
+ */
+export function mergeIncomingMessages(stored, incoming) {
+  const storedMsgs = Array.isArray(stored) ? stored : []
+  // 盘上已收尾的回合：这些 turnId 的任何浏览器副本都不许覆盖权威消息
+  const settled = new Set(storedMsgs.filter((m) => m && m.serverAuthored && m.turnId).map((m) => m.turnId))
+  const byId = new Map()
+  const anon = []
+  const put = (m) => {
+    if (!m || typeof m !== 'object') return
+    if (m.id) byId.set(m.id, m)
+    else anon.push(m)
+  }
+  for (const m of storedMsgs) put(m)
+  for (const m of Array.isArray(incoming) ? incoming : []) {
+    if (!m || typeof m !== 'object') continue
+    // 已收尾回合的客户端副本：无论它自称什么，一律丢掉（上面已说明为什么不能信它的标记）
+    if (m.role === 'assistant' && m.turnId && settled.has(m.turnId)) continue
+    put(m)
+  }
+  return [...byId.values(), ...anon].sort((x, y) => (Number(x.ts) || 0) - (Number(y.ts) || 0))
+}
+
 export function writeHistory(chatDir, cardId, messages) {
   const file = historyFile(chatDir, cardId)
   if (!file) return { ok: false, error: 'missing-card-id' }

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

@@ -1164,6 +1164,140 @@ export function persistReport(result, { sp, dp, irPath, reset = false, design =
   }
 }
 
+/**
+ * 报告摘要：给 stdout（= 模型上下文）用，全文已在 persistReport 里落盘。
+ *
+ * 为什么必须摘要（2026-10-09 实测）：原版 `JSON.stringify(result, null, 2)` 把整份报告灌进上下文，
+ * 单轮 6~15KB，而模型每轮的决策依据只有「gate 过了没有 / match 多少 / 差在哪个节点」。
+ * 体积大头全在它不需要的东西上：
+ *   - `contributors.elements[]`：每个热区逐节点度量（rect/h/hSibling/designH/flags），
+ *     而提示词自己写着「一轮只改 contributors[0].elements[0]」—— 后面的热区本轮根本不看；
+ *   - `elements[]`（--elements 的逐元素实测）、`fidelity.missing[]`/`invented[]` 的全文清单：
+ *     门禁只判 `.length === 0`，逐条文案对「该不该改样式」没有增量信息；
+ *   - `geometry.collapsed[]`/`overWrapped[]` 全文、`lint.warningDetails`、`preflight.details`。
+ * 15 轮迭代 = 9~22 万字符常驻，且每轮都重发（宿主把历史工具结果原样带回）⇒ 上下文斜率被它单独拉高。
+ *
+ * 摘要必须保留的字段（S5 全部决策都基于这些，删一条就会「照着不存在的结论调像素」）：
+ *   ok / gate（含 checks.failed.verdict.stage）/ pixelDiff.match / pixelDiff.size.heightDelta
+ *   / best / stalled / rounds / conclusion / contributors[0] / structuralGaps
+ *   / contentOffset1x+hint / widthMismatch / geometry.counts / 各 errors 计数
+ *   / readiness / diffImage / renderImage / report（全文路径，供 --detail 或 fs_read 取全文）
+ *
+ * 削峰的边界（刻意保留的「第一条 + 计数」）：
+ *   - contributors 只留 [0]，其余热区只报个数；
+ *   - missing / invented / collapsed 等清单只留**前 3 条文本 + 总数**——
+ *     前几条往往就是漏得最刺眼的（最长文案 / 最显眼的标题），模型据此能定位；要看全量有 report 路径。
+ */
+export function summarizeReport(result) {
+  if (!result || typeof result !== 'object') return result
+  // 幂等：已封装的摘要原样放过。宿主侧会对旧版未封装的全量报告做兜底裁剪，
+  // 二次裁剪会把 {total,sample} 当数组处理、把内容清空 —— 这是「封装过就别再动」的硬约束。
+  if (result.summary === true) return result
+  const r = result
+  const pd = r.pixelDiff
+  /**
+   * 清单类字段：留前 3 条 + 总数（不是只留计数 —— 模型要靠具体文案判断漏了什么）。
+   * 容忍两种输入：数组（全量）与 {total,sample}（已封装）—— 后者原样返回。
+   */
+  const list = (arr, map = (x) => x) => {
+    if (arr && !Array.isArray(arr) && typeof arr === 'object') return arr.total != null || arr.sample ? arr : undefined
+    const a = Array.isArray(arr) ? arr : []
+    if (!a.length) return undefined
+    return { total: a.length, sample: a.slice(0, 3).map(map), more: a.length > 3 ? `…另 ${a.length - 3} 条（见 report 全文）` : undefined }
+  }
+
+  const out = {
+    ok: r.ok,
+    cardId: r.cardId,
+    // 全文落盘路径放第一行：模型要看被削掉的内容时有确定入口，不必重跑 --detail
+    report: r.report,
+    conclusion: r.conclusion,
+    rounds: r.rounds,
+    best: r.best,
+    stalled: r.stalled,
+    gate: r.gate,
+    iterationReset: r.iterationReset,
+    appliedSets: r.appliedSets,
+    validate: r.validate
+      ? { errors: r.validate.errors, warnings: r.validate.warnings, envError: r.validate.envError, details: r.validate.details }
+      : undefined,
+    lint: r.lint
+      ? {
+          errors: r.lint.errors,
+          warnings: r.lint.warnings,
+          infos: r.lint.infos,
+          details: r.lint.details,
+          warningDetails: r.lint.warningDetails,
+        }
+      : undefined,
+    preflight: r.preflight
+      ? { errors: r.preflight.errors, details: list(r.preflight.details, (d) => (typeof d === 'string' ? d : d?.message || JSON.stringify(d))) }
+      : undefined,
+    readiness: r.readiness,
+    widthMismatch: r.widthMismatch,
+    contentOffset1x: r.contentOffset1x,
+    contentOffsetHint: r.contentOffsetHint,
+    // 像素主体：只留决策要用的三件（match / 尺寸差 / 热区），inkBox / diffPixels / totalPixels 是中间量
+    pixelDiff: pd
+      ? {
+          match: pd.match,
+          diffRatio: pd.diffRatio,
+          size: pd.size,
+          contentOffset: pd.contentOffset,
+          structuralGaps: pd.structuralGaps,
+          // 热区本身已在 contributors 里归因过，这里只留坐标供「还有哪些区没归因」的自查
+          hotspots: Array.isArray(pd.hotspots) ? pd.hotspots.slice(0, 3) : pd.hotspots,
+          hotspotsTotal: Array.isArray(pd.hotspots) ? pd.hotspots.length : pd.hotspotsTotal,
+        }
+      : undefined,
+    structuralGaps: r.structuralGaps,
+    // 分项归因：只留首条热区（提示词钦定「一轮只改 contributors[0].elements[0]」），其余只报个数
+    contributors: Array.isArray(r.contributors) ? r.contributors.slice(0, 1) : r.contributors,
+    contributorsTotal: Array.isArray(r.contributors) ? r.contributors.length : r.contributorsTotal,
+    contributorsNote: r.contributorsNote,
+    geometry: r.geometry
+      ? {
+          counts: r.geometry.counts,
+          collapsed: list(r.geometry.collapsed),
+          outOfCard: list(r.geometry.outOfCard),
+          overWrapped: r.geometry.counts?.overWrapped != null ? undefined : list(r.geometry.overWrapped),
+        }
+      : undefined,
+    geometryNote: r.geometryNote,
+    fidelity: r.fidelity
+      ? {
+          total: r.fidelity.total,
+          matched: r.fidelity.matched,
+          missing: list(r.fidelity.missing),
+          invented: list(r.fidelity.invented),
+          slices: r.fidelity.slices,
+          symbols: r.fidelity.symbols,
+          shapes: r.fidelity.shapes,
+        }
+      : undefined,
+    render: r.render,
+    designImage: r.designImage,
+    diffImage: r.diffImage,
+    renderImage: r.renderImage,
+    diffImageNote: r.diffImageNote,
+    elapsedMs: r.elapsedMs,
+  }
+  if (r.error || r.message) {
+    out.error = r.error
+    out.message = r.message
+  }
+  // 被削掉的字段名写清楚：模型必须知道「摘要 ≠ 全量」，否则会把「没提到」误读成「不存在」
+  // fs_read 现在支持 offset 续读（尾巴会给下一段起点），所以「读全文」的正解是照着 offset 读到底，
+  // 而不是一遍 fs_read —— 一遍只拿得到一屏。
+  out.summaryNote =
+    '本报告为摘要（contributors 只留首条热区、要素/几何清单只留前 3 条 + 总数、逐元素度量已省略）；' +
+    '需要全量明细用 fs_read 读 report 路径（长报告会带下一段 offset，照抄续读），或重跑加 --detail。'
+  // 幂等标记：宿主侧（ai-chat.js）会对未封装的旧版全量报告做一次兜底裁剪，
+  // 见标记后它会原样放过 —— 否则二次裁剪会把已封装的 {total,sample} 当数组处理、把内容清空。
+  out.summary = true
+  return out
+}
+
 /* ── 核心管线 ──────────────────────────────────────────────── */
 async function runPipeline({ ir: irPath, out: outDir, design: designPath, width, session, alwaysDiffImage, withElements, sets, specPath, skipPreflight, slicesDir: slicesDirArg, reset: resetFlag, noReadiness: noReadinessArg }) {
   const t0 = performance.now()
@@ -1476,7 +1610,7 @@ async function runPipeline({ ir: irPath, out: outDir, design: designPath, width,
 
 /* ── CLI ───────────────────────────────────────────────────── */
 function parseArgs(argv) {
-  const out = { ir: '', out: '', design: '', width: 0, keepAlive: false, diffImage: false, elements: false, sets: [], spec: '', gate: false, id: '', skipPreflight: false, slicesDir: '', reset: false, noReadiness: false }
+  const out = { ir: '', out: '', design: '', width: 0, keepAlive: false, diffImage: false, elements: false, sets: [], spec: '', gate: false, id: '', skipPreflight: false, slicesDir: '', reset: false, noReadiness: false, detail: false }
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i]
     if (a === '--ir') out.ir = argv[++i] || ''
@@ -1488,6 +1622,8 @@ function parseArgs(argv) {
     else if (a === '--slices-dir') out.slicesDir = argv[++i] || ''
     else if (a === '--id') out.id = argv[++i] || ''
     else if (a === '--gate') out.gate = true
+    // stdout 默认只回摘要（省上下文）；--detail 才回全量报告（模型真要看逐元素度量时才加）
+    else if (a === '--detail') out.detail = true
     else if (a === '--no-preflight') out.skipPreflight = true
     // 逃生门：跳过 S4.9 内容就绪门禁（debug 用；正常流程**不该**用它）
     else if (a === '--no-readiness') out.noReadiness = true
@@ -1625,7 +1761,7 @@ async function main() {
   }
 
   if (!args.ir || !args.out) {
-    console.error('用法: node iterate.mjs --ir <IR.json> --out <cardDir> [--design <design.png>] [--width 343]')
+    console.error('用法: node iterate.mjs --ir <IR.json> --out <cardDir> [--design <design.png>] [--width 343] [--detail]')
     process.exit(1)
   }
 
@@ -1644,7 +1780,8 @@ async function main() {
     noReadiness: args.noReadiness,
   })
 
-  console.log(JSON.stringify(result, null, 2))
+  // 默认摘要：stdout = 模型上下文，全量报告已落盘在 report 字段指向的文件（见 summarizeReport 头注）
+  console.log(JSON.stringify(args.detail ? result : summarizeReport(result)))
   if (!result.ok) process.exit(1)
   // 门禁未达标不算脚本失败（报告照常回喂），但退出码要让调用方一眼看出没收敛
   if (result.gate && result.gate.passed === false) process.exitCode = 2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cardbuddy",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "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": {