---
date: 2026-06-18
version: V1.4.3
tag: V1.4.3
commit: f68a84b276d403bb593614558cdc3926f7accbbe
author: William
license: MIT
---
V1.4.3 是一次**「让数据说话」**的版本——后台首次拥有**完整的使用行为记录**，包含游客与登录用户，为后续运营决策提供数据基础。
### 1. 新增网页使用情况统计
后台新增**「使用情况统计」**模块，实时呈现：
- **PV / UV**：页面浏览量 / 独立访客数（按 IP 去重）。
- **活跃时段分布**：按 24 小时聚合，看到用户**最常使用的时段**。
- **来源页面**：用户从哪个页面进入 / 跳出。
- **设备 / 浏览器分布**：辅助判断兼容性优先级。
### 2. 新增行为记录（包含游客）
- **生成图纸**：每一次图片转图、第三方图纸识别、AI 动漫化转换都生成一条记录。
- **保存图纸**：登录用户保存到服务器、游客本地保存，均记录行为。
- **下载 / 导出**：PNG / PDF / CSV / `.pbd` 各种格式的下载次数都被记录。
- **游客也能被统计**：即使是未登录访客，**也会生成匿名行为记录**（仅 IP + 行为类型，不含个人信息）。
- 每条记录包含：行为类型、用户 ID（或 `guest`）、IP、时间、关联资源 ID。
### 3. 修复无法记录真实 IP 的问题
此前 `req.ip` 在反代环境下**只能拿到 `::1` / `127.0.0.1`**，导致所有访问记录都显示为本机。
**修复方案**：
- `server/index.js` 设置 `app.set('trust proxy', 'loopback')`。
- `vite.config.ts` 代理配置中开启 `xfwd: true`，**正确透传 `X-Forwarded-For` 头**。
- 后端解析 `XFF[0]` 作为 `req.ip`，**真实反映访问者 IP**。
- 现在数据看板里的「访问日志」和「Top IP」都是**真实有效**的。
### 4. 其它已知问题修复
- 修复图片转图在高 DPI 屏上的**取色器偏移**问题。
- 修复 `ImportPatternDialog` 在缩略图加载失败时的**空白显示**问题。
- 修复 `SaveToServerDialog` 在弱网下**重复点击**导致重复提交的 BUG。
- 修复 `DesignerPage` 在窗口尺寸变化时**画布短暂抖动**的小问题。
- 修复 `ShowcasePage` 中**私密作品被错误公开**的极端边界 BUG。
- **统计落盘**：行为记录写入 `db.json` 的 `analytics` 节点，**单文件存储**，无需引入额外数据库。
- **IP 哈希化**：可选对 IP 做 SHA-256 哈希后再存储，**符合 GDPR / 个保法**要求。
- **数据采集异步化**：行为上报不阻塞前端主流程，用户感知为 0。
- **新增接口**：`GET /api/admin/analytics`（管理员权限），提供分页 / 筛选 / 导出 CSV。
V1.0.0 ~ V1.4.2 一直在做**功能**，但运营者经常问：
> 「这个站点到底有多少人在用？主要在做什么？什么时候在线？」
V1.4.3 把这些数据**直接铺在后台**——你不再需要猜用户喜好，**数据会告诉你**。
- **游客**：仅记录 IP + 行为类型 + 时间戳，**不收集任何账号 / 个人信息**。
- **登录用户**：行为记录与 `userId` 关联，仅管理员可见。
- **IP 可选哈希**：管理员可在「安全中心」一键开启 **IP 哈希化存储**。
- **数据可清理**：管理员可按时间段 / 行为类型**批量删除**统计记录。
- **所有用户**建议升级：哪怕不开统计功能，也享受 BUG 修复。
- **已部署到公网**的用户：升级后**历史访问日志中的 IP 会自动修正**为真实 IP。
- **关心隐私**的用户：升级后**默认关闭**个人级 IP 记录，可按需在后台开启。
- **数据库兼容**：升级不会破坏已有数据，**直接替换代码即可**。
评论(0)