@taloswork/ose-shared 0.1.12 → 0.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taloswork/ose-shared",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "Talos cross-OSE shared library — skills + MCP servers auto-loaded into every OSE (P93 2026-07-27).",
   "type": "module",
   "files": [
@@ -10,6 +10,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "_talosPublishHash": "sha256-H6oTRkzTtWhz5kbtdMN6IhbuX_uh4d6W8nxcax6lK94",
-  "_talosPublishedAt": "2026-10-07T12:24:23.248Z"
+  "_talosPublishHash": "sha256-HbLb5fXPsWxwD1td2ljod1H_UVd555EmCpblxk4GZ2g",
+  "_talosPublishedAt": "2026-10-10T06:45:49.079Z"
 }

package/skills/document/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: document
-description: "Use for document FILES. Reading: a PDF, .docx, .pptx or .xlsx attachment to read, summarize, translate or search when its pages must be rendered (formulas, scans, figures) or a sheet computed — others arrive as extracted text. Writing: any request to create or edit a Word, PowerPoint, Excel or PDF file, or convert one (转成/导出 PDF, .docx/.pptx → PDF). ALWAYS use its scripts — doc-gen (docs), html2pptx (decks, and a deck made here to PDF), doc-convert (an existing file to PDF); never hand-write a python/ReportLab/LibreOffice/browser pipeline. Do NOT trigger for images or plain .txt/.md/.csv."
+description: "Use for document FILES. Reading: a PDF, .docx, .pptx or .xlsx attachment to read, summarize, translate or search when its pages must be rendered (formulas, scans, figures) or a sheet computed — others arrive as extracted text. Writing: any request to create or edit a Word, PowerPoint, Excel or PDF file, or convert one (转成/导出 PDF, .docx/.pptx → PDF). ALWAYS use its scripts — doc-gen (docs), html2pptx (decks), doc-convert (Office files and final decks to PDF); never hand-write a python/ReportLab/LibreOffice/browser pipeline. Do NOT trigger for images or plain .txt/.md/.csv."
 license: Proprietary. LICENSE.txt has complete terms
 ---
 
@@ -28,16 +28,14 @@ document's content; never guess from the filename. Then:
   produce document files via the scripts — never hand-write a python / ReportLab /
   LibreOffice script for document output.
 - **Convert** a .docx/.pptx/.xlsx to PDF(转成/导出 PDF)→ `bin/doc-convert.cjs <in> <out.pdf>`.
-  FAITHFUL conversion — the source's content, structure and images with neutral print
-  styling; do not re-theme or "优化排版" unless asked, and never hand-roll a textutil /
-  LibreOffice / headless-browser pipeline. Spreadsheets render ONLY through a real
+  Preserve the source; do not re-theme or "优化排版" unless asked, and never hand-roll a textutil /
+  LibreOffice / headless-browser pipeline. PPTX and spreadsheets render ONLY through a real
   LibreOffice (local `soffice` or `TALOS_OFFICE_URL`); without one the command errors.
-- **A deck you built here, as PDF**(PPT 要 PDF)→ print its `deck.html` with the same
-  style flags as the .pptx, minus the .pptx-only `--editable` / `--rasterize` / `--notes-doc`:
-  `bin/html2pptx.cjs deck.html out.pdf --style <id> [--theme-v2 …] [--backdrop …]` — one
-  vector 16:9 page per slide, text selectable, links live. Not `doc-convert` (it re-lays
-  out the .pptx), never slide PNGs assembled into a PDF. `pages` ≠ `slides` in the result
-  means a slide overflows its canvas — fix it and print again.
+  DOCX may fall back to HTML reconstruction; report that its layout can change.
+- **A deck you built here, as PDF**(PPT 要 PDF)→ `bin/doc-convert.cjs deck.pptx out.pdf`.
+  The final PPTX is the source of truth for content, fonts and layout. Reuse its final
+  QA Office PDF only if the PPTX has not changed. Never print `deck.html` or assemble
+  preview PNGs as the delivered PDF. No Office engine → report that PDF export is unavailable.
 - **Any deck/presentation(路演/汇报/评审/宣讲/pitch/roadshow/介绍 PPT)** → the deck route below.
 
 ## Decks
