功能概述

仪表盘展示系统运行概况，数据自动采集，无需手动配置。

各区块说明

• 总请求数 / 总下载数 — 自启动以来的累计统计
• 追踪天数 — 有统计数据的天数
• 文件种类 — 被下载过的不同文件数量
• 每日统计 — 近 30 天的请求数、下载数、流量趋势表
• 热门下载 — 下载量 Top 10 的文件排行
• 最近访问日志 — 最近 20 条 API 请求记录（时间、方法、路径、IP、状态码）

提示

如需重置统计数据，可通过 POST /api/admin/statistics/clear 接口清除（需在 config.json 中启用统计功能）。

激活码格式

系统自动生成 PWRMS-XXXX-XXXX-XXXX 格式的激活码（16 位随机字符），点击「生成」按钮即可获取。

新建授权

• 点击「+ 新建授权」打开弹窗
• 点击「生成」按钮自动填入激活码（也可手动输入自定义码）
• 版本标签：如 standard / pro，仅展示用
• 最大激活数：允许绑定多少台设备，默认 1
• 功能位：逗号分隔，留空授予全部（dashboard,inventory,project,knowledge,plugin）
• 过期时间：Unix 秒时间戳，0 表示永久有效
• 备注：记录客户信息等备注

激活流程

客户在客户端输入激活码 → 客户端发送 key + 机器码到服务端 → 服务端验证并绑定 → 签发签名令牌 → 客户端本地缓存离线验签。

编辑 / 删除

编辑时可修改版本、功能位、过期时间等（不可修改激活码本身）。删除后该激活码立即失效。

功能概述

客户端页面展示所有与服务端交互过的设备（按机器码聚合），帮助管理员了解授权使用情况。

搜索功能

在搜索框中输入关键字可按机器码、IP 地址、激活码模糊匹配客户端，方便快速定位目标设备。

统计卡片

• 总客户端数 — 累计记录过的不同机器码数量
• 活跃客户端（7天） — 近 7 天内有请求记录的客户端数
• 总请求次数 — 所有客户端累计请求服务端的总次数
• 试用客户端 — 当前使用试用授权的客户端数

客户端操作

• 授权 — 对试用客户端直接发放正式授权，自动生成激活码并绑定机器码。可设置版本标签、授权天数（0=永久）、功能位和备注
• 延长试用 — 对试用客户端延长试用有效期，在现有到期时间基础上追加天数。即使试用已过期也可延长
• 更多操作（⋯） — 点击操作列的「⋯」按钮打开下拉菜单：试用客户端可「拉黑」；已授权客户端可「解除授权」和「拉黑」
• 解除授权 — 将该机器从其绑定的激活码上解绑，客户端下次联网校验后失效，需重新激活
• 拉黑 — 封禁违规客户端，可设置天数（0=永久）和原因，详见「黑名单」页说明

客户端试用延长（活动/分享）

客户端可通过 POST /api/license/extend 接口参与活动或分享获得额外试用天数。每次可延长 1-30 天，最多延长 3 次。

数据来源

活动数据在客户端调用激活、试用、校验、解绑接口时自动记录，SQLite 持久化存储。

功能概述

黑名单用于封禁违规客户端（如盗版、滥用试用）。被拉黑的机器将无法激活授权、无法领取试用；已授权客户端在联网校验时也会被判定失效。

拉黑方式

• 客户端页面 — 点击操作列的「⋯」按钮，选择「拉黑」
• 黑名单页面 — 点击「+ 手动拉黑」，直接输入机器码

拉黑时长

• 天数 = 0 — 永久拉黑，不会自动失效
• 天数 > 0 — 临时拉黑，到期后自动失效

生效机制

• 拉黑在客户端下次联网请求（激活 / 试用 / 校验）时生效
• 离线状态下已签发的令牌仍可短期使用（客户端内置公钥离线验签的设计边界）

解除黑名单

在黑名单列表点击「解除黑名单」即可恢复。如需恢复授权，请在客户端页面重新授权。

创建公告

• ID：留空自动生成（格式 YYYYMMDDHHmmss）
• 类型：通知 / 重要 / 推荐 / 提示
• 内容：公告正文，客户端直接展示
• 跳转：可选，填写路径或 URL，客户端点击可跳转

定向推送

• 定向版本：指定版本标签，仅该版本客户端收到（留空=全部）
• 定向功能位：指定功能位如 plugin，仅拥有该功能的客户端收到（留空=全部）

时间控制

• 生效时间：0 表示立即生效，否则到指定时间才展示
• 过期时间：0 表示不过期，否则到期后不再展示

启用 / 禁用

取消勾选「启用」可临时隐藏公告，不删除数据，随时可重新启用。

创建插件

• 插件 ID：唯一标识（如 jlc-QR-code-data-entry），创建后不可修改
• 名称 / 版本 / 分类 / 描述 / 作者：基本信息
• 所需功能位：留空=免费插件；填写如 plugin 表示需要该功能位授权才能安装

上传插件包

• 点击上传区域选择 .zip 文件
• 上传后系统自动计算 SHA256 校验和、文件大小
• 下载地址自动填入（/downloads/plugins/文件名）

客户端安装

客户端在「工具 → 插件市场」浏览并安装。付费插件需要对应功能位授权才能安装。

发布新版本

• 版本号：语义化版本（如 2.1.0）
• 发布日期：默认当天
• 更新说明：简要描述本次更新内容
• 下载地址：安装包路径（如 /downloads/part-wms-2.1.0.exe）
• 最低兼容版本：低于此版本的客户端将收到强制更新提示
• 强制更新：勾选后客户端必须更新才能继续使用
• 变更列表：每行一条变更记录

下载配置

在 config.json 的 download.baseURL 配置下载地址前缀。设为自身地址则由本机提供下载；设为 CDN 地址（如七牛）则流量外移。

版本管理

支持编辑和删除已有版本。删除后客户端将无法下载该版本。

功能概述

用户反馈页面收集并管理客户端提交的反馈信息。客户端通过设置页的「反馈问题」入口提交，无需登录即可提交。

反馈类型

• Bug 上报 — 软件功能异常、崩溃、数据错误等
• 功能建议 — 新功能需求或现有功能改进建议
• 界面/交互 — UI 布局、操作流程、视觉体验优化
• 性能问题 — 卡顿、启动慢、内存占用高等
• 数据问题 — 数据导入导出、备份恢复、数据丢失等
• 兼容性 — 系统兼容、硬件兼容、第三方软件冲突等
• 其他 — 以上类别未覆盖的反馈

状态流转

• 待处理 — 新提交的反馈，尚未处理
• 处理中 — 正在跟进处理
• 已解决 — 问题已修复或建议已采纳
• 已关闭 — 不再跟进（无效反馈或重复问题）

操作说明

点击「查看」打开反馈详情，可修改状态并填写回复内容。支持按关键字搜索和按状态筛选。