sky-ui-kit 0.1.3 → 0.1.5

package/docs/AI-CHANGELOG.md

@@ -177,15 +177,47 @@
 ## 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 注册表为准。
+
+
+2026-10-14 / dev.20：一体机雨量站按参考平台 /atlas/elments/rain 原源码迁移，保留 RainfallRankingTable、RainfallProcessChart、MapValueLegend 的 DOM、CSS、分级与交互，主题变量仅映射到既有 userssite 命名。公开 RainfallRankingTable、RainfallProcessChart、MapValueLegend、AtlasRankingPanel、AtlasProcessPanel、AtlasProcessChart、StationComparisonPanel、MapOperationPanel、SpaceAnalysisPanel；MapTools 新增 before/after/panel 插槽。TemplateLayout 增加 variant=atlas，采用原页面右栏贴右、工具栏右栏左侧、右下图例与底部过程面板的避让几何，workbench 默认行为保留。图表通过 provide('sky-chart-engine', engine) 注入，无业务请求或地图实例进入组件库。MapOperationPanel 接受 tools 和 drawTools；SpaceAnalysisPanel 接受 selectionStore 与 provider，绘制、GIS、空间分析业务由消费方注入。消费项目新雨量页通过平台地图单例绘制非聚合圆点，多数据源各自独立图层，原七级雨量颜色和缩放半径；复用原时间范围、数据源差量请求与批量过程接口。未构建、未打包、未浏览器验证、未发布 npm。需用户发布含新出口版本后更新消费包；当前项目保留旧包兼容显示，避免缺少新出口导致白屏。
 
-## 一级地图胶囊菜单（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）
+2026-10-14：TemplateLayout 新增 contentTop（布局相对地图容器的顶部避让）和 edge（右栏与工具栏共用边距）。工具栏默认顶部跟随右栏，移除186独立偏移；toolbar插槽内MapTools/map-toolbar取消再次绝对定位，避免偏移叠加。当前仅源码修改，发布时必须重新构建产物，再升级版本发布；消费项目仍安装0.1.4，尚未获得此修复。
 
-flat 模式按钮此前错误使用 child 类而内部图标、文字使用 parent 类，导致 active 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+0.1.5 / 2026-10-14：右侧插槽容器采用flex并限制内部溢出，AtlasRankingPanel铺满容器；图例默认底部与右侧面板共用 --template-right-bottom，过程图展开时才额外避让。contentTop/edge控制顶部工作区和共同间距，toolbar插槽的工具栏取消重复绝对定位。修复雨量分级与虚拟行局部CSS变量命名、过程图tooltip参数类型。移除误加的本地消费项目file依赖，库不能依赖使用它的业务项目。打包和类型检查通过；地图页面已检查工具栏/右面板顶部76px、面板/图例底部874px对齐。

package/docs/AI-GUIDE.md

@@ -2,6 +2,8 @@
 
 适用于 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 事件处理。
@@ -185,21 +187,21 @@ defineProps(["engine", "rows"])
 
 一体机左侧改用已有 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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
-
+
+## 一级地图胶囊菜单（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 -->
 
 ### 快速开始：安装最新正式版本
@@ -943,34 +945,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>
 
 ```
 

package/docs/COMPONENT-API.md

@@ -249,7 +249,7 @@ export interface MapMenuItem { key: string; label: string; icon?: Component }
 - `tool-click` — `[key: string]`
 - `context-change` — `[enabled: boolean]`
 
-Slots: No declared content slots.
+Slots: before, after, panel
 
 ```ts
 export interface MapToolItem { key: string; label: string; icon?: Component }
@@ -358,8 +358,9 @@ Slots: icon
 |---|---|---|---|
 | rows | ProcessChartRow[] | true | undefined / no declared default |
 | engine | ProcessChartEngine | true | undefined / no declared default |
-| kind | 'rain' | 'flow' | false | 'rain' |
+| kind | 'rain' | 'flow' | 'line' | false | 'rain' |
 | unit | string | false | '' |
+| label | string | false | undefined / no declared default |
 
 ### Events
 
@@ -400,6 +401,282 @@ Slots: No declared content slots.
 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 | '' |
