kits.chat 迭代版本文档：v12.0.14

• 发布日期：2026-04-24
• 范围：访问统计（工具使用次数/来源）+ 统计页面 + Release 列表排版

变更日志

功能新增

- 工具页打开自动记录工具使用次数（写入 MySQL；Redis 用于计数加速） - 全站记录 pageview，并采集 referrer 与 UTM 参数（写入 MySQL）

- 展示每个工具累计使用次数 - 展示 Top Referrers、Top UTM Source、Top Pages（最近 30 天）

• 访问统计：
• 新增统计页面：`/admin/stats`

体验优化

• `/release` 版本列表支持自动换行分行显示
• 首页热门工具区域改为按“工具使用次数”降序自动挑选展示（并保留兜底列表）

AI 动作全过程（可审计摘要）

- Next.js： - RootLayout 注入 pageview 埋点 - 工具页注入 tool usage 埋点 - 新增 `/admin/stats` 统计页展示工具使用次数与来源汇总 - API： - 工具统计接口支持自定义 limit - 访问统计 summary 增加 referrer / utm_source 汇总 - 服务端补齐 ip/user-agent 获取逻辑（避免依赖前端上报）

• 接受指令：为网站增加访问统计（工具使用次数入库、访客来源统计）并提供可查看统计的页面；同时调整发布日志版本列表分行显示
• 评估：已有后端 MySQL 表与 API 可复用；Next.js 主站需补齐埋点；统计页应以服务端数据为准并避免被搜索引擎收录
• 执行修改（摘要）：

完成效率

• 开发/测试用时：N/A
• Token 消耗：N/A

构建与验收（不含敏感信息）

本地构建

cd kits-web
npm install
npm run build

功能验收要点

• 进入任一工具页：统计页中对应工具使用次数会递增
• 访问带 UTM 的链接（如 `?utm_source=...`）：统计页中 UTM Source 统计会出现对应来源
• `/admin/stats`：能查看每个工具使用次数与来源汇总