跳到主要内容

白标功能设置

需要年付订阅

白标功能仅对年付订阅用户开放。购买年付计划后，请通过 Telegram 联系客服获取解锁码。

白标功能允许您自定义 TikMatrix 的品牌标识以匹配您的公司形象。您可以修改应用名称、Logo和品牌信息，创建个性化的 TikMatrix 版本。

功能特性​

基本设置​

  • 应用名称: 自定义应用显示名称
  • Logo上传: 上传您的自定义主Logo（推荐128x128px）
  • 网站图标: 设置应用的自定义图标

品牌设置​

  • 支持邮箱: 客户支持邮箱地址
  • 教程链接: 自定义教程/文档链接
  • Telegram链接: 设置您的Telegram群组或频道链接

功能开关​

  • 显示教程链接: 控制教程链接的显示
  • 显示品牌信息: 控制品牌信息的显示

设置方法​

方法一：界面配置​

  1. 启动 TikMatrix 应用
  2. 点击标题栏的调色板图标 🎨
  3. 在白标设置对话框中配置参数：
    • 应用名称: 输入您的自定义应用名称
    • 主Logo: 上传您的Logo文件（PNG/JPG，推荐128x128px）
    • 支持邮箱: 输入您的支持邮箱地址
    • 教程链接: 输入您的自定义教程链接
    • Telegram链接: 输入您的Telegram群组/频道链接
    • 功能开关: 启用/禁用教程链接和品牌信息显示
  4. 点击"保存"应用设置

方法二：配置文件​

  1. 复制示例配置文件：

    cp examples/whitelabel-config.json src/config/whitelabel-custom.json

  2. 编辑配置文件：

    {
      "appName": "您的应用名称",
      "logo": {
        "main": "/path/to/your/logo.webp",
        "favicon": "/path/to/your/favicon.ico"
      },
      "brand": {
        "supportEmail": "support@yourcompany.com",
        "tutorialUrl": "https://yourcompany.com/docs",
        "telegramUrl": "https://t.me/yourgroup"
      },
      "features": {
        "showTutorialLink": true,
        "showBrandInfo": true
      }
    }

  3. 保存文件并重启应用

方法三：命令行工具​

  1. 进入项目目录：

    cd tikmatrix-desktop

  2. 运行配置工具：

    node scripts/whitelabel-config.js

  3. 按照提示逐步配置各项参数

构建自定义版本​

1. 准备资源文件​

# 将您的Logo文件放在正确位置
src/assets/your-logo.webp       # 主Logo
public/your-favicon.ico        # 网页图标
src-tauri/icons/               # 应用图标（各种尺寸）

2. 配置构建参数​

使用命令行工具或手动编辑配置：

# 使用命令行工具
node scripts/whitelabel-config.js

# 或手动编辑
src/config/whitelabel-build.json

3. 构建应用​

# 开发模式
npm run dev

# 生产构建
npm run build

# 构建Tauri应用
npm run tauri build

配置优先级​

系统按以下优先顺序使用配置：

  1. 运行时配置: 浏览器LocalStorage中的 whitelabel_config
  2. 构建配置: src/config/whitelabel-build.json（构建时使用）
  3. 示例配置: examples/whitelabel-config.json
  4. 默认配置: 内置默认值

Logo要求​

  • 格式: PNG、JPG或SVG
  • 尺寸: 128x128px（推荐）
  • 背景: 透明背景（PNG格式）
  • 用途: 标题栏、启动画面、关于对话框

网站图标​

  • 格式: ICO或PNG
  • 尺寸: 32x32px或16x16px
  • 用途: 浏览器标签页、窗口图标

应用图标（用于构建）​

  • 格式: PNG、ICO、ICNS
  • 尺寸: 32x32、128x128、256x256、512x512
  • 位置: src-tauri/icons/ 目录

API集成​

JavaScript API​

import { 
  getWhiteLabelConfig,
  saveWhiteLabelConfig, 
  resetWhiteLabelConfig,
  validateWhiteLabelConfig 
} from './config/whitelabel.js';

// 获取当前配置
const config = getWhiteLabelConfig();

// 保存新配置
saveWhiteLabelConfig(newConfig);

// 重置为默认值
resetWhiteLabelConfig();

// 验证配置
validateWhiteLabelConfig(config);

实用工具函数​

import { 
  initWhiteLabel,
  updateDocumentTitle,
  updateFavicon
} from './utils/whitelabel.js';

// 应用启动时初始化白标
initWhiteLabel();

// 更新文档标题
updateDocumentTitle('您的应用名称');

// 更新图标
updateFavicon('/path/to/favicon.ico');

最佳实践​

Logo设计​

  • 使用高分辨率图像以获得清晰显示
  • 在所有Logo尺寸中保持一致的品牌形象
  • 在明暗背景下测试Logo效果
  • 确保Logo在小尺寸下仍可读

品牌一致性​

  • 在整个界面中使用一致的颜色和字体
  • 与您现有的品牌指南保持一致
  • 在不同屏幕尺寸下测试自定义界面
  • 保持专业外观

链接配置​

  • 对所有外部链接使用HTTPS
  • 部署前测试所有链接
  • 确保支持渠道得到适当监控
  • 保持文档链接的最新状态

故障排除​

常见问题​

Logo未显示：

  • 检查文件路径和权限
  • 验证图像格式受支持
  • 确保图像尺寸合适
  • 清除浏览器缓存并重启应用

配置未保存：

  • 检查文件系统权限
  • 验证JSON语法正确
  • 确保配置目录存在
  • 尝试以管理员身份运行（如需要）

构建失败：

  • 验证所有资源文件存在
  • 检查配置文件语法
  • 确保图标文件格式正确
  • 查看构建日志获取具体错误

获取帮助​

如果在白标设置过程中遇到问题：

  1. 查看上述故障排除部分
  2. 检查配置文件语法
  3. 通过 Telegram 联系技术支持
  4. 报告问题时请包含您的配置文件和错误信息

许可和使用​

  • 白标功能仅对年付订阅用户开放
  • 自定义品牌权利包含在您的订阅中
  • 分发自定义版本可能需要额外许可
  • 企业许可选项请联系客服

需要解锁码？ 请携带您的年付订阅详情通过 Telegram 联系客服团队。