# 管理端 Token 统计上线记录

2026-09-17 已完成用户授权的管理端服务更新。

- 服务器：`ps@192.168.110.111`，项目 `/opt/im-admin`。
- 页面：[AI 模型 → 调用统计](http://192.168.110.111:8369/#/model/stats)。若仍显示旧页面，可按 Ctrl+F5 刷新。
- 发布目录：`/home/ps/token-usage-20260917`。
- 当前镜像：`zyt/wecom-admin:token-usage-20260917`，同时标记为 `zyt/wecom-admin:current`。
- 镜像 ID：`sha256:5e30dbfc1c57e3b00392bf1c2d80839c66a6f624253d09df516f8706d42d3cd8`。
- 发布包 SHA-256：`63010f7ca8d01cdbf19b5492cbd28132a1c681f635daa6bb0f29ca8a927f9326`。

## 结果

API、模型网关、知识加工三个服务运行正常且重启计数为 0；API 和网关健康检查通过，知识加工服务没有配置独立 healthcheck。候选镜像 261 项后端测试全部通过；前端 15 项测试、类型检查及生产构建通过。部署文件 261 个、镜像内运行文件 253 个均通过 SHA-256 校验。

实际内网入口的首页、统计 JS、API/网关健康接口返回 200；无登录凭证的统计与明细接口返回 401。全部账号及 18 个指定账号的实际数据库查询通过。浏览器自动化初始化失败，未验证已有登录态下的页面点击及 HTTP 200；权限和返回结构由候选镜像自动测试验证。没有为验收制造付费模型请求或客户消息。

核验时归档消息 580463 条（备份时 580451 条）；知识 864 条、客户端账号 18 个、模型供应商 5 个、管理用户 1 个。以上计数未减少。桌面端发布策略仍为原有 v1.3.3，未发布或安装桌面端新安装包。

Token 统计从升级后的网关和知识整理实际请求开始累计，上游没有返回的用量显示未返回。历史聊天不能回填为准确的历史 Token。检查时新账本尚无真实调用记录。

## 备份与回滚

- 源码备份：`/home/ps/token-usage-20260917/source-before.tar.gz`。
- 数据库备份：API 容器内 `/data/backups/token-usage-20260917/backend.db`，4,765,184,000 字节，完整性快速检查通过。
- 旧镜像：`zyt/wecom-admin:before-token-usage-20260917`。
- 回滚命令：`bash /home/ps/token-usage-20260917/rollback.sh`。

回滚恢复源码及旧镜像，保留实时数据库，避免覆盖上线后收到的新消息。

本地验证证据位于 `C:/kefu/deploy/token-usage-20260917`：`verification.json`、`lan-verification.json`、`scope-verification.json`、`fresh-data-before.json`、`fresh-data-after.json`、`backup-verification.json`、`candidate-tests-summary.json`。首次测试失败仅涉及依赖本地私有配置的旧测试夹具；补齐测试输入后重新运行完整 261 项通过，生产逻辑未因此修改。