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

仓库库存盘点助手

每月盘点把账面库存和实物清单导进来,差异和金额自动算清楚。

这是什么问题

盘点完,账面表和盘点表对不上是常事。一千多个 SKU 一行行核对要好几个小时。

解决办法

本地小工具:导入两张表,按 SKU 比对数量;多/少/缺货的分开列出,金额一并算出。

成品效果

  • 左:账面库存 Excel;右:盘点结果 Excel。
  • 点"开始盘点",几秒出三个表:盘盈、盘亏、未盘到。
  • 每个差异附上 SKU、品名、账面数、实盘数、差值、单价、差额金额。
  • 导出盘点差异 Excel 给财务和仓管。

示例输入字段

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

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

现成提示词

你是一名擅长本地桌面小工具的资深工程师。用户是仓管/物流主管,关注业务结果和操作体验。

【目标】

月度盘点把账面表和实盘表的差异一次性算清楚,连金额一起。

【平台与技术】

- Windows + macOS;Electron + React + TypeScript;SheetJS

【核心功能】

1. 两个导入位:账面库存 Excel、盘点结果 Excel。字段(SKU、品名、数量、单价)从下拉框确认。
2. 比对规则:按 SKU 匹配,盘盈(实>账) / 盘亏(实<账) / 未盘到(账有实无) / 多出(实有账无),四类分开展示。
3. 每行计算差值数量、差额金额;底部总计金额(盘盈金额、盘亏金额、净差)。
4. 顶部统计:SKU 总数、差异数、差异率、净差金额。
5. "导出差异明细" Excel,按四类分 sheet。

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

【交付】
1. 搭建 Electron 框架,实现两个 Excel 导入和字段映射。
2. 完成 SKU 比对引擎和四类差异分组展示。
3. 实现统计卡片和差异明细导出,打包 .exe,附使用说明。

验收清单(全部通过才算完成):
□ 双击启动,第一屏是主工作台
□ 导入两张 Excel 后比对结果正确
□ 四类差异分组展示,金额计算准确
□ 导出差异明细按四类分 sheet
□ 路径含中文/空格时正常工作

本地处理;桌面工具风格;中文沟通。

【高质量交付补充】
若上文要求等待确认,改为:≤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 实现、运行、验证,再改公司名、字段名和按钮文字

同部门的其他案例