dsh-ppt-studio 1.1.5 → 1.2.0

package/skills/diagrams/flow.md

@@ -0,0 +1,24 @@
+# 流程图（flow）· 手画配方
+
+## 骨架
+横向流程：起止 roundRect、中间 rect；末步 accent；**异常分支用回边并标条件**。
+
+## 配方数值
+节点 150×64 @ y=208，x=60 起、间距 22（5 个正好排满 60..898）；节点文字 14pt bold 白字居中。
+主链箭头 accent 宽 2、端点贴卡边。
+回边：自前一步**底边**下探到 y=360 车道 → 左行 → 上扎目标步底边；虚线 + 末端箭头；条件标签放车道**上方**（y=332）。
+
+## 专属坑
+1. 回边竖管与标签必须分离（标签独占车道上方的行）。
+2. 分支多时改用"菱形节点 + 两条出边"，别把回边画在流程带中间。
+
+## 验收清单
+- [ ] 门禁 0 错；[ ] 主链方向一致；[ ] 回边有明确条件标签。
+
+## 本族应调用的机制（先读 mechanisms.md）
+
+- **连边一律 `attach: {from:{ref,side}, to:{ref,side}}`**，不手算像素（含斜边形状 ⇒ 引擎接到真实斜边）。
+- 容器（分组/泳道/面板/背景带）**必须把内部元素写进 `contains`**；只声明**相邻层**。
+- 折线交给引擎**自动正交化**；刻意斜段（环/放射/漏斗）写 `role: decoration` 或 `roleReason` 声明。
+- 箭头前直段 ≥18px 由引擎自动保证；修不了会由 `arrow-end-short-run` 报出 ⇒ **必须读警告**。
+- 收工前**逐条解释本页每一条警告**（见 verify.md 铁律之二）。

package/skills/diagrams/funnel.md

@@ -0,0 +1,25 @@
+# 漏斗（funnel）· 手画配方
+
+## 骨架
+用 **custGeom 梯形**逐段收窄（矩形堆叠是台阶，不是漏斗）。
+
+## 配方数值
+段 bounds [80, 148+i×70, 800, 70]；段内标签**限宽** = min(上宽,下宽) − 60 且居中。
+示例上/下宽：760→560→360→200→100（末段 accent）。
+path：w:800、h:70；moveTo[(800−wTop)/2,0] → lnTo[(800+wTop)/2,0] → lnTo[(800+wBot)/2,70] → lnTo[(800−wBot)/2,70] → close。
+
+## 专属坑
+1. 段间边界相接（下段上宽 = 上段下宽），相接不算重叠。
+2. 标签必须落在梯形内部 ⇒ 必须限宽。
+3. 段太薄时宁可省略段内文字。
+
+## 验收清单
+- [ ] 门禁 0 错；[ ] 两侧斜边连续；[ ] 每段文字在梯形内。
+
+## 本族应调用的机制（先读 mechanisms.md）
+
+- **连边一律 `attach: {from:{ref,side}, to:{ref,side}}`**，不手算像素（含斜边形状 ⇒ 引擎接到真实斜边）。
+- 容器（分组/泳道/面板/背景带）**必须把内部元素写进 `contains`**；只声明**相邻层**。
+- 折线交给引擎**自动正交化**；刻意斜段（环/放射/漏斗）写 `role: decoration` 或 `roleReason` 声明。
+- 箭头前直段 ≥18px 由引擎自动保证；修不了会由 `arrow-end-short-run` 报出 ⇒ **必须读警告**。
+- 收工前**逐条解释本页每一条警告**（见 verify.md 铁律之二）。

package/skills/diagrams/layers.md

