# 何时使用

- 对一块内容（如 AI 回复气泡）**长按**呼出操作菜单
- 需要将少量操作**固定在菜单顶部**（`pinned`），其余收起滚动
- 不适用：普通点击即出的菜单可直接用 antd-mobile `Popover` 或 `Actions`

---

# API

| 属性    | 类型              | 是否必传 | 默认值 | 说明                         |
| ------- | ----------------- | -------- | ------ | ---------------------------- |
| actions | `PopupAction[]`   | 否       | `[]`   | 操作列表                     |
| children| `React.ReactNode` | 是       | -      | 被长按包裹的目标内容         |

### PopupAction（单项，在 `Action` 基础上扩展）

| 属性   | 类型     | 默认值  | 说明           |
| ------ | -------- | ------- | -------------- |
| text   | `string` | -       | 展示文案（必填项之一逻辑同 `Action`） |
| icon   | `keyof typeof Icons` \| `React.ReactElement` | - | 图标 |
| disabled | `boolean` | `false` | |
| onClick | `() => void` | - | |
| pinned | `boolean` | `false` | 为 `true` 时固定在弹出层顶部区域 |

---

# FAQ

- 交互为长按触发，需注意移动端与无障碍提示。
- 示例站点曾配合内部 `Markdown` 渲染正文；业务侧可自行替换为任意 `children`。