@amaster.ai/pi-lark 0.1.4 → 0.1.5

package/skills/lark-im/references/card/components/interactive_container.md

@@ -0,0 +1,46 @@
+# 交互容器 `interactive_container`
+
+整块可点击区域，统一定义内嵌内容的样式和交互（callback/open_url），适合卡片内的列表项、可点击卡片块。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "interactive_container",
+  "width": "fill",
+  "has_border": true,
+  "border_color": "grey",
+  "corner_radius": "8px",
+  "padding": "4px 12px 4px 12px",
+  "behaviors": [{ "type": "callback", "value": { "key": "value" } }],
+  "elements": [
+    { "tag": "markdown", "content": "帮我生成一篇产品方案的框架" }
+  ]
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `interactive_container` |
+| `elements` | 是 | Element[] | [] | 子节点，支持除 `form`/`table` 外的所有组件 |
+| `behaviors` | 是 | Array | / | 点击整容器的交互：`callback`（回传）/ `open_url`（跳转），可同数组共存 |
+| `width` | 否 | String | fill | `fill`/`auto`/`[16,999]px` |
+| `height` | 否 | String | auto | `auto`/`[10,999]px` |
+| `direction` | 否 | String | vertical | `vertical`/`horizontal` |
+| `horizontal_align`/`vertical_align` | 否 | String | left/top | 对齐方式 |
+| `background_style` | 否 | String | default | `default`/`laser`/颜色枚举/RGBA（见 `../resource/colors.md`） |
+| `has_border` | 否 | Boolean | false | 是否展示 1px 边框 |
+| `border_color` | 否 | String | grey | `has_border` 为 true 时生效 |
+| `corner_radius` | 否 | String | 0px | `[0,∞]px` 或 `[0,100]%` |
+| `padding`/`margin` | 否 | String | 4px,12px / 0px | 同间距写法 |
+| `disabled` / `disabled_tips` | 否 | Boolean/Object | false / 空 | 禁用整容器及禁用提示 |
+| `hover_tips` | 否 | Object | 空 | PC 端悬浮提示 |
+| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}` |
+
+## 嵌套 / 易错点
+
+- 可嵌套除 `form`/`table` 外的所有组件，包括嵌套自身（列表项常见写法）。
+- 若容器内有交互组件（如内部 `button`），优先响应该子组件的交互，容器级 `behaviors` 不会触发。
+- 回调来源：`card.action.trigger`，`action.tag` 取决于内部触发的具体组件；容器本身被点击时 `action.value` 即容器 `behaviors.value`。

package/skills/lark-im/references/card/components/markdown.md

@@ -0,0 +1,56 @@
+# 富文本 `markdown`
+
+支持 Markdown + 部分 HTML 的富文本。最常用的内容组件。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "markdown",
+  "content": "**标题**\n正文，<font color='red'>红字</font>，[链接](https://x)"
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `markdown` |
+| `content` | 是 | String | / | Markdown 文本；JSON 里用 `\n` 换行 |
+| `text_size` | 否 | String | normal | `heading-0`~`heading-4` / `normal`(14px) / `notation`(12px) 等；可在 `config.style.text_size` 自定义 pc/mobile 字号 |
+| `text_align` | 否 | String | left | `left` / `center` / `right` |
+| `icon` | 否 | Object | / | 前缀图标（同 `div.icon`） |
+| `margin` | 否 | String | 0 | 外边距 [-99,99]px |
+| `element_id` | 否 | String | / | 唯一标识，字母开头 ≤20 字符 |
+
+## 常用语法
+
+| 效果 | 语法 |
+|---|---|
+| 粗 / 斜 / 删除线 | `**粗**`、`*斜*`、`~~删~~`（前后留空格更稳） |
+| 换行 | JSON 内 `\n`；或 `<br>` |
+| 文字链接 | `[文字](https://x)`（必须带 http/https） |
+| 带图标链接 | `<link icon='chat_outlined' …>文案</link>`（icon token 见 `../resource/icons.md`） |
+| 彩色文本 | `<font color='red'>红字</font>`（color 枚举见 `../resource/colors.md`；链接文本不可着色） |
+| 标签 | `<text_tag color='blue'>标签</text_tag>`（color：neutral/blue/turquoise/lime/orange/violet/indigo/wathet/green/yellow/red/purple/carmine） |
+| @ 人 | `<at id=ou_xxx></at>`、`<at id=all></at>`、`<at ids=id1,id2></at>` |
+| @所有人 | `<at id=all></at>`（需群主开权限，否则发送失败） |
+| 人员卡片 | `<person id='ou_xxx' show_name=true show_avatar=true style='normal'></person>` |
+| 数字角标 | `<number_tag>1</number_tag>`（0-99，可加 background_color/font_color/url） |
+| 国际化时间 | `<local_datetime millisecond='' format_type='date_num'></local_datetime>` |
+| 标题 | `# 一级` ~ `###### 六级`（大标题显丑，正文优先用加粗，见易错点） |
+| 列表 | `- 项`（无序）/ `1. 项`（有序），4 空格一层缩进 |
+| 引用 | `> 引用文字` |
+| 行内/块代码 | `` `code` `` / ```` ```go ... ``` ````（可指定语言） |
+| 分割线 | `<hr>` 或 `---`（需单独一行） |
+| 图片 | `![hover文案](img_key)` |
+| 表格 | 标准 MD 表格；除标题最多 5 行（超出分页），单组件 ≤4 表 |
+| 飞书表情 | `:DONE:`、`:OK:` |
+
+## 易错点
+
+- **慎用大标题**：`#` / `##` / `###` 一~三级标题字号过大、显丑，正文里一律用 `**加粗**` 替代来突出重点。**唯一例外**是「指标卡」里用 `##` 放大数值（见 `../lark-im-card-style.md` 视觉规范）。
+- **少用 `markdown` 的 `margin`**：间距优先交给父容器的 `vertical_spacing` / `padding`，多数情况置 `0px`；仅精细缩进时设非零值（见 `../lark-im-card-style.md` 间距纪律）。
+- 2.0 不再支持旧的 `[xx]($urlVal)` + `href` 差异化跳转语法，改用 `<link>`。
+- 要展示 Markdown 特殊字符（`* ~ > < [ ] ( ) # : _` 等）须 HTML 转义，如 `<`→`&#60;`、`*`→`&#42;`。
+- `content` 里的引号注意与 JSON 转义；属性值用单引号可减少冲突。

package/skills/lark-im/references/card/components/multi_select_person.md

@@ -0,0 +1,40 @@
+# 人员选择-多选 `multi_select_person`
+
+从候选人员中多选。**Card 2.0**。字段与 `select_person` 基本一致，差别在多选默认值。
+
+## 最小示例
+
+```json
+{
+  "tag": "multi_select_person",
+  "name": "reviewers",
+  "placeholder": { "tag": "plain_text", "content": "请选择" },
+  "options": [
+    { "value": "ou_xxx" },
+    { "value": "ou_yyy" }
+  ]
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `multi_select_person` |
+| `options` | 否 | Array | / | 候选人 `{value: open_id}`；为空或全无效时候选项为会话全体成员 |
+| `selected_values` | 否 | String[] | / | 默认选中的 open_id 数组 |
+| `name` | 否* | String | / | 唯一标识；**form 内必填且全局唯一** |
+| `required` | 否 | Boolean | false | 是否必选（form 内生效） |
+| `type` | 否 | String | default | `default`(带框) / `text`(纯文本) |
+| `placeholder` | 否 | Object | / | 占位文本，plain_text |
+| `width` | 否 | String | default | `default` / `fill` / `[100,∞)px` |
+| `disabled` | 否 | Boolean | false | 是否禁用 |
+| `behaviors` | 否 | Array | / | `[{type:"callback", value:{...}}]` |
+| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}` |
+| `margin` | 否 | String | 0 | 外边距 [-99,99]px |
+
+## 嵌套 / 易错点
+
+- 可嵌套在 column_set / form / collapsible_panel / 循环容器 / interactive_container 内。
+- `options[].value` 只接受 **open_id**；默认选中用 `selected_values`（数组）。
+- 回调返回选中的多个 open_id。

package/skills/lark-im/references/card/components/multi_select_static.md

@@ -0,0 +1,40 @@
+# 下拉多选 `multi_select_static`
+
+下拉菜单多选。**Card 2.0**。字段与 `select_static` 基本一致，差别在多选默认值。
+
+## 最小示例
+
+```json
+{
+  "tag": "multi_select_static",
+  "name": "tags",
+  "placeholder": { "tag": "plain_text", "content": "请选择" },
+  "options": [
+    { "text": { "tag": "plain_text", "content": "选项1" }, "value": "1" },
+    { "text": { "tag": "plain_text", "content": "选项2" }, "value": "2" }
+  ]
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `multi_select_static` |
+| `options` | 否 | Array | / | 选项 `{text:{plain_text}, value, icon?}`，`value` 不可重复 |
+| `selected_values` | 否 | String[] | / | 默认选中的 value 数组 |
+| `name` | 否* | String | / | 唯一标识；**form 内必填且全局唯一** |
+| `required` | 否 | Boolean | false | 是否必选（form 内生效） |
+| `type` | 否 | String | default | `default`(带框) / `text`(纯文本) |
+| `placeholder` | 否 | Object | / | 占位文本，plain_text |
+| `width` | 否 | String | default | `default`(带框固定282px) / `fill` / `[100,∞)px` |
+| `disabled` | 否 | Boolean | false | 是否禁用 |
+| `behaviors` | 否 | Array | / | `[{type:"callback", value:{...}}]` |
+| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}` |
+| `margin` | 否 | String | 0 | 外边距 [-99,99]px |
+
+## 嵌套 / 易错点
+
+- 可嵌套在 column_set / form / collapsible_panel / 循环容器 / interactive_container 内。
+- 选项 `value` 唯一；默认选中用 `selected_values`（数组）而非单选的 `initial_*`。
+- 回调返回选中的多个值。

package/skills/lark-im/references/card/components/overflow.md

@@ -0,0 +1,36 @@
+# 折叠按钮组 `overflow`
+
+折叠多个选项按钮，点击展开。适用于操作较多的场景。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "overflow",
+  "options": [
+    { "text": { "tag": "plain_text", "content": "选项A" }, "value": "a" },
+    { "text": { "tag": "plain_text", "content": "选项B" }, "value": "b" }
+  ]
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `overflow` |
+| `options` | 是 | Array | / | 选项按钮，见下 |
+| `options[].text` | 否 | Object | / | `{tag:"plain_text", content}`，≤100 字符 |
+| `options[].value` | 否 | String | / | 点击回传值，用于区分点了哪个选项（回调 `action.option`） |
+| `options[].multi_url` | 否 | Object | / | 跳转链接 `{url, pc_url, ios_url, android_url}` |
+| `behaviors` | 否 | Array | / | 额外回传：`[{type:"callback", value:{...}}]` |
+| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}`（均 plain_text） |
+| `width` | 否 | String | default | `default` / `fill` / `[100,∞)px` |
+| `margin` | 否 | String | 0 | 外边距 [-99,99]px |
+| `element_id` | 否 | String | / | 唯一标识，字母开头 ≤20 字符 |
+
+## 嵌套 / 易错点
+
+- 可嵌套在 form / collapsible_panel / 循环容器 / interactive_container / column_set 内。
+- 多按钮时务必给每个 `options[].value`，否则回调无法区分点了哪个。
+- 点击触发 `card.action.trigger`，回传 `action.tag = "overflow"` + `action.option`。

package/skills/lark-im/references/card/components/person.md

@@ -0,0 +1,30 @@
+# 人员 `person`
+
+展示单个用户的头像/姓名，点击可看名片。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "person",
+  "user_id": "ou_xxx",
+  "show_name": true
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `person` |
+| `user_id` | 是 | String | / | 人员 ID，支持 open_id / union_id / user_id |
+| `size` | 否 | String | medium | `extra_small` / `small` / `medium` / `large` |
+| `show_avatar` | 否 | Boolean | true | 是否显示头像 |
+| `show_name` | 否 | Boolean | false | 是否显示姓名 |
+| `style` | 否 | String | normal | `normal` / `capsule`（胶囊） |
+| `margin` | 否 | String | 0 | 外边距 [-99,99]px |
+| `element_id` | 否 | String | / | 唯一标识，字母开头 ≤20 字符 |
+
+## 易错点
+
+- 发卡应用需有访问用户 ID 的权限，否则人员信息无法展示。

package/skills/lark-im/references/card/components/person_list.md

@@ -0,0 +1,31 @@
+# 人员列表 `person_list`
+
+展示多个用户的头像/姓名。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "person_list",
+  "persons": [{ "id": "ou_xxx" }, { "id": "ou_yyy" }]
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `person_list` |
+| `persons` | 是 | Array | / | 每项 `{ id }`，id 支持 open_id / union_id / user_id |
+| `show_name` | 否 | Boolean | true | 是否显示姓名；关掉且多人时为"葫芦串"叠头像样式 |
+| `show_avatar` | 否 | Boolean | false | 是否显示头像 |
+| `size` | 否 | String | medium | `extra_small` / `small` / `medium` / `large` |
+| `lines` | 否 | Int | / | 最大行数，不可为 0 |
+| `drop_invalid_user_id` | 否 | Boolean | false | true 忽略无效 ID；false 则有无效 ID 时报错 |
+| `icon` / `ud_icon` | 否 | Object | / | 前缀图标（同 `div.icon`）；两者同设以 `icon` 为准 |
+| `margin` | 否 | String | 0 | 外边距 [-99,99]px |
+| `element_id` | 否 | String | / | 唯一标识，字母开头 ≤20 字符 |
+
+## 易错点
+
+- 发卡应用需有访问用户 ID 的权限，否则无法展示人员信息。

package/skills/lark-im/references/card/components/picker_datetime.md

@@ -0,0 +1,34 @@
+# 日期时间选择器 `picker_datetime`
+
+提供日期+时间选项的交互组件，默认拥有交互能力。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "picker_datetime",
+  "placeholder": { "tag": "plain_text", "content": "请选择" },
+  "initial_datetime": "2024-01-01 08:00"
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `picker_datetime` |
+| `name` | 否* | String | / | 唯一标识；**form 内必填且全局唯一** |
+| `required` | 否 | Boolean | false | 是否必选（form 内生效） |
+| `initial_datetime` | 否 | String | / | 初始值，格式 `yyyy-MM-dd HH:mm`，会覆盖 `placeholder` |
+| `placeholder` | 否 | Object | / | 占位文本，plain_text；未设 `initial_datetime` 时必填 |
+| `width` | 否 | String | default | `default`/`fill`/`[100,∞)px` |
+| `disabled` | 否 | Boolean | false | 是否禁用（需端版本 V7.4+） |
+| `behaviors` | 否 | Array | / | `[{type:"callback", value:{...}}]` |
+| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}` |
+| `margin` | 否 | String | 0 | [-99,99]px |
+
+## 嵌套 / 易错点
+
+- 可嵌套在 column_set / form / collapsible_panel / 循环容器 / 交互容器内；搭建工具中暂不支持嵌套在交互容器中。
+- 提醒用户注意时区语境；服务端只返回用户当前时区作为参考，不代表用户选的就是该时区。
+- 回调：`action.tag="picker_datetime"` + `action.option`（如 `"2025-06-10 19:19 +0800"`）+ `action.timezone`；form 内则读 `form_value[name]`。

