sky-ui-kit 0.1.2 → 0.1.3

package/docs/CSS-THEME.md

@@ -62,3 +62,51 @@ import 'sky-ui-kit/global.css'
 全局缩放/主题融合以 GLOBAL-ADAPTATION.md 为准：原 App.vue 写根 --cp-vfit-scale，scoped-vfit 不重置它；保留原主题 store。不要在已消费 cp token 的组件外再增加第二套缩放。body 浮层核对根变量，局部变量需显式接入。
 
 SvgIcon 样式仅作用于 scoped 的 .sky-svg-icon，不覆盖原生 ElIcon 或原项目 .svg-icon。默认继承 currentColor；数字 size 读取 --cp-font-1，缺失回退 1px；固定色 / 多色路径保持原配色。公共样式仍只在 main.ts 引入一次。
+
+## 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 的自定义胶囊变体。工作台只提供定位，不另写菜单皮肤。
+
+## 一级地图胶囊菜单（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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。

package/docs/ELEMENT-PLUS-COVERAGE.md

@@ -1,6 +1,6 @@
 # Element Plus 完整组件目录
 
-基准版本：2.14.7。共 111 个主 / 子组件、4 个服务出口、3 个指令出口。另保留 11 个项目特色组件。
+基准版本：2.14.7。共 111 个主 / 子组件、4 个服务出口、3 个指令出口。另保留 16 个项目特色组件。
 
 清单覆盖官方组件注册表及服务 / 指令，不包含内部工具函数。出口覆盖不代表所有组件的交互、独立示例和视觉状态均已验证。网站每项均提供导入和官方 API 索引，新增组合示例见 AI-GUIDE.md。
 

package/docs/INTEGRATION.md

@@ -87,3 +87,54 @@ Header / SideMenu / MainLayout 的路由、权限、用户和布局状态；Laye
 ## 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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。

package/llms-full.txt

@@ -1,9 +1,10 @@
 # sky-ui-kit
 
-> Vue 3 components compatible with Element Plus, project menus, timeline and map tools. Version 0.1.2. AI tools must explicitly load these files.
+> Vue 3 components compatible with Element Plus, project menus, timeline and map tools. Version 0.1.3. AI tools must explicitly load these files.
 
 ## Documentation
 
+- [Consumers](docs/CONSUMERS.md): shared project convention and local integration.
 - [AI guide](docs/AI-GUIDE.md): setup, examples, icon/event bindings and limits.
 - [Component API](docs/COMPONENT-API.md): props, defaults, events, slots and types.
 - [AI module changes](docs/AI-CHANGELOG.md): module updates and integration impact.
@@ -149,6 +150,81 @@ SvgIcon 保留 name、size、title、decorative，新增 color 和 prefix。默
 
 维护 SVG 快照：node scripts/sync-project-icons.mjs "原项目/src/assets/icons"，仅只读读取参考项目；生成后核对重复名称与配色并运行 npm run docs:ai。
 
+
+## 一体机工作台组件
+
+WorkbenchShell 提供隔离的工作台布局；WorkbenchPanel 提供面板结构；MetricCard 提供指标展示。ProcessChart 接收 rows、kind、unit 以及应用注入的 engine（init/setOption/resize/dispose），不内置业务 API。MapTools 的可选 items 提供 key/label/icon，不传时保持默认工具。消费约定见 docs/CONSUMERS.md。
+
+
+```vue
+<script setup>
+import { WorkbenchShell, WorkbenchPanel, MetricCard, ProcessChart } from "sky-ui-kit"
+// engine 由应用创建；rows 由业务查询提供。
+defineProps(["engine", "rows"])
+</script>
+<template>
+  <WorkbenchShell>
+    <WorkbenchPanel :floating="false"><MetricCard label="接入站点" :value="3060" unit="个" /></WorkbenchPanel>
+    <WorkbenchPanel><ProcessChart :engine="engine" :rows="rows" kind="rain" unit="mm" /></WorkbenchPanel>
+  </WorkbenchShell>
+</template>
+```
+
+
+## 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 的自定义胶囊变体。工作台只提供定位，不另写菜单皮肤。
+
+
+## 一级地图胶囊菜单（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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+
 <!-- GENERATED EXAMPLES -->
 
 ### 快速开始：安装最新正式版本