@@ -0,0 +1,18 @@
+# 分层架构（layers）· 手画配方
+
+## 骨架
+左侧**层标签芯片**（窄条）+ 右侧**层内容带**（长条，软填充），自上而下 N 层；层间用竖直箭头表示"上行/下行"。
+- 标题 (60,34)；层带 x=150，w=740，h=72，y=130 起，层距 88。
+- 层芯片：x=70，w=70，h=72，fill 主色，白字 13pt（竖排或居中均可）。
+- 层带：fill 暖白/浅紫（如 #EDE9FE），**必须把芯片与带内卡片写进 contains**。
+- 带内卡片：白底 roundRect（h=44，y=层带+14），文字 12pt 深色；一个带放 1–2 张。
+- 层间箭头：从上一带底边中点到下一带顶边，**端点正好落在带边**，宽 2，主色。
+
+## 专属坑
+1. **带内卡片压带边**：卡片要留 14px 内边距；带内卡片也各写自己的 contains。
+2. **层间箭头穿过带**：箭头只在带与带之间的空隙里，不要跨带。
+3. 层数 ≥5 时把 h 压到 62、层距压到 74，否则底部溢出安全区。
+
+## 验收清单
+- [ ] 每层"芯片 + 带 + 带内卡片"三层包含关系都声明；[ ] 层间箭头两端贴带边；
+- [ ] 看图能一眼数清层数；[ ] 带内文字对比度 ≥3:1（浅底用深字）。

package/skills/diagrams/loop.md

@@ -0,0 +1,25 @@
+# 闭环（loop）· 手画配方
+
+## 骨架
+N 个步骤卡沿**椭圆环**分布，箭头沿环指向下一步；环心留空（放文字会被线压）。
+
+## 配方数值
+中心 (480,320)，rx=250、ry=132；卡 170×52；角度 = −90° + i×(360/N)。
+卡 x = 480 + rx·cosθ − 85，y = 320 + ry·sinθ − 26。
+箭头沿"卡心→下一卡心"方向，从**卡边**裁剪（off≈96）到下一卡卡边；高亮其中一步。
+
+## 专属坑
+1. 端点必须落在卡边（落卡内 ⇒ 门禁报"卡 × 线"）。
+2. 环心留白；必须有中心文字时把箭头改走环外侧。
+3. N≥5 时 rx 加到 270、卡宽降到 150。
+
+## 验收清单
+- [ ] 门禁 0 错；[ ] 箭头首尾接成环；[ ] 环心无遮挡。
+
+## 本族应调用的机制（先读 mechanisms.md）
+
+- **连边一律 `attach: {from:{ref,side}, to:{ref,side}}`**，不手算像素（含斜边形状 ⇒ 引擎接到真实斜边）。
+- 容器（分组/泳道/面板/背景带）**必须把内部元素写进 `contains`**；只声明**相邻层**。
+- 折线交给引擎**自动正交化**；刻意斜段（环/放射/漏斗）写 `role: decoration` 或 `roleReason` 声明。
+- 箭头前直段 ≥18px 由引擎自动保证；修不了会由 `arrow-end-short-run` 报出 ⇒ **必须读警告**。
+- 收工前**逐条解释本页每一条警告**（见 verify.md 铁律之二）。

package/skills/diagrams/matrix.md

@@ -0,0 +1,23 @@
+# 矩阵（matrix）· 手画配方
+
+## 骨架
+**列 = 处置力度，行 = 频次**；每个条目独占一格（别用通用象限名代替处置档，否则丢信息维度）。
+
+## 配方数值
+列头 14pt bold @ y=158、宽 230 居中；行标 13pt bold @ x=60、宽 90、行内垂直居中。
+格 roundRect 230×120：列 x=160/410/660，行 y=190/330；最高优先级那格用 accent，其余主色；格内 15pt bold 白字。
+
+## 专属坑
+1. 每格写进自身 contains；若用外层容器，容器要登记所有格。
+2. 3 列 × 230 已是安全区上限。
+
+## 验收清单
+- [ ] 门禁 0 错；[ ] 列头/行标齐备；[ ] 高亮唯一。
+
+## 本族应调用的机制（先读 mechanisms.md）
+
+- **连边一律 `attach: {from:{ref,side}, to:{ref,side}}`**，不手算像素（含斜边形状 ⇒ 引擎接到真实斜边）。
+- 容器（分组/泳道/面板/背景带）**必须把内部元素写进 `contains`**；只声明**相邻层**。
+- 折线交给引擎**自动正交化**；刻意斜段（环/放射/漏斗）写 `role: decoration` 或 `roleReason` 声明。
+- 箭头前直段 ≥18px 由引擎自动保证；修不了会由 `arrow-end-short-run` 报出 ⇒ **必须读警告**。
+- 收工前**逐条解释本页每一条警告**（见 verify.md 铁律之二）。

