@taloswork/ose-shared 0.1.10 → 0.1.12

package/skills/document/theme-system.md

@@ -1,102 +1,110 @@
 # Theme V2 — composable deck design system
 
-Theme V2 separates five decisions that the old pack model coupled together:
+This file is the single source for **which entries take Theme V2, what it adds, and
+the spec fields that control it**. Theme V2 separates five decisions:
 
 1. **Theme** (`style`) — palette, typography, background and family identity.
-2. **Component profile** — cards, metrics, pricing, quotes, tables, badges and data UI.
-3. **Media style** — product/device, editorial photo, collage, illustration or cinematic treatment.
-4. **Art direction** — large color fields, pattern language, decorative geometry and page atmosphere.
-5. **Layout + recipe** — content geometry per slide and narrative order per deck.
-
-`theme-system.json` binds every existing catalog id to one component profile, one
-default media style and one art direction. A deck can override only the media treatment;
-art direction remains part of the Theme identity and layout selection stays separate.
-
-Component profiles: `clean`, `glass`, `editorial`, `poster`, `organic`, `luxury`.
-They alter radius, border weight, depth, surface behavior, label typography and emphasis
-patterns across the full semantic component contract (cards, KPI, proof, pricing, quote,
-table, chart, workflow, funding and CTA).
-
-Media styles: `clean-product`, `device-stage`, `editorial-photo`, `cutout-collage`,
-`illustrated`, `cinematic`, `spatial-3d`. They can be changed independently for a deck or
-a bespoke page while the Theme's color, type, background and component grammar remain.
-
-Art directions: `geometric-pop`, `gradient-mesh`, `editorial-cut`, `collage-paper`,
-`illustrated-doodle`, `cinematic-depth`, `luxury-ornament`, `technical-grid`,
-`maximalist-blocks`. The renderer injects a decoration-only backdrop canvas for these
-profiles. Each uses the selected family's full `--c1`…`--c4` ramp rather than only its
-accent, so Theme differences include composition and motif—not merely hue.
+2. **Component profile** — `clean` · `glass` · `editorial` · `poster` · `organic` ·
+   `luxury`: radius, border weight, depth, surfaces, labels and emphasis across the
+   semantic components (cards, KPI, proof, pricing, quote, table, chart, workflow,
+   funding, CTA).
+3. **Media style** — `clean-product` · `device-stage` · `editorial-photo` ·
+   `cutout-collage` · `illustrated` · `cinematic` · `spatial-3d`. The only layer a deck
+   may override (`mediaStyle` / `--media-style`); colour, type, background and component
+   grammar stay the Theme's.
+4. **Art direction** — `geometric-pop` · `gradient-mesh` · `editorial-cut` ·
+   `collage-paper` · `illustrated-doodle` · `cinematic-depth` · `luxury-ornament` ·
+   `technical-grid` · `maximalist-blocks`: a decoration-only backdrop canvas that uses
+   the family's whole `--c1`…`--c4` ramp. Part of the Theme identity — not overridable.
+5. **Layout + recipe** — content geometry per slide (layouts/README.md) and narrative
+   order per deck (`recipes/`). Never chosen by the Theme.
+
+`theme-system.json` binds every catalog id to one component profile, one default media
+style and one art direction.
+
+## Which entries take it — classic-v1 vs V2
+
+- Entries in a `catalog.json` collection with `renderMode:"classic-v1"` (today
+  `original-13`, frozen at commit `7306d8e5`; its `entryIds` are the list) render V1: omit `themeVersion`, `mediaStyle`, `decorRhythm`, per-slide
+  `scene`/`decorDensity` and every layout in `layouts/profiles.json.themeV2Layouts`;
+  render with `--style <id>` and never `--theme-v2`. `deck-build` (exit 64) and
+  `html2pptx` reject the attempt. They keep current bug/font/contrast fixes; samples and
+  fidelity baselines are V1.
+- Every other newly authored deck sets `"themeVersion":2` and renders with
+  `--style <id> --theme-v2 [--media-style <id>]`. `--theme-v2` needs a catalog id
+  (not an explicit style directory or a user style); `--media-style` needs `--theme-v2`.
+- The ten `themeV2Layouts` use the semantic component contract and require
+  `themeVersion:2`; every older layout works in both. `themeVersion:2` never changes
+  which layout a slide uses.
+- Under `--theme-v2` html2pptx does not auto-pick a shared backdrop variant (the art
+  direction owns the backdrop); an explicit `--backdrop` still wins.
 
 ## Page scenes and deck rhythm
 
