@xiaobuyu/nodesign 0.0.1

package/server/engine/plugins/nodesign/skills/deskskill-engine-mini/patterns/hybrid-grid.md

@@ -0,0 +1,22 @@
+# Hybrid Grid（layout-role: `hybrid`）
+
+图文并列的阵列页：feature 阵列 / 多 variant 展示 / 案例集 / 步骤对照。
+
+## 意图
+
+阵列页最容易掉进"等高卡片网格"的默认套路（反默认清单第一条）。做之前先问：
+这些并列项里有没有主角？有主角就打破均质（一大多小、Z 型错位），真没有主角
+（型号对照表这类）等高才是诚实的选择。
+
+## 真正硬的几条
+
+- **格数有天花板**：超过 6 格视觉碎片化，切 `<Tabs>`（≤4 个 variant 逐个看）或
+  embla 轮播（更多）。模板自带 `<Card>` `<Tabs>`，feature 阵列优先 reach for。
+- **每格图共用 referenceImages** 保持风格一致，跟 portrait 的多人物同理。
+- **锁图片比例**（aspect-ratio），不锁的 grid 高度参差是最常见的翻车。
+- caption 是辅料，字号和颜色明确低于格标题。
+
+## 写法
+
+列数、间距、是否等高全部从内容角色推导。section 标 `data-layout-role="hybrid"` +
+常规 data-page / data-anchor；格内 img 建议带 `data-asset-role="illustration"`。

package/server/engine/plugins/nodesign/skills/deskskill-engine-mini/patterns/image-led-cover.md

@@ -0,0 +1,25 @@
+# Image-led Cover（layout-role: `image-led`）
+
+封面 / 全幅 hero。图占满，文字是浮层。它是整个 deck 的视觉锚种子：用户认可这张
+cover 后，它的风格（光线 / 色调 / 质感）通过 referenceImages 传染给后续所有生成图。
+
+## 意图
+
+入口页要在一秒内把锚的气质砸出来。判断一张 cover 成不成，遮住文字只看图，
+还能不能感受到这个 deck 是什么气质。
+
+## 真正硬的几条
+
+- **图传达的别再用文字重述**。"古书堆图"旁边不写"古典氛围"，重复等于不自信。
+- **文字克制**（标题 + 可选副标 + 可选编号，就这些）。想写更多说明这页不该是 cover。
+- **overlay 别用纯黑半透明蒙层压全图亮度**。要压就只压文字落脚的局部（渐变到底部
+  或角落），大字加 drop-shadow，图的亮部留给图。
+- **cover 是种子**：生成后主动请用户确认方向，approve 之前别往后铺。选错一路全漂。
+
+## 写法
+
+图 `absolute inset-0 object-cover` 铺底，`object-position` 按视觉重心调（人物通常
+center-top）。布局、渐变方向、文字位置全部从锚推导，没有默认值。
+
+标记：section 必带 `data-page` / `data-layout-role="image-led"` / 唯一 `data-anchor`；
+img 建议带 `data-asset-role="cover"` + `data-asset-source`（审计与重生成用的约定）。

package/server/engine/plugins/nodesign/skills/deskskill-engine-mini/patterns/portrait.md

@@ -0,0 +1,23 @@
+# Portrait（layout-role: `image-led`）
+
+人物页：主角介绍 / 团队页 / 专家背书。人像 + 身份信息 + 一句 quote 或 tagline。
+
+## 意图
+
+这页在建立"人的可信度或存在感"。竖幅（4:5 / 2:3）人像暗示"这是个人"，
+横幅环境照暗示"这是个场景"，按你要的语义选。跟 quote-backdrop 的区别：
+portrait 人在前景，quote-backdrop 图弱化、大字是主角。
+
+## 真正硬的几条
+
+- **多人物必须锁风格**：generate_image 用同一批 referenceImages 保持光线和质感一致，
+  否则团队页像从三个图库拼出来的。
+- **信息分三层**：身份小字、姓名大字、quote 另一种质感（斜体或衬线），三层不同
+  重量，别做成同字号列表。
+- 人像圆角克制：全圆（头像化）让人物失去分量，除非锚本身就是社交产品气质。
+
+## 写法
+
+左图右文或上图下文皆可，比例和间距从锚推导。img 建议带
+`data-asset-role="portrait"`；section 常规三件套标记（data-page /
+data-layout-role / 唯一 data-anchor，重名加 `-pN` 后缀）。