+| toolbarTop | string | false | '' |
+| contentTop | string | false | '' |
+| edge | string | false | '' |
+| variant | 'workbench' | 'atlas' | false | 'workbench' |
+
+### Events
+
+No declared events.
+
+Slots: top, toolbar, right, legend, timeline, content, default
+
+## RainfallRankingTable
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| rows | RainfallRankingRow[] | false | () => [] |
+| period | string | false | '24h' |
+| unit | string | false | 'mm' |
+| dataSource | string[] | false | () => [] |
+| dataSourceOptions | DataSourceOption[] | false | () => [] |
+| dataSourceLoading | boolean | false | false |
+| rainfallLevels | RainfallLevelOption[] | false | () => [
+    { key: 'extremeStorm', label: '≥250', min: 250, color: 'rgba(129, 0, 64, 1)', textColor: '#ffffff' },
+    { key: 'hardStorm', label: '100~250', min: 100, color: 'rgba(244, 5, 237, 1)', textColor: '#ffffff' },
+    { key: 'storm', label: '50~100', min: 50, color: 'rgba(2, 1, 252, 1)', textColor: '#ffffff' },
+    { key: 'heavy', label: '25~50', min: 25, color: 'rgba(100, 184, 245, 1)', textColor: '#ffffff' },
+    { key: 'moderate', label: '10~25', min: 10, color: 'rgba(61, 185, 63, 1)', textColor: '#ffffff' },
+    { key: 'light', label: '0.5~10', min: 0.5, color: 'rgba(164, 243, 143, 1)', textColor: '#1f2937' },
+    { key: 'none', label: '0~0.5', min: 0, color: '#ffffff', textColor: '#334155' }
+  ] |
+| visibleLevelKeys | RainfallLevelKey[] | false | () => ['none', 'light', 'moderate', 'heavy', 'storm', 'hardStorm', 'extremeStorm'] |
+| loading | boolean | false | false |
+
+### Events
+
+- `close` — `[]`
+- `locate` — `[row: RainfallRankingRow]`
+- `rangeChange` — `[payload: { label: string, range: DateRangeValue }]`
+- `sourceChange` — `[value: string[], payload: DataSourceChangePayload]`
+- `levelVisibilityChange` — `[key: RainfallLevelKey, visible: boolean]`
+
+Slots: No declared content slots.
+
+```ts
+type SortDirection = 'asc' | 'desc'
+export type RainfallLevelKey = 'none' | 'light' | 'moderate' | 'heavy' | 'storm' | 'hardStorm' | 'extremeStorm'
+type RangeShortcutKey = 'current' | '1h' | '24h' | '3d' | '7d' | '1m'
+type DateRangeValue = [string, string]
+type RangeShortcut = {
+  key: RangeShortcutKey
+  label: string
+  amount: number
+  unit: 'current' | 'hour' | 'day' | 'month',
+  type: '1' | '2' // 1是显示日期 2是显示文字
+}
+export type DataSourceOption = {
+  label: string
+  value: string
+}
+export type DataSourceChangePayload = {
+  selectedSources: string[]
+  addedSources: string[]
+  removedSources: string[]
+}
+export type RainfallLevelOption = {
+  key: RainfallLevelKey
+  label: string
+  min: number
+  color: string
+  textColor: string
+}
+export type RainfallRankingRow = {
+  id?: string | number
+  stationName: string
+  rainfall: number
+  region?: string
+  longitude?: number
+  latitude?: number
+  elevation?: number | null
+  dataSource?: string
+  dataSourceName?: string
+  sourceCode?: string | number
+}
+```
+
+## RainfallProcessChart
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| stations | RainfallRankingRow[] | false | () => [] |
+| selectedStations | RainfallRankingRow[] | false | () => [] |
+| rowsByStation | Record<string, RainHourlyPrecipitation[]> | false | () => ({}) |
+| range | [string, string] | true | undefined / no declared default |
+| loading | boolean | false | false |
+
+### Events
+
+- `close` — `[]`
+- `query` — `[payload: { stationIds: StationId[], range: [string, string], quickKey?: QuickRangeKey }]`
+
+Slots: No declared content slots.
+
+```ts
+type EChartsOption = Record<string, any>
+type RainHourlyPrecipitation = { dt: string; drp?: number | null; [key: string]: number | string | null | undefined }
+type StationId = string
+type ProcessSeries = {
+  station: RainfallRankingRow
+  rainfallName: string
+  totalName: string
+  rainfallData: Array<number | null>
+  totalData: number[]
+  latestTotal: number
+}
+type QuickRangeKey = 'current' | '24h' | '7d' | '1m' | '3m'
+```
+
+## MapValueLegend
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| title | string | true | undefined / no declared default |
+| layerName | string | false | '' |
+| unit | string | false | '' |
+| variant | MapValueLegendVariant | false | 'list' |
+| items | MapValueLegendItem[] | false | () => [] |
+| gradientStops | MapValueLegendGradientStop[] | false | () => [] |
+| tickLabels | string[] | false | () => [] |
+| allVisible | boolean | false | true |
+| toggleable | boolean | false | true |
+
+### Events
+
+- `toggle` — `[key: string, visible: boolean, layerName: string]`
+- `toggleAll` — `[visible: boolean, layerName: string]`
+
+Slots: No declared content slots.
+
+```ts
+type MapValueLegendVariant = 'list' | 'gradient'
+export type MapValueLegendItem = {
+  key: string
+  label: string
+  color: string
+  count?: number
+  visible?: boolean
+  empty?: boolean
+}
+export type MapValueLegendGradientStop = {
+  offset: number
+  color: string
+}
+```
+
+## AtlasRankingPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+
+### Events
+
+No declared events.
+
+Slots: default
+
+## AtlasProcessPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+
+### Events
+
+No declared events.
+
+Slots: default
+
+## AtlasProcessChart
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| option | EChartsOption &#124; null | false | null |
+| loading | boolean | false | false |
+| empty | boolean | false | false |
+| loadingText | string | false | '加载中...' |
+| emptyText | string | false | '暂无过程线数据' |
+
+### Events
+
+No declared events.
+
+Slots: No declared content slots.
+
+```ts
+type EChartsOption = Record<string, any>
+```
+
+## StationComparisonPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| rows | { id: string; label: string }[] | true | undefined / no declared default |
+| selected | string[] | true | undefined / no declared default |
+
+### Events
+
+- `update:selected` — `[ids: string[]]`
+- `compare` — `[]`
+- `locate` — `[id: string]`
+- `close` — `[]`
+
+Slots: No declared content slots.
+
+## MapOperationPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| tools | any | true | undefined / no declared default |
+| drawTools | { mode: string; label: string; iconPath: string }[] | true | undefined / no declared default |
+
+### Events
+
+No declared events.
+
+Slots: No declared content slots.
+
+```ts
+type MapDrawMode = string
+type MapMeasureMode = string
+type MapOperationSnapshot = any
+```
+
+## SpaceAnalysisPanel
+
+### Props
+
+| Name | Type | Required | Default expression |
+|---|---|---|---|
+| selectionStore | any | true | undefined / no declared default |
+| provider | any | true | undefined / no declared default |
+
+### Events
+
+No declared events.
+
+Slots: No declared content slots.
+
+```ts
+type GisSelectionRecord = any
+type SpaceAnalysisAction = any
+```
+
 ## 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.