-`deck-build` maps each slide intent to one visual scene: `hero`, `content`, `data`,
-`media` or `closing`. The scene controls which art-direction motifs remain visible;
-`decorDensity` (`low`, `medium`, `high`) controls their combined intensity. With the
-default `decorRhythm:"auto"`, adjacent high-intensity pages are softened, long medium
-runs receive a low beat, and repeated scenes cycle deterministic motif variants.
-
-Authors normally provide only `intent`. Use a per-slide `scene` or `decorDensity` only
-for a deliberate override. Set top-level `decorRhythm:"steady"` to keep the intent
-profile's density unchanged. These fields require `themeVersion:2` and never select or
-rewrite a layout.
+`deck-build` maps each slide's `intent` to one scene — `hero`, `content`, `data`,
+`media` or `closing` — which decides the art-direction motifs shown; `decorDensity`
+(`low`/`medium`/`high`) sets their intensity. With the default `decorRhythm:"auto"`,
+adjacent high-intensity pages are softened, long medium runs get a low beat and
+repeated scenes cycle motif variants. Normally give only `intent`; a per-slide `scene`
+or `decorDensity` is a deliberate override, and top-level `decorRhythm:"steady"` keeps
+each intent's density. These fields require `themeVersion:2` and never pick a layout.
 
 ```json
 {
-  "style": "cool",
+  "style": "neon-cyber",
   "scenario": "发布会",
   "themeVersion": 2,
-  "decorRhythm": "auto",
   "mediaStyle": "device-stage",
   "layoutPack": "none",
   "slides": [
-    {"intent":"problem", "layout":"pitch-problem", "slots":{}},
-    {"intent":"product-demo", "layout":"product-device", "slots":{}}
+    {"intent": "problem", "layout": "pitch-problem", "slots": {
+      "eyebrow": "THE PROBLEM", "title": "对账每月吃掉财务团队一周", "stat": "38h", "stat_label": "每月人工对账", "stat_note": "50 家受访客户中位数",
+      "point1_title": "数据分散", "point1_body": "银行、ERP、表格三处来源",
+      "point2_title": "规则靠人记", "point2_body": "例外处理无沉淀",
+      "point3_title": "出错难追溯", "point3_body": "审计时逐笔翻查",
+      "footer": "", "pageno": ""}},
+    {"intent": "product-demo", "layout": "product-device", "slots": {
+      "eyebrow": "PRODUCT", "title": "一键完成三方对账", "body": "接入银行流水与 ERP，规则自动匹配，例外进入待办",
+      "feature1": "自动匹配 95% 流水", "feature2": "例外一键分派", "feature3": "全程留痕可审计",
+      "media_label": "", "screen_title": "对账工作台", "screen_note": "",
+      "footer": "", "pageno": ""}}
   ]
 }
 ```
 
-`deck-build` emits the matching render command:
+Every slot is filled (`""` blanks one on purpose): an omitted slot renders the layout's
+demo copy and `deck-build` warns. The build result's `next` is the matching render
+command:
 
 ```sh
-html2pptx deck.html out.pptx --style cool --theme-v2 --media-style device-stage
+html2pptx deck.html out.pptx --style neon-cyber --theme-v2 --media-style device-stage
 ```
 
+## Layout selection and packs
+
+Match content to layouts through `layouts/profiles.json` (intent → candidates, density,
+item cap, media requirement) — `deck-plan` does it for you. `deck-build` warns when an
+explicit layout is outside the intent's candidates and errors on an unknown intent.
+
+`layoutPack` is independent of the Theme. `kind:"pack"` entries (`packs/README.md`)
+ship same-name signature layouts: a spec that omits `layoutPack` keeps the legacy
+behaviour (a pack style implicitly uses them); new specs state `layoutPack:"<pack>"`
+or `"none"` (shared layouts only).
+
+`recipes/` hold pitch narratives as roles, not fixed pages, so one story renders in
+any Theme.
+
 ## Compatibility
 