package/server/engine/plugins/nodesign/skills/deskskill-engine-mini/patterns/quote-backdrop.md

@@ -0,0 +1,21 @@
+# Quote Backdrop（layout-role: `image-led`）
+
+引言页：图弱化作衬底，一句大字 quote 是唯一主角。情绪转折 / 关键判断 / 立意页用。
+
+## 意图
+
+quote 页是 deck 节奏里的"暂停"，价值全在减法。它跟 portrait 的分工：portrait
+人在前景 quote 作装饰，这里 quote 是主角图退成氛围。
+
+## 真正硬的几条
+
+- **衬底图弱化要有度**：淡到读不出意境（怕被看到式的 opacity-10）和抢戏的全亮
+  都不行，图要能感觉到但不干扰读字。罩层带一点锚的底色比纯黑白罩透气。
+- **这页只有 quote + 出处两个元素**。每多加一个装饰就背叛一次"暂停"的意图。
+- 出处是辅料：小字、另一种字体质感，跟 quote 拉开重量。
+
+## 写法
+
+图 `absolute inset-0 object-cover` + 低透明度，quote 用锚的 display 字体放大，
+居中或偏置构图从锚推导。section 标 `data-layout-role="image-led"` + 常规
+data-page / data-anchor；img 建议带 `data-asset-role="quote-backdrop"`。

package/server/engine/plugins/nodesign/skills/deskskill-engine-mini/patterns/section-divider.md

@@ -0,0 +1,23 @@
+# Section Divider（layout-role: `image-led`）
+
+章节扉页：多章节 deck 的中段切片。全屏图 + 章节号 + 一句概括。
+
+## 意图
+
+转场页管的是节奏，给观众一次呼吸和一次预告。它的存在让正文页不必每页顶部
+贴 chip 复述"现在是第几部分"（那是反默认清单第四条）。跟 cover 的区别：
+cover 是入口要砸气质，divider 是切片要收着，文案密度更低。
+
+## 真正硬的几条
+
+- **只有章节号 + 标题（+ 可选一句概括）**。bullet 和段落出现在这页就是结构错了。
+- **跟 cover 共用 referenceImages 系列**保风格一致，但场景换（cover 是主体 hero，
+  divider 换 environment / mood），不然像同一张图裁了两次。
+- 章节号和标题拉开质感反差（比如编号用 mono 大字距，标题用锚的 display 字体），
+  同质感排两行就平了。
+
+## 写法
+
+全屏图铺底 + 局部 overlay，居中或角落构图从锚推导。section 标
+`data-layout-role="image-led"` + 常规 data-page / data-anchor；img 建议带
+`data-asset-role="section-divider"`。

package/server/engine/plugins/nodesign/skills/deskskill-engine-mini/patterns/text-led.md

@@ -0,0 +1,21 @@
+# Text-led（layout-role: `text-led`）
+
+文字主导页：论点页 / 结论页 / 痛点页 / 概念页。文字承载叙事，图（如有）只是配重。
+
+## 意图
+
+这页靠一句锋利的话立住。核心句是主角，其余段落和要点是它的证据链。
+跟 hybrid 的区别看图文权重：图超过三成注意力就该走 hybrid。
+
+## 真正硬的几条
+
+- **核心句只有一个**。标题写结论不写名词（"市场规模" → "AI 搜索市场在升级为基础设施"）。
+- **文字量有天花板**：演示稿不是文档，段落多到要缩小字号才装得下，就拆页。
+- **要点列表膨胀是信号**：五六项以上的并列要点说明结构错了，该换卡片阵列或 Tabs，
+  或者砍。
+- 配重图就是配重：干净裁切即可，别套 cover 那套 overlay。
+
+## 写法
+
+大留白单句页、左文右图、纯文居中都是合法形态，从锚的版式语言推导。
+section 常规三件套标记；关键文字元素加 `data-anchor` 方便跨 turn 引用。

