@lark-apaas/coding-steering 0.1.18-dev.0450c3c → 0.1.18-dev.12ae0d8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-steering",
-  "version": "0.1.18-dev.0450c3c",
+  "version": "0.1.18-dev.12ae0d8",
   "description": "Stack-specific steering content for miaoda-coding templates",
   "type": "module",
   "files": [

package/steering/design-html/skills/pptx-style-extract/scripts/draft.py

@@ -28,6 +28,7 @@ OPAQUE_ENOUGH = 128    # 能当背景的最低不透明度：低于半透明就
                        # 那是叠加装饰不是背景
 FILL_MANY = 5          # 「被大量当填充铺开」的次数下限，用于区分卡片底与偶发用色
 BG_CONTENT_CAP = 5     # 内容页背景收几张：再多消费端也挑不过来，超出的写进 TODO 交人取舍
+SHEET_CAP = 12         # 联系表展示上限；进包的资产不受它约束，一张都不截
 
 HERE = os.path.dirname(os.path.abspath(__file__))
 SKILL_ROOT = os.path.dirname(HERE)
@@ -913,6 +914,22 @@ def top_bleed_media(shapes):
     return out
 
 
+def slot_overlaps(slots):
+    """同一页型里坐标互相重叠的槽对。只报事实，不改坐标——坐标是从模板量的。"""
+    out = []
+    for i in range(len(slots)):
+        for j in range(i + 1, len(slots)):
+            a, b = slots[i].get('box'), slots[j].get('box')
+            if not (a and b):
+                continue
+            ox = min(a[0] + a[2], b[0] + b[2]) - max(a[0], b[0])
+            oy = min(a[1] + a[3], b[1] + b[3]) - max(a[1], b[1])
+            if ox > 0 and oy > 0:
+                out.append('%s×%s 叠 %dx%d' % (slots[i].get('role'), slots[j].get('role'),
+                                               round(ox), round(oy)))
+    return out
+
+
 def slot_style(s):
     """占位符自带的排版样式——字号/色值/对齐/字重都是直读，不给消费端留编的空间。
 
@@ -1356,7 +1373,7 @@ def contact_sheet(outdir, cands, path):
     except Exception:
         return None
     cell, pad, cols = 220, 20, 4
-    items = cands[:12]
+    items = cands            # 上限由调用方定，编号与 BRIEF 表格一一对应
     if not items:
         return None
     rows = (len(items) + cols - 1) // cols
@@ -1699,6 +1716,13 @@ def emit_layouts(archetypes, ldir, busy_hints=None, facts=None, recipes=None):
                          % '、'.join('%s=%d字' % (b, n) for b, n in fx['chars'][:6]))
             if fx.get('recipes'):
                 L.append('  # 命中配方：%s' % '、'.join(fx['recipes'][:4]))
+        # 槽与槽在坐标上重叠：PPT 里占位符互相压是常态（文字 valign 居中、样张只有一行，
+        # 看不出来），照抄坐标做成 HTML 后内容一变长就撞。实测封面 title 框比 subtitle
+        # 的顶还低 41px，两行标题直接压在副标题上。这里只报事实，怎么让开由你定。
+        ov = slot_overlaps(a.get('slots') or [])
+        if ov:
+            L.append('  # 槽位重叠：%s（模板里靠文字居中不显形，内容变长会撞）'
+                     % '、'.join(ov[:3]))
         L.append('  %s:' % a['name'])
         if a.get('role'):
             L.append('    role: %s' % a['role'])
@@ -1864,7 +1888,7 @@ def emit_body(d, tokens, fonts, roles, assets, archetypes, exceptions, cusage, l
 
 def emit_brief(d, ctx, ldir):
     (tokens, rest, fonts, roles, assets, rejected, todos, archetypes, cands, sheet,
-     leftover, lsheet) = ctx
+     leftover, lsheet, sheet_n) = ctx
     canvas = d['canvas']['px']
     L = ['# 抽取简报（第 1/3 步产物；改完草案跑 package.py 出包）', '',
          '源：`%s`  画布 %dx%d  %d 页 / %d 版式  主题 %s  form=%s'
@@ -1901,16 +1925,20 @@ def emit_brief(d, ctx, ldir):
     for t in todos:
         L.append('- ' + t)
     L += ['', '## 联系表（一次看完所有候选图）', '',
-          '`l-out/contact-sheet.png`  —— 编号对应下表；看完再决定 logo / 封面归属。' if sheet
+          '`l-out/contact-sheet.png`  —— 图格编号对应下表前几行；看完再决定 logo / 封面归属。' if sheet
           else '（Pillow 不可用，未生成联系表；逐张看 `media-out/`）', '',
           '| # | 文件 | 尺寸 | 出现 | 满屏 | 页 | 草案判定 |', '|---|---|---|---|---|---|---|']
     decided = {a['src']['file']: a['id'] for a in assets}
     why = {c['file']: r for c, r in rejected}
-    for i, c in enumerate(cands[:12], 1):
+    for i, c in enumerate(cands, 1):
         L.append('| %d | `%s` | %sx%s | %d | %s | %s | %s |' % (
             i, c['file'], c['probe'].get('w') or '?', c['probe'].get('h') or '?', c['n'],
             'Y' if c['fullscreen'] else '', ','.join(map(str, c['slides'][:6])) or 'layout',
             decided.get(c['file']) or ('✗ ' + why.get(c['file'], '未采纳'))))
+    if len(cands) > sheet_n:
+        L.append('')
+        L.append('拼版图只含前 %d 张（第 %d 行之后的没有图格）。要看后面某张，'
+                 '按文件名直接看 `media-out/`。' % (sheet_n, sheet_n))
     L += ['', '## 颜色（草案 token 已写进 frontmatter.yaml）', '',
           '| token | hex | 出现 |', '|---|---|---|']
     for name, r in tokens:
@@ -1962,7 +1990,15 @@ def main(argv=None):
     tokens, rest, rows = draft_colors(d, cusage)
     fonts = draft_fonts(d)
     archetypes, pages, leftover = draft_layouts(d, outdir)
+    # 封面底图：form=3 的页型键就是角色名（cover/section/...），直接按名字取。
+    # form=2 按样张聚类，键是 layout-1..N，永远匹配不上 'cover'——实测 vo-lite 因此
+    # 一张 role: cover 都没有，封面主视觉被标成 bg-content-1，消费端拿不到封面资产，
+    # design.md 的「封面底图必用 cover 资产」这条硬规则无从满足。回退到覆盖第 1 页的
+    # 那个页型：deck 的第 1 页就是封面，这是版式无关的事实。
     cover_media = next((a['bg_raw'] for a in archetypes if a['name'] == 'cover'), None)
+    if not cover_media:
+        cover_media = next((a['bg_raw'] for a in archetypes
+                            if 1 in (a.get('pages') or ())), None)
     bg_needed = {a['bg_raw'] for a in archetypes if a['bg_raw'] and a['bg_raw'].startswith('ppt/media')}
     bg_under = {p['no']: p['bg_media'] for p in pages}
     assets, rejected, todos, alias, pool = draft_assets(d, outdir, bg_needed, cover_media, bg_under)
@@ -2018,9 +2054,23 @@ def main(argv=None):
         a['slots'] = keep
     roles = draft_scale(d, archetypes)
     slot_added = cover_slot_colors(tokens, archetypes, rows, cusage)
-    cands = sorted([c for c in [a['src'] for a in assets]] +
-                   [c for c, _ in rejected], key=lambda c: (-c['n'], c['file']))
-    sheet = contact_sheet(outdir, cands, os.path.join(ldir, 'contact-sheet.png'))
+    # 进包的资产必须全部上联系表。BRIEF 让 L 层「看联系表确认 logo / 封面归属」，
+    # 表上没有的东西它只会从表里另挑一张顶上去。封面主视觉按定义只出现在封面那一页
+    # （n=1），按出现次数排序时排在最末——实测被 cands[:12] 截掉，模型于是把 bg-cover
+    # 换成了已经在用的内容页背景，封面与内容页字节相同，封面主视觉整个丢失。
+    decided_c = sorted([a['src'] for a in assets], key=lambda c: (-c['n'], c['file']))
+    other_c = sorted([c for c, _ in rejected], key=lambda c: (-c['n'], c['file']))
+    cands, seen_file = [], set()
+    for c in decided_c + other_c:            # 同一张图可能有多条候选记录（不同位置各一条）
+        if c['file'] not in seen_file:
+            seen_file.add(c['file'])
+            cands.append(c)
+    # 表列全部候选，拼版图只拼前几张：两者成本差着数量级。表是文字，60 行也几乎不占
+    # 上下文，却是模型唯一能知道「存在这张图」的地方——名额砍在这里，被误判成未采纳的
+    # 图连翻案的机会都没有。拼版图是要「看」的，60 格就是 4 列×15 行、降采样后每格
+    # 糊成一团，那个上限才有意义。
+    sheet_items = cands[:max(SHEET_CAP, len(decided_c))]
+    sheet = contact_sheet(outdir, sheet_items, os.path.join(ldir, 'contact-sheet.png'))
     lsheet = layout_sheet(outdir, archetypes, os.path.join(ldir, 'layout-sheet.png'))
 
     anchors = draft_anchors(d, tokens, fonts, roles, assets, archetypes)
@@ -2091,7 +2141,7 @@ def main(argv=None):
     emit_layouts(archetypes, ldir, busy_hints, facts, recipes)
     emit_body(d, tokens, fonts, roles, assets, archetypes, exceptions, cusage, ldir)
     emit_brief(d, (tokens, rest, fonts, roles, assets, rejected, todos, archetypes, cands, sheet,
-                   leftover, lsheet), ldir)
+                   leftover, lsheet, len(sheet_items)), ldir)
 
     # 这几行落在模型判断「skill 是不是做完了」的那一刻。只报数就会被读成「包已生成」，
     # 于是判断和打包整段被跳过，deck 拿不到任何版式坐标。所以这里报进度与下一条命令。

package/steering/design-html/skills/pptx-style-extract/scripts/package.py

@@ -274,6 +274,10 @@ def truthy(v):
     return str(v).strip().lower() in ('1', 'true', 'yes', 'on')
 
 
+# 浏览器能解码的图片格式。落进包的资产必须在此列，否则消费端引用到就是一张空白图。
+WEB_SAFE_EXT = {'png', 'jpg', 'jpeg', 'webp', 'gif', 'svg', 'avif'}
+
+
 def asset_ext(name):
     return name.rsplit('.', 1)[-1].lower() if '.' in name else ''
 
@@ -353,12 +357,25 @@ def place_assets(manifest, extract, stage1, pack):
                 entry['path'] = 'assets/%ss/%s.%s' % (kind, base, cext)
                 if truthy(a.get('use_full')):
                     oext = asset_ext(row['out'])
-                    fdst = os.path.join(sub, '%s@full.%s' % (base, oext))
-                    shutil.copy2(orig_path, fdst)
-                    copied.append(fdst)
-                    entry['full'] = 'assets/%ss/%s@full.%s' % (kind, base, oext)
+                    if oext.lower() in WEB_SAFE_EXT:
+                        fdst = os.path.join(sub, '%s@full.%s' % (base, oext))
+                        shutil.copy2(orig_path, fdst)
+                        copied.append(fdst)
+                        entry['full'] = 'assets/%ss/%s@full.%s' % (kind, base, oext)
+                    else:
+                        # 原图是浏览器不解码的格式（tiff/bmp 之类）。落进包并在 design.md
+                        # 里声明成可用资源，消费端引用它就是一张空白图——实测踩过一次，
+                        # 封面与结束页因此空白。压缩版已经带着全部像素，full 不给。
+                        print('  ⚠ %s 的原图是 .%s，浏览器不解码，只给压缩版' % (aid, oext))
             else:
                 oext = asset_ext(row['out'])
+                if oext.lower() not in WEB_SAFE_EXT:
+                    # 转码两条路（Pillow / sips）都没成，原图又是浏览器不解码的格式。
+                    # 照落进去就是把一张永远显示不出来的图当资产下发——实测封面因此空白。
+                    raise Fail('%s: 原图是 .%s，浏览器不解码，而转码没有产物'
+                               '（extract.json 里看 transcode_blocked 的原因）。'
+                               '装上 Pillow 重跑抽取，或把这条资产从 manifest 删掉'
+                               '并在 gaps 写明。' % (aid, oext))
                 dst = os.path.join(sub, '%s.%s' % (base, oext))
                 shutil.copy2(orig_path, dst)
                 copied.append(dst)