weifuwu 0.87.0 → 0.89.0

package/content/components/toolcallcard.md

@@ -1,51 +0,0 @@
-# ToolCallCard · components
-
-## 概述
-
-工具调用卡片：running / ok / error 状态机（call/progress/result 三字段驱动）
-
-## 典型场景
-
-- AI 对话/工具调用/审批/提示词——agent 场景全链路
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `call` | `WfToolCall` | 是 | wf:tool_call 数据 |
-| `progress` | `WfToolProgress` | 否 | wf:tool_progress 数据（可选，展示进度条） |
-| `result` | `WfToolResult` | 否 | wf:tool_result 数据（可选，ok/error 终态） |
-| `renderArgs` | `(args: Record<string, unknown>) => any` | 否 | 自定义参数渲染（默认 JSON.stringify） |
-
-## 用法示例
-
-```tsx
-<ToolCallCard call={{ id, name, args }} />
-<ToolCallCard call={...} progress={{ toolCallId, step, total }} />
-<ToolCallCard call={...} result={{ id, ok, output }} />
-
-// 状态机：running → ok / error
-```
-
-## 纪律/坑
-
-> AI 协议纪律：消息流事件驱动（useChat 订阅）——高频 notify 由写者控制频率
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：[ai](../backend/ai.md)
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/ToolCallCard/ToolCallCard.ts` |
-| 样式 | `src/client/components/ToolCallCard/ToolCallCard.css` |
-| 测试 | `src/client/components/ToolCallCard/ToolCallCard.test.ts` |
-| demo | `apps/showcase/src/demos/DemoToolCallCard.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/ai/toolcallcard` ——（P1 填充具体步骤）

package/content/components/tooltip.md

@@ -1,50 +0,0 @@
-# Tooltip · components
-
-## 概述
-
-hover 浮动提示，4 方向
-
-## 典型场景
-
-- 浮层交互——弹窗、下拉、气泡、抽屉、命令面板
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `content` | `string` | 是 |  |
-| `position` | `TooltipPosition` | 否 |  |
-| `children` | `any` | 是 |  |
-| `disabled` | `boolean` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Tooltip content="保存"
-  position="top">
-  <Button>保存</Button>
-</Tooltip>
-```
-
-## 纪律/坑
-
-- portal 槽豁免（同 HoverCard）——浮层插槽非业务列表
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Tooltip/Tooltip.ts` |
-| 样式 | `src/client/components/Tooltip/Tooltip.css` |
-| 测试 | `src/client/components/Tooltip/Tooltip.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTooltip.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/overlay/tooltip` ——（P1 填充具体步骤）

package/content/components/tour.md

@@ -1,50 +0,0 @@
-# Tour · components
-
-## 概述
-
-新手引导：步骤气泡 + 目标高亮 + 遮罩 + 键盘 Escape
-
-## 典型场景
-
-- 浮层交互——弹窗、下拉、气泡、抽屉、命令面板
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `steps` | `TourStep[]` | 是 |  |
-| `open` | `boolean` | 否 | 受控：是否打开 |
-| `onChange` | `(open: boolean) => void` | 否 | 受控回调（关闭时 onChange(false)） |
-| `current` | `number` | 否 | 受控：当前步骤索引 |
-| `onStepChange` | `(step: number) => void` | 否 | 步骤变化回调 |
-| `onFinish` | `() => void` | 否 | 完成/跳过回调 |
-| `mask` | `boolean` | 否 | 遮罩（默认 true） |
-
-## 用法示例
-
-```tsx
-<Tour steps={[{ target: '#a', title: '开始', content: '...' }]} open={open} onChange={setOpen} />
-```
-
-## 纪律/坑
-
-> 弹窗纪律（§5.4）：浮层必须 createPortal 渲染（#__wf_portal）——禁 absolute 相对父容器（overflow/transform 裁剪）；统一走 ctx.ui.usePopup
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Tour/Tour.ts` |
-| 样式 | `src/client/components/Tour/Tour.css` |
-| 测试 | `src/client/components/Tour/Tour.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTour.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/overlay/tour` ——（P1 填充具体步骤）

package/content/components/transfer.md

