@aithe/aithe-ui 26.3.1 → 26.3.2

package/docs/api/form/autoform.md

@@ -13,7 +13,7 @@
 
 | Name               | Type    | Default | Description (EN)                                                                                                                                                                                                  | Description (CN)                                                                                                                                                                               |
 | ------------------ | ------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| fields             | String  | '[]'    | JSON string of field configurations. Each field supports: name, type, label, icon, tooltip, description, dft, rules (required/pattern/message), placeholder, disabled, options, dependencies, rules (dependency). | 字段配置的 JSON 字符串。每个字段支持：name、type、label、icon、tooltip、description、dft、rules（required/pattern/message）、placeholder、disabled、options、dependencies、rules（依赖联动）。 |
+| fields             | String  | '[]'    | JSON string of field configurations. Each field supports: name, type, label, icon, tooltip, description, dft, rules (required/pattern/message), placeholder, disabled, options, dependencies, rules (dependency), inputType (for type="input", e.g. `password`/`email`/`tel`; `password` renders a visibility toggle). | 字段配置的 JSON 字符串。每个字段支持：name、type、label、icon、tooltip、description、dft、rules（required/pattern/message）、placeholder、disabled、options、dependencies、rules（依赖联动）、inputType（用于 type="input"，如 `password`/`email`/`tel`；`password` 渲染明文切换按钮）。 |
 | submitText         | String  | ''      | Custom submit button label. Falls back to i18n key `form.autoform.submit`.                                                                                                                                        | 自定义提交按钮文本。缺省使用 i18n 键 `form.autoform.submit`。                                                                                                                                  |
 | loading            | Boolean | false   | Whether the form is in a submitting state.                                                                                                                                                                        | 表单是否处于提交中状态。                                                                                                                                                                       |
 | validate-on-change | Boolean | true    | Whether to validate on every field change.                                                                                                                                                                        | 是否在每次字段变更时实时校验。                                                                                                                                                                 |
@@ -44,7 +44,7 @@
 | input      | Single-line text input.               | 单行文本输入。         |
 | textarea   | Multi-line text input.                | 多行文本输入。         |
 | number     | Numeric input.                        | 数值输入。             |
-| password   | Password input.                       | 密码输入。             |
+| password   | Password input with a visibility toggle suffix icon.  | 密码输入，后缀图标切换明文显示。 |
 | email      | Email input.                          | 邮箱输入。             |
 | select     | Dropdown selector.                    | 下拉选择器。           |
 | radio      | Radio button group.                   | 单选按钮组。           |
@@ -264,6 +264,7 @@ String values use single or double quotes. Boolean values use `true`/`false`. Nu
   fields='[
     {"name":"username","type":"input","label":"Username","icon":"user","required":true,"message":"Username is required","placeholder":"Enter username"},
     {"name":"email","type":"input","label":"Email","tooltip":"Your work email","required":true,"inputType":"email","pattern":"^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$","message":"Invalid email","placeholder":"you@company.com"},
+    {"name":"password","type":"input","label":"Password","icon":"lock","required":true,"inputType":"password","placeholder":"Enter your password","message":"Password is required"},
     {"name":"role","type":"select","label":"Role","options":"[{\\"label\\":\\"Admin\\",\\"id\\":\\"admin\\"},{\\"label\\":\\"Editor\\",\\"id\\":\\"editor\\"},{\\"label\\":\\"Viewer\\",\\"id\\":\\"viewer\\"}]","dft":"viewer"},
     {"name":"notifications","type":"switch","label":"Notifications","dft":"true"}
   ]'

package/docs/api/form/combobox.md

@@ -30,15 +30,24 @@
 
 ## Option Fields / 选项字段
 
