跳到主要内容
返回案例列表
物流Windows 应用

异常件排查小工具

导入每日快递状态表,自动挑出"卡 48 小时"、"派送 3 次未签收"等异常件,交给客服跟进,投诉少一半。

这是什么问题

物流同事每天要看几千条订单的快递状态。卡在某节点两天、派送三次未签、退回转运的单子,如果没人及时发现,轻则客户投诉,重则赔钱。肉眼扫 Excel 跟不过来。

解决办法

做一个桌面小工具:快递导出表拖进去,按四条异常规则自动筛选。列出问题单,一键导出给客服跟进。

成品效果

  • 首页三块:导入快递表 / 异常列表 / 规则设置。
  • 导入后显示总单数、异常单数、正常单数。
  • 四条内置规则可开关可调参:卡 >= 48 小时、派送次数 >= 3、退回、关键词匹配。
  • 异常列表按严重度排序;电话脱敏显示(138****1234)。
  • 一键导出异常清单到 Excel,发给客服。
  • 支持今日 / 近 3 日 / 近 7 日时间粒度。

示例输入字段

复制提示词前,可以把你的 Excel / CSV 表头改成这些名字,或把真实表头一起贴给 Codex。

订单号承运商运单号当前状态最近更新时间

现成提示词

你是一名擅长 Windows 桌面软件的资深工程师。请帮我做一个本地运行的 Windows 小工具,使用者是电商公司物流 / 客服同事,关注业务结果和操作体验。

【目标】

把每天几千条订单中的异常件挑出来,交给客服跟进,减少投诉和赔付。

【平台与技术】

- Windows 10/11 桌面应用
- Electron + React + TypeScript
- SheetJS 处理 Excel / CSV
- 本地 SQLite 保留最近 30 天导入历史
- 完全离线,打包 Windows .exe 安装包

【字段映射】
导入时支持列名映射(中英兼容):订单号、快递公司、快递单号、收件人姓名、收件人电话、当前状态、最近更新时间、派送次数、异常标签。首次映射后记住。

【核心功能】

1. 首页三入口:导入 / 异常列表 / 规则设置。
2. 导入:支持多文件,一次性导入,自动识别编码(UTF-8 / GBK)。显示基础统计。
3. 异常规则(可开关 + 调参):
   - A:最近更新 >= N 小时(默认 48)且状态不是已签收 / 已退回。
   - B:派送次数 >= N(默认 3)且未签收。
   - C:状态含"退回 / 退件 / 拒收 / 异常"关键词。
   - D:用户自定义关键词。
4. 异常列表:按严重度排序。字段:订单号、快递公司、电话(脱敏)、原因、卡住小时数、推荐动作。
5. 时间粒度:今日 / 近 3 日 / 近 7 日,支持历史对比。
6. 导出异常清单到 Excel,文件名 "异常件-YYYY-MM-DD.xlsx"。

【界面风格】

- 业务型:表格清晰、柔和分隔线。
- 严重度红 / 黄 / 蓝三级。
- 深浅模式跟随系统;中英切换。

【稳健性】

- 字段映射失败时手动引导。
- 大文件(> 5 万行)分批处理显示进度。
- 导入出错保留已解析部分。
- 电话默认脱敏;"查看完整号码"需点击按钮,动作计入轻量日志。
- 关闭软件前询问是否清理当日数据。

【约束】
- 全部本地处理,数据不上传外部服务。
- 缺真实数据时先造脱敏 sample-data,不等用户提供文件才开工。
- 不引入不存在的 npm 包;不确定时先查 npm view。
- 不写死 API Key、绝对路径、个人邮箱或内网地址。
- 输出不覆盖原文件,冲突加时间后缀。
- 同一问题 3 次失败 → 降级边缘功能,先交付主流程。

【交付】
1. 摘要需包含列表、异常、规则页安排。
2. 分三步:导入 + 识别 + 列表 -> 规则自定义 + 时间粒度 -> 导出 + 历史对比。
3. 打包 .exe,500 字中文使用说明。

验收清单(全部通过才算完成):
□ 双击 .exe 启动,首页三入口:导入 / 异常列表 / 规则设置
□ 拖入快递 Excel → 自动识别字段 → 显示统计 → 异常列表标红
□ 四条规则可开关可调参 → 筛选结果实时更新
□ 电话脱敏显示(138****1234)
□ 导出异常清单 Excel,文件名带日期
□ 空文件、格式错误 → 友好提示,不闪退

【高质量交付补充】
若上文要求等待确认,改为:≤8 行摘要后直接实现、运行、修复、验证;只因真实文件、账号、证书或不可逆操作停下。

【桌面交付契约】
- 交付本地可运行应用,不是方案;第一屏就是主工作台。M1≤15 分钟先出可启动窗口+示例数据/试用模式,M2 接通真实主流程,M3 补异常/UI/隐私,M4 测试+打包+文档。
- 没有用户真实文件时,先创建贴近业务的脱敏 sample-data 并继续推进。
- 每个里程碑卡住时的降级策略:M1 卡住 → 换更简单的实现方式先出窗口;M2 卡住 → 先跑通核心 3 步,边缘路径后面补;同一问题 3 次失败 → 降级或禁用边缘功能,先交付主流程。
- 每次汇报≤6行:完成、验证、跳过原因、下一步+预计时间,让进度清楚。
- 用业务语言写按钮、错误和说明;支持拖拽+系统打开/保存;空/错格式/取消/无权限/大文件/重名冲突都友好处理,不暴露堆栈。
- 路径兼容中文、空格、括号、长路径和 Windows/macOS 分隔差异;Windows 快捷键用 Ctrl/Alt,macOS 用 Command/Option。
- 默认离线、本地处理;不覆盖原文件;不写死密钥、绝对路径、个人邮箱或内网地址。
- 项目分层:desktop shell / controlled API / UI / core / tests / sample-data / docs;IPC 白名单化,UI 不直接执行本地命令。
- 真实接线:导入、预览、生成/保存、导出、错误状态都可用;不把 TODO、空函数、未用大组件或假数据当完成。

【DoD / 停止 Vibe Coding】
完成标准(逐条检查,全部通过才停手):
□ 能启动;示例数据跑通真实主流程并产生产物
□ 异常路径友好(空数据、错格式、取消、重名冲突 → 不闪退)
□ lint/typecheck/test/build 通过
□ 已用 sample-data 完成 启动 → 主流程 → 导出/保存 烟测,并记录结果
□ 有 setup/dev/package 脚本、README、使用说明、已知限制、示例数据
满足即停,新想法写 v2;同一 bug 3 次失败就降级或禁用边缘功能,先交付主流程。

拿到提示词之后

1

打开 Codex 桌面版,新建一个任务

2

把提示词整段复制,粘贴到对话框里发送

3

让 Codex 实现、运行、验证,再改公司名、字段名和按钮文字

同部门的其他案例