yanhui
e02d1f6d66
两件事，都是 2026-10-23 业务反馈直接引起的。
## 1. 转仓代发不再核对异常
业务反馈：崔桥工厂仓的单 351668937728 被判「未揽收」异常，快递却是「曹县韵达小件」，
而且这单在后台是信誉订单。
实查宽表：这单 `warehouse_name=简尚-崔桥工厂仓`，但 `order_labels` 里带一条
`转x00005` —— 聚水潭「转仓」操作留下的痕迹。记账仓还是崔桥，货却由目标仓
（x00005 = 曹县）实际发出，承运账号也跟着变成曹县韵达小件。结果就是原仓的
物流状态永远停在「未揽收 / 无物流单」，报出来全是假异常。
判据：`order_labels` 命中 `/转\s*[xX]\s*\d{3,}/`（不写死单个编码，后续可能出现
x00006）。实测近 30 天 12 仓：`转x00005` 438 单，报未揽收类 46 单（已签收 371 /
无物流单 31 / 运输中 20 / 未揽收 15）；快递分布 曹县韵达小件 133、邮政快递包裹POSTB 124。
口径要点：
- 与「转空包」（信誉单，发空包）严格区分 —— 转仓是**真发货**，只是不从记账仓发；
- 所以**保留发货分母**，只从异常清单摘掉（与「现场拦截」同类，不稀释异常率）；
- 新增 `exclusions.transferPackages/transferOrders/transferReasons`，
前端页脚与钉钉正文各加一行说明。
## 2. 缓存键只按核验日（修导出卡顿）
原来键是 `${核验日}|${limit}`：页面传 1000、导出传 5000 → 两份缓存互不命中，
点一次导出就要把整轮重算一遍。可 `limit` 只影响最后 `slice(0, limit)`，
异常实际才几十行，扫库成本一模一样。
改为：缓存只存**全量明细**（键 = 核验日），limit 在出口 `finalizeDetail()` 里截断。
生产实测（修复前，容器内直调）：页面冷启 189s、命中缓存 0ms、
**页面已缓存时点导出仍要 317s**；修复后导出复用页面结果 1~3ms。
## 验证
- 后端单测 50/50（新增：转仓标签识别 8 条断言、转仓单不进异常但进分母、
导出复用页面缓存不重查、小 limit 不污染缓存）
- 全量 `npm run check` 474 项 / 472 过，2 项为既有环境失败（Windows 权限位、负缓存需隧道故障态）
- 前端 eslint 0、`npm run build` 通过（含 router lazy 静态检查）
- 真实库（10-23 批）：异常 73 单，转仓剔除 1 单（正是 9894520），目标单已消失；
导出在页面加载后 3ms 返回 73 行
拼多多自动化运营平台
公开的拼多多业务精简版。欢迎所有人克隆、修改、分发代码并提交 Pull Request，代码按 MIT 许可证开放。
保留商品监控、仪表盘、激励看板、营销活动、推广、商品分析、工单以及在线客户端与执行任务等现有模块。部分菜单仍沿用原项目的占位页面。
已删除市场数据、店铺管理和运营工具整组页面、Claw 对话、skills 管理、平台切换与其他平台演示页，以及对应路由、页面资源、专属配置接口和权限项。首页为仪表盘。保留业务仍使用的模型配置、商品数据查询、桌面会话和自动上架公共服务继续可用；Claw 补全与图搜备用通道已经移除，缺失资料需使用业务接口或手工补充。
本地启动
需要 Node.js 22。团队开发机器无需安装或初始化 MySQL、Redis 及第三方数据库；使用管理员发放的部署 Key，一次注册后自动连接中央系统数据库、公网 TLS Redis 和第三方数据库。完整步骤及安全边界见 远程系统数据库部署。
npm --prefix backend ci
npm --prefix frontend ci
npm run remote:dev
首次启动时填写配置请求地址和部署 Key，系统自动写入被 Git 忽略的本机配置并重启后端。保存一次性显示的管理员账号和密码后直接登录，不需要在本地创建数据库或继续执行设置向导。前端默认访问 http://localhost:5173，API 默认代理到本地后端。
拉取主仓库更新后必须停止旧的 npm run remote:dev 进程并重新启动，保证前后端使用同一版本。MKH 页的强制刷新带有版本协议校验；如果新前端仍代理到未重启的旧后端，页面会停止展示可能过期的库存并明确提示重启，不再将旧值冒充为“最新数据”。
验证与构建
npm --prefix backend run check
npm --prefix frontend run check
前端构建输出位于 frontend/dist。部署时需为单页应用配置路由回退，并代理 /api 与 /cubejs-api 到后端。
启动时会迁移旧侧栏配置，并删除已退役页面的权限、专属设置和专用数据表。上架测算旧偏好表中的商品分析阈值会先迁移到商品分析专用表；其他保留模块的数据不受影响。迁移仅作用于实际配置给此实例的系统数据库。
参与修改
开始开发前请阅读 仓库提交与合并规范（多用户与 AI 开发必读）。准备更新生产服务器时必须继续阅读 服务器部署规范（开发者与 AI 必读）。AI 工具的规则入口为 AGENTS.md。每个任务使用独立目录和分支，通过 PR、同步验证和独立审核合并，禁止强推或覆盖其他开发者的工作。
所有用户均可 Fork 仓库、创建分支并提交 Pull Request。直接推送本仓库需要仓库所有者授予协作者写权限。提交时请说明修改和验证结果，勿提交 .env、密码、令牌、数据库备份或真实业务数据。