package/skills/diagrams/sequence.md

@@ -0,0 +1,17 @@
+# 时序图（sequence）· 手画配方
+
+## 骨架
+顶部一排**参与者头卡**（等宽）+ 每人一条**虚线生命线**（垂直到页底）+ 自上而下的**消息箭头**（实线，标签在箭头上方）。
+- 标题 (60,34)；头卡 w=170，h=48，y=110，x=70 起，间距 35（4 人占 70..890）。
+- 生命线：从头卡底边中点到 y=470，`dash: dash`，颜色 #94A3B8，宽 1。
+- 消息：y=200/245/290/335/380 逐条下移；从发送者生命线到接收者生命线，**端点正好落在生命线上**，end 箭头；
+  标签放在箭头**上方 6px**、居中于两端之间，宽 = |x2−x1|，11pt。
+- 自环消息（自己给自己）：向右折 30px 再回来（三折线），标签放右侧。
+
+## 专属坑
+1. **箭头压生命线**：箭头端点落在线上即可，不要越过。
+2. **标签互相压**：相邻两条消息的 y 至少差 40；标签只占箭头正上方一行。
+3. **消息方向看错**：箭头必须在**接收者**那一端（`arrow: true` + points 的终点是接收者）。
+
+## 验收清单
+- [ ] 每条消息能读出"谁→谁、什么消息"；[ ] 生命线不被文字压；[ ] 头和生命线同一条 x 中心。

package/skills/diagrams/state.md

@@ -0,0 +1,34 @@
+# 状态机（state）· 手画配方
+
+## 骨架
+横向一行状态卡 + 卡间箭头 + **回边（返工/异常）走卡片外侧车道**；或竖向一列（见下）。
+- 5 状态：卡 150×84，y=240，x=60 起，间距 20 ⇒ 卡心 y=282，卡底 y=324。
+- 卡内：标题 16pt bold（居中或齐左）+ 副标题 11pt 灰；**卡内文字必须写进卡的 `contains`**。
+- 卡间：短箭头，端点**正好落在卡右边到下一卡左边**，y=卡心；颜色取 accent，宽 1.5–2。
+- 回边：从源卡**下边**出 → 下垂到 **y=400 车道** → 左行 → 上扎到目标卡**下边**；虚线 + 末端箭头。
+- 回边标签放在**车道上方**（如 y=372，高 20），**绝不放车道上**（会压线）。
+
+## 标签（最容易漏）
+**主链每条转移都要标签**，放在箭头**上方**（y = 卡顶 − 28），宽 80 居中于箭头中点；只标回边不标主链 ⇒ 内容就丢了（实测）。
+
+## 竖向变体（状态多、副标题长时更好看）
+一列 5 卡（470×68 / gap 26 / x=300）；内联编号圆徽 24px @ (x+16, y+12)；标题 x+50/y+10 16pt bold；副标题 x+50/y+38 11pt；卡间用**向下**箭头 3px；回边走左侧 x−40 虚线。
+> 实测：这一版观感明显好于横向行（层级清楚、留白够）。优先考虑竖向。
+
+## 该族专属坑
+1. **回边竖管压标签带**：竖管必须让开卡下标签带；把车道整体下移（≥ 标签带高 + 8px）。
+2. **回边端点画在卡内**（如 x+6）⇒ 门禁报 `unexpected-overlap`；端点必须**落在卡边**。
+3. **箭头值只有** `true|false|'end'|'both'`；`'start'` 非法。
+4. 自环/回边**不要跨过卡片区**；多回边时按 18px 递增错开车道。
+
+## 验收清单
+- [ ] `verifyDeck` 0 错；[ ] 每条边都能**用眼睛指出**从哪张卡到哪张卡；
+- [ ] 回边车道不压任何文字；[ ] 卡内文字不溢出（长标签要缩字号或加宽卡）。
+
+## 本族应调用的机制（先读 mechanisms.md）
+
+- **连边一律 `attach: {from:{ref,side}, to:{ref,side}}`**，不手算像素（含斜边形状 ⇒ 引擎接到真实斜边）。
+- 容器（分组/泳道/面板/背景带）**必须把内部元素写进 `contains`**；只声明**相邻层**。
+- 折线交给引擎**自动正交化**；刻意斜段（环/放射/漏斗）写 `role: decoration` 或 `roleReason` 声明。
+- 箭头前直段 ≥18px 由引擎自动保证；修不了会由 `arrow-end-short-run` 报出 ⇒ **必须读警告**。
+- 收工前**逐条解释本页每一条警告**（见 verify.md 铁律之二）。

