@lark-apaas/coding-steering 0.1.18-dev.21ea0ba → 0.1.18-dev.22911a7

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

@@ -279,18 +279,19 @@ def render_shape(shape, media_url, stats):
 
 HEAD = """<style>
 body{margin:0;background:#2b2b2b;font-family:%s}
-.page{position:relative;width:1920px;height:1080px;overflow:hidden}
+.page{position:relative;width:%dpx;height:%dpx;overflow:hidden}
 .sp{position:absolute;box-sizing:border-box}
 .sp p{margin:0}
 .ph{position:absolute;left:6px;top:4px;font:16px/1.2 monospace;color:#ff2b88;background:#fff9;padding:1px 4px}
 </style>
-""" % CJK_STACK
+"""
 
+# 缩略框跟着画布比例走，缩放比也一起算——写死 16:9 会把非 16:9 模板的页面裁掉一截
 INDEX_EXTRA = """<style>
-.wrap{width:960px;margin:0 auto;padding:16px 0}
+.wrap{width:%dpx;margin:0 auto;padding:16px 0}
 .lbl{color:#eee;font:13px/1.6 monospace;margin:14px 0 4px}
-.box{width:960px;height:540px;overflow:hidden;margin-bottom:6px}
-.box .page{transform:scale(.5);transform-origin:top left}
+.box{width:%dpx;height:%dpx;overflow:hidden;margin-bottom:6px}
+.box .page{transform:scale(%g);transform-origin:top left}
 </style>
 """
 
@@ -508,7 +509,8 @@ def render_pages_png(pages, outdir, data, scale=0.5):
                    for m in data.get('media') or [] if m.get('exported') and m.get('out')}
     png_dir = os.path.join(outdir, 'ref', 'rebuild', 'png')
     os.makedirs(png_dir, exist_ok=True)
-    W, H = int(1920 * scale), int(1080 * scale)
+    cpx = ((data.get('canvas') or {}).get('px') or [1920, 1080])
+    W, H = int(cpx[0] * scale), int(cpx[1] * scale)
     for kind, n, label, layers, default_color, page_bg in pages:
         canvas = Image.new('RGBA', (W, H), _rgba(page_bg) or (136, 136, 136, 255))
         g = _grad_stops(page_bg or '')
@@ -642,15 +644,19 @@ def main():
                           tx1_of_master.get(master, '#000000'),
                           layout_bg.get(part, '#888')))
 
-    if only is not None:
-        pages = [p for p in pages if p[0] != 'slide' or p[1] in only]
+    if only is not None:      # 对样张和版式一律生效（form=3 的代表页是版式，不是样张）
+        pages = [p for p in pages if p[1] in only]
 
     stats = {'shapes': 0, 'text': 0, 'img_ok': 0, 'img_missing': 0, 'no_box': 0}
-    index = [HEAD, INDEX_EXTRA, '<div class="wrap">']
+    cw, ch = ((data.get('canvas') or {}).get('px') or [1920, 1080])[:2]
+    head = HEAD % (CJK_STACK, cw, ch)   # 视口跟画布走，非 16:9 模板不能按 1920x1080 裁
+    thumb_scale = 960.0 / cw
+    index = [head, INDEX_EXTRA % (960, 960, round(ch * thumb_scale), thumb_scale),
+             '<div class="wrap">']
     for kind, n, label, layers, default_color, page_bg in (() if args.no_html else pages):
         html = page_html(layers, default_color, page_bg, media_url, stats)
         with open(os.path.join(rebuild, '%s-%d.html' % (kind, n)), 'w', encoding='utf-8') as f:
-            f.write(HEAD + html)
+            f.write(head + html)
         index += ['<div class="lbl">%s</div>' % esc(label),
                   '<div class="box">%s</div>' % html]
     index.append('</div>')

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

@@ -0,0 +1,57 @@
+#!/usr/bin/env python3
+"""Focused regression tests for deterministic picture compositing."""
+import io
+import os
+import sys
+import unittest
+
+from PIL import Image
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from extract import _draw_picture  # noqa: E402
+
+
+class _Archive:
+    def __init__(self, media, raw):
+        self.names = {media}
+        self.zip = self
+        self.raw = raw
+
+    def read(self, media):
+        if media not in self.names:
+            raise KeyError(media)
+        return self.raw
+
+
+def _png(pixels):
+    image = Image.new('RGBA', (len(pixels), 1))
+    image.putdata(pixels)
+    output = io.BytesIO()
+    image.save(output, 'PNG')
+    return output.getvalue()
+
+
+class BackgroundCompositeTest(unittest.TestCase):
+    def test_applies_flip_and_opacity_once(self):
+        media = 'ppt/media/source.png'
+        package = _Archive(media, _png([(255, 0, 0, 255), (0, 0, 255, 255)]))
+        canvas = Image.new('RGBA', (2, 1), (255, 255, 255, 255))
+
+        drawn = _draw_picture(canvas, {
+            'media': media,
+            'box_unrotated': {'x': 0, 'y': 0, 'w': 2, 'h': 1},
+            'flipH': True,
+            'opacity': 0.5,
+        }, package)
+
+        self.assertTrue(drawn)
+        left, right = canvas.getpixel((0, 0)), canvas.getpixel((1, 0))
+        self.assertEqual(left[:3], (128, 128, 255))
+        self.assertEqual(right[:3], (255, 128, 128))
+        self.assertEqual(left[3], 255)
+        self.assertEqual(right[3], 255)
+
+
+if __name__ == '__main__':
+    unittest.main()

package/steering/design-html/skills/pptx-style-extract/v2-format-spec.md

@@ -16,7 +16,7 @@
 
 - 消费方直接读 design.md，靠目录约定找 sidecar 与资产；frontmatter `path` 是唯一文件引用点。
 - manifest（`manifest.json`，识别靠内部 `schemaVersion` 字面量不靠文件名）服务存储、索引、校验和迁移；消费模型不需要读它。
-- `ref/` 是包内可剥离子目录：抽取产出必含（check_v2 不校验其存在性，归位是打包步骤的责任），入库/下发时链路剥离，不进消费上下文。
+- `ref/` 只放 `audit.yaml`（数值出处的人工复核记录，几 KB）。频次原表、聚类原始数据、`extract.json`、重建图、logo 候选图**留在抽取工作目录，不进交付包**——原设计是「下发时链路剥离」，但链路上没有环节真的做剥离，审计材料会连带进消费上下文并占掉包体的大头。
 
 ## 1. design.md frontmatter 新增键
 
@@ -53,10 +53,10 @@ canvas: 1920x1080      # layouts.md 首键；px = round(EMU / sldSz_cx * 1920)
 themes: [dark, light]
 default-theme: dark            # 双主题包必填（V2-13）
 colors:                        # v1 单层扁平，主题进 token 名
-  dark-surface: "#0A0E1E"
-  dark-on-surface: "#FFFFFF"
-  light-surface: "#FFFFFF"
-  primary: "#3C7FFF"           # 共用色不加前缀
+  dark-surface: "#RRGGBB"
+  dark-on-surface: "#RRGGBB"
+  light-surface: "#RRGGBB"
+  primary: "#RRGGBB"           # 共用色不加前缀
 ```
 
 - token 前缀约定（`dark-X`/`light-X` = 主题专属，无前缀 = 共用）在 `## Usage` 里向消费者写一句；主题机制溯源（clrMap 反转等）落 `ref/audit.yaml`。
@@ -65,7 +65,7 @@ colors:                        # v1 单层扁平，主题进 token 名
 
 ### 1.3 排除色
 
-- **排除色进 `## Hard Rules` 带证据计数**，正向给替代（如「`#FBAE40` 为编辑器参考线色（出现 72 次），非设计色」）。频次原表与 color-confidence 证据进 `ref/`。
+- **排除色进 `## Hard Rules` 带证据计数**，正向给替代（如「`<hex>` 为编辑器参考线色（出现 <N> 次），非设计色」）。频次原表与 color-confidence 证据进 `ref/`。
 - 排除色断言必须以**解析后频次**为准，`styleRef` 主题兜底引用（不渲染）与真实设计用色分开。
 
 ## 2. `assets` 段
@@ -84,7 +84,7 @@ assets:
     kind: background
     role: cover                # cover | content | section | closing | accent
     theme: dark
-    recipe: "linear-gradient(135deg, #0A0E1E 0%, #12204A 100%)"   # 可选：CSS 重绘配方
+    recipe: "linear-gradient(<angle>, <color> 0%, <color> 100%)"   # 可选：CSS 重绘配方
   bg-content-solid:            # 纯色背景：无 path/url，引 colors token
     kind: background
     role: content
@@ -123,13 +123,16 @@ layouts:
     themes: [dark, light]      # 深浅孪生合并
     background: {dark: bg-cover-dark, light: bg-cover-light}
     slots:
-      - {role: title, box: [110, 340, 970, 160], type: title}
-      - {role: logo,  box: [120, 121, 235, 74], asset: {dark: logo-on-dark, light: logo-on-light}}
+      - {role: title, box: [<x>, <y>, <w>, <h>], type: title}
+      - {role: logo,  box: [<x>, <y>, <w>, <h>], asset: {dark: logo-on-dark, light: logo-on-light}}
+    decor:
+      - {box: [<x>, <y>, <w>, <h>], geom: ellipse, css: "<CSS 声明串>"}
     confidence: high
 ```
 
 - **`background` 三形态**：`<asset-id>` / `{<theme>: <asset-id>}` / `{color: <colors-token>}`（`color` 是保留键，主题名禁止叫 color）。`asset` 两形态：`<asset-id>` / `{<theme>: <asset-id>}`。
 - **背景安全扩展**：有真实背景图的 archetype 建议写 `text_safe: [x,y,w,h]`、`avoid: [{box: [x,y,w,h], reason: "..."}]`、`pairing_rule: "..."`。这些是消费约束，不参与封闭枚举；用于避免标题、正文、图表、卡片、表格、时间线及其容器外接矩形覆盖背景视觉主体、强光斑或深色透明区；透明容器也不能跨进禁放区。
+- **`decor`（可选）**：这一页无文字的图形骨架——图标托底的圆、卡片、分隔线。每条 `{box, geom, css}`：`box` 定位，`css` 是可直接写进 style 的声明串，`geom` 取源形状的 prst（`ellipse` 另加 `border-radius: 50%`）。层级在背景之上、`slots` 之下；带 `asset` 的槽落在 decor 之上是版式本意，不算重叠。
 - **`type` 封闭枚举**：`title | subtitle | body | pic | table | chart | media | slide-number | footer`。大数字/序号走 `type: title`，语义由 `role`（如 `big-number`）承担。
 - **`slots.*.role` 开放不校验**（语义槽位）：优先复用已知词表（OOXML ST_SlideLayoutType / Slidev 20 布局 / Google PredefinedLayout，如 big-number、caption、main-point），确无对应再自造。
 - archetype ≤15（内联降级形态 ≤11）；深浅孪生合并为一条；版式溯源/母版取舍进 `ref/`。
@@ -139,14 +142,14 @@ layouts:
 
 ```yaml
 safe-area:                     # 开放命名 map，可多套边距体系
-  content:    {top: 214, right: 133, bottom: 77, left: 133, applies-to: [content, quote]}
-  editorial:  {left: 120, right: 120, applies-to: [cover, section, closing]}
+  content:    {top: <px>, right: <px>, bottom: <px>, left: <px>, applies-to: [content, quote]}
+  editorial:  {left: <px>, right: <px>, applies-to: [cover, section, closing]}
   confidence: medium
 ```
 
 冲突裁决：`slots.box` 是实例真值，`safe-area` 是归纳框架，**以 slots.box 为准**。
 
-## 5. check_v2 校验（16 行：V2-1..V2-13 + V2-R5/R6/R7）
+## 5. check_v2 校验（18 行：V2-1..V2-15 + V2-R5/R6/R7）
 
 check_v1 全部规则原样生效。扫描范围 = 包目录，V2-1/V2-2 跨 design.md + layouts.md 求并集。
 
@@ -165,6 +168,8 @@ check_v1 全部规则原样生效。扫描范围 = 包目录，V2-1/V2-2 跨 des
 | V2-11 | 键名命中 YAML 1.1 布尔字面量 | FAIL |
 | V2-12 | `path`/`url`/`color` 恰好存在一个；`color` 仅 background 允许；`full` 仅可伴随 `path` | FAIL |
 | V2-13 | 多主题（`themes` 长度 >1）缺 `default-theme`（只看 design.md frontmatter——冲突以 design.md 为准） | WARN |
+| V2-14 | 版式的 `flow` 与 `slots` 互斥（同时出现 = FAIL）；`flow.regions[].kind` 在 `grid`/`stack`/`free` 内，`grid` 必带 `cols` | FAIL |
+| V2-15 | 同段字段自洽：`backgrounds.*` 的 `text_safe` 不得与任一 `avoid` 相交；两者形态须为 `[x, y, w, h]` 四个数且 w/h 为正 | FAIL |
 | V2-R5 | sidecar frontmatter 重复 design.md 已有顶层键（`layouts` 载荷键与 `canvas` 除外——canvas 的家就在 sidecar） | WARN |
 | V2-R6 | assets 条目出现审计字段（boxes/aspect/mark/confidence）或 design.md 顶层出现 canvas/canvas-source/theme-mechanism/color-confidence——应移 `ref/audit.yaml` / layouts.md | WARN |
 | V2-R7 | 有 layouts sidecar 指针但正文未出现 `layouts.md` 字样（弱指针，消费者到不了版式数据） | WARN |

package/steering/design-html/skills/slide-deck/SKILL.md

@@ -19,10 +19,9 @@ metadata:
 
 ## PPTX/POTX 模板附件前置步骤
 
-如果用户上传了 `.pptx` 或 `.potx`，并要求制作/生成/改做一个 PPT、演示文稿、slides、deck，先判断附件是否是模板或视觉参考。
+如果对话里出现 `.pptx` 或 `.potx` 附件，并且当前任务是制作/生成/改做一个 PPT、演示文稿、slides、deck，**默认附件就是模板或视觉参考，先运行 `pptx-style-extract` skill**，读取产出的 `design.md`、`layouts.md` 和 `assets/`，再开始写 deck。不需要等用户再说“按这个模板”。
 
-- 命中“按这个模板 / 照附件风格 / 参考这个 PPT / 保持同款视觉 / 基于这个模板”等意图时，先调用 `pptx-style-extract` skill，读取产出的 `design.md`、`layouts.md` 和 `assets/`，再开始写 deck。
-- 只总结、翻译、提取内容、审阅已有 PPTX 时，不需要抽取风格。
+- 只有用户明确要求只总结、只翻译、只提取内容、只审阅或直接修改已有 PPTX 时，才跳过风格抽取。
 - 不要用 `SummarizeAttachmentOrFile` 的 Markdown/文本摘要替代风格抽取；文本摘要不包含母版、色板、字体、版式坐标和素材角色。
 
 ## 动手前先问
@@ -144,6 +143,21 @@ deck-stage 组件会对每个 slotted 子元素做绝对定位——**绝不**
 5. **把这套 token 当成每页的内容预算**：在上述数值下，一页正文区大约容纳 14 行正文、或 6 个两行 bullet——在 scratchpad 排内容时就按预算裁剪，而不是写完再看塞不塞得下。装不下的处置顺序是**拆页 > 删内容 > 换更省空间的版式**；缩小字号是最后手段，且绝不越过 24px 下限——靠缩字塞进去的页，只是把溢出换成了后排看不清。反过来，内容远少于预算的页按「视觉平衡」的出路增密或合并，而不是放大字号去撑面积。
 6. 构建幻灯片，牢记每张幻灯片既是设计练习也是文案练习。在版式、文字内容和语调方面给予每张幻灯片应有的关注。遵循上述原则，确保每张幻灯片能独立成立；一个只看这一页的人，应当无需其他上下文就能理解其高层含义。
 
+## 提交前资源完整性门禁
+
+最终一次写入 HTML/CSS 后、调用 `run_commit` 前，必须从项目根目录运行：
+
+```bash
+python3 <本skill目录>/scripts/check_local_references.py index.html
+```
+
+把 `<本skill目录>` 换成本 skill 的实际所在目录。脚本从最终 `index.html` 出发，递归检查 HTML/CSS 引用的每个项目内脚本、样式、图片、字体等文件是否真实存在；外部 URL 不做离线探测。
+
+- 只有输出 `RESOURCE_CHECK: PASS` 才能提交。
+- 输出 `RESOURCE_CHECK: FAIL` 时，先重新复制或修正列出的项目内文件，再原样重跑；不得删除引用来掩盖仍在使用的资源。
+- 该检查针对最终工作区状态。较早执行过复制命令或检查，不能证明最终提交完整。
+- `run_commit` 的静态检查跳过参数不能替代本门禁，也不能用来绕过失败；提交时必须包含检查通过所依赖的全部项目内文件。
+
 ## 验证要点
 
 审阅时，用幻灯片构图规则——而非网页布局直觉——来检查版面。底部留白是不是缺陷，用「留白 ≠ 空洞」的归属判据：内容自身完整、下方是无边框的整块呼吸空间，这是正确的幻灯片构图——不要出于网页直觉把 `flex-start` 改成 `center`；空白被元素边界圈占的，是被动空洞，按「视觉平衡」的出路修。

package/steering/design-html/skills/slide-deck/scripts/check_local_references.py

@@ -0,0 +1,179 @@
+#!/usr/bin/env python3
+
+import re
+import sys
+from html.parser import HTMLParser
+from pathlib import Path
+from urllib.parse import unquote, urlsplit
+
+
+CSS_URL_PATTERN = re.compile(r"""url\(\s*(['"]?)(.*?)\1\s*\)""", re.IGNORECASE)
+CSS_IMPORT_PATTERN = re.compile(
+    r"""@import\s+(?:url\(\s*)?(['"])(.*?)\1\s*\)?""",
+    re.IGNORECASE,
+)
+CSS_COMMENT_PATTERN = re.compile(r"/\*.*?\*/", re.DOTALL)
+HREF_RESOURCE_TAGS = {"image", "link", "use"}
+SRC_RESOURCE_TAGS = {
+    "audio",
+    "embed",
+    "iframe",
+    "img",
+    "input",
+    "script",
+    "source",
+    "track",
+    "video",
+}
+
+
+class ReferenceParser(HTMLParser):
+    def __init__(self) -> None:
+        super().__init__()
+        self.references: set[str] = set()
+        self.in_style = False
+
+    def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
+        tag = tag.lower()
+        if tag == "style":
+            self.in_style = True
+        attributes = dict(attrs)
+        if tag in HREF_RESOURCE_TAGS and attributes.get("href"):
+            self.references.add(attributes["href"])
+        if tag in SRC_RESOURCE_TAGS and attributes.get("src"):
+            self.references.add(attributes["src"])
+        if tag == "object" and attributes.get("data"):
+            self.references.add(attributes["data"])
+        if tag == "video" and attributes.get("poster"):
+            self.references.add(attributes["poster"])
+
+        srcset = attributes.get("srcset")
+        if tag in {"img", "source"} and srcset:
+            self.references.update(
+                candidate.strip().split()[0]
+                for candidate in srcset.split(",")
+                if candidate.strip()
+            )
+
+        style = attributes.get("style")
+        if style:
+            self.references.update(css_references(style))
+
+    def handle_endtag(self, tag: str) -> None:
+        if tag.lower() == "style":
+            self.in_style = False
+
+    def handle_data(self, data: str) -> None:
+        if self.in_style:
+            self.references.update(css_references(data))
+
+
+def css_references(content: str) -> set[str]:
+    content_without_comments = CSS_COMMENT_PATTERN.sub("", content)
+    references = {
+        match.group(2).strip() for match in CSS_URL_PATTERN.finditer(content_without_comments)
+    }
+    references.update(
+        match.group(2).strip() for match in CSS_IMPORT_PATTERN.finditer(content_without_comments)
+    )
+    return references
+
+
+def resolve_local_reference(
+    raw_reference: str,
+    source: Path,
+    project_root: Path,
+) -> Path | None:
+    reference = raw_reference.strip()
+    parsed = urlsplit(reference)
+    if (
+        not reference
+        or reference.startswith(("#", "//"))
+        or (parsed.scheme and parsed.scheme.lower() != "file")
+        or parsed.netloc
+    ):
+        return None
+
+    path_text = unquote(parsed.path)
+    if not path_text:
+        return None
+
+    if parsed.scheme.lower() == "file":
+        return Path(path_text).resolve()
+    if path_text.startswith("/"):
+        return (project_root / path_text.lstrip("/")).resolve()
+    return (source.parent / path_text).resolve()
+
+
+def collect_references(entry: Path, project_root: Path) -> list[tuple[Path, str, Path]]:
+    pending = [entry]
+    visited: set[Path] = set()
+    local_references: list[tuple[Path, str, Path]] = []
+
+    while pending:
+        source = pending.pop()
+        if source in visited or not source.is_file():
+            continue
+        visited.add(source)
+
+        content = source.read_text(encoding="utf-8")
+        if source.suffix.lower() == ".css":
+            references = css_references(content)
+        else:
+            parser = ReferenceParser()
+            parser.feed(content)
+            references = parser.references
+
+        for raw_reference in sorted(references):
+            target = resolve_local_reference(raw_reference, source, project_root)
+            if target is None:
+                continue
+            local_references.append((source, raw_reference, target))
+            if target.suffix.lower() == ".css" and target.is_file():
+                pending.append(target)
+
+    return local_references
+
+
+def display_path(path: Path, project_root: Path) -> str:
+    try:
+        return path.relative_to(project_root).as_posix()
+    except ValueError:
+        return str(path)
+
+
+def main() -> int:
+    if len(sys.argv) != 2:
+        print("usage: check_local_references.py <entry.html>", file=sys.stderr)
+        return 2
+
+    project_root = Path.cwd().resolve()
+    entry = (project_root / sys.argv[1]).resolve()
+    if not entry.is_file():
+        print(f"RESOURCE_CHECK: FAIL entryNotFound={sys.argv[1]}")
+        return 1
+
+    missing: list[tuple[Path, str, Path]] = []
+    for source, raw_reference, target in collect_references(entry, project_root):
+        try:
+            target.relative_to(project_root)
+        except ValueError:
+            missing.append((source, raw_reference, target))
+            continue
+        if not target.is_file():
+            missing.append((source, raw_reference, target))
+
+    if not missing:
+        print("RESOURCE_CHECK: PASS")
+        return 0
+
+    print(f"RESOURCE_CHECK: FAIL missingLocalReferences={len(missing)}")
+    for source, raw_reference, target in missing:
+        source_name = display_path(source, project_root)
+        target_name = display_path(target, project_root)
+        print(f"- {source_name}: {raw_reference} -> {target_name}")
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())