@@ -1,52 +0,0 @@
-# Transfer · components
-
-## 概述
-
-穿梭框：双列表 + 选中移动（antd/EP Transfer）
-
-## 典型场景
-
-- 复杂数据交互——穿梭、树、级联、看板、流水线
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `data` | `TransferItem[]` | 否 |  |
-| `targetKeys` | `string[]` | 否 | 目标侧已选 keys |
-| `onChange` | `(targetKeys: string[]) => void` | 否 |  |
-| `titles` | `[string, string]` | 否 |  |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `showSearch` | `boolean` | 否 | 显示搜索框（每侧独立过滤，内部态） |
-| `searchPlaceholder` | `string` | 否 | 搜索占位符 |
-
-## 用法示例
-
-```tsx
-<Transfer data={members}
-  targetKeys={selected} onChange={setSelected} />
-```
-
-## 纪律/坑
-
-> （该分类暂无通用纪律——组件级事故见源码注释）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Transfer/Transfer.ts` |
-| 样式 | `src/client/components/Transfer/Transfer.css` |
-| 测试 | `src/client/components/Transfer/Transfer.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTransfer.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/advanced/transfer` ——（P1 填充具体步骤）

package/content/components/tree-v2.md

@@ -1,39 +0,0 @@
-# Tree 勾选 · components
-
-## 概述
-
-checkable 父子联动 + 受控 checkedKeys（变体覆盖）
-
-## 典型场景
-
-- 复杂数据交互——穿梭、树、级联、看板、流水线
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<Tree data={treeData} checkable checkedKeys={checked} onCheck={setChecked} />
-```
-
-## 纪律/坑
-
-> （该分类暂无通用纪律——组件级事故见源码注释）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoToggleTreeCheck.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/advanced/tree-v2` ——（P1 填充具体步骤）

package/content/components/tree.md

@@ -1,59 +0,0 @@
-# Tree · components
-
-## 概述
-
-树形：递归模型 + 勾选父子联动 + indeterminate（antd/EP Tree）
-
-## 典型场景
-
-- 复杂数据交互——穿梭、树、级联、看板、流水线
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `data` | `TreeNode[]` | 否 |  |
-| `selectedKeys` | `string[]` | 否 | 受控选中 keys |
-| `onSelect` | `(keys: string[]) => void` | 否 |  |
-| `expandedKeys` | `string[]` | 否 | 受控展开 keys |
-| `onExpand` | `(keys: string[]) => void` | 否 |  |
-| `checkable` | `boolean` | 否 | 勾选模式（父子联动，antd 非 strict 语义） |
-| `expandOnClick` | `boolean` | 否 | 点击有子节点的行 = 展开/折叠（不触发选中）——TreeSelect 场景（点行展开比点箭头直观） |
-| `checkedKeys` | `string[]` | 否 |  |
-| `onCheck` | `(keys: string[]) => void` | 否 |  |
-| `searchValue` | `string` | 否 | 搜索过滤（label 含 searchValue 的节点 + 祖先；自动展开匹配路径 + 高亮） |
-| `virtual` | `boolean` | 否 | 虚拟滚动（大数据树——固定行高 28px，只渲染可见窗口） |
-| `height` | `number` | 否 | 虚拟滚动视口高度（px） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Tree data={treeData} checkable
-  checkedKeys={keys} onCheck={setKeys} />
-```
-
-## 纪律/坑
-
-- 受控纪律：selectedKeys/checkedKeys/expandedKeys 必须配回调（缺回调 console.warn）
-- 小尺寸 button 固定 min/max-height（§5.6）：checkbox 14x36 竖条事故
-- 虚拟模式（virtual）键盘导航限于可见窗口（VirtualList 无 scrollTo——裁剪登记）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Tree/Tree.ts` |
-| 样式 | `src/client/components/Tree/Tree.css` |
-| 测试 | `src/client/components/Tree/Tree.test.ts` |
-| demo | `apps/showcase/src/demos/DemoToggleTree.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/advanced/tree` ——（P1 填充具体步骤）

package/content/components/treeselect.md

@@ -1,54 +0,0 @@
-# TreeSelect · components
-
-## 概述
-
-树形选择：单选/多选（父子联动）+ 选中 label 回显 + 受控纪律
-
-## 典型场景
-
-- 复杂数据交互——穿梭、树、级联、看板、流水线
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `options` | `TreeNode[]` | 是 | 树选项（复用 TreeNode 结构） |
-| `value` | `string \| string[]` | 否 | 受控：单选 string / 多选 string[] |
-| `onChange` | `(value: any) => void` | 否 | 受控回调：单选 key / 多选 keys[] |
-| `multiple` | `boolean` | 否 | 多选（checkable 父子联动语义） |
-| `placeholder` | `string` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `error` | `string` | 否 |  |
-| `virtual` | `boolean` | 否 | 虚拟滚动（大数据树——透传 Tree；固定行高 28） |
-| `height` | `number` | 否 | 虚拟滚动视口高度（px） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<TreeSelect options={options} value={value} onChange={setValue} />
-```
-
-## 纪律/坑
-
-- 弹窗纪律（§5.4）：曾遗漏 portal——absolute 在父容器 overflow/transform 下裁剪/错位——统一 usePopup
-- 选项量小场景搜索过滤已裁剪（components-cuts.md 永久裁剪）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/TreeSelect/TreeSelect.ts` |
-| 样式 | `src/client/components/TreeSelect/TreeSelect.css` |
-| 测试 | `src/client/components/TreeSelect/TreeSelect.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTreeSelect.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/advanced/treeselect` ——（P1 填充具体步骤）

package/content/components/typography.md

@@ -1,51 +0,0 @@
-# Typography · components
-
-## 概述
-
-Title/Text/Paragraph：语义标签 + 语义色 -text 变体 + mark/code/删除线
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `level` | `1 \| 2 \| 3 \| 4 \| 5` | 否 | 1-5，默认 1（h1-h5） |
-| `children` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-| `style` | `Record<string, string>` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Title level={1}>标题</Title>
-<Text type="secondary">次要</Text>
-<Text type="danger">危险</Text>
-<Text code>code</Text>
-<Paragraph ellipsis>长文本</Paragraph>
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Typography/Typography.ts` |
-| 样式 | `src/client/components/Typography/Typography.css` |
-| 测试 | `src/client/components/Typography/Typography.test.ts` |
-| demo | `apps/showcase/src/demos/DemoTypography.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/typography` ——（P1 填充具体步骤）