package/skills/diagrams/steps-ring.md

@@ -0,0 +1,24 @@
+# 步骤环（steps-ring）· 手画配方
+
+## 两种画法
+1. **卡片环**（快）：N 张卡沿椭圆分布 + 沿环直箭头（数值见 loop.md）。
+2. **真圆 + 编号点**（更雅，旧版用的，**优先**）：ellipse 浅填充+主色描边 + 圆周上编号小圆点 + 圆外标签。
+
+## 真圆数值
+圆 ellipse 中心 (480,300)、r=190 ⇒ bounds [290,110,380,380]；fill 浅紫、line 主色 1.5。
+编号点 ellipse 46×46 在圆周（角度 = −90° + i×360/N），点内序号 bold 白字；标签在半径+70 处 12pt。
+
+## 专属坑
+1. 编号点写进圆的 contains，或干脆都不声明 contains（避免"未真正包含"）。
+2. 标签与编号点至少留 24px。
+
+## 验收清单
+- [ ] 门禁 0 错；[ ] 序号顺序可读；[ ] 圆与点同心。
+
+## 本族应调用的机制（先读 mechanisms.md）
+
+- **连边一律 `attach: {from:{ref,side}, to:{ref,side}}`**，不手算像素（含斜边形状 ⇒ 引擎接到真实斜边）。
+- 容器（分组/泳道/面板/背景带）**必须把内部元素写进 `contains`**；只声明**相邻层**。
+- 折线交给引擎**自动正交化**；刻意斜段（环/放射/漏斗）写 `role: decoration` 或 `roleReason` 声明。
+- 箭头前直段 ≥18px 由引擎自动保证；修不了会由 `arrow-end-short-run` 报出 ⇒ **必须读警告**。
+- 收工前**逐条解释本页每一条警告**（见 verify.md 铁律之二）。

package/skills/diagrams/swimlane.md