@@ -2872,6 +2948,34 @@ const popoverRef = ref()
 
 ```
 
+### 地图菜单多选示例
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { Pouring, List, Sunny } from '@element-plus/icons-vue'
+import { MapSideMenu, UiButton } from 'sky-ui-kit'
+const activeKeys = ref(['rain', 'water'])
+const compactKeys = ref(['rain', 'temperature'])
+const message = ref('可同时选择多个监测要素，再次点击取消')
+const items = [{ key: 'rain', label: '降水', icon: Pouring }, { key: 'water', label: '水位', icon: List }, { key: 'temperature', label: '气温', icon: Sunny }]
+</script>
+<template>
+  <h3>地图胶囊菜单 · 多选</h3>
+  <div class="multi-menu"><MapSideMenu multiple v-model:active-keys="activeKeys" :items="items" @change="message = '已选：' + $event.join('、')" /></div>
+  <p>当前选择：{{ activeKeys.join('、') || '无' }}</p>
+  <UiButton @click="activeKeys = []">清空选择</UiButton>
+  <h3>纯图标 · 多选</h3>
+  <div class="multi-menu"><MapSideMenu multiple compact v-model:active-keys="compactKeys" :items="items" /></div>
+  <p>图标选择：{{ compactKeys.join('、') || '无' }}</p>
+  <p role="status">{{ message }}</p>
+</template>
+<style scoped>
+.multi-menu { height: 260px; border: 1px solid var(--color-border, #dbe3ef); border-radius: 8px; background: var(--surface-subtle, #eef5ff); }
+</style>
+
+```
+
 # 团队 AI 模块变更记录
 
 本文件记录源码模块调整与接入影响，不作为 npm 发布完成的依据。团队使用安装包时以包内文档及 package.json 版本为准；使用当前源码时读取仓库中的同名文档。
@@ -3010,6 +3114,59 @@ const popoverRef = ref()
 - UiIcon 页面补充 Element Plus 全量图标、业务 SVG 分类搜索、名称复制、尺寸颜色、按钮状态和菜单绑定示例；项目特色组件新增 SVG 入口。
 - 同步生成 API、AI 示例、主题及原项目反向接入说明。未构建、发布或提交，原业务项目未修改。
 
+
+## 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 的自定义胶囊变体。工作台只提供定位，不另写菜单皮肤。
+
+
+## 2026-10-13 · 地图胶囊菜单多选
+
+新增 multiple、activeKeys、update:activeKeys 和 change，保留单选 active/select；支持取消、清空、搜索和图标模式，新增可复制双模式示例。未构建或发布。
+
+## 一级地图胶囊菜单（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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
 
 # Component API reference
 
@@ -3214,8 +3371,11 @@ export interface ProjectMenuGroup { label: string; items: ProjectMenuItem[] }
 
 | Name | Type | Required | Default expression |
 |---|---|---|---|
+| flat | boolean | false | false |
 | title | string | false | '实况(测站)' |
 | active | string | false | 'rain' |
