weifuwu 0.87.0 → 0.89.0

package/content/components/link.md

@@ -1,52 +0,0 @@
-# Link · components
-
-## 概述
-
-文字链接：语义色/下划线/disabled/新窗口
-
-## 典型场景
-
-- 页面模式：landing（复制即用蓝本——examples/patterns/）
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `href` | `string` | 否 |  |
-| `variant` | `'default' \| 'primary' \| 'danger' \| 'muted'` | 否 |  |
-| `underline` | `boolean` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `target` | `string` | 否 |  |
-| `icon` | `any` | 否 |  |
-| `onClick` | `(e: any) => void` | 否 |  |
-| `children` | `any` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Link href="/docs" variant="primary">文档</Link>
-```
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：[landing](../patterns/landing.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Link/Link.ts` |
-| 样式 | `src/client/components/Link/Link.css` |
-| 测试 | `src/client/components/Link/Link.test.ts` |
-| demo | `apps/showcase/src/demos/DemoLink.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/link` ——（P1 填充具体步骤）

package/content/components/list.md

@@ -1,44 +0,0 @@
-# List · components
-
-## 概述
-
-通用列表：renderItem + divided + header/footer/empty
-
-## 典型场景
-
-- 页面模式：workspace、mobile（复制即用蓝本——examples/patterns/）
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`src/client/components/List/List.ts`
-
-## 用法示例
-
-```tsx
-<List divided header="最近文件" items={files}
-  renderItem={f => <div>{f.name}</div>} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：[workspace](../patterns/workspace.md) · [mobile](../patterns/mobile.md)
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/List/List.ts` |
-| 样式 | `src/client/components/List/List.css` |
-| 测试 | `src/client/components/List/List.test.ts` |
-| demo | `apps/showcase/src/demos/DemoList.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/list` ——（P1 填充具体步骤）

package/content/components/loading.md

@@ -1,45 +0,0 @@
-# Loading · components
-
-## 概述
-
-加载状态，支持自定义文字
-
-## 典型场景
-
-- 操作反馈/结果页/确认——保存成功、删除确认、空态/加载态
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `text` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Loading />
-<Loading text="提交中..." />
-```
-
-## 纪律/坑
-
-> 退场动画（§8）：exit 类必须挂载（animationend 驱动）+ reduced-motion 降级
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Loading/Loading.ts` |
-| 样式 | `src/client/components/Loading/Loading.css` |
-| 测试 | `src/client/components/Loading/Loading.test.ts` |
-| demo | `apps/showcase/src/demos/DemoLoading.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/feedback/loading` ——（P1 填充具体步骤）

package/content/components/logviewer-v2.md

@@ -1,39 +0,0 @@
-# LogViewer 自定义 · components
-
-## 概述
-
-自定义日志源 + 行号 + 复制（变体覆盖）
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<LogViewer height={140} lines={ANSI日志} showLineNumbers showCopy />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoLogViewerCustom.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/logviewer-v2` ——（P1 填充具体步骤）

package/content/components/logviewer.md

@@ -1,53 +0,0 @@
-# LogViewer · components
-
-## 概述
-
-日志流：ANSI 着色 + 虚拟滚动 + 自动跟随 + 复制
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `lines` | `string[]` | 是 |  |
-| `height` | `number` | 否 | 视口高度（px），默认 400 |
-| `lineHeight` | `number` | 否 | 行高（px），默认 24 |
-| `overscan` | `number` | 否 | 可见区外额外渲染行数 |
-| `follow` | `boolean` | 否 | 自动跟随：新行到达时若已在底部则滚到底（默认 true） |
-| `maxLines` | `number` | 否 | 只显示尾部 N 行（内存保护，默认不限） |
-| `showCopy` | `boolean` | 否 | 显示复制按钮（默认 true） |
-| `showLineNumbers` | `boolean` | 否 | 显示行号（默认 true） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<LogViewer lines={logs} height={260} follow
-  showCopy showLineNumbers maxLines={500} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/LogViewer/LogViewer.ts` |
-| 样式 | `src/client/components/LogViewer/LogViewer.css` |
-| 测试 | `src/client/components/LogViewer/LogViewer.test.ts` |
-| demo | `apps/showcase/src/demos/DemoLogViewer.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/logviewer` ——（P1 填充具体步骤）