-| Field | Type | Description (EN) | Description (CN) |
-|-------|------|-------------------|-------------------|
-| label | `string` | Display text. | 显示文本。 |
-| id | `string` | Unique value emitted on select. | 选择时发出的唯一值。 |
-| icon | `string` | Icon name rendered before the label via aithe-icon. | 通过 aithe-icon 在标签前渲染的图标名称。 |
-| variant | AitheVariant | Visual variant / semantic color for the option. | 选项的视觉变体/语义色。 |
+| Field   | Type         | Description (EN)                                                                                                                                       | Description (CN)                                            |
+| ------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
+| label   | `string`     | Display text.                                                                                                                                         | 显示文本。                                                  |
+| id      | `string`     | Unique value emitted on select.                                                                                                                       | 选择时发出的唯一值。                                        |
+| icon    | `string`     | Icon name rendered before the label via aithe-icon.                                                                                                   | 通过 aithe-icon 在标签前渲染的图标名称。                    |
+| variant | AitheVariant | Visual variant / semantic color for the option.                                                                                                       | 选项的视觉变体/语义色。                                     |
+| group   | `string`     | Group name for grouped rendering. When any option carries a `group` field, all options are aggregated by `group` and rendered under a group header. | 分组名称，用于分组显示。任一选项携带 `group` 字段时，所有选项按 `group` 聚合，每组前置分组标题渲染。 |
+
+## Grouped Rendering / 分组渲染
+
+When any option in `options` carries a `group` field, the combobox automatically switches to grouped rendering mode: options are aggregated by `group` (preserving insertion order), each group is preceded by a `.group-header` title, and options within a group are indented. Options without a `group` field are collected under an untitled section. When no option carries `group`, rendering falls back to the flat list.
+
+当 `options` 中任一选项携带 `group` 字段时，combobox 自动切换到分组渲染模式：选项按 `group` 聚合（保留插入顺序），每组前置 `.group-header` 标题，组内选项缩进显示。未携带 `group` 字段的选项归入无标题分组。无任何 `group` 字段时回退为扁平列表渲染。
 
 ## Examples / 示例
 
+### 基本用法
+
 ```html
 <aithe-combobox
   options='[{"label":"Apple","id":"apple"},{"label":"Banana","id":"banana"}]'
@@ -46,4 +55,15 @@
   icon="search"
   filterable
 ></aithe-combobox>
-```
+```
+
+### 分组选项
+
+```html
+<aithe-combobox
+  title="Preset search"
+  icon="search"
+  placeholder="Search presets"
+  options='[{"label":"A/B Test","id":"ab-test","group":"Analytics","icon":"barChart"},{"label":"Funnel","id":"funnel","group":"Analytics","icon":"filter"},{"label":"Assistant Shell","id":"assistant-shell","group":"Automation","icon":"terminal"},{"label":"Workflow Editor","id":"workflow-editor","group":"Automation","icon":"edit"}]'
+></aithe-combobox>
+```

package/docs/api/form/select.md

@@ -34,17 +34,26 @@
 
 ## Option Fields / 选项字段
 
-| Field       | Type         | Description (EN)                                    | Description (CN)                         |
-| ----------- | ------------ | --------------------------------------------------- | ---------------------------------------- |
-| label       | `string`     | Display text.                                       | 显示文本。                               |
-| id          | `string`     | Unique value emitted on select.                     | 选择时发出的唯一值。                     |
-| disabled    | `boolean`    | Whether the option is non-interactive.              | 是否不可交互。                           |
-| description | `string`     | Secondary description line.                         | 二级描述行。                             |
-| icon        | `string`     | Icon name rendered before the label via aithe-icon. | 通过 aithe-icon 在标签前渲染的图标名称。 |
-| variant     | AitheVariant | Visual variant / semantic color for the option.     | 选项的视觉变体/语义色。                  |
+| Field       | Type         | Description (EN)                                                                                                                                       | Description (CN)                                            |
+| ----------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------- |
+| label       | `string`     | Display text.                                                                                                                                         | 显示文本。                                                  |
+| id          | `string`     | Unique value emitted on select.                                                                                                                       | 选择时发出的唯一值。                                        |
+| disabled    | `boolean`    | Whether the option is non-interactive.                                                                                                                | 是否不可交互。                                              |
+| description | `string`     | Secondary description line.                                                                                                                           | 二级描述行。                                                |
+| icon        | `string`     | Icon name rendered before the label via aithe-icon.                                                                                                   | 通过 aithe-icon 在标签前渲染的图标名称。                    |
+| variant     | AitheVariant | Visual variant / semantic color for the option.                                                                                                       | 选项的视觉变体/语义色。                                     |
+| group       | `string`     | Group name for grouped rendering. When any option carries a `group` field, all options are aggregated by `group` and rendered under a group header. | 分组名称，用于分组显示。任一选项携带 `group` 字段时，所有选项按 `group` 聚合，每组前置分组标题渲染。 |
+
+## Grouped Rendering / 分组渲染
+
+When any option in `options` carries a `group` field, the select automatically switches to grouped rendering mode: options are aggregated by `group` (preserving insertion order), each group is preceded by a `.group-header` title, and options within a group are indented. Options without a `group` field are collected under an untitled section. When no option carries `group`, rendering falls back to the flat list. Keyboard navigation (`activeIndex`) is maintained via a flattened index across groups.
+
+当 `options` 中任一选项携带 `group` 字段时，select 自动切换到分组渲染模式：选项按 `group` 聚合（保留插入顺序），每组前置 `.group-header` 标题，组内选项缩进显示。未携带 `group` 字段的选项归入无标题分组。无任何 `group` 字段时回退为扁平列表渲染。键盘导航（`activeIndex`）通过跨分组的扁平索引维护。
 
 ## Examples / 示例
 
+### 基本用法
+
 ```html
 <aithe-select
   options='[{"id":"a","label":"Option A"},{"id":"b","label":"Option B"}]'
