antdigital-ai AgenticLayout 组件开发
智能体应用主布局：左-中-右三栏 + 头部，用于应用外壳与侧栏布局。修改布局或头部时，按本技能内的 API 与规范直接实现，无需再查源码。
组件 API（自包含）
AgenticLayoutProps
| 属性 | 说明 | 类型 | 默认 |
|---|---|---|---|
left |
左侧内容 | ReactNode | - |
center |
中间内容（必填） | ReactNode | - |
right |
右侧内容 | ReactNode | - |
header |
头部配置，见下 | LayoutHeaderConfig | - |
style |
自定义样式，会透传到根节点（可含 minHeight 等） |
React.CSSProperties | - |
className |
自定义类名，与根节点 prefixCls、hashId 一起拼接 |
string | - |
leftWidth |
左侧宽度（px） | number | 256 |
rightWidth |
右侧宽度（px），可被用户拖拽改变，会受最小/最大限制 | number | 540 |
minHeight |
最小高度（类型已声明，实现上可用 style.minHeight 覆盖样式默认值） |
string | number | - |
children |
子元素（兼容用，内容建议用 center） |
ReactNode | - |
说明：根节点最小高度由样式固定为 600px；需自定义时传 style={{ minHeight: '...' }}。当前未从 props 的 minHeight 读到根节点，与类型保持一致即可。
LayoutHeaderConfig（头部配置）
| 属性 | 说明 | 类型 | 默认 |
|---|---|---|---|
title |
标题，支持文本或 React 节点 | ReactNode | 'AI 助手' |
showShare |
是否显示分享按钮 | boolean | false |
leftCollapsible |
左侧是否可折叠（未传时由 AgenticLayout 按是否有 left 推断） |
boolean | - |
rightCollapsible |
右侧是否可折叠（未传时由 AgenticLayout 按是否有 right 推断） |
boolean | - |
leftCollapsed |
左侧折叠状态（受控） | boolean | - |
rightCollapsed |
右侧折叠状态（受控） | boolean | - |
leftDefaultCollapsed |
左侧默认折叠（非受控） | boolean | false |
rightDefaultCollapsed |
右侧默认折叠（非受控） | boolean | false |
onLeftCollapse |
左侧折叠回调 | (collapsed: boolean) => void | - |
onRightCollapse |
右侧折叠回调 | (collapsed: boolean) => void | - |
onShare |
分享点击 | () => void | - |
leftExtra |
头部左侧额外内容，渲染在标题同侧 | ReactNode | - |
rightExtra |
头部右侧额外内容，渲染在分享/折叠按钮同侧 | ReactNode | - |
className |
头部根节点自定义类名 | string | - |
折叠状态：有 leftCollapsed/rightCollapsed 时为受控；否则用 leftDefaultCollapsed/rightDefaultCollapsed 作初始值，由内部 useMergedState + onLeftCollapse/onRightCollapse 更新。LayoutHeader 内部用 I18n 的 locale['chatFlow.collapseLeft']、locale['chatFlow.collapseRight']、locale['chatFlow.share'] 等做文案与 aria-label。
导出（库入口）
- AgenticLayout：
export { AgenticLayout }，类型export interface AgenticLayoutProps - LayoutHeader：
export { LayoutHeader }，类型export type { LayoutHeaderConfig, LayoutHeaderProps }（LayoutHeaderProps 与 LayoutHeaderConfig 相同）
从 @ant-design/agentic-ui 可解构：AgenticLayout、AgenticLayoutProps、LayoutHeader、LayoutHeaderConfig、LayoutHeaderProps。
DOM 与类名结构（BEM）
AgenticLayout
- 根：
prefixCls（默认ant-agentic-layout） - 主体：
${prefixCls}-body（flex 容器） - 左侧栏：
${prefixCls}-sidebar、${prefixCls}-sidebar-left，折叠时加${prefixCls}-sidebar-left-collapsed - 中间区：
${prefixCls}-main，内容包裹在${prefixCls}-main-content；头部渲染在 main 内、content 前；main-content 高度为calc(100% - 48px)以预留头部 - 右侧栏容器：
${prefixCls}-sidebar-wrapper-right，内为拖拽手柄 + 右侧栏 - 拖拽手柄：
${prefixCls}-resize-handle、${prefixCls}-resize-handle-right（宽度 6px，hover 时高亮） - 右侧栏：
${prefixCls}-sidebar、${prefixCls}-sidebar-right，折叠时加${prefixCls}-sidebar-right-collapsed - 侧栏内容区：
${prefixCls}-sidebar-content
样式通过 useAgenticLayoutStyle(prefixCls) 注册，使用项目内 genStyleHooks 与 token（如 componentCls）。根节点在样式中设 minHeight: 600px。
LayoutHeader（头部子组件）
- 根：
prefixCls（默认ant-layout-header） - 左侧区域：
${prefixCls}-left（含折叠按钮、分隔线、标题、leftExtra） - 标题：
${prefixCls}-left-title - 左侧分隔线：
${prefixCls}-left-separator（在折叠按钮与标题之间） - 右侧区域：
${prefixCls}-right（含分享按钮、折叠按钮、rightExtra） - 分享按钮：
${prefixCls}-right-share-btn
样式通过 useLayoutHeaderStyle(prefixCls) 注册；头部高度 48px（minHeight），与 main-content 的 48px 对应。
行为与常量
- 右侧栏：可拖拽调整宽度。最小宽度
MIN_RIGHT_WIDTH = 400（px），最大宽度window.innerWidth * 0.7；rightWidth变化会同步到内部 state；折叠时宽度为 0。 - 左侧栏：宽度由
leftWidth控制，默认DEFAULT_LEFT_WIDTH = 256（px），无拖拽；折叠时宽度为 0。 - 右侧默认宽度：
DEFAULT_RIGHT_WIDTH = 540（px）。 - 头部：使用
LayoutHeader（来自Components/LayoutHeader），传入header并补充leftCollapsible/rightCollapsible（未传时由是否有left/right决定）。头部高度 48px；拖拽手柄宽度 6px。 - 根节点：样式里
minHeight: 600px，无prefixCls/classNames/styles等 Semantic 透传，仅style、className。
开发规范（与 AGENTS 一致）
- 使用 Ant Design Token 与
useAgenticLayoutStyle，支持主题与响应式；样式用createStyles/token，避免硬编码颜色与尺寸。 - 类名用
clsx拼接；支持classNames/styles时按项目 Semantic 规范命名。 - Props/事件命名：配置用
Config后缀，事件用on前缀；布尔用showXxx、xxxCollapsible、xxxCollapsed。 - 组件为函数式 + Hooks；用
React.memo包装导出组件；保持向下兼容，不破坏已有 props。 - 与 ChatLayout、Workspace 等组合时保持结构清晰，避免嵌套过深。
按上述 API、DOM 结构和规范修改布局或头部即可，无需依赖源码路径。