@@ -50,40 +48,29 @@ AskUserQuestion call with at most THREE questions**, and wait for the answers. I
 three are already known, do not ask them again.
 
 **STYLE PICKER — ONE RESULT PER IMAGE, SCENARIO-RANKED.** After the scenario is
-known, read the skill directory's **current `catalog.json` from disk immediately
-before building the picker**. Never reuse a catalog listing from earlier conversation
-context and never infer pack availability by scanning `packs/`. If the current catalog
-  cannot be read or parsed, stop and report that exact error instead of presenting stale
-options.
+known, run `node <skill>/bin/deck-styles.cjs --scenario "<the confirmed scenario>"`: it
+reads the current `catalog.json` from disk immediately and ranks the entries (a
+scenario-matching pack first, at least six cards). Never rank from memory, reuse a listing
+from earlier context or scan `packs/`. If it exits non-zero, stop and report that exact
+error instead of presenting stale options.
 
 Unless the user already named an entry id/name, supplied a template file, or explicitly
-said **"无需展示模板，直接替我选定风格"**, send one single-question image-card picker:
-
-- Rank **entries**, not groups, against the confirmed scenario and the user's requested
-  tone. Show at most 8 recommended entries. A scenario-matching `kind === "pack"` ranks
-  before matching skins; include at least one matching pack whenever one exists.
-- Every image card maps to exactly one final entry and uses
-  `{ label: entry.kind === "pack" ? "PACK · " + entry.name_cn :
-  (entry 属于 renderMode === "classic-v1" 的 collection ? "经典 · " + entry.name_cn : entry.name_cn),
-  description: entry.oneliner, imagePath: <skill目录下entry.sample的绝对路径> }`.
-  Copy `entry.oneliner` verbatim. Never use `group.sample` in this default picker.
-- Append `{ label: "查看全部风格", description: "一次查看全部模板" }`, then
-  `{ label: "使用我的模板文件", description: "复用现成 PPT 的版式/风格",
-  filePick: "file" }` as the final option.
+said **"无需展示模板，直接替我选定风格"**, send one single-question image-card picker whose
+`options` are deck-styles' `options` **as printed** — never rewrite, reorder or add a card.
 
 **"按场景推荐/你推荐" means rank the cards and still ask.** It does NOT waive the
 picker. Only the explicit no-picker wording above authorizes automatic selection.
 Do not waive this gate because the deck is small or quick.
 
-If the user chooses **查看全部风格**, immediately show **every current
-  `catalog.entries` item in one single-question image-card picker** using the same label,
-description, and imagePath rule above. Preserve catalog order, keep `PACK ·` visible,
-and append the custom-template file card. Do not ask for a group, paginate, or return to
-  any category/second-level picker; the browse-all action must expose final selectable
-templates directly.
+**查看全部风格** opens the full gallery in the app itself — you receive the final pick, not
+the click. Only if 查看全部风格 comes back as the answer, show **every current
+  `catalog.entries` item in one single-question image-card picker** in catalog order:
+`{ label: "PACK · " + entry.name_cn` for a pack, `"经典 · " + entry.name_cn` in a
+`classic-v1` collection, else `entry.name_cn`; `description: entry.oneliner, imagePath:
+"document:" + entry.sample }`, then the template card. Do not ask for a group, paginate, or return to
+  any category/second-level picker.
 
-Samples are pre-rendered WebP files shipped with the skill: pass their absolute paths
-directly and render nothing during the question. The selected `entry.id` is the stable
+The selected `entry.id` is the stable
 `style` id. An entry in a `renderMode:"classic-v1"` collection of `catalog.collections`
 renders V1 (no `themeVersion`, never `--theme-v2`); every other new deck uses Theme V2 —
 read **theme-system.md** before authoring.
@@ -100,12 +87,13 @@ the preference to memory.
 
 **Custom style** (其他/自定义, 使用我的模板文件, "我之前那个风格"): routes and naming are in
 **deck-design.md "Custom skins"** — prefer deriving a bespoke skin, saved as a user style