@@ -0,0 +1,23 @@
+# 泳道图（swimlane）· 手画配方
+
+## 骨架
+左泳道名芯片 + 右侧泳道带；任务卡按角色落到对应道；跨道连线允许穿带（**必须声明**）。
+
+## 配方数值
+芯片 roundRect 96×72 @ x=60；道 i 的 y=156+i×84。带 rect 780×72 @ x=156（同 y），奇数道浅紫、偶数道白底。
+任务卡 roundRect 110×44（文字 11pt bold），首卡 x=176、间距 124。
+
+## 专属坑
+1. **带的 contains 要列出本道全部任务卡与其文字**（否则报"背景压内容"）。
+2. 跨道连线只把**真正相交**的对写进 expectedOverlaps（过声明会产生 declared-stale 噪音）。
+
+## 验收清单
+- [ ] 门禁 0 错；[ ] 归属一眼可辨；[ ] 声明清单无 stale。
+
+## 本族应调用的机制（先读 mechanisms.md）
+
+- **连边一律 `attach: {from:{ref,side}, to:{ref,side}}`**，不手算像素（含斜边形状 ⇒ 引擎接到真实斜边）。
+- 容器（分组/泳道/面板/背景带）**必须把内部元素写进 `contains`**；只声明**相邻层**。
+- 折线交给引擎**自动正交化**；刻意斜段（环/放射/漏斗）写 `role: decoration` 或 `roleReason` 声明。
+- 箭头前直段 ≥18px 由引擎自动保证；修不了会由 `arrow-end-short-run` 报出 ⇒ **必须读警告**。
+- 收工前**逐条解释本页每一条警告**（见 verify.md 铁律之二）。

package/skills/diagrams/timeline.md

@@ -0,0 +1,24 @@
+# 时间轴（timeline）· 手画配方
+
+## 骨架
+水平主轴 + 等距里程碑点 + 标签**上下交替**。
+
+## 配方数值
+主轴 line @ y=300、x 70→890、宽 3；里程碑 ellipse 18×18，x=90 起、间距 156。
+标签宽 140 居中：名称 14pt bold + 说明 11pt 灰；奇数在上（y=300−96），偶数在下（y=300+34）；刻度短线 1px。
+**只高亮一个**关键节点（accent）。
+
+## 专属坑
+1. 6 个以上要缩间距或改两行；标签超 140 宽会互压。
+2. 全部高亮 = 没有重点。
+
+## 验收清单
+- [ ] 门禁 0 错；[ ] 标签不重叠；[ ] 高亮唯一。
+
+## 本族应调用的机制（先读 mechanisms.md）
+
+- **连边一律 `attach: {from:{ref,side}, to:{ref,side}}`**，不手算像素（含斜边形状 ⇒ 引擎接到真实斜边）。
+- 容器（分组/泳道/面板/背景带）**必须把内部元素写进 `contains`**；只声明**相邻层**。
+- 折线交给引擎**自动正交化**；刻意斜段（环/放射/漏斗）写 `role: decoration` 或 `roleReason` 声明。
+- 箭头前直段 ≥18px 由引擎自动保证；修不了会由 `arrow-end-short-run` 报出 ⇒ **必须读警告**。
+- 收工前**逐条解释本页每一条警告**（见 verify.md 铁律之二）。

package/skills/diagrams/tree.md

@@ -0,0 +1,24 @@
+# 层级树（tree）· 手画配方
+
+## 骨架
+根居顶中 → 一级一行 → 叶一行；连线用**正交折线 + 箭头**。
+
+## 配方数值（安全区 60..900 / 60..480）
+根 roundRect 200×64 @ (380,124)；一级 170×52 @ y=258（x=90/395/700）；叶 150×48 @ y=380。
+连线自根底边 y=188 起 → 主干 y=220 → 落到子节点顶边；**arrow: true**。
+
+## 专属坑
+1. 同组子树应加**分组容器**（旧版胜过手画版之处）；容器要把内部所有元素写进 contains，连线穿容器按纪律精确声明。
+2. 父盒加高后子文本要一起重排，否则 contains 不成立。
+3. 连线端点落在**卡边**，不要落在卡内。
+
+## 验收清单
+- [ ] 门禁 0 错；[ ] 每条连线有箭头且贴边；[ ] 组容器登记了内部元素。
+
+## 本族应调用的机制（先读 mechanisms.md）
+
+- **连边一律 `attach: {from:{ref,side}, to:{ref,side}}`**，不手算像素（含斜边形状 ⇒ 引擎接到真实斜边）。
+- 容器（分组/泳道/面板/背景带）**必须把内部元素写进 `contains`**；只声明**相邻层**。
+- 折线交给引擎**自动正交化**；刻意斜段（环/放射/漏斗）写 `role: decoration` 或 `roleReason` 声明。
+- 箭头前直段 ≥18px 由引擎自动保证；修不了会由 `arrow-end-short-run` 报出 ⇒ **必须读警告**。
+- 收工前**逐条解释本页每一条警告**（见 verify.md 铁律之二）。

