指南

许可

所有功能均免费。付费许可仅移除“Powered by KatuCharts”水印 — 而激活只需一行代码。

工作原理

即使没有许可，图表也会以全部功能渲染；唯一的区别是一个小小的“Powered by KatuCharts”水印。许可会为你提供一个移除该水印的密钥。验证端点已内置于已发布的包中，因此无需配置任何传输 — 只需设置密钥。

激活你的密钥

在启动时应用一次密钥，在创建任何图表之前。由于验证端点已包含在包内，只需调用一次 setLicenseKey 即可：

import KatuCharts from 'katucharts.js';

// run once at startup, before creating any chart
KatuCharts.setLicenseKey('YOUR_LICENSE_KEY');

购买后可在你的账户面板获取密钥。开发期间 localhost 始终通过验证，因此你可以在上线前完成集成。

域名与席位

密钥会绑定到其运行的域名，直至你套餐的席位上限：

密钥首次运行的域名会被记录为席位，直至你套餐的上限。
localhost 和本地地址始终被允许，且不会占用席位。
在你的面板中释放某个域名，以释放席位并迁移许可。

严格模式与自托管

默认情况下，密钥会在后台进行在线确认，图表在短暂的网络中断期间仍可正常工作（宽松模式）。向 configureLicensing 传入选项可要求在线确认、指向你自己的验证端点，或调整离线宽限窗口：

KatuCharts.configureLicensing({
  mode: 'strict',          // require an online confirmation; default 'lenient'
  verifyUrl: 'https://charts.example.com/api/v1/license/verify',
  gracePeriodMs: 7 * 24 * 60 * 60 * 1000,
});
KatuCharts.setLicenseKey('YOUR_LICENSE_KEY');

大多数应用都不需要这样做 — 默认设置会自行处理激活。

检查许可状态

isLicensed() 会报告当前是否有有效密钥处于激活状态，便于你记录或提示未授权使用：

KatuCharts.setLicenseKey('YOUR_LICENSE_KEY');
if (!KatuCharts.isLicensed()) {
  console.warn('KatuCharts running unlicensed — watermark shown.');
}