@@ -54,3 +63,16 @@
   clearable
 ></aithe-select>
 ```
+
+### 分组选项
+
+```html
+<aithe-select
+  title="Region selector"
+  icon="globe"
+  placeholder="Choose a city"
+  clearable
+  searchable
+  options='[{"label":"上海","id":"sh","group":"华东"},{"label":"杭州","id":"hz","group":"华东"},{"label":"北京","id":"bj","group":"华北"},{"label":"天津","id":"tj","group":"华北"},{"label":"广州","id":"gz","group":"华南"},{"label":"深圳","id":"sz","group":"华南"}]'
+></aithe-select>
+```

package/docs/api/summary.md

@@ -164,6 +164,7 @@ Rich content display and media components. 富内容展示和媒体组件。
 | [Profile](display/profile.md)                 | `<aithe-profile>`         | Profile display with icon/avatar, title and description. 档案展示，含图标/头像、标题和描述。     |
 | [Description List](display/desc.md)           | `<aithe-desc>`            | Structured key-value description list. 结构化键值描述列表。                                      |
 | [Description Item](display/desc-item.md)      | `<aithe-desc-item>`       | Single item in a description list with label and value. 描述列表中的单个条目，含标签和值。       |
+| [Auto View](display/autoview.md)              | `<aithe-autoview>`        | JSON-driven read-only detail view, the display-only counterpart of autoform. JSON 驱动的只读详情视图，autoform 的只读镜像。 |
 
 ---
 

package/docs/autoform.md

@@ -41,40 +41,9 @@ interface FormFieldConfig {
 
 ### 内置控件类型
 
-### 顶层结构
-
-`fields` 属性接收一个 JSON 字符串，解析后为 `FormFieldConfig[]`：
-
-```typescript
-interface FormFieldConfig {
-  name?: string; // 字段唯一标识
-  type?: string; // 控件类型
-  label?: string; // 标签文本
-  icon?: string; // 图标名称
-  tooltip?: string; // 悬停提示
-  description?: string; // 说明文字
-  dft?: string; // 缺省值
-  placeholder?: string; // 占位提示
-  disabled?: boolean; // 是否禁用
-  required?: boolean; // 是否必填
-  pattern?: string; // 校验正则
-  message?: string; // 校验失败提示
-  options?: string | FormItemOption[]; // 选项
-  inputType?: string; // HTML input type
-  min?: string; // 最小值
-  max?: string; // 最大值
-  step?: string; // 步长
-  rows?: string; // 文本域行数
-  dependencies?: string[]; // 依赖字段列表
-  rules?: FormRule[]; // 联动规则
-}
-```
-
-### 内置控件类型
-
 | type           | 说明       | 特有属性                                |
 | -------------- | ---------- | --------------------------------------- |
-| `input`        | 文本输入框 | `inputType`（如 `email`、`url`、`tel`） |
+| `input`        | 文本输入框 | `inputType`（如 `email`、`url`、`tel`、`password`；`password` 渲染明文切换按钮） |
 | `textarea`     | 多行文本域 | `rows`                                  |
 | `select`       | 下拉选择   | `options`                               |
 | `radio`        | 单选组     | `options`                               |

package/docs/changelog/CHANGELOG.md

@@ -4,6 +4,81 @@
 
 ---
 
+## 26.3.2 (2026-09-11)
+
+### 2026年第3季度第2个月版本 - 只读视图组件、选项分组、DataHub force 选项与文档质量提升
+
+- **新增 `<aithe-autoview>` 只读视图组件**: 基于 `<aithe-desc>` 的轻量适配器，与 `<aithe-autoform>` 共用 `FormFieldConfig` 模型，内置 8 类只读渲染器（input/select/checkbox/switch/date-picker/color-picker/rate/slider），支持依赖联动显隐和 `ViewRegistry` 自定义渲染器
+- **`<aithe-select>` / `<aithe-combobox>` 选项分组**: 选项对象新增 `group` 字段，自动按分组聚合渲染，每组前置标题并缩进组内选项；无 `group` 字段时保持扁平渲染，向后兼容
+- **`<aithe-autoform>` 密码明文切换**: `inputType="password"` 时渲染 `eye`/`eyeOff` 图标按钮，点击切换 `password` 与 `text`
+- **`<aithe-desc>` 描述列表增强**: 新增 `border-style`（`none`/`full`/`row`）和 `label-background`（`filled`/`none`）属性；`border-radius` CSS 变量修正为 `--aithe-container-radius-md`；`labelWidth` 默认值改为 `'150px'`
+- **DataHub `forceDedup` / `forceCache` 请求选项**: 无视 URL 命名约定强制启用并发去重和结果缓存，适用于 URL 不以 `query`/`list`/`get` 结尾但语义为查询的 GET 请求；force 选项为 true 时自动跳过幂等防护
+- **DataHub 缓存命中响应处理修复**: 缓存命中路径跳过 `APIStyle.onResponse` 转换、`isSuccess` 业务校验、全局 `config.onResponse` 拦截器三道处理；抽取统一 `handleResponse` 方法，让缓存命中与实际请求走完全一致的响应处理逻辑
+- **DataHub `request` 方法重构**: 抽取 `executeRequest`/`buildHttpError`/`applyResponseInterceptor`/`isCacheable`/`isDedupable`/`shouldGuardIdempotent` 六个独立方法，降低认知复杂度
+- **`listPlugin` 嵌套子列表与缩进续行支持**: 重写列表解析逻辑，通过递归调用 `listPlugin.block` 生成嵌套 `list` AST 节点；抽取 `collectItemSubLines`/`buildListItemChildren`/`blankLineBelongsToItem`/`lineEndsItem`/`parseSubLines` 五个独立函数治理认知复杂度（52→阈值以内）；删除死代码 `parseListItem`
+- **`<aithe-tree-menu>` / `<aithe-sub-menu>` 激活态样式调整**: 移除 `.group-toggle.active` / `.toggle.active` 的灰底背景，激活态仅靠文字颜色区分；tree-menu `.children` 新增顶部内边距
+- **DataHub GET 请求 body 修复**: `defaultStyle.onRequest` GET 请求跳过 `data` 包装，避免 "GET request with body is unusual" 警告
+- **文档质量提升**: 修复 `autoform.md`/`datahub.md`/`markdown.md`/`i18n.md`/`guide.md`/`theming.md`/`quickstart.md` 等 7 个文档 10 处错误；issue 文件按基线版本拆分到 `26.2.2/`/`26.2.3/`/`26.3.1/`/`26.3.2/` 子目录
+- **组件数量**: 103 个可复用的 UI 组件
+
+### 破坏性变更
+
+- **`<aithe-desc>` 的 `labelWidth` 默认值变更**: `''`（auto）→ `'150px'`
+- **`<aithe-desc>` 的 `border-radius` CSS 变量重命名**: `--aithe-radius-md` → `--aithe-container-radius-md`
+- **`<aithe-desc>` 的 `isBordered` 判定变更**: `this.border` → `this.border || this.borderStyle !== 'none'`
+- **`listPlugin` 的 `parseListItem` 函数删除**: 被 `parseListItemIndented` 完全替代
+- **`listPlugin` 的 `list-item` AST `children` 结构变更**: 单一 `paragraph` → `paragraph` + 嵌套节点
+- **`listPlugin` 的 `list-item` AST `checked` 字段变更**: 透传 `item.checked` → 显式 `null`
+
+### 组件分类
+
+| 分类              | 数量 | 组件                                                                                                                                                            |
+| ----------------- | ---- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 基础 (basic)      | 12   | button, button-group, icon, input, textarea, card, tag, badge, avatar, divider, empty, chip                                                                     |
+| 布局 (layout)     | 8    | container, row, col, flex, space, collapse, collapse-item, affix                                                                                                |
+| 导航 (navigation) | 7    | menu, menu-item, sub-menu, breadcrumb, breadcrumb-item, steps, back-top                                                                                         |
+| 表单 (form)       | 18   | autoform, autoform-item, checkbox, checkbox-group, radio, radio-group, select, switch, color-picker, combobox, date-picker, time-picker, slider, rate, form, form-item, upload, transfer |
+| 反馈 (feedback)   | 9    | dialog, modal, drawer, tooltip, popover, toast, alert, notification, loading                                                                                    |
+| 数据展示 (data)   | 14   | table, table-column, tabs, tab-pane, tab-group, tree, tree-menu, dropdown, metrics, metrics-group, pagination, timeline, timeline-item, box-table                |
+| 展示 (display)    | 14   | carousel, comparison, animated-image, markdown, markdown-editor, code-editor, label, mini-box, brief-box, detail-box, profile, desc, desc-item, autoview         |
+| 进度 (progress)   | 4    | progress-bar, progress-ring, spinner, skeleton                                                                                                                  |
+| 容器 (container)  | 4    | callout, details, scroller, split-panel                                                                                                                         |
+| 主题 (theme)      | 7    | theme-picker, shape-picker, shadow-picker, typo-picker, theme-preview, locale-switch, theme-switch                                                              |
+| 框架 (framework)  | 7    | page, body, header, sidebar, dashboard, dashboard-panel, log-panel                                                                                               |
+
+### 主题列表
+
+**Light 系 (11)**: light, blue, festive, orange, purple, pink, teal, indigo, cyan, amber, gray
+
+**Dark 系 (11)**: dark, slate, charcoal, midnight, obsidian, graphite, ink, onyx, ebony, navy, raisin
+
+**云主题 (3)**: aliyun, huawei, tianyi
+
+### 阴影风格列表
+
+**内置阴影 (9)**: flat, neumorphism, skeuomorphic, glassmorphism, cyber, deep, diffuse, sharp-business, retro
+
+### 形状风格列表
+
+**内置形状 (8)**: sharp, smooth, rounded, rounder, pill, circle, chamfer, organic
+
+### 核心特性摘要
+
+- **`<aithe-autoview>` 只读视图**: JSON 驱动的只读详情视图，与 autoform 共用 `FormFieldConfig` 模型，`ViewRegistry` 自定义渲染器
+- **选项分组**: `<aithe-select>`/`<aithe-combobox>` 支持 `group` 字段自动分组渲染
+- **密码明文切换**: `<aithe-autoform>` 密码字段支持 `eye`/`eyeOff` 图标切换
+- **`<aithe-desc>` 增强**: `border-style`/`label-background` 属性，边框样式灵活控制
+- **DataHub force 选项**: `forceDedup`/`forceCache` 无视 URL 命名约定强制启用去重和缓存
+- **DataHub 缓存修复**: 缓存命中路径与实际请求路径走完全一致的响应处理逻辑
+- **`listPlugin` 嵌套子列表**: 递归解析缩进子列表，支持多层嵌套
+- **跨框架兼容**: Web Components 标准，框架无关
+- **样式隔离**: Shadow DOM 确保组件样式不冲突
+- **多主题系统**: 25 套预设主题，支持全局和局部切换
+- **无障碍访问**: ARIA 语义、键盘导航、焦点管理
+- **自定义事件**: `aithe-*` 前缀的统一事件系统
+
+---
+
 ## 26.3.1 (2026-08-06)
 
 ### 2026年第3季度第1个月版本 - 组件功能增强与质量提升
@@ -13,7 +88,7 @@
 - **Table 六项新功能**: 列固定（sticky）、`max-visible-tabs` 溢出折叠、`has-fixed` 属性、斑马纹行固定列背景修复、`selection-cell` sticky 固定、`min-width: max-content` 控制
 - **Autoform 增强**: 条件渲染、字段联动、自定义控件注册表扩展
 - **Tabs 溢出折叠**: `<aithe-tabs>` 新增 `max-visible-tabs` 属性，溢出 tab 折叠为下拉选择；新增 `extra` 具名插槽
-- **Display 组件系列新增**: 新增 `<aithe-desc>`、`<aithe-desc-item>`、`<aithe-log-panel>`、`<aithe-mini-box>`、`<aithe-detail-box>`、`<aithe-brief-box>`、`<aithe-box-table>` 7 个新组件
+- **Display 组件系列新增**: 新增 `<aithe-desc>`、`<aithe-desc-item>`、`<aithe-mini-box>`、`<aithe-detail-box>`、`<aithe-brief-box>`、`<aithe-profile>`、`<aithe-box-table>` 7 个新组件
 - **主题 CSS 变量统一**: 25 个主题统一新增 8 个 CSS 变量（`--aithe-fill-1`/`--aithe-fill-2`/`--aithe-color-surface-hover` 等），CSS 自定义属性命名规范化
 - **DataHub 错误处理增强**: HTTP 非 2xx 错误响应优先用 APIStyle 解析，`DataHubError` 新增 `data` 字段；K8s APIStyle 支持 `Status` 对象解析
 - **SSR 环境适配**: 4 个组件 `window` 引用改为 `globalThis`，兼容非浏览器环境

package/docs/changelog/VERSION_26.3.1.md

@@ -23,7 +23,7 @@
 
 1. **CSS 自定义属性统一** — 将组件中使用的 CSS 自定义属性从旧命名规范迁移到新规范（`--aithe-duration-normal` → `--aithe-duration-base`/`--aithe-duration-slow`，`--aithe-container-radius` → `--aithe-container-radius-md`，`--aithe-border-radius-md` → `--aithe-radius-md`，`--aithe-font-mono` → `--aithe-font-family-mono`）
 2. **CSS 变量新增** — `global.css.ts` 新增 `--aithe-font-size-base`/`--aithe-font-size-3xl`/`--aithe-font-size-4xl`/`--aithe-font-size-5xl` 字体尺寸变量
-3. **主题系统增强** — 所有 24 个主题统一新增 `--aithe-fill-1`/`--aithe-fill-2`/`--aithe-color-surface-hover`/`--aithe-color-text-secondary`/`--aithe-color-bg-muted`/`--aithe-color-bg-hover`/`--aithe-color-border-subtle`/`--aithe-primary-6-rgb` 8 个 CSS 变量
+3. **主题系统增强** — 所有 25 个主题统一新增 `--aithe-fill-1`/`--aithe-fill-2`/`--aithe-color-surface-hover`/`--aithe-color-text-secondary`/`--aithe-color-bg-muted`/`--aithe-color-bg-hover`/`--aithe-color-border-subtle`/`--aithe-primary-6-rgb` 8 个 CSS 变量
 4. **`<aithe-desc>` 样式重构** — 移除 `desc-cell-label` 的 `padding`，改用 flex 居中；移除 `desc-item` 的 `padding`；`desc-cell-content` 的 `background` 移除回退值
 5. **`<aithe-mini-box>` 样式修复** — hover 背景色移除嵌套的 `--aithe-color-bg-hover` 回退
 6. **`<aithe-autoform-item>` 颜色修正** — `box-shadow` 中的 `--aithe-primary-6-rgb` 回退值从 `59, 130, 246` 改为 `77, 141, 255`
@@ -107,11 +107,11 @@
 
 ## 概述
 
-Aithe UI 26.3.1 是 2026 年第 3 季度第 1 个月版本，聚焦于组件功能增强与质量提升。本版本在 26.2.3 基线版本的基础上，完成了树形菜单伸缩与事件改造、Filter 数据格式化框架、Table 六项新功能、Autoform 增强、Tabs 溢出折叠、Display 组件系列新增、主题 CSS 变量统一、DataHub 错误处理增强、SSR 环境适配等核心改进，并新增了 7 个 display 组件和 1 个 data 组件。组件数量从 90 个扩展至 98 个。
+Aithe UI 26.3.1 是 2026 年第 3 季度第 1 个月版本，聚焦于组件功能增强与质量提升。本版本在 26.2.3 基线版本的基础上，完成了树形菜单伸缩与事件改造、Filter 数据格式化框架、Table 六项新功能、Autoform 增强、Tabs 溢出折叠、Display 组件系列新增、主题 CSS 变量统一、DataHub 错误处理增强、SSR 环境适配等核心改进，并新增了 6 个 display 组件和 1 个 data 组件。组件数量从 90 个扩展至 100 个。
 
 **26.3.1.7 子版本** 聚焦于 DataHub 错误处理增强（HTTP 非 2xx 错误响应优先用 APIStyle 解析、K8s Status 对象识别）、DataHub/Filter 导入路径规范化、SSR 环境适配（4 个组件 `window` → `globalThis`）、API 文档补充（log-panel/desc-item/autoform-item）。
 
-**26.3.1.6 子版本** 聚焦于 CSS 自定义属性统一（旧命名规范迁移到新规范）、主题系统增强（24 个主题统一新增 8 个 CSS 变量）、`AitheUI` 类浏览器环境检测（10 个 getter）、样式修复。
+**26.3.1.6 子版本** 聚焦于 CSS 自定义属性统一（旧命名规范迁移到新规范）、主题系统增强（25 个主题统一新增 8 个 CSS 变量）、`AitheUI` 类浏览器环境检测（10 个 getter）、样式修复。
 
 **26.3.1.5 子版本** 聚焦于 `<aithe-tabs>` 溢出折叠与样式修复、`<aithe-desc>` 描述列表重构（独立 grid 列布局）、`<aithe-box-table>` 卡片表格重构（改用 `<aithe-brief-box>`）、`AitheSelectableType` 类型重构（纯字符串枚举）。
 
@@ -191,7 +191,7 @@ Aithe UI 26.3.1 是 2026 年第 3 季度第 1 个月版本，聚焦于组件功
 ### 8. 主题系统增强
 
 - **CSS 自定义属性统一**: 旧命名规范迁移到新规范（`--aithe-duration-normal` → `--aithe-duration-base`/`--aithe-duration-slow`，`--aithe-container-radius` → `--aithe-container-radius-md`，`--aithe-border-radius-md` → `--aithe-radius-md`，`--aithe-font-mono` → `--aithe-font-family-mono`）
-- **24 个主题统一新增 8 个 CSS 变量**: `--aithe-fill-1`/`--aithe-fill-2`/`--aithe-color-surface-hover`/`--aithe-color-text-secondary`/`--aithe-color-bg-muted`/`--aithe-color-bg-hover`/`--aithe-color-border-subtle`/`--aithe-primary-6-rgb`
+- **25 个主题统一新增 8 个 CSS 变量**: `--aithe-fill-1`/`--aithe-fill-2`/`--aithe-color-surface-hover`/`--aithe-color-text-secondary`/`--aithe-color-bg-muted`/`--aithe-color-bg-hover`/`--aithe-color-border-subtle`/`--aithe-primary-6-rgb`
 - **字体尺寸变量**: `global.css.ts` 新增 `--aithe-font-size-base`/`--aithe-font-size-3xl`/`--aithe-font-size-4xl`/`--aithe-font-size-5xl`
 
 ### 9. AitheUI 浏览器环境检测
@@ -834,7 +834,7 @@ Aithe UI 26.3.1 是 2026 年第 3 季度第 1 个月版本，聚焦于组件功
 
 - **设计令牌**: 统一的颜色、间距、字体、阴影等设计变量
 - **CSS 自定义属性统一**: 旧命名规范迁移到新规范（26.3.1.6）
-- **24 个主题统一新增 8 个 CSS 变量**: `--aithe-fill-1`/`--aithe-fill-2`/`--aithe-color-surface-hover`/`--aithe-color-text-secondary`/`--aithe-color-bg-muted`/`--aithe-color-bg-hover`/`--aithe-color-border-subtle`/`--aithe-primary-6-rgb`（26.3.1.6）
+- **25 个主题统一新增 8 个 CSS 变量**: `--aithe-fill-1`/`--aithe-fill-2`/`--aithe-color-surface-hover`/`--aithe-color-text-secondary`/`--aithe-color-bg-muted`/`--aithe-color-bg-hover`/`--aithe-color-border-subtle`/`--aithe-primary-6-rgb`（26.3.1.6）
 - **字体尺寸变量**: `--aithe-font-size-base`/`--aithe-font-size-3xl`/`--aithe-font-size-4xl`/`--aithe-font-size-5xl`（26.3.1.6）
 - **响应式**: 基于 CSS 媒体查询的响应式设计
 - **主题切换**: 通过 CSS 类名切换主题