# fan-standard-comp@6.x 文档导航

> 这是 npm 包内的完整文档地图。当前版本基于 React 18 和 Ant Design 6。所有相对链接同时适用于 npm 包和在线文档站。

在线文档根地址：[http://47.113.227.251:1203/doc-v6/](http://47.113.227.251:1203/doc-v6/)。在线入口：[llms.txt](http://47.113.227.251:1203/doc-v6/llms.txt)、[llms-full.txt](http://47.113.227.251:1203/doc-v6/llms-full.txt)、[component-index.json](http://47.113.227.251:1203/doc-v6/ai/component-index.json)。优先使用当前安装的 npm 包内文件；在线文档仅作为兜底，版本不一致时以本地文档和 TypeScript 类型声明为准。

## 项目与指南

- [项目首页](./docs/index.md) - 组件库定位与特性。
- [安装使用](./docs/guide/usage.md) - 安装、在线文档和 React 兼容说明。
- [For Agents](./docs/guide/for-agents.md) - AI 读取顺序与本地优先原则。
- [主题样式](./docs/guide/theme.md) - Ant Design 6、Design Token、CSS-in-JS 和 antd-style。
- [更新日志](./docs/guide/update.md) - 6.x 版本变更。
- [升级建议](./docs/manage/upgradeV6.md) - Ant Design 6 API 兼容调整。
- [待解决问题](./docs/guide/todoList.md) - 已知限制。

## 组件 API

### 全局配置

- [FanProvider](./docs/components/FanProvider.md) - 全局默认值、语言和 Ant Design 反馈实例；相关公共导出包括 `FanContext`、`FanDefaultConfig`、`useFanContext`。

### 表单控件

- [Field](./docs/components/Field.md) - 按 `type` 渲染 Ant Design 控件，支持只读、禁用和扩展类型；`FieldComponent` 为别名。
- [RefactorTreeSelect](./docs/components/Field.md) - 6.x 新增的独立公共树选择控件导出。
- [ItemGroup](./docs/components/ItemGroup.md) - 配置化表单项与栅格布局；`RenderItemGroup` 为别名。
- [StandardForm](./docs/components/StandardForm.md) - 通用表单，包含独立公共导出 `StepForm` 和 `TabForm`。
- [JsonInput](./docs/components/JsonInput.md) - JSON 输入、校验、格式化与只读预览。
- [Uploader](./docs/components/Uploader.md) - 文件和图片上传、预览、裁剪与限制。
- [EditButton](./docs/components/EditButton.md) - 按钮式输入与保存。
- [VarTemplate](./docs/components/VarTemplate.md) - 变量模板编辑。

### 筛选、表格与数据展示

- [StandardFilter](./docs/components/StandardFilter.md) - 表格上方的配置化筛选栏。
- [StandardTable](./docs/components/StandardTable.md) - 通用表格、操作列、行选择和按钮组。
- [StandardTablePro](./docs/components/StandardTablePro.md) - 支持接口请求与表单条件的高阶表格。
- [StandardList](./docs/components/StandardList.md) - 列表、可选和拖拽排序。
- [RefactorTree](./docs/components/RefactortTree.md) - 页面侧边树，支持搜索、禁用和选择限制。

### 弹层

- [StandardModal](./docs/components/StandardModal.md) - 通用操作弹窗，可组合配置化表单、步骤表单和 Tab 表单。
- [StandardDrawer](./docs/components/StandardDrawer.md) - 通用抽屉与配置化表单。
- [StandardDragModal](./docs/components/StandardDragModal.md) - 已废弃并从包根公共导出移除。

### 页面结构

- [WrapperContent](./docs/components/WrapperContent.md) - 页面外层内容容器。
- [SubfieldContent](./docs/components/SubfieldContent.md) - 分区内容容器。
- [SideCard](./docs/components/SideCard.md) - `SubfieldContent` 中的侧边卡片。
- [SplitterLayout](./docs/components/SplitterLayout.md) - 可分割布局。
- [StandardPanel](./docs/components/StandardPanel.md) - 面板、按钮、类别和标签组合。
- [StandardTitle](./docs/components/StandardTitle.md) - 标准标题。
- [DragContent](./docs/components/DragContent.md) - 仍公开但处于实验状态的可拉伸内容容器。

### 操作、导航与媒体

- [ButtonGroup](./docs/components/ButtonGroup.md) - 普通按钮、文本按钮、表格操作列和功能权限。
- [NavLeafScroll](./docs/components/NavLeafScroll.md) - 可横向或纵向滚动翻页的菜单列表。
- [SpecIcon](./docs/components/SpecIcon.md) - 组件库图标、扩展图标和状态图标。
- [ImageGallery / ImagePreview](./docs/components/ImageGallery.md) - 图片画廊与图集预览。
- `IconNode` - 将字符串、数组或 ReactNode 图标配置转换为节点的包根公共基础组件，暂无独立文档。

### 未从包根路径公开的实验、测试或废弃组件

- [CalendarCoordPicker](./docs/components/CalendarCoordPicker.md) - 实验中的日历区块选择。
- [SpecNavigation](./docs/components/Navigation.md) - 实验中的超出区域隐藏菜单。
- [ButtonGroupBeta](./docs/components/ButtonGroupBeta.md) - 样式方案测试组件。
- [StandardDragModal](./docs/components/StandardDragModal.md) - 已废弃，6.x 不再公开导出。

## 工具函数

- [转换工具](./docs/utils/convert.md)
- [数据工具](./docs/utils/data.md)
- [字典与选项](./docs/utils/dict.md)
- [其他通用工具](./docs/utils/other.md)
- [正则与校验](./docs/utils/regExp.md)
- [接口响应处理](./docs/utils/response.md)
- [树数据](./docs/utils/treeData.md)
- [URL 工具](./docs/utils/urlUtils.md)

包根 `export *` 暴露的具体工具、数据常量和类型名称及源码位置见 [`ai/component-index.json`](./ai/component-index.json) 的 `exports` 字段。

## 项目开发规范

- [项目使用说明](./docs/manage/usage.md)
- [升级使用说明](./docs/manage/upgrade.md)
- [组件化规范](./docs/manage/componenting.md)
- [命名规范](./docs/manage/naming.md)
- [权限说明](./docs/manage/authority.md)
- [Git 提交规范](./docs/manage/commit.md)
- [公共业务工具](./docs/manage/businessUtils.md)
- [错误边界](./docs/manage/errorBoundary.md)
- [WebSocket 客户端](./docs/manage/socketClient.md)
- [水印](./docs/manage/watermark.md)
- [系统管理开发包](./docs/manage/sdkSystem.md)

## AI 解析规则

- 优先从包根路径导入，例如 `import { StandardTable, useFanContext } from 'fan-standard-comp'`。
- `FieldComponent` 是 `Field` 的别名，`RenderItemGroup` 是 `ItemGroup` 的别名。
- `RefactorTreeSelect` 和 `useFanContext` 是 6.x 新增公共导出。
- `StandardDragModal` 已取消包根公共导出，不要深层导入。
- 使用索引时先检查 `public` 和 `status`，不要把实验、测试或废弃条目误写成推荐公共 API。
- API 参数优先参考对应组件文档；若文档与类型声明冲突，以当前安装包内 `.d.ts` 为准。
- 组件文档中的 `<code src="...">` 指向仓库演示源码；发布包可能不包含这些 `src` 文件。