-- Existing `{style:"cool"}` specs and `html2pptx --style cool` calls remain V1 and
-  render exactly as before.
-- `catalog.json` collection `original-13` freezes the initial roster at commit
-  `7306d8e5` with `renderMode:"classic-v1"`. Those entries keep current bug/font/contrast
-  fixes but reject `themeVersion:2`, `--theme-v2`, media overrides, scene controls and
-  Theme V2-only layouts. Their samples and fidelity cover baselines are rendered in V1.
-- `themeVersion:2` adds component, media and art-direction layers; it does not change
-  the selected layout.
-- Existing `{style:"press-room"}` keeps the legacy implicit same-name layout pack.
-  New specs should state `layoutPack:"press-room"` or `layoutPack:"none"` explicitly.
-- `--theme <theme.json>` is a different legacy document recolor path and is not Theme V2.
-
-## Content-first layout selection
-
-Use `layouts/profiles.json`. Match `intent`, then check density, item capacity and media
-requirement before selecting a candidate. `deck-build` warns when a slide's explicit
-layout is outside the candidate list and errors on unknown intents. It never forces a
-layout merely because a visual Theme was selected.
-
-The ten layouts listed in `themeV2Layouts` use the new semantic component contract and
-therefore require `themeVersion:2`; `deck-build` rejects a V1 attempt before writing HTML.
-All pre-existing layouts remain valid in both V1 and V2.
-
-Pitch recipes live in `recipes/`. They describe narrative roles, not fixed visual pages,
-so the same fundraising story can render in a clean consulting Theme, neon product Theme
-or editorial Theme without changing its content contract.
-
-## Coverage and provenance
-
-The 18 pitch intents cover problem, solution, product, market, competition, business
-model, pricing, traction, go-to-market, economics, financials, proof, team, ask and close.
-The visual archetypes are clean-room abstractions informed by broad category patterns,
-including the SlidesCarnival pitch-deck index: geometric color fields, gradient/3D depth,
-editorial cropping, paper collage, illustration/doodles, ornament, grids and maximalist
-blocks. Do not copy third-party template assets or page geometry. SlidesCarnival templates
-are CC BY 4.0 and embedded photos may carry separate licenses; importing an actual template
-requires preserving attribution and asset credits.
+- `{style:"<id>"}` without `themeVersion`, and `html2pptx --style <id>` without
+  `--theme-v2`, stay V1 and render exactly as before.
+- `--theme <theme.json>` is the legacy document-recolor path, not Theme V2, and it does
+  not repaint a `--style` deck (the skin's tokens win).
+
+## Provenance
+
+The 18 pitch intents (problem … ask, close) and the visual archetypes are clean-room
+abstractions of broad category patterns (incl. the SlidesCarnival index). Do not copy
+third-party template assets or page geometry; SlidesCarnival templates are CC BY 4.0
+and their photos may carry separate licenses — importing one requires keeping
+attribution and asset credits.

package/skills/document/themes/README.md

@@ -9,14 +9,14 @@
 
 | 主题 | 配对家族 | 基调 | 适用场景 |
 |---|---|---|---|
-| **cool-tech**（默认） | `cool` | 深海军蓝 + 蓝青辉光(深色 deck) | 科技/发布/pitch/keynote —— 默认酷炫 |
+| **cool-tech** | `cool` | 深海军蓝 + 蓝青辉光(深色 deck) | 科技/发布/pitch/keynote |
 | **apple-keynote** | `apple` | 纯黑 + 单色近白(深色 deck) | 产品发布、keynote、极简演示:超大字、大留白、无彩色 |
 | **mckinsey-consulting** | `mckinsey` | 白底 + 深藏青 + 克制亮蓝 | 咨询/战略汇报、评审、董事会;**报告/docx 默认** |
 | **anthropic-clay** | `anthropic` | 奶油底 + 赤陶珊瑚(暖) | AI/产品、温暖人文品牌、研究分享:衬线标题、有深度 |
 | **black-gold** | `black-gold` | 纯黑 + 金辉光 + 衬线金字 | 金融/年报/路演/奢侈品/高端商务 |
 | **hand-drawn** | `hand-drawn` | 纸感 + 手绘描边 + 马克笔色 | 创意/头脑风暴/教学/工作坊 |
 | **mono** | `mono` | 纯白 + 黑灰 + 细线 + 大留白 | 极简/高端/设计;**clean/light 默认** |
-| **warm-editorial** | `warm` | 奶油 + 陶土橙 + 衬线 | 品牌/咨询/报告暖调 |
+| **warm-editorial** | —(无同名 deck 风格) | 奶油 + 陶土橙 + 衬线 | 品牌/咨询/报告暖调 |
 | **ivory-gold** | `ivory-gold` | 奶油底 + 青铜金 Anton 粗体大写标题 + 黑色反色区块 | 奢华极简/品牌手册/路演/高端零售 |
 | **cinereel** | `cinereel` | 黑底/照片底 + 白色 Anton 粗体大写(无色相)+ 常驻胶片取景框 | 影视/创意作品集/音乐传媒行业/幕后花絮 |
 | **magazine-ink** | `magazine-ink` | 瓷白底 + 靛蓝 Noto Serif SC 衬线大标题 + 无阴影无卡片盒 | 人文分享/行业观察/商业发布/杂志感演讲 |
@@ -26,9 +26,11 @@
 白纸 + 品牌色标题。具名"风格"主题只设 `fonts.heading`(Latin 标题生效、CJK 自动回退,
 正文留空走引擎栈保 CJK)。
 
-**用户自建主题放 `themes/custom/`**(资源更新永不触碰;选型时优先查它),文件名
-kebab-case、带 `bestFor`。确认过的偏好写入 agent memory,下次直接用(见 rewrite.md
-"Picking a theme")。
+**用户自建主题保存到 `$TALOS_DOC_STYLES_DIR/themes/<名>.json`**(kebab-case、带
+`bestFor`),之后用 `--theme <名>` 按名字套用。这是用户自己的风格目录,跨会话保留、所有
+专家共用;**不要写进 skill 目录**——它是带完整性校验的安装包,内容一变就会被隔离重装,
+写进去的文件随之丢失。确认过的偏好写入 agent memory,下次直接用(见 rewrite.md
+"Themes" 的 Choosing with the user)。
 
 > 更多纯配色变体(arctic-frost / ocean-depths / golden-hour / chinese-ink 等 17 套)已
 > **退役到 `apps/admin/data/deck-template-backup/retired-themes/`** —— 它们只是同布局换色,

package/skills/document/vision.md

@@ -6,8 +6,9 @@ loses.
 
 ## Steps
 
-1. `bin/pdf-render file.pdf <pages>` — `<pages>` is a single page (`4`) or a
-   range (`2-6`). It writes PNGs and prints their paths.
+1. `bin/pdf-render.cjs file.pdf <pages> [scale]` — `<pages>` is `4`, `2-6`, `3,7-8`
+   or `all`; PNGs land beside the PDF (`<stem>_p<N>.png`) and their paths are printed.
+   Keep the default scale `2` for formulas and fine print; `1` is enough for layout.
 2. Look at each PNG. For:
    - **Formulas** → transcribe to LaTeX from the image.
    - **Tables** → read the table structure directly; report values row/column.
@@ -25,9 +26,11 @@ render that page here and read it visually instead.
 When the model has **no** image modality but the page is scanned, OCR the raster
 instead of guessing:
 
-1. `bin/pdf-render file.pdf <page>` → PNG.
-2. `bin/ocr <page.png> [lang]` → `{ text, confidence }`. Report low confidence
-   honestly. Set `$TALOS_TESSDATA` to a dir to cache/serve language data offline.
+1. `bin/pdf-render.cjs file.pdf <page>` → PNG.
+2. `bin/ocr.cjs <page.png> [lang]` → `{ text, confidence }` (`lang` default `eng`).
+   Report low confidence honestly. Chinese: `chi_sim` (or `chi_sim+eng` for mixed
+   text; `chi_tra` traditional). `eng` and `chi_sim` are bundled and work offline;
+   other languages download once into `$TALOS_TESSDATA`.
 
 Prefer vision when it is available — OCR loses layout and struggles with
 formulas. Use OCR only as the text-only fallback.

package/skills/document/xlsx.md

@@ -7,7 +7,7 @@ files.
 ## Steps
 
 1. `bin/xlsx-query file.xlsx --summary` → per-sheet shape (name, row/col counts,
-   headers). Decide which sheet + column the question is about.
+   `headerRow`, headers). Decide which sheet + column the question is about.
 2. Aggregate: `bin/xlsx-query file.xlsx --agg <sheet> <column> <op>` where `op` ∈
    `sum | avg | min | max | count | count-nonempty`. `<column>` may be a header
    label or a 1-based index.
