@fectivnfy112358/minimax-code-web 0.1.0-preview.0 → 0.1.0-preview.3

package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/bar-chart.md

@@ -0,0 +1,181 @@
+# 柱状图
+
+## Content 约束
+
+- 数据点 ≤ 12
+- 同一数据系列用同一颜色（不要每个柱不同色）
+- Y 轴必须有单位标注（如 "万元"、"人次"）
+
+## Layout 选型
+
+- **脚本生成坐标**（推荐）：用 .js 脚本计算柱体位置和高度，脚本输出 JSON 文件后调用 `npx -y @larksuite/whiteboard-cli@^0.2.0` 渲染
+- **绝对定位手写**：简单柱状图（≤ 5 个柱）可手写坐标
+
+## Layout 规则
+
+- 白板坐标系 Y 轴向下为正，图表"底部原点"拥有最大 Y 值，柱体向上生长时 Y 减小
+- 柱体等宽等间距，底部对齐 X 轴
+- 柱体高度：`height = (value / maxValue) * chartHeight`
+- 柱体 Y 坐标：`y = originY - height`
+- 坐标轴用 connector 直线，末端带箭头（endArrow: "arrow"）
+- 格线用虚线 connector（lineStyle: "dashed"，endArrow: "none"）
+- 刻度线短横线 connector（endArrow: "none"）
+- 数值标注放在柱体顶部上方
+- 类别标签放在 X 轴下方，居中对齐柱体
+
+## 坐标与尺寸计算指南
+
+白板坐标系中，**X 轴向右为正，Y 轴向下为正**。因此图表的"底部原点"实际上拥有最大的 Y 坐标，图形向上生长时 Y 坐标在不断减小。
+
+1. **确定图表区域**：
+   - 设定图表区高度 `chartHeight` 和宽度 `chartWidth`
+   - 设定左下角坐标原点 `(originX, originY)`
+   - 示例：originX=80, originY=480, chartWidth=1000, chartHeight=400
+2. **Y 轴映射（计算高度）**：
+   - 找出数据的最大值 `maxValue`
+   - 将 maxValue 向上取整到"整数刻度"（如数据最大 190 → maxValue 取 200）
+   - 柱子高度：`height = (value / maxValue) * chartHeight`
+   - 柱子 Y 坐标：`y = originY - height`
+3. **X 轴映射（计算宽度与 X 坐标）**：
+   - 将 chartWidth 按数据个数均分：`slotWidth = chartWidth / barCount`
+   - 设定柱子间距 `barGap`（推荐 slotWidth 的 25%-30%）
+   - 柱子宽度：`barWidth = slotWidth - barGap`
+   - 第 i 根柱子 X 坐标：`x = originX + i * slotWidth + barGap / 2`
+4. **Y 轴刻度计算**：
+   - 将 0 到 maxValue 等分为 4-6 个刻度
+   - 每个刻度的 Y 坐标：`gridY = originY - (tickValue / maxValue) * chartHeight`
+   - 刻度线：从 (originX-10, gridY) 到 (originX, gridY) 的短横线
+   - 网格线：从 (originX, gridY) 到 (originX+chartWidth, gridY) 的虚线
+
+## 完整 JSON 示例
+
+以下示例：3 根柱子，数据 [120, 200, 150]，maxValue=200，originX=80, originY=480, chartWidth=900, chartHeight=400。
+
+- slotWidth = 900 / 3 = 300
+- barGap = 80, barWidth = 220
+- 刻度：0, 50, 100, 150, 200（每 50 一格，gridInterval = 80px）
+
+```json
+{
+  "version": 2,
+  "nodes": [
+    { "type": "rect", "x": 0, "y": 0, "width": 1100, "height": 580 },
+
+    { "type": "text", "x": 80, "y": 10, "width": 900, "height": "fit-content",
+      "text": "季度销售额对比", "fontSize": 24, "textAlign": "center" },
+
+    { "type": "text", "x": 10, "y": 40, "width": 60, "height": "fit-content",
+      "text": "万元", "fontSize": 12, "textAlign": "center" },
+
+    { "type": "connector", "connector": {
+      "from": { "x": 80, "y": 480 }, "to": { "x": 80, "y": 55 },
+      "lineShape": "straight", "lineWidth": 2, "endArrow": "arrow"
+    }},
+    { "type": "connector", "connector": {
+      "from": { "x": 80, "y": 480 }, "to": { "x": 1000, "y": 480 },
+      "lineShape": "straight", "lineWidth": 2, "endArrow": "arrow"
+    }},
+
+    { "type": "connector", "connector": {
+      "from": { "x": 70, "y": 480 }, "to": { "x": 80, "y": 480 },
+      "lineShape": "straight", "lineWidth": 1,
+      "startArrow": "none", "endArrow": "none"
+    }},
+    { "type": "text", "x": 20, "y": 470, "width": 50, "height": 20,
+      "text": "0", "fontSize": 12, "textAlign": "right" },
+
+    { "type": "connector", "connector": {
+      "from": { "x": 70, "y": 400 }, "to": { "x": 80, "y": 400 },
+      "lineShape": "straight", "lineWidth": 1,
+      "startArrow": "none", "endArrow": "none"
+    }},
+    { "type": "text", "x": 20, "y": 390, "width": 50, "height": 20,
+      "text": "50", "fontSize": 12, "textAlign": "right" },
+    { "type": "connector", "connector": {
+      "from": { "x": 80, "y": 400 }, "to": { "x": 980, "y": 400 },
+      "lineShape": "straight", "lineWidth": 1, "lineStyle": "dashed",
+      "startArrow": "none", "endArrow": "none"
+    }},
+
+    { "type": "connector", "connector": {
+      "from": { "x": 70, "y": 320 }, "to": { "x": 80, "y": 320 },
+      "lineShape": "straight", "lineWidth": 1,
+      "startArrow": "none", "endArrow": "none"
+    }},
+    { "type": "text", "x": 20, "y": 310, "width": 50, "height": 20,
+      "text": "100", "fontSize": 12, "textAlign": "right" },
+    { "type": "connector", "connector": {
+      "from": { "x": 80, "y": 320 }, "to": { "x": 980, "y": 320 },
+      "lineShape": "straight", "lineWidth": 1, "lineStyle": "dashed",
+      "startArrow": "none", "endArrow": "none"
+    }},
+
+    { "type": "connector", "connector": {
+      "from": { "x": 70, "y": 240 }, "to": { "x": 80, "y": 240 },
+      "lineShape": "straight", "lineWidth": 1,
+      "startArrow": "none", "endArrow": "none"
+    }},
+    { "type": "text", "x": 20, "y": 230, "width": 50, "height": 20,
+      "text": "150", "fontSize": 12, "textAlign": "right" },
+    { "type": "connector", "connector": {
+      "from": { "x": 80, "y": 240 }, "to": { "x": 980, "y": 240 },
+      "lineShape": "straight", "lineWidth": 1, "lineStyle": "dashed",
+      "startArrow": "none", "endArrow": "none"
+    }},
+
+    { "type": "connector", "connector": {
+      "from": { "x": 70, "y": 160 }, "to": { "x": 80, "y": 160 },
+      "lineShape": "straight", "lineWidth": 1,
+      "startArrow": "none", "endArrow": "none"
+    }},
+    { "type": "text", "x": 20, "y": 150, "width": 50, "height": 20,
+      "text": "200", "fontSize": 12, "textAlign": "right" },
+    { "type": "connector", "connector": {
+      "from": { "x": 80, "y": 160 }, "to": { "x": 980, "y": 160 },
+      "lineShape": "straight", "lineWidth": 1, "lineStyle": "dashed",
+      "startArrow": "none", "endArrow": "none"
+    }},
+
+    { "type": "rect", "id": "bar-0", "x": 120, "y": 240,
+      "width": 220, "height": 240, "borderRadius": 4 },
+    { "type": "text", "x": 120, "y": 215,
+      "width": 220, "height": 20,
+      "text": "120", "fontSize": 14, "textAlign": "center" },
+    { "type": "text", "x": 120, "y": 490,
+      "width": 220, "height": 30,
+      "text": "Q1", "fontSize": 14, "textAlign": "center" },
+
+    { "type": "rect", "id": "bar-1", "x": 420, "y": 80,
+      "width": 220, "height": 400, "borderRadius": 4 },
+    { "type": "text", "x": 420, "y": 55,
+      "width": 220, "height": 20,
+      "text": "200", "fontSize": 14, "textAlign": "center" },
+    { "type": "text", "x": 420, "y": 490,
+      "width": 220, "height": 30,
+      "text": "Q2", "fontSize": 14, "textAlign": "center" },
+
+    { "type": "rect", "id": "bar-2", "x": 720, "y": 180,
+      "width": 220, "height": 300, "borderRadius": 4 },
+    { "type": "text", "x": 720, "y": 155,
+      "width": 220, "height": 20,
+      "text": "150", "fontSize": 14, "textAlign": "center" },
+    { "type": "text", "x": 720, "y": 490,
+      "width": 220, "height": 30,
+      "text": "Q3", "fontSize": 14, "textAlign": "center" }
+  ]
+}
+```
+
+坐标推导验证：
+- bar-0 (120): height = (120/200)*400 = 240, y = 480-240 = 240
+- bar-1 (200): height = (200/200)*400 = 400, y = 480-400 = 80
+- bar-2 (150): height = (150/200)*400 = 300, y = 480-300 = 180
+- bar-0 x = 80 + 0*300 + 80/2 = 120, bar-1 x = 80 + 1*300 + 40 = 420, bar-2 x = 80 + 2*300 + 40 = 720
+
+## 陷阱
+
+- 单系列用多色（不专业）：同一数据系列所有柱体应使用同一颜色
+- 缺 Y 轴单位标注，读者无法理解数值含义
+- 柱体间距不均匀（脚本需统一计算 barGap）
+- Y 轴刻度线和格线误带箭头
+- 坐标轴忘记带箭头