package/content/components/markdown.md

@@ -1,51 +0,0 @@
-# Markdown · components
-
-## 概述
-
-AI 回复渲染：安全子集 parser + 代码块 + 链接白名单
-
-## 典型场景
-
-- 数据展示——列表页、详情页、信息呈现
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `content` | `string` | 是 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Markdown content={"# 标题
-
-**粗体** 与 `code`
-
-- 列表项
-
-[链接](https://weifuwu.dev)"} />
-```
-
-## 纪律/坑
-
-> 三层一致（§6.3）：条件渲染 false 是空洞占位——数组项 key 由业务声明
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Markdown/Markdown.ts` |
-| 样式 | `src/client/components/Markdown/Markdown.css` |
-| 测试 | `src/client/components/Markdown/Markdown.test.ts` |
-| demo | `apps/showcase/src/demos/DemoMarkdown.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/display/markdown` ——（P1 填充具体步骤）

package/content/components/markdowneditor.md

@@ -1,47 +0,0 @@
-# MarkdownEditor · components
-
-## 概述
-
-分屏 Markdown 编辑器——textarea + 实时预览（复用 Markdown parser 零漂移）
-
-## 典型场景
-
-- office 文档/代码/内容编辑——xlsx/pptx/代码/公式/裁剪
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 是 |  |
-| `onChange` | `(value: string) => void` | 否 |  |
-| `placeholder` | `string` | 否 |  |
-| `mode` | `'write' \| 'preview' \| 'split'` | 否 | 初始模式：'write' | 'preview' | 'split'（默认 split） |
-| `rows` | `number` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 内容编辑：textarea value 走 property（attribute 只是 defaultValue）；受控输入纪律
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/MarkdownEditor/MarkdownEditor.ts` |
-| 样式 | `src/client/components/MarkdownEditor/MarkdownEditor.css` |
-| 测试 | `src/client/components/MarkdownEditor/MarkdownEditor.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/editor/markdowneditor` ——（P1 填充具体步骤）

package/content/components/math.md

@@ -1,42 +0,0 @@
-# Math · components
-
-## 概述
-
-轻量公式渲染——自研 LaTeX 子集（上下标/分数/根号/希腊字母——零依赖不引 KaTeX）
-
-## 典型场景
-
-- 基础元素（按钮/图标/文本/卡片/标签）——任意页面的构成单元
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `tex` | `string` | 是 | LaTeX 公式（如 'x^2 + \\frac{1}{2}'） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-> （P1 迁移 CODE 字符串）
-
-## 纪律/坑
-
-> 浏览器纪律（§5.5）：组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Math/Math.ts` |
-| 样式 | `src/client/components/Math/Math.css` |
-| 测试 | `src/client/components/Math/Math.test.ts` |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/core/math` ——（P1 填充具体步骤）

package/content/components/mentions-v2.md

@@ -1,39 +0,0 @@
-# Mentions 禁用态 · components
-
-## 概述
-
-disabled 时不可输入（状态矩阵覆盖）
-
-## 典型场景
-
-- 表单输入/搜索/筛选——查询区、编辑表单、设置页
-
-## API
-
-> props 提取降级（接口格式特殊）——见源码：`—`
-
-## 用法示例
-
-```tsx
-<Mentions options={users} disabled rows={2} placeholder="输入 @ 提及成员…" />
-```
-
-## 纪律/坑
-
-> 受控输入纪律（§5.3）：输入期间 value 走内部态（useControlledInput）——依赖回流会重挂 input 丢焦点；IME composition 门控
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| demo | `apps/showcase/src/demos/DemoMentionsDis.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/input/mentions-v2` ——（P1 填充具体步骤）

package/content/components/mentions.md

@@ -1,52 +0,0 @@
-# Mentions · components
-
-## 概述
-
-@提及：composition 抑制 + 过滤插入（antd Mentions）
-
-## 典型场景
-
-- 复杂数据交互——穿梭、树、级联、看板、流水线
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `value` | `string` | 否 |  |
-| `onChange` | `(value: string) => void` | 否 |  |
-| `options` | `MentionsOption[]` | 否 |  |
-| `prefix` | `string` | 否 | 触发字符，默认 '@' |
-| `placeholder` | `string` | 否 |  |
-| `rows` | `number` | 否 |  |
-| `disabled` | `boolean` | 否 |  |
-| `size` | `'sm' \| 'md' \| 'lg'` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Mentions options={[{value:'alice',label:'Alice'}]}
-  value={text} onChange={setText} />
-```
-
-## 纪律/坑
-
-> （该分类暂无通用纪律——组件级事故见源码注释）
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Mentions/Mentions.ts` |
-| 样式 | `src/client/components/Mentions/Mentions.css` |
-| 测试 | `src/client/components/Mentions/Mentions.test.ts` |
-| demo | `apps/showcase/src/demos/DemoMentions.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/advanced/mentions` ——（P1 填充具体步骤）

package/content/components/menu.md

@@ -1,56 +0,0 @@
-# Menu · components
-
-## 概述
-
-侧栏导航：分组 + 图标 + 选中态 + 方向键
-
-## 典型场景
-
-- 应用模板：admin、agent-platform（examples/apps/ 完整可跑）
-- 页面导航——侧栏、页头、标签页、步骤、分页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `items` | `MenuItem[]` | 是 |  |
-| `onSelect` | `(key: string) => void` | 否 |  |
-| `activeKey` | `string` | 否 |  |
-| `className` | `string` | 否 |  |
-| `openKeys` | `string[]` | 否 | 受控展开 key 列表（子菜单） |
-| `onOpenChange` | `(keys: string[]) => void` | 否 |  |
-| `collapsible` | `boolean` | 否 | 可折叠侧栏（宽度收窄 + label 隐藏） |
-| `collapsed` | `boolean` | 否 |  |
-| `onCollapseChange` | `(collapsed: boolean) => void` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Menu items={[
-  { key: 'agents', label: 'Agent 管理', icon: <Icon name="cpu" size={16} />, group: '工作台' },
-  { key: 'settings', label: '设置', icon: <Icon name="settings" size={16} />, group: '系统' },
-]} activeKey="agents" onSelect={k => setActive(k)} />
-```
-
-## 纪律/坑
-
-> 键盘可达（P1）：方向键导航焦点跟随（roving tabindex）；受控 props 配回调
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：[admin](../apps/admin.md) · [agent-platform](../apps/agent-platform.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Menu/Menu.ts` |
-| 样式 | `src/client/components/Menu/Menu.css` |
-| 测试 | `src/client/components/Menu/Menu.test.ts` |
-| demo | `apps/showcase/src/demos/DemoMenu.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/navigation/menu` ——（P1 填充具体步骤）

package/content/components/menubar.md

@@ -1,44 +0,0 @@
-# Menubar · components
-
-## 概述
-
-水平菜单栏：←→ 切换 + ↓ 展开（shadcn Menubar）
-
-## 典型场景
-
-- 页面导航——侧栏、页头、标签页、步骤、分页
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `menus` | `MenubarMenu[]` | 否 |  |
-
-## 用法示例
-
-```tsx
-<Menubar menus={[{key:'file',label:'文件',items:[...]}]} />
-```
-
-## 纪律/坑
-
-> 键盘可达（P1）：方向键导航焦点跟随（roving tabindex）；受控 props 配回调
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Menubar/Menubar.ts` |
-| 样式 | `src/client/components/Menubar/Menubar.css` |
-| 测试 | `src/client/components/Menubar/Menubar.test.ts` |
-| demo | `apps/showcase/src/demos/DemoMenubar.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/navigation/menubar` ——（P1 填充具体步骤）

package/content/components/messagebubble.md

@@ -1,50 +0,0 @@
-# MessageBubble · components
-
-## 概述
-
-消息气泡：user/assistant + streaming/error 状态 + actions
-
-## 典型场景
-
-- AI 对话/工具调用/审批/提示词——agent 场景全链路
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `content` | `any` | 是 |  |
-| `role` | `MessageBubbleRole` | 是 |  |
-| `status` | `MessageBubbleStatus` | 否 |  |
-| `actions` | `any` | 否 | 气泡尾部操作区（重试/复制按钮等，VNode 或数组） |
-| `className` | `string` | 否 |  |
-
-## 用法示例
-
-```tsx
-<MessageBubble role="user" content="北京天气如何？" />
-<MessageBubble role="assistant" status="streaming" content="…"
-  actions={<Button size="sm">重试</Button>} />
-```
-
-## 纪律/坑
-
-> AI 协议纪律：消息流事件驱动（useChat 订阅）——高频 notify 由写者控制频率
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：（暂无）
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/MessageBubble/MessageBubble.ts` |
-| 样式 | `src/client/components/MessageBubble/MessageBubble.css` |
-| 测试 | `src/client/components/MessageBubble/MessageBubble.test.ts` |
-| demo | `apps/showcase/src/demos/DemoMessageBubble.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/ai/messagebubble` ——（P1 填充具体步骤）

package/content/components/modal.md

@@ -1,59 +0,0 @@
-# Modal · components
-
-## 概述
-
-自定义宽度 + closable 控制关闭按钮
-
-## 典型场景
-
-- 应用模板：agent-platform（examples/apps/ 完整可跑）
-- 浮层交互——弹窗、下拉、气泡、抽屉、命令面板
-
-## API
-
-| prop | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| `open` | `boolean` | 否 |  |
-| `title` | `string` | 否 |  |
-| `onClose` | `() => void` | 否 |  |
-| `children` | `any` | 否 |  |
-| `footer` | `any` | 否 |  |
-| `width` | `string` | 否 | 自定义宽度，如 '500px'、'80%'，默认 400px |
-| `closable` | `boolean` | 否 | 是否显示关闭按钮，默认 true |
-| `maskClosable` | `boolean` | 否 | 点击遮罩是否关闭，默认 true（危险确认应设 false） |
-
-## 用法示例
-
-```tsx
-<Modal open={open}
-  title="标题"
-  width="500px"
-  closable={false}
-  onClose={() => open = false}>
-  <p>内容</p>
-</Modal>
-```
-
-## 纪律/坑
-
-- 退场动画：exit 类必须挂载（animationend 驱动卸载）——reduced-motion 下动画降为 0.01ms 等效瞬时
-- 会话级模态四件套：presence/trapFocus/lockScroll 由 usePopup 统一提供
-
-## 关系
-
-- ↑ 用于页面模式：（暂无）
-- ↑ 用于应用：[agent-platform](../apps/agent-platform.md)
-- → 后端能力：（暂无）
-
-## 文件位置
-
-| 文件 | 路径 |
-|------|------|
-| 源码 | `src/client/components/Modal/Modal.ts` |
-| 样式 | `src/client/components/Modal/Modal.css` |
-| 测试 | `src/client/components/Modal/Modal.test.ts` |
-| demo | `apps/showcase/src/demos/DemoModal.tsx`（P1 拆分） |
-
-## 验证
-
-> agent-browser 走查：打开 `/components/overlay/modal` ——（P1 填充具体步骤）