@@ -16,31 +16,21 @@ files.
 
 ## Notes / boundaries
 
-- Non-numeric cells are ignored by `sum/avg/min/max`; `value:null` means no
-  numeric cells qualified — report that rather than guessing 0.
+- The header row is detected: the first mostly-text row (of the first ~10) whose next
+  row has numbers, so a title row above the table is skipped — check `headerRow`;
+  `--header-row N` (1-based sheet row) overrides it.
+- `--agg` leaves total rows out — a cell reading 合计 / 总计 / 小计 / Total / Subtotal /
+  Sum, or a `SUM` over the same column — and lists them in `excludedRows`;
+  `--include-totals` keeps them.
+- Numbers: numeric cells use their stored value (a cell shown as `15%` is 0.15). In
+  text cells `¥ ￥ $ € £`, commas, spaces and a trailing `元` are stripped; `15%` → 0.15,
+  `(300)` → −300. Sums/averages are rounded to 15 significant digits (no `0.1+0.2` noise).
+- Non-numeric cells are ignored by `sum/avg/min/max` and listed in `skippedCells`
+  (first 20; `skippedCellCount` is the total); `value:null` means no numeric cells
+  qualified — report that rather than guessing 0.
 - A missing/misnamed column returns `value:null` with `colIdx:-1`; check headers
   first via `--summary`.