-under `$TALOS_DOC_STYLES_DIR/styles/<name>/`; an uploaded deck whose exact layouts must be
-kept → rewrite.md "Reuse an uploaded deck". Never write inside the skill directory.
+under `$TALOS_DOC_STYLES_DIR/styles/<name>/`; a 使用我的模板文件 deck is learned as a style
+(`template-skin`); refilling its original pages (opt-in) → rewrite.md "Reuse an
+uploaded deck". Never write inside the skill directory.
 
-**Then build it.** Read **content-pipeline.md** (brief → research → narrative → one
-outline gate) for a substantive deck, then **deck-design.md** (workflow, slide contract,
-sign-off) and **`layouts/README.md`** (layout selection and fill contract). In short:
+**Then build it.** Read **content-pipeline.md** for a substantive deck, then
+**deck-design.md** and **`layouts/README.md`**. Assess whether generated visuals help;
+if so, read **generated-visuals.md**. In short:
 **plan before you fill** — `bin/deck-plan.cjs plan.json spec.json` picks layouts by
 MEASURED capacity and drafts the spec, `deck-build` fills it, charts are drawn from data
 (never hand-write chart SVG), and `bin/html2pptx.cjs deck.html out.pptx --style <id>`
@@ -118,7 +106,7 @@ fall back to a lesser deck.
 1. **Valid.** `doc-gen` and `html2pptx` check their own output in the step that wrote
    it — `valid: false` exits 1, fix before delivering;
    never re-run `doc-validate` on their output. `doc-gen pdf` prints `{valid, pages, textChars, cjkChars, previews}`
-   (a ≈72dpi PNG per page — read those, do not re-render or count characters yourself);
+   (≈72dpi PNGs — read those, do not re-render). Counts describe input, not visible glyphs.
    `doc-gen docx` prints `{valid, textChars, cjkChars}`, `xlsx` `{valid}`. After any
    other write (doc-fill, docx-annotate, pptx-*, pdf-form / pdf-ops, doc-xml pack, a
    doc-run script) run `bin/doc-validate.cjs <file>` yourself — exit 1 means fix it.
@@ -149,10 +137,10 @@ codes). Never read or grep `bin/*.cjs` themselves: they are bundled builds.
 - Read: `bin/doc-scan.cjs` · `bin/doc-text.cjs` · `bin/pdf-render.cjs` · `bin/pdf-images.cjs` ·
   `bin/pdf-tables.cjs` · `bin/ocr.cjs` · `bin/xlsx-query.cjs`
 - Generate: `bin/doc-gen.cjs` · `bin/doc-run.cjs` · `bin/xlsx-recalc.cjs`
-- Fill / edit: `bin/doc-fill.cjs` · `bin/doc-xml.cjs` · `bin/docx-annotate.cjs` · `bin/pptx-clone.cjs` ·
-  `bin/pptx-slide.cjs` · `bin/pptx-tokenize.cjs` · `bin/pptx-set-image.cjs` · `bin/pptx-theme.cjs` ·
+- Fill / edit: `bin/doc-fill.cjs` · `bin/doc-xml.cjs` · `bin/docx-annotate.cjs` · `bin/docx-defaults.cjs` · `bin/pptx-clone.cjs` ·
+  `bin/pptx-slide.cjs` · `bin/pptx-tokenize.cjs` · `bin/pptx-set-image.cjs` · `bin/pptx-notes.cjs` · `bin/pptx-theme.cjs` ·
   `bin/pptx-embed-fonts.cjs` · `bin/pdf-form.cjs` · `bin/pdf-ops.cjs`
-- Decks: `bin/deck-scenario.cjs` · `bin/deck-plan.cjs` · `bin/deck-build.cjs` · `bin/deck-chart.cjs` · `bin/html2pptx.cjs` · `bin/deck-qa.cjs`
+- Decks: `bin/deck-scenario.cjs` · `bin/deck-styles.cjs` · `bin/deck-plan.cjs` · `bin/deck-build.cjs` · `bin/deck-chart.cjs` · `bin/html2pptx.cjs` · `bin/deck-qa.cjs` · `bin/template-skin.cjs`
 - Validate / convert: `bin/doc-validate.cjs <file.docx|pptx|xlsx|pdf> [--strict]` · `bin/doc-convert.cjs`
 
 Every script prints a machine-readable result. On a missing dependency or unreadable