包裹流转一目了然
入库、取件、滞留件都在这里汇总。
近 7 日流转
入库 / 出库滞留提醒
最近入库
查件
报尾号或扫单号，立刻看到货架位与取件状态
登记新包裹
回车提交 · 连续录入录入小贴士
- 用扫码枪扫面单，回车即完成入库，焦点自动回到运单号。
- 货架位默认取该区第一个空位，占用会自动跳过。
- 只存手机号后四位，不收集完整号码。
- 同一运单号在库时不能重复登记，避免重件。
刚刚入库
| 运单号 | 公司 | 收件人 / 后四位 | 货架位 | 入库时间 | 停留 | 状态 | 操作 |
|---|
近 7 日入库 / 出库趋势
入库 出库在库件 · 快递公司分布
在库件 · 货架区占用
滞留分布
运营小结
图片存储 · 云盘
入库照片与出库取件凭证统一写入云盘。云盘接口只能由服务端中转（浏览器跨域会被拦），两条路任选其一：坚果云 + Cloudflare Worker（不用 NAS / Docker，步骤最少），或 阿里云盘 + AList WebDAV。凭据只填在这里和自己的 Worker / AList 后台，绝不写进公开仓库。GitHub Pages 是 https，WebDAV 地址也必须是 https。
① 坚果云网页版 → 账户信息 → 安全选项 → 第三方应用管理 → 添加应用密码；② 把仓库里的 deploy/nutstore-worker.js 粘贴部署成 Cloudflare Worker（它只负责补 CORS 头，不用服务器）；③ 上面 WebDAV 地址填 Worker 根地址（结尾不要带 /dav），账号填坚果云邮箱，密码填应用密码，点「测试连接」。不要把 https://dav.jianguoyun.com/dav 直接填进来——坚果云不返回 CORS 头，浏览器会拦掉上传。免费版每月上传 1GB / 下载 3GB，照片量大就把「图片最长边」调到 1200 或升级专业版。若测试连接正常但上传报 409，先在坚果云网页端手工建好 express-station 文件夹再试。
驿站设置
数据备份
数据默认保存在当前浏览器。换设备、清缓存前请先导出备份。
GitHub 仓库同步
可选。用仓库里的一个 JSON 文件保存台账，实现多设备同步。需要仅授权该仓库 Contents 读写权限的 fine-grained token；token 只保存在本浏览器。
使用说明与部署
查件（最常用）
顾客报手机号后四位或扫面单，在「查件」页输入即可看到货架位、在库天数，若已取走则显示取件人与出库时间；在库件可一键跳到「取件出库」并自动勾选。工作台顶部也有快速查件框。
日常流程
入库登记（可拍面单照）→ 包裹按货架位上架 → 取件时按后四位检索 → 拍照留证后确认出库。所有动作写入操作流水，误操作可撤销出库。
摄像头与拍照
「打开摄像头 / 拍取件凭证」会直接调用设备摄像头，可连拍、切换前后镜头；拍照后自动压缩并写入阿里云盘。摄像头需要 https 页面（GitHub Pages 满足）并授权相机权限，用本地 file:// 打开或浏览器不支持时会自动回退到系统相机 / 相册。出库默认要求先拍照，可在「图片存储」里关闭。
数据在哪
默认保存在浏览器 localStorage，无需服务器、无需登录。开启 GitHub 同步后，台账会写入指定仓库的 JSON 文件；仓库建议设为私有，Pages 站点本身不要放任何令牌。
GitHub Pages
把本仓库推送到 GitHub 后，在 Settings → Pages 选择分支 main、目录 /（root）即可获得在线地址。纯静态，无构建步骤。
照片存云盘：坚果云（简）
入库可拍面单 / 包裹照，出库可拍取件凭证，压缩后按「年-月」写入云盘的 express-station 目录。坚果云不用 NAS：网页版生成应用密码 → 把 deploy/nutstore-worker.js 部署成 Cloudflare Worker → 在「图片存储」填 Worker 根地址 + 邮箱 + 应用密码。坚果云本身没有 CORS 头，直接填 dav.jianguoyun.com 会被浏览器拦，这个 Worker 就是补这一步。免费版每月上传 1GB / 下载 3GB。
照片存云盘：阿里云盘（AList）
用 deploy/docker-compose.yml 在 NAS 上启动 AList：管理 → 存储 → 添加 → 选「阿里云盘 Open」→ 刷新令牌填云盘 token、根文件夹 ID 填 root、WebDAV 策略选「本机代理」→ 在设置里开启 WebDAV。把 https://你的域名/dav 和管理员账号填进「图片存储」。AList 自带 CORS 头，但仍是 https：内网 http 地址会被 Pages 拦截，可用 Cloudflare Tunnel / Nginx 反代。
安全提醒
手机号只保留后四位。坚果云应用密码只存在本机浏览器、随请求头透传给自己的 Worker，Worker 代码里不写任何账号密码；云盘 token 只填 AList 后台。本机 deploy/.env 与 deploy/data/ 已被 .gitignore 排除，绝不提交到公开仓库。建议在 Worker 里配置 ALLOWED_ORIGINS / PROXY_KEY，避免地址泄露后被他人借用额度。