package/skills/lark-im/references/card/components/picker_time.md

@@ -0,0 +1,34 @@
+# 时间选择器 `picker_time`
+
+提供时间选项的交互组件，默认拥有交互能力。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "picker_time",
+  "placeholder": { "tag": "plain_text", "content": "请选择" },
+  "initial_time": "09:00"
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `picker_time` |
+| `name` | 否* | String | / | 唯一标识；**form 内必填且全局唯一** |
+| `required` | 否 | Boolean | false | 是否必选（form 内生效） |
+| `initial_time` | 否 | String | / | 初始值，格式 `HH:mm`，会覆盖 `placeholder` |
+| `placeholder` | 否 | Object | / | 占位文本，plain_text；未设 `initial_time` 时必填 |
+| `width` | 否 | String | default | `default`/`fill`/`[100,∞)px` |
+| `disabled` | 否 | Boolean | false | 是否禁用（需端版本 V7.4+） |
+| `behaviors` | 否 | Array | / | `[{type:"callback", value:{...}}]` |
+| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}` |
+| `margin` | 否 | String | 0 | [-99,99]px |
+
+## 嵌套 / 易错点
+
+- 可嵌套在 column_set / form / collapsible_panel / 循环容器 / 交互容器内；搭建工具中暂不支持嵌套在交互容器中。
+- 提醒用户注意时区语境；服务端只返回用户当前时区作为参考，不代表用户选的就是该时区。
+- 回调：`action.tag="picker_time"` + `action.option`（时间字符串，如 `"05:05 +0800"`）+ `action.timezone`；form 内则读 `form_value[name]`。

package/skills/lark-im/references/card/components/recycling_container.md

@@ -0,0 +1,35 @@
+# 循环容器（搭建工具专属，无 JSON tag）
+
+批量渲染同版式不同数据的列表（如商品列表、推荐列表）。**仅支持在飞书卡片搭建工具中可视化构建，不支持手写卡片 JSON 代码实现**——因此没有 `tag` 字段可直接编排。
+
+## 使用方式
+
+1. 在[卡片搭建工具](https://open.feishu.cn/cardkit)中添加循环容器组件，绑定一个对象数组变量。
+2. 在容器内添加任意展示/交互/分栏组件，并将其字段绑定到对象数组的子变量。
+3. 发布卡片模板后，发送时通过 `template_variable` 传入实际数据数组，数组每个元素对应一条循环项。
+
+## 发送示例（模板 + 变量赋值）
+
+```json
+{
+  "type": "template",
+  "data": {
+    "template_id": "AAqi6xJ8rabcd",
+    "template_version_name": "1.0.0",
+    "template_variable": {
+      "looping": [
+        { "title": "**和风陶韵**", "description": "...", "image": { "img_key": "img_v3_xxx" } },
+        { "title": "**匠心之作**", "description": "...", "image": { "img_key": "img_v3_yyy" } }
+      ]
+    }
+  }
+}
+```
+
+将以上 JSON 压缩转义后作为 `messages.create` 的 `content`，`msg_type` 为 `interactive`。
+
+## 嵌套 / 易错点
+
+- 不支持再嵌套循环容器（对象数组变量不支持嵌套对象数组类型）。
+- 数组元素个数即渲染条数，可直接控制列表长度。
+- 若循环容器内嵌表单容器的交互组件（如 input），交互组件的 `name`（表单项标识）必须绑定到不重复的子变量，否则预览/发送报错。

package/skills/lark-im/references/card/components/select_img.md

@@ -0,0 +1,42 @@
+# 多图选择 `select_img`
+
+以图片为选项的交互组件，支持单选/多选（如商品图、模板图、AI 生成图）。仅支持手写 JSON，搭建工具不支持。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "select_img",
+  "name": "select_img_1",
+  "layout": "bisect",
+  "aspect_ratio": "16:9",
+  "options": [
+    { "img_key": "img_v2_xxx", "value": "picture1" },
+    { "img_key": "img_v2_yyy", "value": "picture2" }
+  ]
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `select_img` |
+| `options` | 是 | Array | / | 选项，每项 `{img_key, value, disabled?, disabled_tips?, hover_tips?}` |
+| `multi_select` | 否 | Boolean | false | 多选仅支持异步提交，**必须**内嵌在 form 中，否则报错 |
+| `layout` | 否 | String | bisect | 图片布局：`stretch`(撑满)/`bisect`(二等分)/`trisect`(三等分) |
+| `aspect_ratio` | 否 | String | 16:9 | `1:1`/`16:9`/`4:3` |
+| `name` | 否* | String | / | 唯一标识；**form 内必填且全局唯一** |
+| `required` | 否 | Boolean | false | 是否必选（form 内生效） |
+| `can_preview` | 否 | Boolean | true | 点击图片是否弹窗放大（仅 form 内生效） |
+| `disabled` | 否 | Boolean | false | 是否禁用整组件 |
+| `value` | 否 | String/Object | / | 自定义回传参数 |
+| `behaviors` | 是 | Array | / | `[{type:"callback", value:{...}}]` |
+| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}` |
+
+## 嵌套 / 易错点
+
+- 可嵌套在根节点 / column_set / form / 交互容器（搭建工具暂不支持嵌套交互容器）。
+- **不在 form 内**：仅支持单选，点击立即提交触发回调，不支持多选/异步提交。
+- **在 form 内**：支持单选/多选 + 异步提交（随表单一起提交）。
+- 回调（非 form）：`action.tag="select_img"` + `action.options`（单选时仍是该字段）；form 内则读 `form_value[name]`。