+| multiple | boolean | false | false |
+| activeKeys | string[] | false | () => [] |
 | dark | boolean | false | false |
 | compact | boolean | false | false |
 | items | MapMenuItem[] | false | () => [
@@ -3231,6 +3391,8 @@ export interface ProjectMenuGroup { label: string; items: ProjectMenuItem[] }
 ### Events
 
 - `update:active` — `[key: string]`
+- `update:activeKeys` — `[keys: string[]]`
+- `change` — `[keys: string[]]`
 - `update:compact` — `[value: boolean]`
 - `select` — `[item: MapMenuItem]`
 
@@ -3249,6 +3411,7 @@ export interface MapMenuItem { key: string; label: string; icon?: Component }
 | active | string | false | 'layers' |
 | horizontal | boolean | false | false |
 | icons | Record<string, Component> | false | () => ({}) |
+| items | MapToolItem[] | false | undefined / no declared default |
 
 ### Events
 
@@ -3258,6 +3421,10 @@ export interface MapMenuItem { key: string; label: string; icon?: Component }
 
 Slots: No declared content slots.
 
+```ts
+export interface MapToolItem { key: string; label: string; icon?: Component }
+```
+
 ## AtlasMapTitle
 
 ### Props
@@ -3306,6 +3473,103 @@ No declared events.
 
 Slots: No declared content slots.
 
+## WorkbenchShell
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| collapsed | boolean | false | false |
+
+### Events
+
+No declared events.
+
+Slots: default
+
+## WorkbenchPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| as | 'section' &#124; 'aside' &#124; 'div' | false | 'section' |
+| floating | boolean | false | true |
+
+### Events
+
+No declared events.
+
+Slots: default
+
+## MetricCard
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| label | string | true | undefined / no declared default |
+| value | string &#124; number | false | '—' |
+| unit | string | false | '' |
+| tone | 'blue' &#124; 'cyan' &#124; 'green' &#124; 'purple' | false | 'blue' |
+| compact | boolean | false | false |
+
+### Events
+
+No declared events.
+
+Slots: icon
+
+## ProcessChart
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| rows | ProcessChartRow[] | true | undefined / no declared default |
+| engine | ProcessChartEngine | true | undefined / no declared default |
+| kind | 'rain' &#124; 'flow' | false | 'rain' |
+| unit | string | false | '' |
+
+### Events
+
+No declared events.
+
+Slots: No declared content slots.
+
+```ts
+export interface ProcessChartRow { time: string; value: number | null }
+export interface ProcessChartInstance { setOption: (option: Record<string, unknown>, notMerge?: boolean) => void; resize: () => void; dispose: () => void }
+export interface ProcessChartEngine { init: (element: HTMLElement) => ProcessChartInstance }
+```
+
+## MapLayerControl
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| nodes | MapLayerNode[] | true | undefined / no declared default |
+| basemap | string | false | 'imagery' |
+| annotation | boolean | false | true |
+
+### Events
+
+- `update:basemap` — `[value: string]`
+- `update:annotation` — `[value: boolean]`
+- `visibility` — `[node: MapLayerNode, visible: boolean]`
+- `opacity` — `[node: MapLayerNode, value: number]`
+- `move` — `[dragId: string, targetId: string, position: string]`
+- `remove` — `[node: MapLayerNode]`
+- `locate` — `[node: MapLayerNode]`
+- `close` — `[]`
+
+Slots: No declared content slots.
+
+```ts
+export interface MapLayerNode { id: string; name: string; visible?: boolean; opacity?: number; disabled?: boolean; removable?: boolean; children?: MapLayerNode[] }
+```
+
 ## UiAffix
 
 固钉 · 导航组件. Original: ElAffix. Import from: sky-ui-kit. [API](https://element-plus.org/zh-CN/component/affix.html). See dist/components/element-plus.d.ts.
@@ -4023,7 +4287,7 @@ Preserves upstream structure and context. Structural children inherit theme from
 
 # Element Plus 完整组件目录
 
-基准版本：2.14.7。共 111 个主 / 子组件、4 个服务出口、3 个指令出口。另保留 11 个项目特色组件。
+基准版本：2.14.7。共 111 个主 / 子组件、4 个服务出口、3 个指令出口。另保留 16 个项目特色组件。
 
 清单覆盖官方组件注册表及服务 / 指令，不包含内部工具函数。出口覆盖不代表所有组件的交互、独立示例和视觉状态均已验证。网站每项均提供导入和官方 API 索引，新增组合示例见 AI-GUIDE.md。
 
@@ -4504,3 +4768,111 @@ import 'sky-ui-kit/global.css'
 全局缩放/主题融合以 GLOBAL-ADAPTATION.md 为准：原 App.vue 写根 --cp-vfit-scale，scoped-vfit 不重置它；保留原主题 store。不要在已消费 cp token 的组件外再增加第二套缩放。body 浮层核对根变量，局部变量需显式接入。
 
 SvgIcon 样式仅作用于 scoped 的 .sky-svg-icon，不覆盖原生 ElIcon 或原项目 .svg-icon。默认继承 currentColor；数字 size 读取 --cp-font-1，缺失回退 1px；固定色 / 多色路径保持原配色。公共样式仍只在 main.ts 引入一次。
+
+## 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 的自定义胶囊变体。工作台只提供定位，不另写菜单皮肤。
+
+## 一级地图胶囊菜单（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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+
+# 一体机组件库接入约定
+
+用户要求：一体机 Web 的通用组件全部使用 sky-ui-kit，缺失能力先补充库，再由应用消费。
+
+消费项目：D:/Work/01-项目code/一体化平台/一体机项目。库源码：D:/sky-ui-kit。参考业务平台只读。
+
+新增 WorkbenchShell、WorkbenchPanel、MetricCard、ProcessChart；MapTools 支持 items 自定义工具。ProcessChart 由应用注入 ECharts engine，库不耦合业务 API。基础表单、按钮、导航、表格、卡片使用库公开出口。地图引擎、业务查询、数据快照留在应用。
+
+CSS 入口按顺序仅导入一次 Element Plus CSS 和 sky-ui-kit/style.css。暗色使用 html.theme-dark。工作台样式隔离在 .sky-workbench 内。
+
+本次使用 0.1.3-dev.0 本地开发包，未发布 npm。npm 正式版本仍为 0.1.2。后续修改必须同步 AI 文档，构建、打包后更新应用 vendor 包及锁文件。不要提交、推送或发布，除非用户明确要求。
+
+其他对话进入上述目录时应读取 AGENTS.md 和本文件；这是磁盘上的共享约定，不代表自动向其他聊天发送消息。
+
+验证：库完整类型检查、包构建、应用 ui:check 与生产构建通过。浏览器验证 RID 563666 返回流量过程，深浅色组件切换正常，数据卡片可显示。构建存在大体积 chunk 提示，后续可继续拆分。
+
+## 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 的自定义胶囊变体。工作台只提供定位，不另写菜单皮肤。
+
+## 一级地图胶囊菜单（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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。

package/llms.txt

@@ -1,9 +1,10 @@
 # sky-ui-kit
 
-> Vue 3 components compatible with Element Plus, project menus, timeline and map tools. Version 0.1.2. AI tools must explicitly load these files.
+> Vue 3 components compatible with Element Plus, project menus, timeline and map tools. Version 0.1.3. AI tools must explicitly load these files.
 
 ## Documentation
 
+- [Consumers](docs/CONSUMERS.md): shared project convention and local integration.
 - [AI guide](docs/AI-GUIDE.md): setup, examples, icon/event bindings and limits.
 - [Component API](docs/COMPONENT-API.md): props, defaults, events, slots and types.
 - [AI module changes](docs/AI-CHANGELOG.md): module updates and integration impact.