sky-ui-kit 0.1.2 → 0.1.4

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.4. 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.
@@ -26,6 +27,8 @@ Import element-plus/dist/index.css then sky-ui-kit/style.css once in main.ts. Im
 
 适用于 Vue 3 + TypeScript。此文件描述包的真实 API 和约束，不是自动执行的代理指令。AI 工具需要主动读取这些文档；安装包不会自动改变其上下文。
 
+管理布局：WorkbenchShell 使用 collapsed=false 和 management-layout 类，顶部 app-header、management-sidebar 和 workspace 组成后台布局。management-metrics / management-card 为共享信息展示样式；由消费方提供账号、菜单及数据，组件库不提供认证。新增样式在 0.1.3-dev.12 测试包中，尚未发布 npm。
+
 预览站已移除“统一组件入口 / 组件入口与兼容”菜单与展示示例。安装和导入方式查看快速开始，组件效果查看各组件页面；此调整不改变组件包出口或 API。
 
 项目选择与时间展示为 AppSelect、TreeSelectPanel、TimeRangeQuickSelect、MapTimeline 分别提供查看代码与复制入口；各自代码从 src/examples.ts 同步生成，使用 sky-ui-kit 公开封装组件，包含状态与 change 事件处理。
@@ -149,6 +152,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 -->
 
 ### 快速开始：安装最新正式版本
