@wagemule/daemon 0.1.2 → 0.1.4

package/dist/skills/larksuite/lark-whiteboard/scenes/milestone.md

@@ -0,0 +1,139 @@
+# 里程碑时间线 (Milestone)
+
+## Content 约束
+
+- 节点 4-8 个
+- 每节点：标题 + 日期 + 可选描述
+- 时间从左到右递增
+
+## Layout 选型
+
+两种方案按需选择：
+
+1. **横向时间线**：horizontal frame，节点等分
+2. **交替上下**：绝对定位，节点交替在时间轴上下方（节点多时更紧凑）
+
+## 结构特征
+
+- **标题居中**：顶部放置图表标题
+- **年份/时间轴条**：箭头形色块承载年份，按时间从左到右递增
+- **里程碑卡片**：下方虚线圆角卡片承载标题与描述
+- **严格对齐**：年份条与对应卡片等宽，左右对齐
+- **文字层级**：标题加粗在上，描述文字更小更浅在下，居中对齐
+
+## Layout 规则
+
+- 绝对定位为主（`layout: "none"`），节点位置承载时间序列含义
+- 先确定里程碑数量，计算等距的 x 坐标序列
+- 时间轴用 connector 贯穿所有节点
+- 节点与时间轴用短竖线连接
+- 节点间水平间距一致
+- 年份条宽度 = 卡片宽度，垂直间距统一
+- 标题与年份区域保留足够留白
+
+## 骨架示例
+
+```json
+{
+  "version": 2,
+  "nodes": [
+    {
+      "type": "frame",
+      "x": 0, "y": 0,
+      "width": 1200, "height": 360,
+      "layout": "none",
+      "children": [
+        {
+          "type": "text",
+          "x": 300, "y": 12,
+          "width": 600, "height": "fit-content",
+          "text": [{ "content": "{{CHART_TITLE}}", "bold": true, "fontSize": 24 }],
+          "textAlign": "center"
+        },
+
+        {
+          "type": "svg",
+          "x": 50, "y": 56,
+          "width": 190, "height": 36,
+          "svg": {
+            "code": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 190 36\"><polygon points=\"0,0 170,0 190,18 170,36 0,36\"/></svg>"
+          }
+        },
+        {
+          "type": "text",
+          "x": 50, "y": 64,
+          "width": 190, "height": "fit-content",
+          "text": "{{DATE_1}}",
+          "textAlign": "center"
+        },
+        {
+          "type": "rect",
+          "x": 50, "y": 132,
+          "width": 190, "height": 120,
+          "borderDash": "dashed",
+          "borderRadius": 8
+        },
+        {
+          "type": "text",
+          "x": 50, "y": 150,
+          "width": 190, "height": "fit-content",
+          "text": [{ "content": "{{MILESTONE_1_TITLE}}", "bold": true, "fontSize": 16 }],
+          "textAlign": "center"
+        },
+        {
+          "type": "text",
+          "x": 50, "y": 180,
+          "width": 190, "height": "fit-content",
+          "text": "{{MILESTONE_1_DESC}}",
+          "fontSize": 13,
+          "textAlign": "center"
+        },
+
+        {
+          "type": "svg",
+          "x": 290, "y": 56,
+          "width": 190, "height": 36,
+          "svg": {
+            "code": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 190 36\"><polygon points=\"0,0 170,0 190,18 170,36 0,36\"/></svg>"
+          }
+        },
+        {
+          "type": "text",
+          "x": 290, "y": 64,
+          "width": 190, "height": "fit-content",
+          "text": "{{DATE_2}}",
+          "textAlign": "center"
+        },
+        {
+          "type": "rect",
+          "x": 290, "y": 132,
+          "width": 190, "height": 120,
+          "borderDash": "dashed",
+          "borderRadius": 8
+        },
+        {
+          "type": "text",
+          "x": 290, "y": 150,
+          "width": 190, "height": "fit-content",
+          "text": [{ "content": "{{MILESTONE_2_TITLE}}", "bold": true, "fontSize": 16 }],
+          "textAlign": "center"
+        },
+        {
+          "type": "text",
+          "x": 290, "y": 180,
+          "width": 190, "height": "fit-content",
+          "text": "{{MILESTONE_2_DESC}}",
+          "fontSize": 13,
+          "textAlign": "center"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## 陷阱
+
+- **节点太多时太拥挤**：超过 6 个节点时考虑交替上下布局或增大画布宽度
+- **右侧节点与时间轴末端重叠**：最后一个节点的 x + width 不要超出画布边界
+- **年份条与卡片不对齐**：年份条和卡片的 x、width 必须完全一致

package/dist/skills/larksuite/lark-whiteboard/scenes/organization.md

@@ -0,0 +1,173 @@
+# 组织架构图
+
+适用于：公司组织架构、模块依赖树、分类层级树等树形层级结构的场景。
+
+## Content 约束
+
+- 层级 ≤ 4
+- 每个父节点下 ≤ 5 个子节点
+- 叶节点有意义（不要只为凑数添加空节点）
+- 长文本用 `\n` 手动换行（如"研发负责人\n(CTO)"）
+
+## Layout 选型
+
+| 模式 | 适用条件 | 特征 |
+|------|---------|------|
+| **tree（居中展开）** | 有明确从属关系的层级结构 | 根节点居中，子节点横向排列，逐层展开。每个"父+子"用 vertical frame 包裹（子树模块） |
+| **grid（矩阵式）** | 多部门平级，每部门内部有细分 | 横向等分各部门，每部门内部 vertical 列表 |
+
+## Layout 规则
+
+以下规则违反会导致连线错乱或排版崩溃：
+
+1. **子树包裹模式（关键）**：每个父节点和它的子节点群用一个 `layout: "vertical"` + `alignItems: "center"` 的 frame 包裹。**不要**把所有父节点放一层、所有子节点放另一层。*违反后果：父节点与子节点群中心偏移，正交连线无法合并，分裂成两条平行线。*
+2. **同层节点建议等高**：同层节点统一 `height`（如 60-70），保证连线横向主轴平直。如果文字长度差异大可用 `fit-content`，但要确保同层文字行数接近。*违反后果：同层节点高低不平，rightAngle 连线横向弯折错乱。*
+3. **垂直间距 >= 60**：父子间纵向 `gap: 60`。*违反后果：连线引擎没有足够空间折弯与合并，导致连线穿模或提前分叉。*
+4. **叶子容器偶数宽度**：包含叶子节点的横向 frame，宽度应手动计算（子节点宽度之和 + gap × (n-1)），如 2 个 120px 节点 + 20px gap = `width: 260`。或用 `fill-container` 自动等分。*违反后果：父节点中心与子节点群中心有像素级偏差。*
+5. **同层兄弟间横向 gap: 20-40**
+6. 最小字号 14px
+7. 连线：所有父子连线必须 `lineShape: "rightAngle"`（总线风格），`fromAnchor: "bottom"`, `toAnchor: "top"`。*违反后果：失去组织架构图专属的总线视觉效果。*
+8. 根 frame 宽度要足够（如 1200-1600），避免叶节点被挤压重叠
+9. 不同层级在 fontSize、borderWidth、颜色上递进区分（如 Root 深灰 → L1 浅蓝 → L2 浅绿 → L3 浅紫）
+10. 长文本用 `\n` 主动换行（如 "基础架构部\n(包含云原生)"），确保节点高度足够容纳
+
+## 骨架示例
+
+### 树形展开（子树包裹模式）
+
+```json
+{
+  "version": 2,
+  "nodes": [
+    {
+      "type": "frame",
+      "width": 1200,
+      "height": "fit-content",
+      "layout": "vertical",
+      "gap": 48,
+      "padding": 40,
+      "alignItems": "center",
+      "children": [
+        {
+          "type": "text",
+          "id": "title",
+          "width": "fill-container",
+          "height": "fit-content",
+          "text": "[图表标题]",
+          "fontSize": 24,
+          "textAlign": "center",
+          "verticalAlign": "middle"
+        },
+        {
+          "type": "rect",
+          "id": "root-node",
+          "width": 240,
+          "height": "fit-content",
+          "borderWidth": 3,
+          "borderRadius": 8,
+          "text": "[根节点名]",
+          "fontSize": 18,
+          "padding": 12
+        },
+        {
+          "type": "frame",
+          "width": "fill-container",
+          "height": "fit-content",
+          "layout": "horizontal",
+          "gap": 40,
+          "padding": 0,
+          "alignItems": "stretch",
+          "children": [
+            {
+              "type": "frame",
+              "width": "fill-container",
+              "height": "fit-content",
+              "layout": "vertical",
+              "gap": 48,
+              "padding": 0,
+              "alignItems": "center",
+              "children": [
+                {
+                  "type": "rect",
+                  "id": "child-a",
+                  "width": 200,
+                  "height": "fit-content",
+                  "borderWidth": 2,
+                  "borderRadius": 8,
+                  "text": "[子节点名]",
+                  "fontSize": 16,
+                  "padding": 10
+                },
+                {
+                  "type": "frame",
+                  "width": "fill-container",
+                  "height": "fit-content",
+                  "layout": "horizontal",
+                  "gap": 40,
+                  "padding": 0,
+                  "alignItems": "stretch",
+                  "children": [
+                    { "type": "rect", "id": "leaf-a1", "width": "fill-container", "height": "fit-content", "borderWidth": 1, "borderRadius": 8, "text": "[叶节点名]", "fontSize": 14, "padding": 8 },
+                    { "type": "rect", "id": "leaf-a2", "width": "fill-container", "height": "fit-content", "borderWidth": 1, "borderRadius": 8, "text": "[叶节点名]", "fontSize": 14, "padding": 8 }
+                  ]
+                }
+              ]
+            },
+            {
+              "type": "frame",
+              "width": "fill-container",
+              "height": "fit-content",
+              "layout": "vertical",
+              "gap": 48,
+              "padding": 0,
+              "alignItems": "center",
+              "children": [
+                {
+                  "type": "rect",
+                  "id": "child-b",
+                  "width": 200,
+                  "height": "fit-content",
+                  "borderWidth": 2,
+                  "borderRadius": 8,
+                  "text": "[子节点名]",
+                  "fontSize": 16,
+                  "padding": 10
+                },
+                {
+                  "type": "frame",
+                  "width": "fill-container",
+                  "height": "fit-content",
+                  "layout": "horizontal",
+                  "gap": 40,
+                  "padding": 0,
+                  "alignItems": "stretch",
+                  "children": [
+                    { "type": "rect", "id": "leaf-b1", "width": "fill-container", "height": "fit-content", "borderWidth": 1, "borderRadius": 8, "text": "[叶节点名]", "fontSize": 14, "padding": 8 },
+                    { "type": "rect", "id": "leaf-b2", "width": "fill-container", "height": "fit-content", "borderWidth": 1, "borderRadius": 8, "text": "[叶节点名]", "fontSize": 14, "padding": 8 }
+                  ]
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    { "type": "connector", "connector": { "from": "root-node", "to": "child-a", "fromAnchor": "bottom", "toAnchor": "top", "lineShape": "rightAngle", "lineWidth": 2 } },
+    { "type": "connector", "connector": { "from": "root-node", "to": "child-b", "fromAnchor": "bottom", "toAnchor": "top", "lineShape": "rightAngle", "lineWidth": 2 } },
+    { "type": "connector", "connector": { "from": "child-a", "to": "leaf-a1", "fromAnchor": "bottom", "toAnchor": "top", "lineShape": "rightAngle", "lineWidth": 2 } },
+    { "type": "connector", "connector": { "from": "child-a", "to": "leaf-a2", "fromAnchor": "bottom", "toAnchor": "top", "lineShape": "rightAngle", "lineWidth": 2 } },
+    { "type": "connector", "connector": { "from": "child-b", "to": "leaf-b1", "fromAnchor": "bottom", "toAnchor": "top", "lineShape": "rightAngle", "lineWidth": 2 } },
+    { "type": "connector", "connector": { "from": "child-b", "to": "leaf-b2", "fromAnchor": "bottom", "toAnchor": "top", "lineShape": "rightAngle", "lineWidth": 2 } }
+  ]
+}
+```
+
+## 陷阱
+
+- **分离父子层级（致命错误）**：不要把所有同级父节点放一个 horizontal frame、所有子节点放另一个。必须用 `alignItems: "center"` 的 vertical frame 把每个父节点和它的子节点包裹在一起。
+- **同层节点高低不平**：同层节点高度应一致（或文字行数接近），否则 rightAngle 连线横向弯折错乱。
+- **垂直间距不足**：父子间 gap 必须 >= 60。不够时连线引擎无法折弯合并。也不要用 80，3-4 层会纵向拉伸过度。
+- **做成线性链而非树形展开**：每个父节点的子节点必须横向展开，不要做单链。
+- **连线混用 straight**：所有父子连线必须 `lineShape: "rightAngle"`，`fromAnchor: "bottom"`，`toAnchor: "top"`。
+- **叶节点字号 12px 看不清**：最小字号 14px。
+- **所有节点同一大小和样式**：不同层级必须在 fontSize、borderWidth、颜色上有区分（根>子>叶）。

package/dist/skills/larksuite/lark-whiteboard/scenes/photo-showcase.md

@@ -0,0 +1,126 @@
+# 图片展示 (Photo Showcase)
+
+适用于：用户**显式要求使用图片/配图/插图**的场景（如"画一个带配图的旅行路线"、"做一个有图片的产品展示"）。
+
+> **注意**：仅当用户明确说了「图片/配图/插图/照片」等词时才进入本场景。单纯说"旅行路线图"、"产品展示"等不触发。
+
+> **前置条件**：进入本场景前，必须已完成 [`references/image.md`](../references/image.md) 的 Step 0（图片准备），拿到所有 media token。
+
+## Content 约束
+
+- 图片 3-6 张，每张配标题（必需）+ 简短描述（可选，15字内）
+- **每张图必须是不同的真实图片**（不同 media token），下载时用不同关键词/URL
+- 下载后用 `ls -l` 比较文件大小确保每张图不重复
+- 文字仅作辅助说明，图片是信息主体
+
+## Layout 选型
+
+| 模式 | 适用条件 | 特征 |
+|------|---------|------|
+| **卡片网格（默认）** | 多图平级展示（产品墙、团队介绍、美食推荐） | horizontal frame 内放等尺寸图文卡片 |
+| **路线时间线** | 有先后顺序（旅行路线、团建路线、项目演进） | 图文卡片 + connector 串联 |
+| **中心辐射** | 有一个核心主题 + 周围子项 | 中心标题 + 周围图文卡片 |
+
+## Layout 规则
+
+- **图文卡片结构**：vertical frame（图上文下），image 宽度 = 卡片宽度，height 按 3:2 比例
+- **卡片统一尺寸**：所有卡片宽高一致（推荐 240×280 或 200×250）
+- **图片统一尺寸**：所有 image 节点用相同 width/height（推荐 240×160 或 200×133）
+- **卡片间距**：gap: 24（比纯文字图表间距更大，让图片呼吸）
+- **卡片样式**：白色底 + 圆角 12 + 细边框，image 无圆角（紧贴卡片顶部）
+- **有序路线时**：卡片间用 connector 连接，connector 放顶层 nodes 数组
+
+## 骨架示例
+
+### 卡片网格（产品展示/团队介绍/美食推荐）
+
+```json
+{
+  "version": 2,
+  "nodes": [
+    {
+      "type": "frame", "id": "grid", "layout": "vertical", "gap": 24, "padding": 32,
+      "width": 840, "height": "fit-content",
+      "children": [
+        { "type": "text", "id": "title", "width": 776, "height": 36,
+          "text": "图表标题", "fontSize": 24, "textAlign": "center" },
+        {
+          "type": "frame", "id": "row", "layout": "horizontal", "gap": 24, "padding": 0,
+          "width": "fit-content", "height": "fit-content",
+          "children": [
+            {
+              "type": "frame", "id": "card-1", "layout": "vertical", "gap": 8, "padding": [0, 0, 12, 0],
+              "width": 240, "height": "fit-content",
+              "fillColor": "#FFFFFF", "borderWidth": 1, "borderColor": "#E0E0E0", "borderRadius": 12,
+              "children": [
+                { "type": "image", "id": "img-1", "width": 240, "height": 160, "image": { "src": "<token_1>" } },
+                { "type": "text", "id": "t-1", "text": "标题", "fontSize": 14, "width": 216, "height": 20 },
+                { "type": "text", "id": "d-1", "text": "简短描述", "fontSize": 11, "textColor": "#666666", "width": 216, "height": 16 }
+              ]
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}
+```
+
+每张图文卡片结构相同，复制并替换 `<token_N>`、标题和描述即可。3 张卡片一行，超过 3 张换行（嵌套第二个 horizontal frame）。
+
+### 路线时间线（旅行路线/团建路线）
+
+```json
+{
+  "version": 2,
+  "nodes": [
+    {
+      "type": "frame", "id": "route", "layout": "vertical", "gap": 24, "padding": 32,
+      "width": 1100, "height": "fit-content",
+      "children": [
+        { "type": "text", "id": "title", "width": 1036, "height": 36,
+          "text": "路线标题", "fontSize": 24, "textAlign": "center" },
+        {
+          "type": "frame", "id": "stops", "layout": "horizontal", "gap": 32, "padding": 0,
+          "width": "fit-content", "height": "fit-content",
+          "children": [
+            {
+              "type": "frame", "id": "stop-1", "layout": "vertical", "gap": 8, "padding": [0, 0, 12, 0],
+              "width": 240, "height": "fit-content",
+              "fillColor": "#FFFFFF", "borderWidth": 1, "borderColor": "#E0E0E0", "borderRadius": 12,
+              "children": [
+                { "type": "image", "id": "img-1", "width": 240, "height": 160, "image": { "src": "<token_1>" } },
+                { "type": "text", "id": "t-1", "text": "第1站：地点名", "fontSize": 14, "width": 216, "height": 20 }
+              ]
+            },
+            {
+              "type": "frame", "id": "stop-2", "layout": "vertical", "gap": 8, "padding": [0, 0, 12, 0],
+              "width": 240, "height": "fit-content",
+              "fillColor": "#FFFFFF", "borderWidth": 1, "borderColor": "#E0E0E0", "borderRadius": 12,
+              "children": [
+                { "type": "image", "id": "img-2", "width": 240, "height": 160, "image": { "src": "<token_2>" } },
+                { "type": "text", "id": "t-2", "text": "第2站：地点名", "fontSize": 14, "width": 216, "height": 20 }
+              ]
+            }
+          ]
+        }
+      ]
+    },
+    { "type": "connector", "id": "c1", "connector": { "from": "stop-1", "to": "stop-2", "fromAnchor": "right", "toAnchor": "left" } }
+  ]
+}
+```
+
+注意：connector 必须放在**顶层 nodes 数组**，不能嵌套在 frame.children 内。connector 的属性须包裹在 `connector` 字段中。
+
+## 图片准备检查清单
+
+生成 DSL 前确认：
+
+- [ ] 所有 image 节点的 `image.src` 都是通过 `docs +media-upload --parent-type whiteboard` 上传的 media token（非 URL、非 Drive file token）
+- [ ] 所有图片已上传到目标画板（`--parent-node` 设为目标画板 token）
+- [ ] 每个 media token 不同（对应不同的真实图片）
+- [ ] 所有图片尺寸一致（同一画板内统一 width×height）
+- [ ] 图片宽高比合理（推荐 3:2，即 240×160）
+- [ ] 渲染 PNG 后查看图片内容，确认每张图片与主题相关
+- [ ] 未使用随机占位图服务（关键词参数不影响返回内容的图库）

package/dist/skills/larksuite/lark-whiteboard/scenes/pyramid.md

@@ -0,0 +1,99 @@
+# 金字塔图 (Pyramid)
+
+## Content 约束
+
+- 层级 3-6 个，从底到顶宽度递减
+- 每层一个短标签（如关键词或短语）
+- 长文案外置到金字塔旁边，图形内仅保留核心短文案
+
+## Layout 选型
+
+vertical frame + 每层宽度递减。gap 4px 保持紧密。
+
+## Layout 规则
+
+- 外层 frame 使用 `layout: "vertical"` + `alignItems: "center"`
+- 所有层必须使用脚本计算宽度，以保证**绝对完美的等斜率（直线边缘）**。切勿手写拍脑袋的宽度！
+- children 数组中第一个元素是顶层（最窄），最后一个是底层（最宽）。
+- 顶层通常用 `triangle`（`topWidth: 0`），中间和底层用 `trapezoid`。
+- gap 通常设为 4px 保持紧密的金字塔感。
+
+> **严格的斜率算法（必须在脚本中实现）**：
+> 要让金字塔的侧边形成一条完美的直线，**宽度的增量必须与高度和 gap 严格挂钩**。
+> 1. 设定整体宽度扩张系数 `angleK`（建议值 1.5 到 2.5，表示高度每增加1px，总宽度增加的像素数）。
+> 2. 当前层的底宽公式：`width = topWidth + (height * angleK)`
+> 3. 下一层的顶宽公式（必须考虑 gap 带来的额外外扩）：`nextTopWidth = width + (gap * angleK)`
+
+## 脚本构建模板
+
+必须使用 `node` 运行脚本生成 JSON。
+
+```javascript
+const fs = require('fs');
+
+// 1. 配置基础参数
+const GAP = 4;
+const ANGLE_K = 2; // 斜率系数：高度每增加1px，宽度增加2px
+const LAYER_HEIGHT = 80;
+
+const data = [
+  { text: "顶层核心", fillColor: "#1F2329", textColor: "#FFFFFF" },
+  { text: "中间层 B", fillColor: "#DFF5E5", textColor: "#1F2329" },
+  { text: "中间层 A", fillColor: "#EAE2FE", textColor: "#1F2329" },
+  { text: "最底层基础", fillColor: "#F0F4FC", textColor: "#1F2329" }
+];
+
+let currentTopWidth = 0; // 顶层如果是尖角，初始为 0
+const children = data.map((layer, index) => {
+  // 2. 根据公式计算当前层的底宽
+  const currentBottomWidth = currentTopWidth + (LAYER_HEIGHT * ANGLE_K);
+  
+  const node = {
+    type: currentTopWidth === 0 ? "triangle" : "trapezoid",
+    width: currentBottomWidth,
+    topWidth: currentTopWidth,
+    height: LAYER_HEIGHT,
+    text: layer.text,
+    textAlign: "center",
+    fillColor: layer.fillColor,
+    borderColor: layer.fillColor,
+    borderWidth: 2,
+    fontSize: 16,
+    textColor: layer.textColor
+  };
+
+  // 3. 关键：计算下一层的顶宽。必须把 gap 的延伸也算进去！
+  currentTopWidth = currentBottomWidth + (GAP * ANGLE_K);
+  
+  return node;
+});
+
+const output = {
+  version: 2,
+  nodes: [
+    {
+      type: "frame",
+      layout: "vertical",
+      alignItems: "center",
+      gap: GAP,
+      padding: 40,
+      children: children
+    }
+  ]
+};
+
+fs.writeFileSync('diagram.json', JSON.stringify(output, null, 2));
+```
+
+## 陷阱
+
+- **不要手写随意递增的宽度**：这会导致金字塔侧边变成折线，不直。必须严格使用上述 `angleK` 公式计算。
+- **忘记计算 gap 带来的扩展**：如果下一层的 `topWidth` 只是简单等于上一层的 `width`，在有 gap 的情况下，衔接处会产生锯齿折角。必须加上 `gap * angleK`。
+- **从上到下排列错误**：children 数组第一个是顶层（最窄），最后一个是底层（最宽），宽度依次递增。
+- **文字溢出顶层三角形**：顶层三角形内部可用空间极小。短文案用 `\n` 手动换行；长文案外置到金字塔旁边（外层套 horizontal frame，金字塔左侧，说明文字右侧）
+- **倒金字塔误用**：如果用户要求"倒金字塔"、"漏斗图"或"自上而下递减的结构"，**不要**使用本文件，切换到 `scenes/funnel.md`
+
+## 扩展
+
+- **辅助说明**：需要在旁边添加文字说明时，在最外层套一个 `layout: "horizontal"` 的 frame，金字塔放左侧，说明文字（vertical 排列的 text 节点）放右侧
+- **配色**：各层颜色应从色板中选取不同颜色以示区分（如蓝→紫→绿→黄递进）