sky-ui-kit 0.1.1 → 0.1.3

package/docs/ELEMENT-PLUS-COVERAGE.md

@@ -0,0 +1,159 @@
+# Element Plus 完整组件目录
+
+基准版本：2.14.7。共 111 个主 / 子组件、4 个服务出口、3 个指令出口。另保留 16 个项目特色组件。
+
+清单覆盖官方组件注册表及服务 / 指令，不包含内部工具函数。出口覆盖不代表所有组件的交互、独立示例和视觉状态均已验证。网站每项均提供导入和官方 API 索引，新增组合示例见 AI-GUIDE.md。
+
+组件使用 Ui 前缀；滚动条例外，直接从 element-plus 使用 ElScrollbar，不提供库出口。项目组件保持原名。结构子组件应放在相应 Ui 父组件下；配置组件和无界面指令保留官方语义。UiLoading 提供 service / directive，不提供 install。
+
+## 导航组件
+
+| 名称 | 库出口 | 官方实现 | 方式 | API |
+|---|---|---|---|---|
+| 固钉 | UiAffix | ElAffix | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/affix.html) |
+| 回到顶部 | UiBacktop | ElBacktop | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/backtop.html) |
+| 面包屑 | UiBreadcrumb | ElBreadcrumb | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/breadcrumb.html) |
+| 面包屑项 | UiBreadcrumbItem | ElBreadcrumbItem | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/breadcrumb.html) |
+| 下拉菜单 | UiDropdown | ElDropdown | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/dropdown.html) |
+| 下拉菜单项 | UiDropdownItem | ElDropdownItem | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/dropdown.html) |
+| 下拉菜单面板 | UiDropdownMenu | ElDropdownMenu | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/dropdown.html) |
+| 菜单 | UiMenu | ElMenu | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/menu.html) |
+| 菜单项 | UiMenuItem | ElMenuItem | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/menu.html) |
+| 菜单分组 | UiMenuItemGroup | ElMenuItemGroup | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/menu.html) |
+| 子菜单 | UiSubMenu | ElSubMenu | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/menu.html) |
+| 页头 | UiPageHeader | ElPageHeader | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/page-header.html) |
+| 步骤条 | UiSteps | ElSteps | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/steps.html) |
+| 步骤项 | UiStep | ElStep | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/steps.html) |
+| 标签页 | UiTabs | ElTabs | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/tabs.html) |
+| 标签页面板 | UiTabPane | ElTabPane | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/tabs.html) |
+| 锚点 | UiAnchor | ElAnchor | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/anchor.html) |
+| 锚点链接 | UiAnchorLink | ElAnchorLink | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/anchor.html) |
+
+## 基础组件
+
+| 名称 | 库出口 | 官方实现 | 方式 | API |
+|---|---|---|---|---|
+| 图标 | UiIcon | ElIcon | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/icon.html) |
+| 滚动条 | ElScrollbar | ElScrollbar | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/scrollbar.html) |
+| 按钮 | UiButton | ElButton | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/button.html) |
+| 按钮组 | UiButtonGroup | ElButtonGroup | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/button.html) |
+| 栅格行 | UiRow | ElRow | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/layout.html) |
+| 栅格列 | UiCol | ElCol | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/layout.html) |
+| 折叠动画 | UiCollapseTransition | ElCollapseTransition | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/transition.html) |
+| 布局容器 | UiContainer | ElContainer | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/container.html) |
+| 侧栏 | UiAside | ElAside | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/container.html) |
+| 底栏 | UiFooter | ElFooter | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/container.html) |
+| 顶栏 | UiHeader | ElHeader | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/container.html) |
+| 主体 | UiMain | ElMain | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/container.html) |
+| 分割线 | UiDivider | ElDivider | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/divider.html) |
+| 链接 | UiLink | ElLink | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/link.html) |
+| 间距 | UiSpace | ElSpace | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/space.html) |
+| 文本 | UiText | ElText | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/text.html) |
+
+## 反馈组件
+
+| 名称 | 库出口 | 官方实现 | 方式 | API |
+|---|---|---|---|---|
+| 警告提示 | UiAlert | ElAlert | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/alert.html) |
+| 文字提示 | UiTooltip | ElTooltip | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/tooltip.html) |
+| 对话框 | UiDialog | ElDialog | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/dialog.html) |
+| 抽屉 | UiDrawer | ElDrawer | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/drawer.html) |
+| 气泡确认 | UiPopconfirm | ElPopconfirm | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/popconfirm.html) |
+| 引导 | UiTour | ElTour | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/tour.html) |
+| 引导步骤 | UiTourStep | ElTourStep | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/tour.html) |
+| 气泡卡片 | UiPopover | ElPopover | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/popover.html) |
+| 消息提示 | UiMessage | ElMessage | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/message.html) |
+| 消息确认 | UiMessageBox | ElMessageBox | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/message-box.html) |
+| 通知 | UiNotification | ElNotification | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/notification.html) |
+| 加载 | UiLoading | ElLoading | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/loading.html) |
+| 加载指令 | vUiLoading | ElLoadingDirective | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/loading.html) |
+
+## 表单组件
+
+| 名称 | 库出口 | 官方实现 | 方式 | API |
+|---|---|---|---|---|
+| 表单 | UiForm | ElForm | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/form.html) |
+| 表单项 | UiFormItem | ElFormItem | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/form.html) |
+| 输入框 | UiInput | ElInput | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/input.html) |
+| 自动补全 | UiAutocomplete | ElAutocomplete | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/autocomplete.html) |
+| 时间选择器 | UiTimePicker | ElTimePicker | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/time-picker.html) |
+| 选择器 | UiSelect | ElSelect | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/select.html) |
+| 选项 | UiOption | ElOption | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/select.html) |
+| 选项组 | UiOptionGroup | ElOptionGroup | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/select.html) |
+| 复选框 | UiCheckbox | ElCheckbox | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/checkbox.html) |
+| 复选按钮 | UiCheckboxButton | ElCheckboxButton | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/checkbox.html) |
+| 复选框组 | UiCheckboxGroup | ElCheckboxGroup | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/checkbox.html) |
+| 单选框 | UiRadio | ElRadio | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/radio.html) |
+| 单选按钮 | UiRadioButton | ElRadioButton | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/radio.html) |
+| 单选框组 | UiRadioGroup | ElRadioGroup | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/radio.html) |
+| 级联面板 | UiCascaderPanel | ElCascaderPanel | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/cascader.html) |
+| 级联选择器 | UiCascader | ElCascader | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/cascader.html) |
+| 颜色面板 | UiColorPickerPanel | ElColorPickerPanel | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/color-picker-panel.html) |
+| 颜色选择器 | UiColorPicker | ElColorPicker | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/color-picker.html) |
+| 日期面板 | UiDatePickerPanel | ElDatePickerPanel | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/date-picker-panel.html) |
+| 日期选择器 | UiDatePicker | ElDatePicker | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/date-picker.html) |
+| 数字输入框 | UiInputNumber | ElInputNumber | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/input-number.html) |
+| 标签输入框 | UiInputTag | ElInputTag | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/input-tag.html) |
+| 验证码输入框 | UiInputOtp | ElInputOtp | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/input-otp.html) |
+| 评分 | UiRate | ElRate | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/rate.html) |
+| 虚拟选择器 | UiSelectV2 | ElSelectV2 | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/select-v2.html) |
+| 滑块 | UiSlider | ElSlider | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/slider.html) |
+| 开关 | UiSwitch | ElSwitch | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/switch.html) |
+| 时间下拉选择 | UiTimeSelect | ElTimeSelect | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/time-select.html) |
+| 穿梭框 | UiTransfer | ElTransfer | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/transfer.html) |
+| 树选择器 | UiTreeSelect | ElTreeSelect | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/tree-select.html) |
+| 上传 | UiUpload | ElUpload | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/upload.html) |
+| 提及 | UiMention | ElMention | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/mention.html) |
+
+## 其他与配置
+
+| 名称 | 库出口 | 官方实现 | 方式 | API |
+|---|---|---|---|---|
+| 底层浮层 | UiPopper | ElPopper | 保留结构 / 无界面行为 | [官方文档 / 源码](https://github.com/element-plus/element-plus/tree/2.14.7/packages/components/popper) |
+| 全局配置 | UiConfigProvider | ElConfigProvider | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/config-provider.html) |
+| 水印 | UiWatermark | ElWatermark | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/watermark.html) |
+| 分割面板 | UiSplitter | ElSplitter | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/splitter.html) |
+| 分割区域 | UiSplitterPanel | ElSplitterPanel | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/splitter.html) |
+| 无限滚动 | vUiInfiniteScroll | ElInfiniteScroll | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/infinite-scroll.html) |
+| 气泡触发指令 | vUiPopover | ElPopoverDirective | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/popover.html) |
+
+## 数据展示
+
+| 名称 | 库出口 | 官方实现 | 方式 | API |
+|---|---|---|---|---|
+| 头像 | UiAvatar | ElAvatar | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/avatar.html) |
+| 头像组 | UiAvatarGroup | ElAvatarGroup | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/avatar.html) |
+| 徽标 | UiBadge | ElBadge | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/badge.html) |
+| 标签 | UiTag | ElTag | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/tag.html) |
+| 日历 | UiCalendar | ElCalendar | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/calendar.html) |
+| 卡片 | UiCard | ElCard | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/card.html) |
+| 轮播 | UiCarousel | ElCarousel | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/carousel.html) |
+| 轮播项 | UiCarouselItem | ElCarouselItem | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/carousel.html) |
+| 可选标签 | UiCheckTag | ElCheckTag | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/check-tag.html) |
+| 折叠面板 | UiCollapse | ElCollapse | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/collapse.html) |
+| 折叠项 | UiCollapseItem | ElCollapseItem | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/collapse.html) |
+| 统计数值 | UiStatistic | ElStatistic | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/statistic.html) |
+| 倒计时 | UiCountdown | ElCountdown | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/statistic.html) |
+| 描述列表 | UiDescriptions | ElDescriptions | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/descriptions.html) |
+| 描述项 | UiDescriptionsItem | ElDescriptionsItem | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/descriptions.html) |
+| 空状态 | UiEmpty | ElEmpty | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/empty.html) |
+| 图片预览 | UiImageViewer | ElImageViewer | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/image.html) |
+| 图片 | UiImage | ElImage | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/image.html) |
+| 分页 | UiPagination | ElPagination | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/pagination.html) |
+| 进度条 | UiProgress | ElProgress | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/progress.html) |
+| 结果 | UiResult | ElResult | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/result.html) |
+| 骨架屏 | UiSkeleton | ElSkeleton | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/skeleton.html) |
+| 骨架元素 | UiSkeletonItem | ElSkeletonItem | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/skeleton.html) |
+| 表格 | UiTable | ElTable | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/table.html) |
+| 表格列 | UiTableColumn | ElTableColumn | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/table.html) |
+| 虚拟表格 | UiTableV2 | ElTableV2 | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/table-v2.html) |
+| 自动尺寸容器 | UiAutoResizer | ElAutoResizer | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/table-v2.html) |
+| 时间线 | UiTimeline | ElTimeline | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/timeline.html) |
+| 时间线项 | UiTimelineItem | ElTimelineItem | 保留结构 / 无界面行为 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/timeline.html) |
+| 树 | UiTree | ElTree | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/tree.html) |
+| 虚拟树 | UiTreeV2 | ElTreeV2 | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/tree-v2.html) |
+| 分段控制器 | UiSegmented | ElSegmented | 主题封装 | [官方文档 / 源码](https://element-plus.org/zh-CN/component/segmented.html) |
+
+## 维护
+
+升级 Element Plus 后运行 `npm run components:sync`，审查新增组件、中文名称、分类、父子关系及最低依赖版本，再运行 `npm run docs:ai`。仅同步源码与文档，不构建或发布。

package/docs/GLOBAL-ADAPTATION.md

@@ -0,0 +1,38 @@
+# 原项目全局适配与组件库融合
+
+## 已读取的实际链路
+
+- main.ts：createFitScale，target #app，设计尺寸 1920×912，scaleMode auto；注册 Pinia / router，注册 SVG sprite。
+- App.vue：useFitScale → watch → document.documentElement 的 --cp-vfit-scale；主题 store 的 deep watch 调用 applyCssVars，卸载释放 watch 并移除 scale。根 ElConfigProvider 保留中文 locale。
+- styles/vfit-vars.scss：--cp-size-1…360 与 --cp-font-1…40 按缩放值计算；部分图表高度使用 clamp 与视口约束。
+- styles/theme.css / stores/theme.ts：六色与派生主题、--header-height / --sidebar-width / --rightpanel-width / --layout-gutter，以及 Element Plus 变量；主题 store 保留为唯一控制者。
+- styles/base.css / MainLayout：html/body/#app 的高度链、box-sizing、字体继承、workspace 扣除 header 高度。
+- MainLayoutMap / TemplateLayout：地图与 pointer-events:none 覆盖层分离，交互区域恢复事件；右栏开关影响浮层位置，ResizeObserver 测量时间轴和图例并在卸载释放。map/index.vue 挂载后 nextTick 调用 map.resize。
+
+## 融合分工
+
+| 内容 | 原项目维护 | 组件库消费 |
+|---|---|---|
+| 视口与设计尺寸 | VFit 单次注册，1920×912 auto | 不注册 VFit，不管理窗口缩放 |
+| 全局缩放 | App.vue 写根 --cp-vfit-scale | 局部尺寸 token 根据该变量计算，缺失按 1 |
+| 主题 | 原主题 store、六色、暗色、字体与 localStorage | 读取变量并提供缺失默认值；不迁入预览站 store |
+| 页面结构 | RouterView、权限、ui store、布局开关 | Ui 容器及项目展示组件组合 |
+| 地图与图表 | 地图实例、resize、图层订阅、图表 resize、释放 | 工具、菜单、时间轴事件由页面接回原逻辑 |
+| 浮层 | 根主题变量与现有弹窗配置 | 默认主题范围；显式 body 浮层另核对主题和缩放 |
+
+默认 style.css 的 scoped-vfit.scss 不把 --cp-vfit-scale 重置为 1；其低优先级默认 token 在 .userssite-theme 内计算。原项目根节点已有的六色与布局变量由 --userssite-* 桥接读取。库没有全局 html/body reset，保留原 base.css。ElScrollbar 直接从 element-plus 使用；它的主题来自应用已有作用域，不额外包装。
+
+## 接入步骤
+
+1. 保留原 main.ts 的 VFit、Pinia、路由、SVG、字体与主题导入，公共库 CSS 追加一次；默认不引入 global.css。原项目已有 VFit，不重新安装、注册或另设设计尺寸。
+2. 保留 App.vue 的 scale 和 theme 两个 watch；不要在单个页面重复写根变量或引入组件库预览 store。复制代码见 AI-GUIDE.md 的全局适配示例，布局页面也提供相同代码。
+3. 页面容器用 --header-height / --sidebar-width / --rightpanel-width / --layout-gutter，内容 min-width/min-height:0。系统页内部滚动用 ElScrollbar；地图页面保持地图与覆盖层分离，避免整层拦截鼠标。
+4. 组件已通过 --cp-font-* / --cp-size-* 消费比例时，不再添加第二套 transform:scale / zoom。原项目 VFit 本身的行为保留；这里只禁止迁移时额外引入新的缩放层。
+5. 右栏、左栏或底部过程区改变地图宿主尺寸时，由应用在 DOM 更新/过渡完成后调用地图 resize；ECharts 在容器尺寸变化时调用实例 resize。原 map/index.vue 的挂载 resize 不等于已覆盖所有后续布局变化，不把这项能力宣称为库自动处理。
+6. body 上的 dialog / drawer / select / image preview 不能读取局部容器独有变量。原项目根 scale/theme 可被它们继承；局部主题需显式传 class/style 或保持浮层在容器内，并检查 overflow 裁剪。
+
+## 窄屏与验证
+
+全局比例适配解决设计尺寸缩放，内容重排仍由布局负责；必要时收起侧栏、把业务面板改为抽屉、允许表格水平滚动。演示布局的紧凑宽度为预览用途，不等于原生产布局参数；真实页面优先使用原布局变量。地图色带、业务阈值和图片点位不随六色替换。
+
+在 1920×912、较小桌面和窄屏下核对：根 scale 值、控件字体和高度、左右面板避让、时间轴/图例重叠、地图/图表 resize、弹窗与图片预览、键盘焦点和滚动。明暗主题分别验证，关闭页面确认 watch / ResizeObserver / 地图图表监听释放。当前只读审查与文档示例不替代原项目运行回归；本次未修改原项目。

package/docs/INTEGRATION.md

@@ -4,8 +4,22 @@
 
 # 发布与反向接入
 
+## 图标替换
+
+原 components/global/SvgIcon.vue 可替换为从 sky-ui-kit 导入 SvgIcon，保留 name / size / title / decorative。库内置 274 个项目 SVG，自动按需注册到 sky-icon- 命名空间；不依赖业务项目 Vite 插件。暂时保留旧 sprite 时传 prefix="icon-"，资源仍由原 virtual:svg-icons-register 提供。完成所有旧引用检查后才移除旧全局组件和插件，地图 PNG / Logo 的注册不变。子目录名称改为目录前缀以避免重名，按 projectIcons.source 与 name 对照迁移。Element Plus 图标仍从 @element-plus/icons-vue 导入，用 UiIcon 包裹。图标操作事件、路由和权限继续由业务方绑定。
+
 ## 当前交付范围
 
+全局适配融合见 [GLOBAL-ADAPTATION.md](GLOBAL-ADAPTATION.md)：保留原 VFit 注册、根缩放/主题变量桥接和页面高度链，库只读取变量。地图/图表 resize、浮层主题与窄屏重排仍由业务方接入，完整共享代码在布局页和 AI-GUIDE.md。
+
+最新只读使用清单见 [COMPONENT-USAGE.md](COMPONENT-USAGE.md)，逐模块适配见 [ADAPTATION.md](ADAPTATION.md)。原项目接入页面同步展示清单和替换边界。图标 Vite 完整配置和页面调用见 AI-GUIDE.md 的图标接入示例；原项目已经配置插件，保留旧 sprite 时不重复配置。
+
+预览站左侧按 Element Plus 全量目录分类，并独立保留项目选择、时间、菜单和地图组件。标准组件已提供出口与 API 索引，但不能据此认为所有独立示例或业务回归均已完成；替换时仍应核对公开出口、API 与下文路径映射。预览站 SiteNavigation 无需迁入业务项目。
+
+## 全量标准组件替换
+
+使用新增组件前确认实际安装的 Element Plus 至少为 2.14.7；原业务项目目前声明 ^2.14.2，该范围可包含 2.14.7，先检查 lockfile 与安装版本，再决定是否安排升级和回归，本次未修改原项目。标准组件通常把 El 名称换为 Ui 名称并从 sky-ui-kit 导入，属性、事件、插槽和实例方法沿用对应安装版本 API。结构子组件搭配对应 Ui 父组件，特别是轮播项、引导步骤、选项、表格列、标签页面板。服务使用 UiMessage / UiMessageBox / UiNotification / UiLoading.service；指令使用 vUiLoading / vUiInfiniteScroll / vUiPopover。组件库不承接地图请求、上传接口、路由或权限逻辑。
+
 本包是现有项目公共主题及组件的独立快照，不是原平台业务 SDK。全页面盘点见 PAGE-INVENTORY.md；全部原组件依赖见 COMPONENT-INVENTORY.md。扫描是完整源码静态读取，业务页面尚未逐页运行验证。尚未发布，不应现在把主项目全部替换。
 
 ## 默认视觉
@@ -51,7 +65,7 @@ Header / SideMenu / MainLayout 的路由、权限、用户和布局状态；Laye
 
 ## 按步骤反向接入
 
-1. 样式确认后确定 npm 包名 / scope、版本和许可证，删除 private，执行 typecheck、build、pack --dry-run 后发布。预览站用暂定包名，发布后更新文档示例。
+1. 包名已确定为 sky-ui-kit；先完成模块与样式确认并记录版本。仅明确安排打包/发布时执行构建与发布检查；当前源码未发布，npm latest 不会包含工作区的新修改。
 2. 主项目安装精确版本，保留 Vue / Pinia / Element Plus / motion-v / icons 依赖。先在独立分支接入一个非核心页面验证，不修改所有页面。
 3. main.ts 保持 Element Plus CSS 在前，包 style.css 在后。默认隔离；只有主动整站换肤时才额外引入 global.css。
 4. 选择原 theme store 继续作为单一主题控制者（推荐首轮）：先只迁组件和 CSS；保持原 `app-theme` 配置、RightPanel 和 App.vue 的 watch。不在此阶段引入包 store。
@@ -69,3 +83,58 @@ Header / SideMenu / MainLayout 的路由、权限、用户和布局状态；Laye
 ## 验收门槛
 
 包：typecheck / build / npm pack 内容、公开导出及依赖清单。应用：typecheck / build、每个迁移页面运行核对、实际 API 和地图事件接线、明暗截图与业务回归。当前自动扫描与预览站构建不能替代实际业务验收。
+
+## TemplateLayout 地图业务布局
+
+原 TemplateLayout 保留在业务应用中，组件库布局页提供独立区域说明和组合轮廓示例。替换其子组件时保留 ui store 右栏状态、地图工具事件、图层与区域逻辑、默认图例和主题弹窗；保留图例/时间轴 ResizeObserver 测量及卸载释放。不能直接从 sky-ui-kit 导入 TemplateLayout。
+
+## 2026-10-13：一体机本地开发接入
+
+新增四个工作台组件和 MapTools.items。工作台 CSS 在 .sky-workbench 下隔离，使用库主题变量；应用消费本地 0.1.3-dev.0，未发布。详情见 [消费项目记录](CONSUMERS.md)。
+
+## 2026-10-13：顶部菜单修复（0.1.3-dev.1）
+
+删除工作台残留的 primary-nav 样式，选中效果由 ProjectMenu 统一负责。顶部菜单按内容宽度居中，不再拉满或撑满头部高度；横向菜单不换行，仅允许横向滚动并隐藏滚动条，保留滚轮、触摸和键盘操作。应用升级本地开发包，未发布 npm。
+
+## 2026-10-13：左侧胶囊布局（0.1.3-dev.2）
+
+工作台左侧采用留白悬浮圆角侧栏，内部菜单使用胶囊圆角，移除选中项侧边竖线和嵌套菜单外框。数据范围卡片统一圆角。样式限定 sky-workbench，不改变独立 ProjectMenu。更新本地消费包，未发布 npm。
+
+## 2026-10-13：地图布局（0.1.3-dev.3）
+
+一体机应用彻底移除左侧工作台、数据范围及侧栏开关，导航由顶部菜单提供。WorkbenchShell collapsed=true 使用单列布局，地图占满导航下方；指标、列表、工具和过程图保持悬浮。修复 collapsed 根节点选择器，取消地图定位的侧栏留白。该布局替代此前胶囊侧栏方案。
+
+## 地图左侧胶囊导航（0.1.3-dev.4）
+
+移除顶部横向菜单，使用 ProjectMenu 在地图左侧悬浮展示五个胶囊入口；不占侧栏列、不恢复数据范围与终端信息。工作台提供 map-capsule-menu 样式变体。
+
+## 透明地图顶部栏（0.1.3-dev.5）
+
+地图布局下头部绝对定位悬浮，无背景、边框或阴影；地图延伸至页面顶部。业务标题、指标、列表保留顶部避让。独立带侧栏布局不受影响。
+
+## 地图排版统一（0.1.3-dev.6）
+
+左侧标题与胶囊导航对齐，去除重复面包屑及介绍；四项指标合为紧凑统计栏。右侧与过程面板使用实底、统一圆角和留白，图例固定左下。过程图初始隐藏，查询站点或预报后打开。
+
+## 顶部可读性与地图穿透（0.1.3-dev.7）
+
+品牌和操作按钮分组使用实底胶囊，顶部整条容器 pointer-events:none，仅品牌及操作区恢复 auto。空白处拖拽、滚轮交给地图；去掉冗余本地应用文字和分隔线。
+
+## 使用正式地图胶囊菜单（0.1.3-dev.8）
+
+一体机左侧改用已有 MapSideMenu，保留搜索、图标模式、分组折叠及选中样式。替代此前 ProjectMenu 的自定义胶囊变体。工作台只提供定位，不另写菜单皮肤。
+
+
+地图要素叠加可用 MapSideMenu multiple + v-model:active-keys，change 中差量更新业务图层；路由菜单继续单选，不对多个 key 执行多次路由跳转。原 SideMenuMap 为路由单选，新增能力只在库中实现。
+
+## 一级地图胶囊菜单（0.1.3-dev.9）
+
+MapSideMenu 新增 flat:boolean，默认 false 保持分组模式。flat=true 隐藏父节点，将各项显示为一级胶囊，去除缩进及连线。一体机使用 flat=true 展示五个主菜单。
+
+## 图层控制封装（0.1.3-dev.10）
+
+MapLayerControl 参考平台 LayerControl/LayerTreeNode，提供底图选择、注记、树分组、搜索、显隐、拖拽排序、透明度、定位与可移除图层事件。数据及地图操作由消费方提供，未绑定平台 Pinia 或假服务。
+
+## 地图胶囊选中修复（0.1.3-dev.11）
+
+flat 模式按钮此前错误使用 child 类而内部图标、文字使用 parent 类，导致 active 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。