-- Currency/percent strings (`$1,200`, `15%`) are coerced to numbers.
 - For pivots or multi-column math beyond these ops, read rows with `--sample`
   and compute in a short script, or ask for the specific cut.
-
-## Writing formulas (the repair loop — mandatory)
-
-When you GENERATE or EDIT a spreadsheet, use live formulas (`"=SUM(A2:A9)"`),
-never precomputed values — the file must recalculate when the user edits data.
-Then close the loop:
-
-1. `bin/xlsx-recalc.cjs out.xlsx out.xlsx` — evaluates every formula and caches
-   results (openpyxl-class writers leave them blank).
-2. The output's `errors` array must be **empty**. Any `#DIV/0!`, `#REF!`, `#N/A`
-   → fix the formula (guard divisors with IF, correct the range) and re-run
-   recalc. **Never deliver a spreadsheet with formula errors**, and never
-   "fix" one by replacing the formula with a hardcoded value.
-
-## Known engine limits (HyperFormula vs LibreOffice recalc)
-
-`xlsx-recalc` covers ~400 functions — all common math/stat/text/date/lookup.
-Known gaps vs a full Excel/LibreOffice engine: some exotic financial functions
-and dynamic-array spilling. If recalc reports `#NAME?` on a function you know is
-valid Excel, that is an engine limit — say so and compute that cell's value via
-`xlsx-query`/script instead of guessing.
+- **Generating or editing** a workbook (formulas, the `xlsx-recalc` repair loop) →
+  rewrite.md "Formulas".

package/skills/cozy-static-svg/SKILL.md

