我们没有把 AI 加进一家店。我们用 AI 搭了一家店。
这一页写给审核我们的人、给我们供货的人,和想这样做事的人。它具体地说明"AI 原生"在这里是什么意思。
SEC 01 — 原则
-
01 ONE LEDGER
一本账
库存是一本只增不改的账。每一次变动——进货、售出、退货、盘点、拿一盒回家——都是一行带正负数量的记录,在库数就是这些行的和。没有修改这回事;记错了,再记一行去纠正。
每个渠道的挂牌数量都从这一个数字推出来。任何平台上的库存永远不会超过家里货架上的实物;一个渠道卖出一件,其他渠道随之减一。
-
02 TWO KINDS OF USERS
两类用户
人从浏览器进来,agent 从 MCP 进来。两者走同一层业务逻辑、同样的规则、同样的审计记录——Claude 记的一次库存变动,和人记的那一行一模一样。
-
03 MONEY MOVES SLOWLY
钱走得慢
所有花钱的动作——比如买面单——一律从 dry-run 开始,有日上限,失败不自动重试。agent 能做很多事,但不能"顺手"花钱。钱,要由人来打开。
SEC 02 — 系统
它是怎么连起来的
只有一个 API,人和 agent 共用。Postgres 存账本;worker 跟平台打交道;一台 Windows 小机上的 agent 驱动热敏打印机。
- 人 · 浏览器 NGINX API · FASTAPI + MCP POSTGRES · 账本
- CLAUDE · MCP NGINX API · FASTAPI + MCP POSTGRES · 账本
- WORKER · 定时任务 TIKTOK SHOP / EBAY / GRAPH 邮件
- WORKER · 定时任务 POSTGRES · 账本
- 打印 AGENT · WINDOWS PC API · FASTAPI + MCP
- 打印 AGENT · WINDOWS PC 热敏打印机
SEC 03 — 一天
系统眼中的一天
- 02:10 worker 轮询 TikTok Shop 和 eBay 的新订单。
- 02:11 账本里预留库存;每个渠道的挂牌数量随之下调。
- 07:30 买面单(在负责人打开之前一直是 dry-run),排进打印队列。
- 08:00 Max 打包。打印 agent 早就把面单打好了。
- 每小时 Drive 收件箱里的收据被读取、记账、归档。
- 每晚 发货截止、保质期、令牌到期、合规日历逐项扫描;有需要人处理的才发一封邮件。
SEC 04 — 工具
用什么搭的
| 工具 | 是什么 | 用来做什么 |
|---|---|---|
| ERP | 自研 · Python、FastAPI、React | 账本、订单、面单、提醒;对外暴露 MCP server |
| Claude Code | Anthropic | 写代码、维护代码 |
| Claude Cowork | Anthropic | 浏览器里的杂务:平台后台、表单、导出 |
| MCP | 协议 | agent 进入 ERP 的通道,规则与人相同 |
| QuickBooks | Intuit | 账目;收据从 Drive 收件箱进到这里 |
| Cloudflare | — | 域名、DNS、这个网站,以及 eBay 要求的那一个公网端点 |
| Microsoft 365 | — | 邮件与提醒 |
SEC 05 — AGENT 不做什么
agent 不做的事:选品、和供应商谈、定价,以及在没有人打开开关的情况下碰钱。这些是 Max 的事。
想亲眼看看?我们乐意带合作伙伴走一遍这套系统。