@@ -892,34 +970,20 @@ const items = [{ key: 'overview', label: '运行概览' }, { key: 'data', label:
 ```vue
 <script setup lang="ts">
 import { ref } from 'vue'
-import { UiButton } from 'sky-ui-kit'
+import { TemplateLayout, UiButton, MapTools, WorkbenchPanel } from 'sky-ui-kit'
 const rightOpen = ref(true)
-const timelineVisible = ref(true)
 </script>
 <template>
-  <div class="template-demo" :class="{ 'right-open': rightOpen }">
-    <div class="map-placeholder">地图宿主（由 MainLayoutMap 提供）</div>
-    <div class="top-region">top · 标题 / 查询条件</div>
-    <div class="toolbar-region"><span>toolbar · 地图工具</span><UiButton size="small" @click="rightOpen = !rightOpen">{{ rightOpen ? '收起右栏' : '展开右栏' }}</UiButton><UiButton size="small" @click="timelineVisible = !timelineVisible">切换时间轴</UiButton></div>
-    <aside v-if="rightOpen" class="right-region">right · 业务面板<br>测站详情 / 过程数据</aside>
-    <div class="content-region">content · 业务浮层</div>
-    <div class="legend-region" :class="{ 'above-timeline': timelineVisible }">legend · 图例</div>
-    <div v-if="timelineVisible" class="timeline-region">timeline · 实况 / 预报时间轴</div>
+  <div style="position: relative; height: 460px">
+    <TemplateLayout :right-open="rightOpen">
+      <template #top><UiButton @click="rightOpen = !rightOpen">{{ rightOpen ? '收起右栏' : '展开右栏' }}</UiButton></template>
+      <template #toolbar><MapTools :items="[{ key: 'layers', label: '图层' }]" /></template>
+      <template #right><WorkbenchPanel style="height: 100%">right · 业务面板</WorkbenchPanel></template>
+      <template #legend>legend · 图例</template>
+      <template #timeline>timeline · 时间轴</template>
+    </TemplateLayout>
   </div>
 </template>
-<style scoped>
-.template-demo { position: relative; height: 360px; overflow: hidden; border: 2px solid var(--color-border, #c5d2e5); border-radius: 8px; --demo-panel-width: min(220px, 30%); --demo-right-offset: 12px; }
-.right-open { --demo-right-offset: calc(var(--demo-panel-width) + 24px); }
-.map-placeholder { position: absolute; inset: 0; display: grid; place-items: center; color: var(--color-muted, #748096); background-color: var(--color-surface, #f4f7fb); background-image: linear-gradient(var(--color-border, #dbe3ef) 1px, transparent 1px), linear-gradient(90deg, var(--color-border, #dbe3ef) 1px, transparent 1px); background-size: 32px 32px; }
-.top-region, .toolbar-region, .right-region, .content-region, .legend-region, .timeline-region { position: absolute; padding: 12px; box-sizing: border-box; border: 1px solid var(--color-primary, #1677ff); border-radius: 6px; background: var(--color-panel, white); color: var(--color-text, #1f2937); }
-.top-region { top: 12px; left: 12px; }
-.toolbar-region { top: 64px; right: var(--demo-right-offset); display: flex; gap: 8px; align-items: center; flex-wrap: wrap; max-width: 65%; }
-.right-region { top: 12px; right: 12px; bottom: 12px; width: var(--demo-panel-width); }
-.content-region { top: 124px; left: 12px; }
-.legend-region { bottom: 12px; right: var(--demo-right-offset); }
-.legend-region.above-timeline { bottom: 76px; }
-.timeline-region { bottom: 12px; left: 12px; right: var(--demo-right-offset); text-align: center; }
-</style>
 
 ```
 
@@ -2872,6 +2936,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 +3102,84 @@ 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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+# 管理布局（2026-10-13）
+
+WorkbenchShell 添加 management-layout 样式变体：顶部栏、侧栏、滚动内容区、管理指标和信息卡片；management.css 提供共享样式。业务账号登录与数据由消费方提供，一体机当前使用明确标注的演示登录和模拟信息。
+
+
+## 独立演示登录页（0.1.3-dev.13）
+
+账号入口：当前会话已演示登录则直接进入管理平台；未登录显示独立登录页，移除原弹窗。模拟账号通过 sessionStorage 保存，退出时清除，不是真实认证。登录页共享样式由库 management.css 提供，当前本地 dev.13 测试包；登录、刷新后直达管理平台及构建已验证。
+
+0.1.3-dev.14：添加 business-embed 业务 iframe 共享布局，用于一体机水库调度接入。
+
+0.1.3-dev.15：工作台没有 status-bar 时取消地图底部 30px 预留，避免空白边。保留带状态栏消费方的布局。
+
+2026-10-14：新增工作台 map-top-navigation 浮动顶部导航、forecast-form 预报表单与 forecast-product-switch 产品选择布局。四个顶部菜单由消费方提供；地图交互仍通过未覆盖区域。窄屏导航换行，右侧面板避让。无业务接口进入组件库。
+
+0.1.3-dev.17：预报表单补充两列色带与评价图例布局；forecast-workspace 的过程面板取消左侧菜单预留。消费方负责真实色阶、指标分类和过程查询。
+
+0.1.3-dev.18：ProcessChart 增加 kind=line 与 label 可选属性，用于温度、风速等通用过程线与可访问名称；保留 rain/flow 现有行为，不将所有非降雨要素称为流量。
+
+
+2026-10-14 / dev.19：公开 TemplateLayout 地图叠加布局。提供 top、toolbar、right、legend、timeline、content 与默认插槽；rightOpen 为受控右栏状态，rightPanelEnabled 默认 true，rightPanelWidth 可覆盖响应式宽度。工具栏、图例、时间轴随右栏自动避让；空白区域透传地图事件。布局不初始化地图、不依赖业务 store，不内置业务工具；消费方将 MapTools 和 MapLayerControl 放到 toolbar，将业务面板放到 right。
+
+## 2026-10-14 · 0.1.4 发布准备
+
+汇集当前工作区地图布局 TemplateLayout、工作台与管理样式、图层控制、过程图 line/label 以及菜单修订。重新生成 API 与 AI 文档，发布状态以 npm 注册表为准。
 
 # Component API reference
 
@@ -3214,8 +3384,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 +3404,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 +3424,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 +3434,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 +3486,120 @@ 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' &#124; 'line' | false | 'rain' |
+| unit | string | false | '' |
+| label | string | false | undefined / no declared default |
+
+### 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[] }
+```
+
+## TemplateLayout
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| rightOpen | boolean | false | false |
+| rightPanelEnabled | boolean | false | true |
+| rightPanelWidth | string | false | '' |
+
+### Events
+
+No declared events.
+
+Slots: top, toolbar, right, legend, timeline, content, default
+
 ## 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 +4317,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 个指令出口。另保留 17 个项目特色组件。
 
 清单覆盖官方组件注册表及服务 / 指令，不包含内部工具函数。出口覆盖不代表所有组件的交互、独立示例和视觉状态均已验证。网站每项均提供导入和官方 API 索引，新增组合示例见 AI-GUIDE.md。
 
@@ -4503,4 +4797,155 @@ 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 引入一次。
+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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+# 管理平台布局
+
+management.css 由 WorkbenchShell 引入，management-layout 提供管理平台顶部栏、侧栏与可滚动内容区；management-metrics、management-card、account-entry 为相关共享样式。遵循工作台现有主题变量，登录表单使用 UiDialog / UiForm。业务认证与数据不在库中。
+
+独立登录页共享样式：management-login-page、login-layout、login-card 在 management.css 内维护，桌面双列、窄屏单卡。
+
+business-embed：management.css 提供工作台业务 iframe 布局，保留顶部与左侧导航操作区域。
+
+0.1.3-dev.15：工作台没有 status-bar 时取消地图底部 30px 预留，避免空白边。保留带状态栏消费方的布局。
+
+2026-10-14：新增工作台 map-top-navigation 浮动顶部导航、forecast-form 预报表单与 forecast-product-switch 产品选择布局。四个顶部菜单由消费方提供；地图交互仍通过未覆盖区域。窄屏导航换行，右侧面板避让。无业务接口进入组件库。
+
+0.1.3-dev.17：预报表单补充两列色带与评价图例布局；forecast-workspace 的过程面板取消左侧菜单预留。消费方负责真实色阶、指标分类和过程查询。
+
+
+2026-10-14 / dev.19：公开 TemplateLayout 地图叠加布局。提供 top、toolbar、right、legend、timeline、content 与默认插槽；rightOpen 为受控右栏状态，rightPanelEnabled 默认 true，rightPanelWidth 可覆盖响应式宽度。工具栏、图例、时间轴随右栏自动避让；空白区域透传地图事件。布局不初始化地图、不依赖业务 store，不内置业务工具；消费方将 MapTools 和 MapLayerControl 放到 toolbar，将业务面板放到 right。
+
+# 一体机组件库接入约定
+
+用户要求：一体机 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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+
+## 一体机正式包接入（2026-10-13）
+
+D:/dev/TasksBot 已从本地 tgz 切换为 npm sky-ui-kit@0.1.3。安装包多选的选中、取消、清空和外部 activeKeys 同步已浏览器验证。五个主菜单继续作为单选业务导航；多选消费者使用 change/activeKeys 获取最终集合，select 在取消时也会触发。具体交接见消费项目 docs/UI-KIT-INTEGRATION.md。
+# 一体机管理布局演示（2026-10-13）
+
+四个地图主菜单保留；数据接入移至右上角账号演示登录后的管理平台。管理信息为固定假数据，无真实认证和后台修改。WorkbenchShell 的 management-layout 及 management.css 由共享库维护；演示业务留在消费项目。
+
+
+## 独立演示登录页（0.1.3-dev.13）
+
+账号入口：当前会话已演示登录则直接进入管理平台；未登录显示独立登录页，移除原弹窗。模拟账号通过 sessionStorage 保存，退出时清除，不是真实认证。登录页共享样式由库 management.css 提供，当前本地 dev.13 测试包；登录、刷新后直达管理平台及构建已验证。
+
+## 平台业务菜单接入（2026-10-13）
+
+删除实时雨水情独立入口，综合一张图保留雨量站/水库/河道/视频及历史查询。气象预报入口更名中尺度数值预报，沿用已接入的 WRF 小时产品。水库调度沿用参考平台 ReservoirDispatch.vue 的外部 dashboard iframe，不执行调度写操作。气象大模型接入 GraphCast 六要素、发布批次、时次 WMS 与点位过程接口，参考 weatherLlm/api/weatherLlm.ts、weatherLlmConfig.ts；不虚构新批次。图层依赖 geoserver 65255 服务，生产需同样配置 /graphcast-wms 反向代理。业务 iframe 共享布局样式在 management.css。当前共享库为 dev.14 本地测试包，未发布 npm。
+
+0.1.3-dev.15：工作台没有 status-bar 时取消地图底部 30px 预留，避免空白边。保留带状态栏消费方的布局。
+
+2026-10-14：新增工作台 map-top-navigation 浮动顶部导航、forecast-form 预报表单与 forecast-product-switch 产品选择布局。四个顶部菜单由消费方提供；地图交互仍通过未覆盖区域。窄屏导航换行，右侧面板避让。无业务接口进入组件库。
+
+0.1.3-dev.17：预报表单补充两列色带与评价图例布局；forecast-workspace 的过程面板取消左侧菜单预留。消费方负责真实色阶、指标分类和过程查询。
+
+0.1.3-dev.18：ProcessChart 增加 kind=line 与 label 可选属性，用于温度、风速等通用过程线与可访问名称；保留 rain/flow 现有行为，不将所有非降雨要素称为流量。
+
+
+2026-10-14 / dev.19：公开 TemplateLayout 地图叠加布局。提供 top、toolbar、right、legend、timeline、content 与默认插槽；rightOpen 为受控右栏状态，rightPanelEnabled 默认 true，rightPanelWidth 可覆盖响应式宽度。工具栏、图例、时间轴随右栏自动避让；空白区域透传地图事件。布局不初始化地图、不依赖业务 store，不内置业务工具；消费方将 MapTools 和 MapLayerControl 放到 toolbar，将业务面板放到 right。

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.4. 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sky-ui-kit",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Vue UI components compatible with Element Plus and the project theme",
   "type": "module",
   "files": [
@@ -22,7 +22,8 @@
     "components.json",
     "docs/AI-GUIDE.md",
     "docs/AI-CHANGELOG.md",
-    "docs/COMPONENT-API.md"
+    "docs/COMPONENT-API.md",
+    "docs/CONSUMERS.md"
   ],
   "exports": {
     ".": {
@@ -54,10 +55,10 @@
     "components:sync": "node scripts/sync-element-plus.mjs"
   },
   "peerDependencies": {
-    "element-plus": "^2.14.7",
-    "vue": "^3.4.21",
     "@element-plus/icons-vue": "^2.3.2",
-    "motion-v": "^2.3.0"
+    "element-plus": "^2.14.7",
+    "motion-v": "^2.3.0",
+    "vue": "^3.4.21"
   },
   "devDependencies": {
     "@element-plus/icons-vue": "^2.3.2",
@@ -76,5 +77,8 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "license": "UNLICENSED"
+  "license": "UNLICENSED",
+  "dependencies": {
+    "reservoir-hydromet-terminal": "file:../Work/01-项目code/一体化平台/一体机项目"
+  }
 }