@@ -1,76 +0,0 @@
----
-name: cozy-static-svg
-description: "手工编写纯静态 SVG 插画：柔和渐变、圆润主体、舒适留白，可配温柔短句或贴题的唐宋诗词；色系自由、默认明快。适用于手绘 SVG、静态插画、治愈插画、诗词配图、沿用上次画风、再画一张等请求。"
----
-
-# 温柔静态 SVG 插画
-
-## 使用依据与范围
-
-用户以《月亮替你值夜班》为准，认可这套画风、精细度与制作流程；要求**手写直出原生 SVG、不转 PNG**：以速查表约束画风，以质检脚本守住最后质量。
-
-- 认可原作：`references/moon_keeps_watch.svg`；风格参考：`references/approved-preview.png`。
-- **速查与配方（每幅开画前必读）**：`references/style-anchor.md`。
-- **跨平台速查**：`references/cross-platform.md`（macOS / Windows 命令对照、字体差异、转 PNG、故障对照）。
-- **脚本（两平台共用同一份，不写死绝对路径）**：`scripts/artkit.py` 质检（结构校验＋画风合规报告，秒级，不出图、不转 PNG；文件 / 目录 / 通配符都收，纯标准库）；`scripts/to_png.py` 转 PNG（仅在用户明确要 PNG 时用，跨平台自动挑后端）。
-- 首幅或题材类型首次出现时，可对照原作与风格参考复习一次；之后速查表＋质检即可。
-- 固定的是画风、方法、完成度，不是题材；不要每张重复同一主体、结构或坐标；成批出图按速查表的「题材轮换」主动错开。
-- 拼接已有作品用 image-layout 技能，保持原图，不要用简化重绘冒充。
-- 不改动原作母版；每次新建独立文件。
-
-## 提速工作流（默认按此执行）
-
-1. **一句话定创意**：主体姿态＋环境结构＋主光源位置。用户给了内容就直接用，不追问低风险细节。
-2. **读速查表**：`references/style-anchor.md`（画风、硬底线、题材轮换、配方与清单都在里面）。
-3. **手写整幅 SVG**：一次写全；defs+use 复用重复小元素；落盘前按速查表「开画前自查清单」过一遍。
-4. **一条命令质检**：
-
-   ```bash
-   python3 scripts/artkit.py 作品.svg      # macOS / Linux
-   py -3 scripts\artkit.py 作品.svg        # Windows
-   ```
-
-   参数给目录或通配符即为批量（如 `python3 scripts/artkit.py .`），通配符由脚本自己展开，
-   两个平台写法一致；细节见 `references/cross-platform.md`。
-   报告含结构、圆角裁切、引用、字体、调色清单、文案清单；**无 ✗ 才算过**。不通过就用 edit 精准修复（只动需要动的坐标 / 路径 / 层级），再跑一次；成功报告留着核对文案与调色。
-5. **交付**：`present_file` 直出原生 SVG；预览、脚本不交付。质检报告核对过后，回复里用温柔、贴合画面意境的一两句话介绍这幅画，**严禁输出“质检通过、直出原生 SVG”这类生硬的技术汇报**。
-
-- **成批出图**：先按顺序写完所有 SVG，再用一条命令批量质检（传目录或通配符即可），逐个按报告核对。
-- **不拆子 agent**：画 SVG 全程自己完成，不派子 agent、不并行外发。逐张手写、逐张落盘、最后统一质检；成批也是串行画完再批量质检，不用子 agent 分担画面。
-- **默认不渲染、不转 PNG**：直接交付原生 SVG。
-- 不调用生图模型替代手绘；不把位图包进 SVG。
-
-## 画风与底线（细节与配方见速查表）
-
-**画风（长什么样）**
-- 情绪：安静、柔软、温暖、有一点生活趣味；每张只讲一个看得懂的小故事。
-- 形状：手写贝塞尔与基础几何，圆润自然；大形先成立，细节克制；不以元素数量代替质量。
-- 构图：默认 1200×900；舒服的留白；远／中／近与承托面分层；全幅圆角由最外层 clipPath 统一裁切（含文字）。
-- 光与渐变：渐变过渡自然、层次分明、主光源统一（暖灯 / 冷月 / 落日 / 晨雾 / 日间自然光皆可）。
-
-**硬底线（不可让步，详见速查表）**
-- 明度均衡：不设固定色板——每幅按题材与情绪自由发挥、可多变；保持整幅协调；**默认明快，亮调与中间调为主，深色夜景只做少数**（原作那套夜色不是默认值）。
-- 对比度：明快不等于发飘——亮底要有深色锚点，深底要有大面积亮部；整幅留一处明确的明暗落差，且集中在少数区域。
-- 文字可读性：按文字所在区域的实际底色选色（不是按整幅平均色）；亮底深字、暗底亮字；字号越小对比要求越高；脸、轮廓、文字对比必须清楚。详见速查表的「文字可读性」。
-- 题材轮换：连续两张不同类型，每 4 张覆盖三类以上，同一母题最多两次。详见速查表的「题材轮换」。
-
-**文案与落款**
-- 上限：最多标题＋一句温柔注脚（＋少量落款）；字体栈含中文系统回退。
-- 诗词版：画面相宜时左下角可改题一首贴题的唐宋诗词（诗句两行＋出处一行），此时**去掉右下小字**，全图五处文字（左上标题、右上落款、左下诗句与出处）；标题写自己的话、诗句引原典，两者不重复。结构与对比照速查表的「诗词版」。
-- 落款名不写死：按当前使用者的称呼填写；不确定就改用中性落款（如「晚安」），宁可无名字也不要猜错。详见速查表的「落款名：按使用者替换，不要照抄」。
-
-**技术与可访问性**
-- 含命名空间；显式 width/height/viewBox；`role="img"` 与 `aria-labelledby`；title/desc 如实；纯静态、纯矢量、自包含（无动画 / 脚本 / 外链 / 位图）。
-
-## 交付前质量核对
-
-- 质检报告无 ✗：结构、圆角裁切（全部内容在框内）、引用、字体栈、静态底线。
-- 文字可读性已核对：各处文字（标题、注脚、诗词、落款、小字）在其底色上都能轻松读出来；没有低对比或横跨明暗交界的句子。
-- 对比度已核对：有一处明确的明暗落差，且集中在少数区域，没有整幅发飘或处处高对比。
-- 落款名已核对：是当前使用者的称呼，或中性落款；没有照抄示例里的名字。
-- 若用了诗词版：五处文字齐全（左上标题、右上落款、左下诗句与出处），右下无小字。
-- 成批时题材轮换已核对：连续两张不同类型，母题未超两次。
-- 整幅用色协调统一（色系自由、可多变）；文案逐句核对无错字、无残缺句。
-- 自查清单已勾完；最终交付 = 质检通过的最新版原生 SVG。
-
-

