@TechUI/Base 简介
TechUI Base (基础组件库) 是 TechUI 生态系统的底层基石，也是构建现代化 Web 应用的原子级 UI 库。
如果说 Admin 是骨架，Scifi 是皮肤，那么 Base 就是细胞。它是一个基于 Vue 3 开发的基础组件集合，旨在满足 TechUI 框架中对表单处理、数据展示及基础交互的核心需求。目前，它支撑着整个 TechUI 上层建筑的运行。
一句话总结：TechUI 万丈高楼的地基，提供最纯粹的原子组件。
免费组件库
为了降低开发者的准入门槛并回馈社区，当您独立使用 @techui/base 时，它完全支持免费商用。
- ✅ 核心基础：它是 Admin 和 Prime 的共同依赖，拥有相同的基因。
- ✅ 无强制密钥：无需购买 License Key 即可直接使用。
- ✅ 闭源但开放：提供标准化的 API 接口，服务于整个生态。
💡 唯一的约束
在使用免费版 Base 时，请保留控制台（Console）和Html末的版权输出信息。
革命性适配
在 Base 组件库中，我们内置了引以为傲的 TuiAdaptive 组件——这是目前市面上最强大的自适应/适配解决方案。
它采用等比缩放方案，彻底解决了大屏与管理后台在不同分辨率下的适配难题。
- 多种适配模式：完美适应全屏、宽屏、带缩放浏览器等多种场景。
- GIS/地图专属优化：
- 解决了传统 transform 缩放导致 Cesium/Leaflet 等地图组件点击坐标偏移的行业痛点。
- 独创 “同步穿透容器” 技术，确保在缩放状态下，地图交互依然精准无误。
- 拖拽模式：支持通过浏览器缩放功能激活拖拽调试，还原设计稿不再痛苦。
开发状态说明
不同于 Admin 的“安装即用”，Base 目前处于 ⚠️积极开发与快速迭代 阶段。我们崇尚透明，因此需要告知您：
- 🚧 迭代中：尚未涵盖所有极端使用场景，部分功能仍在打磨。
- ⚡ 定位差异：现阶段它旨在满足 TechUI 内部需求，不能完全替代 Element Plus 等成熟通用的开源 UI 库。
- 🔄 API 变动：在正式版发布前，API 和组件接口可能会发生变化。
完备的生态依赖
Base 并非孤立存在，它聚合了 TechUI 生态底层的通用能力，为您屏蔽了底层的复杂性：
- @techui/fonts：统一的字体库，确保字体的一致性，引入了开源免费中文字体，内置了字体库的选取和预览功能。
- @techui/icons：由TechUI设计、收集整理的图标库，内置了图标预览选取功能。
- @techui/colors：统一的色彩系统，确保视觉一致性，内置了颜色表预览和选取功能。
- @techui/themes：灵活的主题系统，支持深色/浅色模式切换。
- @techui/locales：内置国际化支持，处理多语言环境。
- @techui/utils：集成了大量高频使用的工具函数。
- @techui/libs：集成了大量第三方库封装（防止破坏性更新导致的TechUI组件库异常）。
- @techui/lessmixins：提供了一套强大的 LESS 混入库，提升样式开发效率。
适用场景
@techui/base 剥离了业务逻辑与科幻特效，回归了最朴素的交互本质，适合：
- 构建自定义组件库：以 Base 为基础，封装属于您公司内部的 UI 库。
- 轻量级应用开发：不需要复杂后台模板，只需基础 UI 元素的场景。
- 学习与研究：研究 TechUI 如何处理响应式布局与基础交互。
关联关系
Base 是整个 TechUI 金字塔的最底层，向上支撑着所有高级库：
- Base (本库)：
npm i @techui/base-> 提供基础原子组件 + TuiAdaptive -> 免费商用。 - Admin：依赖 Base -> 提供完整的后台管理系统骨架 -> 免费商用。
- Prime：依赖 Base -> 提供科幻视觉与 3D 引擎 -> 需付费授权。
许可证
TechUI许可证类别分为：
- 重许可轻许可：双向联合解密，客户端密钥+Npm钥匙串。
- 轻许可：单一密钥串，客户端密钥。
Base 组件库采用轻许可，单向验证机制。其核心 Wasm 模块直接对传入的许可证字符串进行解密与校验，确保系统的轻量化部署。
- 便捷性：无需引入额外的密钥包，配置简单。
- 兼容性：支持免费模式，未检测到有效许可时自动切换至免费版状态。
🚀 开始探索
如果您需要一个对 GIS 地图组件极其友好，且具备强大自适应能力的 Vue3 基础库，@techui/base 值得您一试。