package/docs/CONSUMERS.md

@@ -1,59 +1,93 @@
-# 一体机组件库接入约定
-
-用户要求：一体机 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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。
+# 一体机组件库接入约定
+
+用户要求：一体机 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。
+
+
+2026-10-14 / dev.20：一体机雨量站按参考平台 /atlas/elments/rain 原源码迁移，保留 RainfallRankingTable、RainfallProcessChart、MapValueLegend 的 DOM、CSS、分级与交互，主题变量仅映射到既有 userssite 命名。公开 RainfallRankingTable、RainfallProcessChart、MapValueLegend、AtlasRankingPanel、AtlasProcessPanel、AtlasProcessChart、StationComparisonPanel、MapOperationPanel、SpaceAnalysisPanel；MapTools 新增 before/after/panel 插槽。TemplateLayout 增加 variant=atlas，采用原页面右栏贴右、工具栏右栏左侧、右下图例与底部过程面板的避让几何，workbench 默认行为保留。图表通过 provide('sky-chart-engine', engine) 注入，无业务请求或地图实例进入组件库。MapOperationPanel 接受 tools 和 drawTools；SpaceAnalysisPanel 接受 selectionStore 与 provider，绘制、GIS、空间分析业务由消费方注入。消费项目新雨量页通过平台地图单例绘制非聚合圆点，多数据源各自独立图层，原七级雨量颜色和缩放半径；复用原时间范围、数据源差量请求与批量过程接口。未构建、未打包、未浏览器验证、未发布 npm。需用户发布含新出口版本后更新消费包；当前项目保留旧包兼容显示，避免缺少新出口导致白屏。
+
+2026-10-14：TemplateLayout 新增 contentTop（布局相对地图容器的顶部避让）和 edge（右栏与工具栏共用边距）。工具栏默认顶部跟随右栏，移除186独立偏移；toolbar插槽内MapTools/map-toolbar取消再次绝对定位，避免偏移叠加。当前仅源码修改，发布时必须重新构建产物，再升级版本发布；消费项目仍安装0.1.4，尚未获得此修复。
+
+0.1.5 / 2026-10-14：右侧插槽容器采用flex并限制内部溢出，AtlasRankingPanel铺满容器；图例默认底部与右侧面板共用 --template-right-bottom，过程图展开时才额外避让。contentTop/edge控制顶部工作区和共同间距，toolbar插槽的工具栏取消重复绝对定位。修复雨量分级与虚拟行局部CSS变量命名、过程图tooltip参数类型。移除误加的本地消费项目file依赖，库不能依赖使用它的业务项目。打包和类型检查通过；地图页面已检查工具栏/右面板顶部76px、面板/图例底部874px对齐。