package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/comparison.md

@@ -0,0 +1,135 @@
+# 对比图 / 矩阵图
+
+适用于：方案对比、功能矩阵、技术选型等多选项按多维度比较的场景。
+
+## Content 约束
+
+- **每格内容要充实**：不要只写一个关键词，给出具体说明（如"MVCC 多版本并发控制，支持行级锁"而非仅"支持"）
+- 单格内容不同格子允许不同长度，但每格不超过 5 行
+- 长文本（超过 15 字）用 `textAlign: "left"`（不要居中）
+- 第一行是标题行（对象名称），第一列是维度标签列
+- 维度数量至少 4 个，充分展开对比维度
+
+## Layout 选型
+
+| 模式 | 适用条件 | 特征 |
+|------|---------|------|
+| **严格 grid（默认）** | 所有对比场景 | 表头行 + 数据行，每行 horizontal frame，行内 rect 等分 |
+| **卡片式对比（替代）** | 维度较少（2-3 个） | 每个对象做一张独立卡片，卡片内纵向列出各维度。卡片横向等分：外层 `layout: "horizontal"`，每张卡片 `width: "fill-container"` |
+
+## Layout 规则
+
+- 最外层 frame：`layout: "vertical"`，固定 `width`（如 1000），`height: "fit-content"`
+- 每行：horizontal frame，`width: "fill-container"`，`alignItems: "stretch"`
+- 行内单元格全部 `width: "fill-container"` 等分列宽
+- 行间 `gap >= 12`（不要 8，太紧）
+- 行内列间 `gap: 8-12`
+- 标题行：深色底白字（由 style 控制具体颜色）
+- 每列同色边框保持视觉一致性
+- 单元格 `height: "fit-content"`，不要写固定 height
+
+## 骨架示例
+
+### 3 列 4 行表格
+
+```json
+{
+  "version": 2,
+  "nodes": [
+    {
+      "type": "frame",
+      "width": 1000,
+      "height": "fit-content",
+      "layout": "vertical",
+      "gap": 12,
+      "padding": 0,
+      "children": [
+        {
+          "type": "text",
+          "id": "title",
+          "width": "fill-container",
+          "height": "fit-content",
+          "text": "[对比图标题]",
+          "fontSize": 24,
+          "textAlign": "center",
+          "verticalAlign": "middle"
+        },
+        {
+          "type": "frame",
+          "id": "header-row",
+          "width": "fill-container",
+          "height": "fit-content",
+          "layout": "horizontal",
+          "gap": 8,
+          "padding": 0,
+          "alignItems": "stretch",
+          "children": [
+            { "type": "rect", "id": "h-dim", "width": "fill-container", "height": "fit-content", "text": "[维度]", "fontSize": 15, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 0, "borderWidth": 2 },
+            { "type": "rect", "id": "h-col-1", "width": "fill-container", "height": "fit-content", "text": "[对象A]", "fontSize": 15, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "h-col-2", "width": "fill-container", "height": "fit-content", "text": "[对象B]", "fontSize": 15, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "h-col-3", "width": "fill-container", "height": "fit-content", "text": "[对象C]", "fontSize": 15, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 }
+          ]
+        },
+        {
+          "type": "frame",
+          "id": "data-row-1",
+          "width": "fill-container",
+          "height": "fit-content",
+          "layout": "horizontal",
+          "gap": 8,
+          "padding": 0,
+          "alignItems": "stretch",
+          "children": [
+            { "type": "rect", "id": "d1-dim", "width": "fill-container", "height": "fit-content", "text": "[维度1]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "d1-c1", "width": "fill-container", "height": "fit-content", "text": "[...]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "d1-c2", "width": "fill-container", "height": "fit-content", "text": "[...]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "d1-c3", "width": "fill-container", "height": "fit-content", "text": "[...]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 }
+          ]
+        },
+        {
+          "type": "frame",
+          "id": "data-row-2",
+          "width": "fill-container",
+          "height": "fit-content",
+          "layout": "horizontal",
+          "gap": 8,
+          "padding": 0,
+          "alignItems": "stretch",
+          "children": [
+            { "type": "rect", "id": "d2-dim", "width": "fill-container", "height": "fit-content", "text": "[维度2]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "d2-c1", "width": "fill-container", "height": "fit-content", "text": "[...]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "d2-c2", "width": "fill-container", "height": "fit-content", "text": "[...]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "d2-c3", "width": "fill-container", "height": "fit-content", "text": "[...]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 }
+          ]
+        },
+        {
+          "type": "frame",
+          "id": "data-row-3",
+          "width": "fill-container",
+          "height": "fit-content",
+          "layout": "horizontal",
+          "gap": 8,
+          "padding": 0,
+          "alignItems": "stretch",
+          "children": [
+            { "type": "rect", "id": "d3-dim", "width": "fill-container", "height": "fit-content", "text": "[维度3]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "d3-c1", "width": "fill-container", "height": "fit-content", "text": "[...]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "d3-c2", "width": "fill-container", "height": "fit-content", "text": "[...]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 },
+            { "type": "rect", "id": "d3-c3", "width": "fill-container", "height": "fit-content", "text": "[...]", "fontSize": 14, "textAlign": "center", "verticalAlign": "middle", "borderRadius": 8, "borderWidth": 2 }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+## 陷阱
+
+- **行间距 8px 太紧**：行间 gap 至少 12，8 会让行与行视觉粘连。
+- **长文本居中对齐**：超过一行的文本应改为 `textAlign: "left"`，居中多行文本可读性差。
+- **列数太多导致每列太窄**：对比对象建议 ≤ 5 列（含维度列），超过时合并维度或拆分为多张表。
+- **列宽不等**：所有数据列必须用 `width: "fill-container"` 等分，不要给某列写固定宽度。
+- **行高不等**：每行 frame 必须 `alignItems: "stretch"`，否则同行单元格因文字行数不同高矮不齐。
+- **忘记维度标签列**：第一列放维度名称，标题行（维度列）用与数据列不同的视觉处理。
+- **单元格用固定 height**：单元格必须 `height: "fit-content"`，固定高度会导致文字截断。

package/server/assets/skills/lark-tools/cli-skills/lark-whiteboard-cli/scenes/fishbone.md

@@ -0,0 +1,238 @@
+# 鱼骨图（因果图）
+
+> **必须写脚本生成 JSON。** 鱼骨图的分支角度、原因小骨坐标需要三角函数计算，直接手写 JSON 极易导致节点重叠和连线穿模。请用下方脚本模板。
+
+## Content 约束
+
+- 分类 4-6 个
+- 每个分类的原因 ≤ 4
+- 总原因 ≤ 20（超过必须合并分类）
+
+## Layout 选型
+
+- **脚本生成坐标**（必须）：用 .js 脚本通过三角函数计算鱼骨坐标，脚本输出 JSON 文件后调用 `npx -y @larksuite/whiteboard-cli@^0.2.0` 渲染
+
+## Layout 规则
+
+- 主干水平居中，从左向右延伸
+- 分类节点按 spineX 从左到右排列，奇数（第 1、3、5...）在上方，偶数（第 2、4...）在下方
+- 每个分类的原因沿斜线（分支骨）等距排列
+- 鱼头（中心问题）在右侧，用 ellipse
+- 主干连线带箭头指向鱼头，分支骨和原因小骨连线 endArrow: "none"
+- 原因小骨水平延伸到原因框右侧，Y 坐标精准对齐
+
+## 骨架示例
+
+**上下交替**：分类标签按 spineX 从左到右排列，奇数（第1、3、5...）在上方，偶数（第2、4...）在下方。
+
+**视觉同色系**：同一个分支的分类标签、连线及其下的所有原因节点，必须使用同一个色系（如相同的背景色与边框色组合），以保持图形风格统一和逻辑连贯。可以预定义一组颜色数组，按分支轮询使用。
+
+### 坐标计算脚本模板（必须严格参照此算法生成）
+
+以下 Node.js 脚本模板包含了完整的动态布局算法，能够自动适配任意数量的分类和原因，生成完美不重叠的鱼骨图：
+
+```javascript
+const fs = require('fs');
+
+const nodes = [];
+
+// 1. 数据定义 (根据用户需求填充)
+const categories = [
+  { id: "c0", text: "前端代码", reasons: ["未压缩资源", "冗余请求", "超大图片未懒加载"] },
+  { id: "c1", text: "后端服务", reasons: ["数据库慢查询", "缓存失效", "并发量过大"] },
+  { id: "c2", text: "网络环境", reasons: ["CDN配置错误", "DNS解析缓慢", "带宽限制", "网络抖动"] }
+];
+
+// 2. 动态布局计算
+const catWidth = 120;
+const catHeight = 40;
+const reasonWidth = 140; // 调整原因框宽度以适应长文本
+const reasonHeight = 32;
+const lineLength = 20; // 原因小骨连线的水平延伸长度
+const paddingX = 40; // 同侧节点间的水平安全间距
+
+// 预置的分支色系数组（分支骨分类和具体原因保持同一色系）
+const branchColors = [
+  { fill: "#E8F3FF", stroke: "#1664FF" }, // 蓝色系
+  { fill: "#E6FFED", stroke: "#00B42A" }, // 绿色系
+  { fill: "#FFF7E8", stroke: "#FF7D00" }, // 橙色系
+  { fill: "#FFECE8", stroke: "#F5319D" }, // 粉色系
+  { fill: "#F2E8FF", stroke: "#722ED1" }, // 紫色系
+  { fill: "#E8FFFF", stroke: "#14C9C9" }  // 青色系
+];
+
+let maxSpineY_up = 0;
+let maxSpineY_down = 0;
+
+// 第一步：计算每个 category 的内部尺寸和相对包围盒
+categories.forEach((cat, index) => {
+  const isTop = index % 2 === 0;
+  const numReasons = cat.reasons.length;
+
+  // 动态计算分支高度，确保原因小骨不会垂直重叠
+  // 每个原因需要 reasonHeight + 上下间距(约 16)
+  const requiredY = (numReasons + 1) * (reasonHeight + 16);
+  const branchDY = Math.max(160, requiredY);
+  const branchDX = -branchDY * 0.7; // 保持固定的倾斜角度向左延伸
+
+  cat.isTop = isTop;
+  cat.branchDX = branchDX;
+  cat.branchDY = branchDY;
+
+  // 记录最大分支高度，用于计算背景高度和主骨 Y 坐标
+  if (isTop) maxSpineY_up = Math.max(maxSpineY_up, branchDY + catHeight + 40);
+  else maxSpineY_down = Math.max(maxSpineY_down, branchDY + catHeight + 40);
+
+  // 计算该分类的相对包围盒的极值（相对于 spineX 锚点）
+  // 最左侧可能由分类框或原因框决定
+  cat.minX = Math.min(branchDX - catWidth / 2, branchDX - lineLength - reasonWidth);
+  // 最右侧为主骨挂载点 0 或 分类框右侧
+  cat.maxX = Math.max(0, branchDX + catWidth / 2);
+});
+
+// 第二步：计算每个 category 在主骨上的绝对 X 坐标 (spineX)
+let currentSpineX = 100; // 初始偏移
+for (let i = 0; i < categories.length; i++) {
+  const cat = categories[i];
+  let startX = currentSpineX;
+
+  // 需要和上一个同侧的 category 保持距离，防止水平重叠
+  if (i >= 2) {
+    const prevSameSideCat = categories[i - 2];
+    const requiredX = prevSameSideCat.spineX + prevSameSideCat.maxX - cat.minX + paddingX;
+    startX = Math.max(startX, requiredX);
+  }
+
+  // 确保左侧最长分支不会超出画布左边界
+  if (startX + cat.minX < 50) {
+    startX = 50 - cat.minX;
+  }
+
+  cat.spineX = startX;
+  // 每次略微向前推进，确保异侧节点也能稍微错开
+  currentSpineX = startX + 80;
+}
+
+// 第三步：计算全局画布尺寸
+const lastCat = categories[categories.length - 1];
+const spineY = maxSpineY_up + 50; // 动态推导主骨 Y 坐标
+const totalWidth = lastCat.spineX + 350; // 右侧留出鱼头的空间
+const totalHeight = spineY + maxSpineY_down + 50;
+
+// 4. 生成节点数据
+// 背景
+nodes.push({ type: "rect", x: 0, y: 0, width: totalWidth, height: totalHeight, fillColor: "#FFFFFF", borderWidth: 0 });
+
+// 鱼头
+const headWidth = 180;
+const headHeight = 80;
+const headX = totalWidth - headWidth - 40;
+const headY = spineY - headHeight / 2;
+nodes.push({ type: "ellipse", id: "head", x: headX, y: headY, width: headWidth, height: headHeight, text: "核心问题" });
+
+// 主骨连线
+const firstSpineX = categories[0].spineX + categories[0].minX;
+nodes.push({
+  type: "connector",
+  connector: { from: { x: firstSpineX, y: spineY }, to: "head", toAnchor: "left", lineShape: "straight", endArrow: "arrow" }
+});
+
+// 遍历生成分类和原因小骨
+categories.forEach((cat, index) => {
+  const isTop = cat.isTop;
+  const branchDY = cat.branchDY;
+  const branchDX = cat.branchDX;
+  const color = branchColors[index % branchColors.length];
+
+  // 分类标签
+  const catX = cat.spineX + branchDX - catWidth / 2;
+  const catY = spineY + (isTop ? -branchDY - catHeight : branchDY);
+
+  nodes.push({
+    type: "rect", id: cat.id, x: catX, y: catY, width: catWidth, height: catHeight, text: cat.text,
+    fillColor: color.fill, strokeColor: color.stroke
+  });
+  // 分支骨连线
+  nodes.push({
+    type: "connector",
+    connector: { from: { x: cat.spineX, y: spineY }, to: cat.id, toAnchor: isTop ? "bottom" : "top", lineShape: "straight", endArrow: "none", lineColor: color.stroke }
+  });
+
+  // 原因小骨
+  cat.reasons.forEach((reason, rIndex) => {
+    // 线性插值，均匀分布在分支骨上
+    const t = (rIndex + 1) / (cat.reasons.length + 1);
+    const attachX = cat.spineX + branchDX * t;
+    const attachY = spineY + (isTop ? -branchDY : branchDY) * t;
+
+    // 关键对齐：确保原因盒子完全在连线左侧，并且 Y 坐标中心精准对齐
+    const boxX = attachX - lineLength - reasonWidth;
+    const boxY = attachY - reasonHeight / 2;
+
+    const rId = `${cat.id}-r${rIndex}`;
+    nodes.push({
+      type: "rect", id: rId, x: boxX, y: boxY, width: reasonWidth, height: reasonHeight, text: reason,
+      fillColor: color.fill, strokeColor: color.stroke
+    });
+    // 原因小骨连线
+    nodes.push({
+      type: "connector",
+      connector: { from: { x: attachX, y: attachY }, to: rId, toAnchor: "right", lineShape: "straight", endArrow: "none", lineColor: color.stroke }
+    });
+  });
+});
+
+fs.writeFileSync('diagram.json', JSON.stringify({ version: 2, nodes }, null, 2));
+```
+
+## 连线格式与注意点
+
+所有 connector 都用 `{ "type": "connector", "connector": { ... } }` 格式。
+**注意：除了主骨外，其他所有连线（分支骨、原因小骨）都必须设置 `"endArrow": "none"`，否则会默认带箭头，导致方向混乱。**
+
+分支骨：从主骨上的绝对坐标点 → 分类标签节点：
+
+```json
+{
+  "version": 2,
+  "nodes": [
+    { "type": "rect", "x": 0, "y": 0, "width": "__totalWidth__", "height": "__totalHeight__" },
+
+    { "type": "ellipse", "id": "head", "x": "__headX__", "y": "__headY__",
+      "width": 180, "height": 80, "text": "[中心问题]" },
+
+    { "type": "connector", "connector": {
+      "from": { "x": "__spineStartX__", "y": "__spineY__" },
+      "to": "head", "toAnchor": "left",
+      "lineShape": "straight", "endArrow": "arrow"
+    }},
+
+    { "type": "rect", "id": "c0", "x": "__catX__", "y": "__catY__",
+      "width": 120, "height": 40, "text": "[分类A]" },
+    { "type": "connector", "connector": {
+      "from": { "x": "__spineX0__", "y": "__spineY__" },
+      "to": "c0", "toAnchor": "bottom",
+      "lineShape": "straight", "endArrow": "none"
+    }},
+
+    { "type": "rect", "id": "c0-r0", "x": "__reasonX__", "y": "__reasonY__",
+      "width": 140, "height": 32, "text": "[原因1]" },
+    { "type": "connector", "connector": {
+      "from": { "x": "__attachX__", "y": "__attachY__" },
+      "to": "c0-r0", "toAnchor": "right",
+      "lineShape": "straight", "endArrow": "none"
+    }}
+  ]
+}
+```
+
+上述骨架展示一个分类（上方）+ 一条原因的模式。完整鱼骨图重复此模式，上下交替。每个分类下可有多条原因，均匀插值分布在分支骨上。
+
+## 陷阱
+
+- **代码生成**：必须使用带有动态防重叠算法的脚本来计算坐标并输出 JSON。
+- **分支骨防重叠**：同一侧的相邻分支骨和原因框必须没有任何交叉。
+- **自适应高度**：原因数量较多时，分支骨自动拉长以容纳所有小骨。
+- **原因小骨水平**：原因框右侧的附着点必须与连线起点 Y 坐标一致。
+- **无箭头**：所有分类的分支连线、小骨连线均必须关闭箭头。
+- **同色系**：同一个分支骨、分类标签节点以及原因小骨节点和连线，必须使用同色系的颜色以保持视觉连贯性。