package/skills/cozy-static-svg/references/cross-platform.md

@@ -1,73 +0,0 @@
-# 跨平台速查（macOS / Windows / Linux）
-
-这套技能本体是「手写 SVG 文本 + 纯标准库 Python 脚本」，没有平台依赖。
-真正需要按系统调整的只有两件事：**质检命令怎么写**、**转 PNG 用什么工具**。
-
-## 一、质检命令
-
-脚本 `scripts/artkit.py` 只用 Python 标准库（需 **Python 3.9+**），两个平台都能跑。
-参数支持**文件 / 目录 / 通配符**——目录会递归找全部 `.svg`；通配符由脚本自己展开，
-所以 PowerShell 不必先替命令展开 `*.svg`，两边的写法才真正一致。
-
-| 场景 | macOS / Linux | Windows |
-| --- | --- | --- |
-| 单张 | `python3 scripts/artkit.py 作品.svg` | `py -3 scripts\artkit.py 作品.svg` |
-| 整批（当前目录） | `python3 scripts/artkit.py .` | `py -3 scripts\artkit.py .` |
-| 整批（通配符） | `python3 scripts/artkit.py "out/*.svg"` | `py -3 scripts\artkit.py "out\*.svg"` |
-| 严格模式 | 加 `--strict`（提示也算不合格） | 同左 |
-
-- Windows 上用 `py -3` 最稳；若装了新版 Python 且 PATH 里有 `python`，也可用 `python scripts\artkit.py`。
-- 脚本已强制 UTF-8 输出，中文报告在 PowerShell / cmd 里不会乱码；个别老终端若仍乱码，先跑 `chcp 65001`。
-- 退出码：0 通过，1 有不合格项 —— 可接进任何平台的脚本里做关卡。
-
-## 二、转 PNG（默认不做，用户明确要才做）
-
-默认工作流是**直出原生 SVG，不转 PNG**。用户明确要 PNG 时用 `scripts/to_png.py`，
-它自动探测本机可用的后端，两个平台命令一致：
-
-```bash
-python3 scripts/to_png.py 作品.svg              # macOS / Linux
-py -3 scripts\to_png.py 作品.svg                # Windows
-python3 scripts/to_png.py --scale 2 .           # 整目录，2 倍图
-python3 scripts/to_png.py -o out 作品目录        # 指定输出目录
-```
-
-后端优先级：`rsvg-convert` → `inkscape` → `cairosvg` → `chrome/edge`（找不到可用的会给出安装提示）。
-也可以 `--backend inkscape` 手动指定。
-
-| 后端 | macOS | Windows | 备注 |
-| --- | --- | --- | --- |
-| rsvg-convert | `brew install librsvg` | MSYS2 `pacman -S mingw-w64-x86_64-librsvg` | 与手绘流程同源，首选 |
-| Inkscape | `brew install --cask inkscape` | 官网安装包（自带你丢命令行） | 图形界面顺手可编辑 |
-| cairosvg | `pip install cairosvg` | 同左（wheel 自带 cairo） | 纯 Python 路线 |
-| chrome / edge | 系统已有 Chrome/Edge 即可 | 系统自带 Edge 即可 | 零安装兜底，`--backend chrome` |
-
-- 默认**保留透明底**（画风四角是圆角）；要白底加 `--background FFFFFF`。
-- 不指定尺寸时按 SVG 原始宽高输出（默认画布 1200×900），`--scale 2` 得 2400×1800。
-- 不要用「截图整个屏幕」的方式凑 PNG；也不要把位图塞回 SVG。
-
-## 三、字体差异（唯一会看出区别的地方）
-
-字体栈固定为 `'PingFang SC','Noto Sans CJK SC','Microsoft YaHei',sans-serif`：
-
-- macOS → **苹方**（PingFang SC）；Windows → **微软雅黑**（Microsoft YaHei）；两者都不会掉成方块。
-- 字形与字宽略有差异（雅黑略宽、笔画更方），同一句话两平台占宽差几个百分点。
-  本套画风标题与注脚都留了大片留白，**不会溢出画布**；做像素级对齐要求极高的活儿时，
-  要么目标平台上装苹方（字体授权自行确认），要么把文字转成路径（代价：以后不能改文案）。
-- Linux 上若两者都没有，装 `fonts-noto-cjk` 即可命中第二顺位。
-
-## 四、常见问题对照
-
-| 现象 | 处理 |
-| --- | --- |
-| `python3: command not found`（Windows） | 改用 `py -3`；或到 python.org 装新版并勾选 Add to PATH |
-| PowerShell 报找不到 `*.svg` | 参数用目录 `.`，或给通配符加引号 `"out\*.svg"`，脚本会自己展开 |
-| 报告中文乱码 | 脚本已强制 UTF-8；老终端再执行 `chcp 65001` |
-| `rsvg-convert` 不存在（Windows） | 用 `--backend inkscape` 或 `--backend chrome`（系统自带 Edge） |
-| PNG 四角是透明格子 | 正常，画风就是圆角；要白底加 `--background FFFFFF` |
-| 提示缺少 Python 版本 | 需 3.9+（用到 `str.removesuffix`），脚本会直接告诉你当前版本 |
-
-## 五、底线
-
-- 交付物永远是**质检通过的原生 SVG**；PNG 只是复制品，改图只改 SVG 源文件。
-- 两个平台跑同一份 `scripts/`，不各自维护两套；路径一律相对技能目录，不写死绝对路径。