package/server/engine/plugins/nodesign/skills/docx-craft/SKILL.md

@@ -0,0 +1,162 @@
+---
+name: docx-craft
+version: 0.1.0
+description: NoDesign Word 文档设计守则 —— 产出 .docx（真 Word 文件，对方能打开接着改）。先问这份文档给谁看、进什么流程，再把用户嘴里的形容词翻译成一个真实存在的版式名，然后试作、给看、改、锚定、铺开。含中文排版军规（eastAsia 字体槽 / 首行缩进随字号 / 禁则 / 中文无真斜体）、闭合 token 契约、结构真实性（真样式真编号真表格几何）、渲染验收回路。**当用户明确要一份 .docx / Word 文件，或要的东西必须能在 Word 里打开继续编辑，或是有格式硬规定的正式文书（公文、学位论文、合同、投递用简历）时使用。** 反向：要演示 / 幻灯片 / PPT 走 deskskill-engine-mini，要网页 / 站点 / 落地页走 site-craft。⚠️ 用户只说"做个报告 / 写个方案"而没提格式时**不要**用这条 —— 默认仍走 deck 或站点，画布里可看可迭代是主场，Word 是显式出口。
+---
+
+# 核心守则：跟 deck / 站点同一条路
+
+**命名 → 试作 → 给看 → 改 → 用户说"就这个" → 锚定 → 铺开**
+
+区别只在试作做什么：deck 试作一页封面，站点试作首页上半屏，**文档试作头一页**
+（标题区 + 两三段正文 + 一个二级标题）。文档的气质八成由正文排版决定 —— 行距、
+首行缩进、标题层级的字号跳跃。只给用户看个漂亮封面，铺到正文那天他会说"怎么跟
+我想的不一样"。
+
+## 〇、先问三件（决定后面所有取舍）
+
+1. **给谁看** —— 领导 / 甲方 / 评审 / 投递对方
+2. **进什么流程** —— 要不要盖章、要不要走 OA、要不要打印、对方会不会在上面批注
+3. **对方用什么打开** —— 十有八九是 Windows 上的 Word；这条决定字体怎么选
+
+第 3 条尤其不能跳。**docx 的字体是"点名"不是"备选链"** —— 一个槽只能写一个名字，
+没有 CSS 那种 fallback。点了用户机器上没有的字体，Word 会自己替一个，你控制不了。
+
+## 一、先给版式一个名字
+
+跟 deck / 站点同一条规矩：**把形容词翻译成一个真实存在的版式名**。形容词
+（"正式一点""清爽点"）把模型推向均值；名字有可仿照的对象。
+
+docx 的版式谱系跟网页不是一套，常用的这些：
+
+| 用户可能说 | 翻译成 | 落到 token 上是哪几条 |
+|---|---|---|
+| 要正式 / 报上去的 / 盖章 | **公文体（GB/T 9704-2012）** | 三号仿宋正文、固定行距 28pt、每页 22 行、黑体一级楷体二级、页边距 37/26/35/28mm |
+| 论文 / 投稿 / 毕业 | **学术论文体** | 小四宋体、1.5 倍行距、章节编号、图表题注 |
+| 商务 / 提案 / 汇报 | **商务简报体** | 小四、段前段后留白、无首行缩进改段间距、标题带细规则线 |
+| 就要普通的 / 别花哨 | **办公标准（素颜 Word）** | Word 默认观感本身。⚠️这是**合法选择不是偷懒** —— 要混进办公流程的文档，"看起来像人在 Word 里敲的"就是需求 |
+| 简历 / 投递 | **单页履历体** | 窄边距、姓名区大字号、条目左对齐悬挂缩进、零装饰 |
+| 手册 / 说明书 | **技术文档体** | 编号标题、等宽代码块、表格密排 |
+
+内置词典条目有三个（`build_docx` 的 `preset`）：`办公标准` / `公文` / `学术论文`。
+**它们是起点不是菜单** —— 上表其余的用 preset 起手再覆写 tokens，或者干脆不写
+preset 给完整 token 表。自造词作废（"科技感文档"不是版式名），但凡是真实存在、
+你能说出它长什么样的版式，都可以当名字。
+
+## 二、token 是真相源，docx 是构建产物
+
+工作方式**只有这一种**：
+
+```
+写/改 文档.json  →  build_docx  →  screenshot_canvas 看  →  改 JSON  →  再 build
+```
+
+⛔ **永远不要直接改 .docx**。它是构建产物，下一次 build 会把你的手改无声抹掉。
+（外来文档除外，见第七节。）
+
+**放进文件夹，一份文档一个家**：`报告/文档.json` + `报告/文档.docx`。画布会把
+整个文件夹显示成一张文档卡，里面所有 .docx 都是它的成员，用户在窗里切换查看。
+所以**用户要保留旧版时，另起文件名**（`报告/终稿v2.json` → build 出 `终稿v2.docx`，
+新旧并排），⛔ 别覆盖旧版 —— 版本是给用户看的，不是给你腾地方的。
+
+起手文件 `文档.template.json` 已经拷进工作区了 —— 照着它改，别从空白开始。
+**字段全集 Read `references/token-schema.md`** —— 键名、值域、单位、块的形状、
+常见错法对照全在那里，别靠猜，也别去读引擎源码。
+
+**schema 是闭合的**：写了没登记过的字段名，`build_docx` 直接报错。这是故意的 ——
+静默忽略会让你以为那条排版指令生效了。闭合的是"哪些问题必须回答"，不是"答案是
+什么"，跟"不预设范式"不冲突。
+
+⭐ **没写的值由打开文件的那个渲染器决定**（Word 各版本 / WPS / Pages 各不同）。
+网页至少还有一份 CSS 初始值规范兜底，docx 没有。所以：**凡是你在意的值就显式写出来**，
+别指望默认。
+
+## 三、结构真实性：不许假造
+
+这一条决定文档是"能看"还是"能交"。
+
+- **标题必须是真样式**（带 `outlineLevel`），不是"把一行字调大加粗"。假标题
+  → Word 的导航窗格是空的、TOC 生成不出来、对方改样式时它不跟着变。
+- **列表必须是真编号定义**，不是手打 `1.` `2.` 或者 `•`。假列表在用户插一条的
+  时候不会自动重排，删一条就断号。写法：`tokens.numbering` 里起个名字挂一个梯队，
+  段落上 `list: { name:'条款', ilvl:0 }`（单层可以简写成 `list: '条款'`）。
+  内置四个梯队都是照中文排版传统定的，**先用内置的**：
+  - `公文条款` 一、→（一）→ 1. →（1）。首行缩进两字、文字紧跟编号、折行顶格
+  - `数字条款` 1. → 1.1 → 1.1.1。悬挂缩进，折行对齐到文字起点
+  - `圈码` ①②③ —— 中文文档里"并列要点"最常见的那种
+  - `项目符号` ●○▪（故意用真汉字区符号，不用 Symbol/Wingdings 的私用码位：
+    那些在没装对应字体的机器上会变豆腐块）
+  自己写梯队见 `references/token-schema.md` 的 numbering 节。
+- **表格必须给显式几何**（DXA 宽度，`tblW` / `tblGrid` / 每个 `tcW` 要一致），
+  不许靠 autofit，不许拿表格当版式骨架。
+- **缩进用缩进属性，不用空格/全角空格凑**。
+
+判据很简单：**用户在 Word 里改一处，会不会散架。** 会散架的就是假的。
+
+## 四、中文排版军规（目标用户是中文用户，这节不是可选项）
+
+1. ⭐ **`eastAsia` 槽必须设。** 中文字符走的是 `w:rFonts` 的 `eastAsia` 槽，
+   只写 `ascii` 等于没给中文指定字体。token 里 `fonts` 每个槽四件套都要填。
+2. ⭐ **首行缩进用字符单位**（`firstLineChars`，200 = 两字符），不要用固定磅值。
+   字号一变，固定磅值的缩进就不是两个字了。（引擎会自动同时发 twip 兜底，
+   因为 LibreOffice 不认单独的 chars —— 这条已经内建，你不用管。）
+3. **首行缩进和段间距二选一。** 中文正文传统是缩进不留白；两个都上是网页习惯
+   带过来的错，看起来会松垮。
+4. **中文没有真斜体。** Word 的中文斜体是把字硬拉斜，很难看。强调改用
+   加粗 / 换字体（楷体）/ 着重号（`em`）/ 字号。
+5. **标题不要跟着正文缩进。** 标题样式 `basedOn` 正文时会继承首行缩进 ——
+   这是中文用户在 Word 里天天骂的那个现象。标题样式里显式写 `firstLineChars: 0`。
+
+字号用中文字号名（三号 / 小四 / 五号）比写磅值可靠，token 直接收它们。
+
+## 五、渲染验收：做完必须看
+
+`screenshot_canvas` 对 .docx 会渲成页图（LibreOffice → PDF → PNG），带 `pages` 参数
+（`"3"` / `"2-5"` / `"all"`），默认前两页、一次最多六页。
+
+⚠️ **构建没报错不等于排版对了。** docx 没有 DOM，没有 `query_elements` 可查 ——
+渲染是唯一的验收手段。每次 build 完看一眼，不要攒到最后。
+
+**这只眼睛的三条已知失真**（caption 里也会重复，别忘）：
+
+- **中文是替身字体**：雅黑/等线→MiSans、仿宋→朱雀仿宋、宋体→Noto Serif、
+  楷体→LXGW 文楷。字形跟用户 Word 里仍有差。**CJK 全角等宽，断行位置是一致的**，
+  字形观感不能判。
+- ⚠️ **multiple 行距下页数不可照图判**（2026-08-19 真 Word 实证：这里 2 页的
+  简历在用户 Word 里变 4 页）。multiple 乘的是**字体自带行高**，替身和真机字体
+  不同高 —— 雅黑/等线档已对齐（MiSans 1.326 ≈ 真雅黑 1.32，Windows Word 基本
+  同高），但宋体等其它档、Mac 替到苹方（≈1.4）仍有差。**页数敏感的文档（简历
+  「必须两页」、公文这类）行距一律用 `exact` / `atLeast` 磅值**：磅值在哪个
+  渲染器里都一样高，页数就钉死了（公文词典条目本来就是 exact 28pt，天然免疫）。
+- **TOC 域显示的是占位文案**，不是真目录（Word 打开更新域才生成）。页码域是
+  正常的，看到几就是几。
+
+**能判的**：版面留白、行距密度、标题层级跳跃、缩进、表格对齐、孤行寡行；
+exact/atLeast 行距下分页位置也能判。
+**不能判的**：字形好不好看、目录内容、multiple 行距下的页数、跨版本 Word 兼容性。
+
+最后一条只有用户能验 —— 交付时主动说一句"建议在 Word 里开一遍确认"。
+
+## 六、验收次序
+
+```
+build_docx        →  过不了就按报错改 JSON，别猜
+screenshot_canvas →  看版式
+（多页文档）screenshot_canvas pages:"N-M"  →  看分页处有没有孤行、标题掉在页底
+交付前            →  提醒用户在真 Word 里开一遍
+```
+
+## 七、外来文档（用户上传的 .docx）
+
+⚠️ 这一段能力**还没做完**，别承诺。现在能做的只有：读它的内容、渲染它、
+原样导出。**改它**要等编辑道上线。
+
+如果用户要改一份上传的文档，现在的诚实回答是：可以基于它的内容**重做**一份
+（我们自己的 token 源，改起来干净），但不能在他那份原件上做定点修改。
+问清楚他要哪种再动手。
+
+## 八、导出
+
+`raw` 就是那个 .docx 本身 —— **它就是交付物**，不是"导出的副产品"，这跟 deck /
+站点反过来。`pdf` 走 LibreOffice，是快速预览用的；要发出去的正式 PDF 让用户在
+Word 里导（域和字体都对）。