package/skills/lark-im/references/card/components/select_person.md

@@ -0,0 +1,39 @@
+# 人员选择-单选 `select_person`
+
+从候选人员中单选一人。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "select_person",
+  "placeholder": { "tag": "plain_text", "content": "请选择" },
+  "options": [
+    { "value": "ou_xxx" },
+    { "value": "ou_yyy" }
+  ]
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `select_person` |
+| `options` | 否 | Array | / | 候选人，每项 `{value: open_id}`；**为空或全无效时，候选项为会话内全体成员** |
+| `name` | 否* | String | / | 唯一标识；**form 内必填且全局唯一** |
+| `required` | 否 | Boolean | false | 是否必选（form 内生效） |
+| `type` | 否 | String | default | `default`(带框) / `text`(纯文本) |
+| `placeholder` | 否 | Object | / | 占位文本，plain_text |
+| `initial_option` | 否 | String | / | 初始选中的 open_id，须在 options 内 |
+| `width` | 否 | String | default | `default` / `fill` / `[100,∞)px` |
+| `disabled` | 否 | Boolean | false | 是否禁用 |
+| `behaviors` | 否 | Array | / | `[{type:"callback", value:{...}}]` |
+| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}` |
+| `margin` | 否 | String | 0 | 外边距 [-99,99]px |
+
+## 嵌套 / 易错点
+
+- 可嵌套在 column_set / form / collapsible_panel / 循环容器 / interactive_container 内。
+- `options[].value` 只接受 **open_id**。
+- 回调 `action.tag="select_person"` + `action.option`（选中人的 open_id）。

package/skills/lark-im/references/card/components/select_static.md

@@ -0,0 +1,43 @@
+# 下拉单选 `select_static`
+
+下拉菜单单选。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "select_static",
+  "placeholder": { "tag": "plain_text", "content": "请选择" },
+  "options": [
+    { "text": { "tag": "plain_text", "content": "选项1" }, "value": "1" },
+    { "text": { "tag": "plain_text", "content": "选项2" }, "value": "2" }
+  ]
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `select_static` |
+| `options` | 否 | Array | / | 选项，见下 |
+| `options[].text` | 是 | Object | / | 选项名，plain_text |
+| `options[].value` | 是 | String | / | 选项回调值，**同组件内不可重复** |
+| `options[].icon` | 否 | Object | / | 选项前缀图标（同 `div.icon`） |
+| `name` | 否* | String | / | 唯一标识；**form 内必填且全局唯一** |
+| `required` | 否 | Boolean | false | 是否必选（form 内生效） |
+| `type` | 否 | String | default | `default`(带框) / `text`(纯文本) |
+| `placeholder` | 否 | Object | / | 占位文本，plain_text |
+| `initial_option` | 否 | String | / | 初始选中内容（覆盖 placeholder 和 initial_index） |
+| `initial_index` | 否 | Int | / | 初始选中序号，0=不选，1=第一个 |
+| `width` | 否 | String | default | `default` / `fill` / `[100,∞)px` |
+| `disabled` | 否 | Boolean | false | 是否禁用 |
+| `behaviors` | 否 | Array | / | `[{type:"callback", value:{...}}]` |
+| `confirm` | 否 | Object | / | 二次确认弹窗 `{title, text}` |
+| `margin` | 否 | String | 0 | 外边距 [-99,99]px |
+
+## 嵌套 / 易错点
+
+- 可嵌套在 column_set / form / collapsible_panel / 循环容器 / interactive_container 内。
+- 选项 `value` 必须唯一，否则交互异常、服务端无法区分选了哪个。
+- 回调 `action.tag="select_static"` + `action.option`（选中项的 value）。

package/skills/lark-im/references/card/components/table.md

@@ -0,0 +1,53 @@
+# 表格 `table`
+
+多列数据表，支持文本/数字/选项/人员/日期等列类型。**Card 2.0**。
+
+## 最小示例
+
+```json
+{
+  "tag": "table",
+  "columns": [
+    { "name": "city", "display_name": "城市", "data_type": "text" },
+    { "name": "qty", "display_name": "数量", "data_type": "number" }
+  ],
+  "rows": [
+    { "city": "北京", "qty": 12 },
+    { "city": "上海", "qty": 8 }
+  ]
+}
+```
+
+## 字段
+
+| 字段 | 必填 | 类型 | 默认 | 说明 |
+|---|---|---|---|---|
+| `tag` | 是 | String | / | 固定 `table` |
+| `columns` | 是 | column[] | / | 列定义，≤50 列，见下 |
+| `rows` | 是 | Object[] | / | 行数据，按 `列name: 值` 填充 |
+| `page_size` | 否 | Number | 5 | 每页行数，[1,10] |
+| `row_height` | 否 | String | low | `low`/`middle`/`high`/`auto`/`[32,124]px` |
+| `row_max_height` | 否 | String | 124px | `row_height:auto` 时最大行高 [32,999]px |
+| `freeze_first_column` | 否 | Boolean | false | 冻结首列 |
+| `header_style` | 否 | Object | / | 表头样式：`{text_align, text_size, background_style:grey\|none, text_color, bold, lines}` |
+| `margin` | 否 | String | 0 | 外边距 [-99,99]px |
+
+**column 字段**：`name`(必填，键名) / `display_name`(表头名) / `data_type`(见下) / `width`(`auto`/`[80,600]px`/`%`) / `horizontal_align` / `vertical_align`；`number` 列可加 `format:{precision, symbol, separator}`；`date` 列可加 `date_format`(如 `YYYY/MM/DD`)。
+
+**data_type 与行值结构**：
+
+| data_type | 行值 |
+|---|---|
+| `text` | `"飞书"` |
+| `lark_md` | `"[链接](https://x)"` |
+| `number` | `168.23` |
+| `options` | `[{text:"S2", color:"blue"}]`（颜色枚举见 `../resource/colors.md`，文本勿过长） |
+| `persons` | `"ou_xxx"` 或 `["ou_a","ou_b"]` |
+| `date` | `1699341315000`（毫秒时间戳，按本地时区显示） |
+| `markdown` | `"![img](img_key)"` 完整 Markdown |
+
+## 嵌套 / 易错点
+
+- **table 只能放卡片根 `body.elements`**：不能被任何容器嵌套，自身也不能嵌别的组件。
+- 单卡最多 5 个 table（多语言每语言 5 个）。
+- `rows` 的键必须与 `columns[].name` 对应。