package/content/components/videoplayer.md

@@ -1,52 +0,0 @@
-# VideoPlayer · components
-
-## 概述
-
-视频播放器——原生 video 封装（controls/封面/宽高比/事件——零依赖）
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `src` | `string` | 是 |  |
-| `poster` | `string` | 否 |  |
-| `aspect` | `number` | 否 | 宽高比（默认 16/9） |
-| `controls` | `boolean` | 否 |  |
-| `autoPlay` | `boolean` | 否 |  |
-| `loop` | `boolean` | 否 |  |
-| `muted` | `boolean` | 否 |  |
-| `onPlay` | `() => void` | 否 | 事件回调 |
-| `onPause` | `() => void` | 否 |  |
-| `onEnded` | `() => void` | 否 |  |
-| `onError` | `(err: Error) => void` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/VideoPlayer/VideoPlayer.ts` |
-| 样式 | `src/client/components/VideoPlayer/VideoPlayer.css` |
-| 测试 | `src/client/components/VideoPlayer/VideoPlayer.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/videoplayer` ——（P1 填充具体步骤）

package/content/components/virtuallist.md

@@ -1,52 +0,0 @@
-# VirtualList · components
-
-## 概述
-
-虚拟列表：spacer + 可见窗口，200 条只渲染 ~12 个 DOM
-
-## 典型场景
-
-- 大数据列表/表格/树——千级+数据量的性能场景
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `any[]` | 否 |  |
-| `height` | `number` | 否 | 视口高度（px） |
-| `itemHeight` | `number` | 否 | 固定 item 高度（px）——虚拟滚动的基础 |
-| `renderItem` | `(item: any, index: number) => any` | 否 |  |
-| `overscan` | `number` | 否 | 可见区外额外渲染数量 |
-| `keyBy` | `(item: any, index: number) => string \| number` | 否 |  |
-| `emptyText` | `string` | 否 | 空数据占位（F2 状态矩阵——容器类基线） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<VirtualList height={400} itemHeight={36}
-  items={rows} renderItem={renderRow} />
-```
-
-## 纪律/坑
-
-> 大数据渲染：固定行高 + 窗口化（VirtualList）——动态高度裁剪登记
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/VirtualList/VirtualList.ts` |
-| 样式 | `src/client/components/VirtualList/VirtualList.css` |
-| 测试 | `src/client/components/VirtualList/VirtualList.test.ts` |
-| demo | `apps/showcase/src/demos/DemoVirtualList.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/virtual/virtuallist` ——（P1 填充具体步骤）

package/content/components/virtualtable-v2.md

@@ -1,39 +0,0 @@
-# VirtualTable 大数据 · components
-
-## 概述
-
-10 万行虚拟滚动（只渲染可见窗口——性能展示）
-
-## 典型场景
-
-- 大数据列表/表格/树——千级+数据量的性能场景
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<VirtualTable height={280} data={100000行大数据} columns={[{key:'id',label:'ID'}]} />
-```
-
-## 纪律/坑
-
-> 大数据渲染：固定行高 + 窗口化（VirtualList）——动态高度裁剪登记
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoVirtualTableBig.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/virtual/virtualtable-v2` ——（P1 填充具体步骤）

package/content/components/virtualtable.md

@@ -1,55 +0,0 @@
-# VirtualTable · components
-
-## 概述
-
-虚拟表格：10k 行固定表头 + 可见窗口渲染 + 排序
-
-## 典型场景
-
-- 大数据列表/表格/树——千级+数据量的性能场景
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `columns` | `TableColumn[]` | 是 |  |
-| `data` | `any[]` | 否 |  |
-| `height` | `number` | 否 | 视口高度（px），默认 400 |
-| `rowHeight` | `number` | 否 | 行高（px），默认 40 |
-| `overscan` | `number` | 否 | 可见区外额外渲染行数 |
-| `sortKey` | `string` | 否 | 当前排序列 key |
-| `sortOrder` | `'asc' \| 'desc'` | 否 | 当前排序方向 |
-| `onSort` | `(key: string, order: 'asc' \| 'desc') => void` | 否 | 排序变化回调 |
-| `emptyText` | `string` | 否 | 数据为空时显示的文本 |
-| `onRowClick` | `(row: any, index: number) => void` | 否 | 行点击 |
-| `className` | `string` | 否 | 行 key 字段名，默认 'id'；无该字段回退到索引 |
-
-## 用法示例
-
-```tsx
-<VirtualTable columns={cols} data={rows} height={320}
-  sortKey={sortKey} sortOrder={sortOrder} onSort={handleSort} />
-```
-
-## 纪律/坑
-
-> 大数据渲染：固定行高 + 窗口化（VirtualList）——动态高度裁剪登记
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/VirtualTable/VirtualTable.ts` |
-| 样式 | `src/client/components/VirtualTable/VirtualTable.css` |
-| 测试 | `src/client/components/VirtualTable/VirtualTable.test.ts` |
-| demo | `apps/showcase/src/demos/DemoVirtualTable.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/virtual/virtualtable` ——（P1 填充具体步骤）

package/content/components/watermark.md

@@ -1,53 +0,0 @@
-# Watermark · components
-
-## 概述
-
-水印：canvas 平铺绘制 + overlay（antd Watermark）
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `text` | `string` | 否 | 水印文字 |
-| `fontSize` | `number` | 否 |  |
-| `color` | `string` | 否 | 文字颜色（默认继承） |
-| `opacity` | `number` | 否 | 透明度 0-1，默认 0.15 |
-| `rotate` | `number` | 否 | 旋转角度（度），默认 -25 |
-| `gap` | `number` | 否 | 平铺间距（px），默认 100 |
-| `children` | `any` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Watermark text="内部资料">
-  <div>内容</div>
-</Watermark>
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Watermark/Watermark.ts` |
-| 样式 | `src/client/components/Watermark/Watermark.css` |
-| 测试 | `src/client/components/Watermark/Watermark.test.ts` |
-| demo | `apps/showcase/src/demos/DemoWatermark.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/watermark` ——（P1 填充具体步骤）