package/skills/ppt-studio-manual/SKILL.md

@@ -48,7 +48,7 @@ DSH 上做 PPT 的工作区：说需求 → 四类任务工作流 → 「数字
 - 元素通用：`elementId`（页内唯一）、`elementType: text|shape|line|image|table|chart`、`bounds: [x,y,w,h]`（line 可省，由 points 推导）、`role: background|content|decoration`。
 - text：`content: {text, style: "$name" 或内联样式键}`；**样式键必须在 content 内**。
 - shape：`kind: rect|roundRect|ellipse|triangle + prst(箭头/菱形/五边形/flowchart…) + custGeom path`；`fill #hex | {color,alpha} | {type: gradient, stops: [{pos,color,alpha}], angle}`；`line {color,width}`；`rotation`。
-- line：`points: [[x1,y1],[x2,y2]]`（**每条只有两点**，多点折线不支持——时间轴/折线拆成首尾相接的多条 line）；`arrow: true`（箭头在第二个点那一端）。
+- line：`points: [[x1,y1],…]`（≥2 点，>2 点为折线）；`arrow: true|'both'`；`line.dash`；`attach` 可锚到元素边（阶段 A）。
 - image：`src: "media/xx.png"`；`fit: cover|contain|fill`。
 - table：`cols: [列名...]`、`rows: [[..]]`、`header: true|false`。
 - chart：`chart: {type: bar|line|pie, data: {cols: [列名…], rows: [[…]]}, series: [{name,x,y}]（多系列时显式写）, colors}`。
@@ -97,7 +97,7 @@ DSH 上做 PPT 的工作区：说需求 → 四类任务工作流 → 「数字
 ## 7. 开发维护（仅改插件时用）
 
 - 改码：`src/` → `node scripts/build.mjs` → **重启 host**（插件经 agent preset 会话装配；`dev_reload_package` 只覆盖注入器装配包，且注入器 junction 已存在时会指向旧安装根）。
-- 回归：`node scripts/smoke.mjs`（303 断言）→ `node scripts/preflight-1.0.mjs`（发布预检）→ `node scripts/regression-real.mjs`。
+- 回归：`node scripts/smoke.mjs`（322 断言）→ `node scripts/preflight-1.0.mjs`（发布预检）→ `node scripts/regression-real.mjs`。
 - 跨层验证纪律：**预览层与成品层必须互相验证**——`ppt_render`+`ppt_verify` 只管 HTML/估算层，OOXML 层靠 `ppt_export` 的 parity 自证（表/图/线方向）+ `ppt_visual` 真渲染抽检；只跑单层会漏掉"预览对、成品错"（2026-09-14 连线方向事故）。
 - 文档链：改需求/决策 → docs/01；改机制 → docs/02；每次 → docs/03；验收 → docs/04；发布前 → docs/06。
 - 装配：**默认装法是 npm 包名**（`dsh plugin --profile <p> add dsh-ppt-studio`，profile 级、随 profile 启动装配；**桌面端**在插件管理里填同一个包名 `dsh-ppt-studio`；GitHub Release 的资产 URL 与 `scripts/install*.mjs` 是离线/归档备选）。装完**必须重启 host**。排查：`dsh plugin --profile web list` → `dsh --profile web --dump-config` 找 `ppt-studio` 行。preset 插件行只在"离线 junction"场景用，与 bundle 装法**互斥**。