TechUI Docs

简中

EN

简中

EN

主题

信息反馈 ​

虽然 TechUI Core (Wasm) 大部分时间在后台静默运行，但它提供了一套完整的信息反馈机制，用于向开发者展示授权状态、运行健康度以及必要的阻断告警。

这些状态信息主要分布在 DOM 结构、浏览器标题、控制台 (Console) 以及 交互式 API 中。

DOM 隐式签名 ​

为了确立正版身份且不干扰页面视觉，Wasm 模块会在 <body> 或 <html> 标签的末尾注入一段 HTML 注释。

  • 位置：DevTools -> Elements 面板底部。
  • 内容：包含当前加载的组件库版本、授权主体、有效期及联系方式。
  • 作用：这是一个“静默水印”。即使页面 UI 被遮挡，通过查看源代码也能确认授权归属。
html
<!--
TechUI Base v0.1
本许可证由 [您的公司名] 授权给 [客户的公司名]
有效期至 永久 公司许可证
联系方式
-->

<!--
TechUI Base v0.1
目前为免费版
https://techui.net https://techui.cn
-->

浏览器标题交互 ​

Wasm 守卫拥有对 document.title 的临时接管权，用于增强品牌露出或进行安全校验。

  • 项目绑定 (Project Binding)：

    • 若许可证开启了 projectBind: true，守卫会锁定浏览器标题。一旦检测到标题不包含指定的项目名称，将触发警告或熔断。
    • 项目许可证默认开启此选项
    • 开发许可证此选项可选

  • 授权闪现 (Auth Flash)：

    • 在组件初始化或随机时刻，浏览器标题可能会短暂变更为 “授权给 [您的公司名称]”。
    • 持续约 3 秒后，自动恢复为原标题。这是一种反盗版机制，用于明确当前系统的法律归属。

  • 免费许可，不会对此进行任何修改和接管。

控制台面板 ​

DevTools 的 Console 面板是 TechUI 与开发者沟通的主要渠道。

初始化铭牌 ​

组件库加载成功后，会在控制台输出带有样式的 Badge 信息。

  • 内容：显示组件版本、距离过期的天数（倒计时）、授权链路。
  • 状态：
    • 🟦 蓝色：正常授权 / 开发许可 / 提示信息。
    • 🟨 黄色：体验模式 / 临期警告。
    • 🟥 红色：授权无效 / 已过期。

运行警报 ​

当 INFO 模块检测到异常时，会直接输出对应的多语言提示：

  • [TechUI Warn] 当前域名与许可证限定域名不匹配
  • [TechUI Error] 检测到WASM模块依赖的浏览器的原生方法遭篡改

交互式诊断 API ​

为了方便开发者进行深度调试，Core 模块暴露了全局函数 tuiCoreInfo('pandoraKey')。根据传入参数的不同，它会返回不同密级的状态信息。

🛡️ Level 1: 公开声明 (Public) ​

调用方式：tuiCoreInfo() (不传参) 适用人群：最终用户、访客。 返回内容：仅返回法律声明与版权警告，不暴露任何内部参数。

声明：本组件库授权合法有效。为保障合法权益，请勿复制、泄露许可文件。任何未经授权的共享行为将导致售后服务终止，并将授权信息列入黑名单。

🔧 Level 2: 客户调试 (Client Debug) ​

调用方式：tuiCoreInfo('YOUR_CLIENT_KEY')适用人群：持有 Client Key 的开发者/客户。 返回内容：返回经过脱敏的 Global State、License Info 及 Sub-License Info。用于排查“为什么我的授权不生效”等问题。

javascript
// 控制台输出示例
GLOBALSTATE: {
  "environment": "dev",
  "licenseState": "true",
  "subLicExpired": "true",  // <--- 快速定位问题：子许可过期
  ...
}
LICENSEINFO: {
  "company": "尹正软件工作室 Base",
  "expDate": "endless",
  ...
}
SUBLICENSEINFO: {
  "company": "aYinStudio Base", // 最终客户
  "expDate": "20251121",
  ...
}

🔐 Level 3: 内核审计 (Admin Audit) ​

调用方式：tuiCoreInfo('ADMIN_KEY')适用人群：TechUI 官方技术支持。 返回内容：显示内存中所有的原始状态、哈希值及未脱敏的参数，用于排查复杂的底层 Bug。

熔断阻断屏 ​

当系统触发 Level 3 级熔断（如严重篡改、许可证过期、黑名单区域）时，TechUI 会强制移除所有 DOM 节点，并渲染全屏的错误提示。

  • 视觉表现：全黑背景，居中显示错误图标。
  • 信息包含：
    • 具体的错误代码（如 subLicDateValid）。
    • 简明的错误原因（如“子许可证已过期”）。
    • 当前的授权归属与联系方式。

⚠️ 遇到此屏幕怎么办？

请截图保存该画面，并发送给 TechUI 技术支持或您的软件供应商。错误代码是定位问题的唯一凭证。