Skip to content

TechUI-Toolkit

历史版本,已废弃

TechUI-Toolkit (TUI-TK) 是 TechUI 发展历程中一个承上启下的关键版本。

它诞生于 2023 年下半年,定位为一款 “去风格化” 的基础工具库。当时的开发初衷是为了满足那些不需要科幻 SVG 装饰,但又急需 TechUI 强大的自适应能力的移动端或基础项目。

它是如今 @techui/base 组件库的直接前身。

定位:实用主义至上

不同于 TechUI-Vue2 的“大而全”和 TechUI-Lite 的“展示为主”,Toolkit 专注于解决具体的技术痛点:

  1. 移动端优先:设计之初就考虑了手机端的交互体验(如陀螺仪控制)。
  2. 样式解耦:允许开发者在不引入沉重 SVG 资源的情况下,仅使用 TechUI 的核心逻辑(如自适应、3D 模拟)开发普通项目。
  3. 开发提效:旨在让开发者“无需编写繁琐的响应式 CSS 代码”,即可实现多端适配。

核心特性

尽管是一个过渡版本,Toolkit 贡献了几个至今仍在使用的核心组件原型:

全能自适应 (AdaptivePanel)

这是 Toolkit 的核心资产。它内置了一个完整版的自适应组件,能够处理跨度极大的分辨率,无论是移动端、PC 端还是企业拼接屏,都能完美适配。

  • 注:这演变成了后来 @techui/base 中的 TuiAdaptive

泛 3D 化能力 (The 3D Wrapper)

Toolkit 探索了一种“万物皆可 3D”的轻量化方案,可以把任何普通的 DOM 组件模拟出 3D 变形效果:

  • Panel3D (PC端):通过光标位置计算透视,实现 3D 交互。
  • PanelGyro (移动端):利用手机陀螺仪传感器,实现跟随设备倾斜的 3D 视差效果。

WASM 许可证雏形

Toolkit 改造了 TechUI-Vue2 复杂的 WASM 模块,开发了一个简化版的前端许可证验证机制

  • 机制:如果许可证过期或缺失,系统仍可运行,但会生成一个有效期仅 10 分钟的临时 Key,过期后组件功能受限。
  • 意义:这一简化逻辑经过验证后,演变成了目前 TechUI 3.0 中通用的“简单许可”功能。

独特的“免费”模式

TechUI-Toolkit 在当时采用了一种有趣的 "Star 换授权" 模式:

  • 闭源但免费:大部分组件免费商用,但核心的 TUI-TK 模块需要授权。
  • 免费获取:开发者只需要在 GitHub 上为指定项目(如 techui-vue2, ayin-color 等)点亮 Star,并将截图发送给作者,即可获得为期 1 年甚至永久的免费商业许可证。
  • 初衷:作者明确表示“本工具库不以营利为目的”,仅用于验证简单版许可证的技术实现。

蜕变与现状

TechUI-Toolkit 现已停止独立维护。

它的命运并非终结,而是升华。 随着功能的不断拓展,Toolkit 逐渐吸纳了更多的基础 UI 组件(如按钮、输入框等),最终演变成了现在的 @techui/base 组件库。

  • AdaptivePanel -> 升级为 TuiAdaptive
  • Panel3D -> 升级为 Tui3DPanel
  • 核心逻辑 -> 融入 @techui/utils

历史意义

TechUI-Toolkit 证明了 TechUI 的核心价值不仅仅在于“科幻的皮肤”,更在于“好用的底层”。它为后来的分层架构(Base + Scifi)提供了实践依据。