sky-ui-kit 0.1.1 → 0.1.3

package/docs/AI-CHANGELOG.md

@@ -0,0 +1,191 @@
+# 团队 AI 模块变更记录
+
+本文件记录源码模块调整与接入影响，不作为 npm 发布完成的依据。团队使用安装包时以包内文档及 package.json 版本为准；使用当前源码时读取仓库中的同名文档。
+
+## 2026-10-13 · 0.1.2 发布准备
+
+- 核对并重新生成组件 API、AI 指南、llms 索引和完整文档，包含项目图标、全局适配、独立常驻示例和导航调整。
+- 修正 README 默认 CSS 作用域描述；版本更新为 0.1.2。发布是否完成以 npm 注册表为准。
+
+## 2026-10-13 · 修正项目图标定位
+
+- 移除 SvgIcon 到 UiIcon 的导航重映射，给项目 SVG 图库添加独立锚点，点击项目菜单直接定位项目图标。
+
+## 2026-10-13 · 四类连续展示
+
+- 数据展示、导航、反馈和其他配置主入口补充独立常驻示例、代码和交互；结构子组件跟随父示例。
+- 菜单只定位，不替换同一展示区，源码同步 AI 文档。
+
+## 2026-10-13 · 补全五项独立示例
+
+- 时间下拉选择、穿梭框、树选择器、上传和提及补充常驻效果、事件反馈及各自代码。
+- 上传只选择本地文件，不发起请求；示例源码同步生成团队 AI 文档。
+
+## 2026-10-13 · 示例连续展示
+
+- 已完成的基础和表单示例全部常驻页面，每项保留独立交互状态及代码入口；菜单只定位，不再替换顶部示例。
+
+## 2026-10-13 · 补全控件独立示例
+
+- 为截图中的时间、选择、单复选、级联、颜色、日期、数字、标签、验证码、评分及折叠动画补充各自效果、状态反馈与复制代码。
+- 每项 Demo 源码同步生成 AI 示例，公开组件 API 不变。
+
+## 2026-10-13 · 合并表单导航分组
+
+- 移除左侧“表单组件”独立分组，将相关入口合并到“基础组件”；原有示例、子组件关系及公开 API 保留。
+
+## 2026-10-13 · 自动补全效果
+
+- 自动补全入口替换为真实 UiAutocomplete 示例，支持站点/流域筛选、建议选择、清空、禁用、输入触发和自定义建议插槽。
+- 源码同步生成可复制代码与 AI 示例；远程查询仍由应用接入。
+
+## 2026-10-13 · 表单交互示例
+
+- UiForm 和 UiFormItem 入口展示完整测站配置表单，提供必填校验、重置、禁用及提交数据反馈。
+- 示例保留控件状态和图标绑定，源码同步代码展示与 AI 指南，真实请求由使用方接入。
+
+## 2026-10-13 · 基础组件使用示例
+
+- 分割线补充方向、标题位置和虚线；链接补充类型、禁用、图标与点击反馈；间距补充换行、垂直排列与间距切换；文本补充类型、尺寸与省略。
+- 四个独立展示页共用真实 Demo 源码生成复制代码和 AI 示例，公开 API 不变。
+
+## 2026-10-13 · 地图业务布局入口
+
+- 布局容器下新增地图业务布局子项；顶栏、侧栏、主体、底栏统一进入完整布局页，避免切换后看不到地图布局示例。
+
+## 2026-10-13 · 地图业务布局说明
+
+- 新增 TemplateLayout 独立布局说明及交互轮廓示例，展示 top、toolbar、right、legend、timeline、content 区域与右栏避让。
+- 记录真实 props、默认值和作用域插槽，明确原组件及业务依赖仍在应用侧；不新增库 API。
+
+## 2026-10-13 · 整体布局优先
+
+- 布局容器先展示四区完整结构，再按顶栏、左侧栏、主体、底栏排列独立示例；补充完整布局复制代码。
+
+## 2026-10-13 · 布局区域轮廓与完整展示
+
+- 布局子组件页面同时展示四个独立区域示例，菜单按锚点定位。
+- 添加外框、区域分隔和主色高亮，修复包装组件下局部演示样式匹配，复制代码同步轮廓样式。
+
+## 2026-10-13 · 布局子组件效果
+
+- 侧栏、顶栏、底栏、主体入口补充真实封装组件效果和各自代码，替代仅有导入与 API 索引的展示。
+- 示例在 UiContainer 内演示宽高和剩余空间，代码同步 AI 指南；公开 API 不变。
+
+## 2026-10-13 · 项目组件独立展示
+
+- 将四个项目选择与时间组件拆成独立 Vue 预览模块，每个模块拥有独立展示卡片、导航锚点、状态和代码入口。
+- 移除合并展示模块，保持原导航地址和组件包 API。
+
+## 2026-10-13 · 项目选择与时间示例代码
+
+- 四个展示模块各自增加查看代码和复制代码，替代页面底部唯一的组合示例入口。
+- 示例包含公开组件导入、单选多选和禁用空状态、分类树数据、时间范围与时间轴状态，以及 change 事件；代码同步到 AI 指南。
+
+## 2026-10-13 · 移除统一组件入口展示
+
+- 删除开发指南中的组件入口与兼容菜单及统一组件入口展示组件，同时移除组件索引页的相关跳转链接。
+- 安装和导入方式继续查看快速开始，组件效果放在对应模块；组件库出口与 API 保留。
+
+## 2026-10-12 · 开发指南 / 快速开始
+
+- 安装和升级命令统一为 `npm install sky-ui-kit@latest`，移除固定 0.1.1 和“等待注册表处理”的过时描述。latest 表示 npm 已发布的最新正式版本，不包含尚未发布的工作区修改。
+- 新增团队可复制的 AI 文档读取提示，涵盖公开组件、API、主题及业务接入规则。
+- 网站与 AI 文档共用 src/quick-start-examples.ts；文档生成会同步安装、入口、首个组件示例和 AI 读取提示。
+- 每次后续模块修改均需更新相关说明、本变更记录及生成文档；仓库 AGENTS.md 保存此约定。
+
+## 2026-10-12 · 预览站 / 左侧导航
+
+- 分区名称为“使用指南 / 团队专用组件 / 项目特色组件”。团队专用组件基于 Element Plus 封装。
+- 一级分类采用手风琴展开，二级为主组件，子组件收在对应主组件下；搜索保留父级上下文。
+- 此调整只影响预览网站，不改变组件包 API。
+
+## 2026-10-12 · 团队专用组件 / 完整目录
+
+- 源码以 Element Plus 2.14.7 为基准，提供 111 个主 / 子组件、4 个服务出口和 3 个指令；保留 10 个项目特色组件。
+- 完整映射见 ELEMENT-PLUS-COVERAGE.md。组件出口与 API 索引覆盖不代表全部独立示例及视觉状态已验证。
+- 新增组件使用方需要 Element Plus 至少 2.14.7；业务请求、路由和权限仍由应用接入。
+# 2026-10-12 按钮、滚动条与图标
+
+## 按钮独立示例
+
+- 读取原 main.ts / App.vue / base.css / VFit token / 地图布局，新增 GLOBAL-ADAPTATION.md；布局页加入全局适配链路、入口/变量桥接/尺寸代码与浮层、resize、窄屏边界，AI 文档同步。
+
+- 布局页扩展为六种结构，新增横向导航、双侧栏及上下分区，保留业务边界并提供共享源码及 AI 示例。
+
+- 布局容器补充实际组件组合：系统查询表格、菜单切换、无菜单页、地图菜单/工具/图例/时间轴/右面板与操作反馈；完整示例代码与 AI 文档共用源码。
+
+- 左侧去掉栅格行 / 栅格列；布局容器补充原系统、无菜单与地图布局对应关系、插槽和业务边界，新增侧栏/右面板交互和共享示例；原业务项目未修改。
+
+- 按用户要求移除按钮页的按钮组效果和对应可复制代码，保留其他按钮示例。
+
+- UiButton 页面新增语义色、描边、圆角、文字/链接、图标、尺寸、禁用和加载示例；保存交互带操作反馈，源码可复制并生成到 AI 文档。
+
+## 滚动条直接使用约定
+
+- 滚动条页面、菜单名称、导入示例改为 ElScrollbar，直接从 element-plus 导入。
+- 删除 UiScrollbar 包装出口；同步生成目录、API、使用清单与 AI 文档。滚动条沿用应用现有样式范围，不新增主题包装层。
+
+## 图标与业务适配
+
+- 补齐自有 SVG 插件安装、Vite 配置、main.ts 注册、TS 声明、页面 prefix 与原项目命名规则适配；共享示例保证页面与 AI 文档一致。
+- 重扫原项目：590 个 Vue / TS / JS 文件、57 种 EP 模板组件、3 种服务、56 个公共 Vue 组件；新增 COMPONENT-USAGE.md / component-usage.json 与 ADAPTATION.md。
+- 原项目接入页新增实际清单、使用位置和适配边界；同步 npm 文档文件及 llms 索引。静态扫描不等于业务运行验收。
+
+- 新增 SvgIcon、projectIcons、ProjectIconName、registerProjectIcons；导入 274 个业务 SVG，子目录名称加前缀，隔离 sprite 和内部 ID。
+- 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 样式不匹配。统一按钮及内容层级类，保留现有单选、多选及事件逻辑。