01 · DEPLOYMENT
01部署架构
演示与真实系统分开路由、分开存储，只共用同一个确定性计算引擎。
访客浏览器
演示页/ · 内置 7 个虚构场景
真实数据页/workspace.html · 上传 CSV
架构页/architecture.html
HTTPS · ai3.shadowmotion.cn
公网服务器（阿里云）
nginx备案域名 · 证书 · 反向代理
→
frps端口 8013
frp 隧道 → 本机 127.0.0.1:6012
Mac mini · Docker Compose（marrow-pulse-mock）
web 容器 · nginx静态页面（HTML/CSS/JS，无构建步骤）· /api 反代 · 上传接口单独放宽到 8 MB · 安全响应头
/api/*
api 容器 · Python 标准库 HTTP 服务（零第三方依赖）
演示datasets/ + Pulse/api/marrow · /api/pulse
7 个场景即 7 份输入数据
不调用大模型
7 个场景即 7 份输入数据
不调用大模型
共用marrow.py 计算引擎纯函数 · Decimal 精确到分
利润桥必须精确对账
缺数据就降级
利润桥必须精确对账
缺数据就降级
真实workspace//api/workspace
ingest · assistant · llm · store
后台任务 + 轮询
ingest · assistant · llm · store
后台任务 + 轮询
pulse-data 卷Pulse 决策记录 · 访问统计
workspace-data 卷每个访客一个目录 · 24 小时无操作自动删除
DeepSeek APIdeepseek-flash · 只由 workspace/ 调用 · 每工作区每天 40 次、全站 600 次上限
usage-hub（ai9）只读汇总各服务访问统计 · 不依赖本服务运行
02 · DATA FLOW
02真实数据处理流程
每一步标明由谁负责：人确认与声明，程序计算与校验，AI建议与解读。
- 程序上传与读取浏览器先 gzip；识别 UTF-8 / GBK 与分隔符；≤ 5 MB、≤ 5 万行；只保存解析后的表格
- AI程序字段识别列名规则 + DeepSeek 看列名与前 3 行样例给建议；负数记账的费用列建议取相反数
- 人确认与声明确认每个字段对应哪列；空白代表 0 还是未知、缺的列视为 0 还是未知、没传广告是“未投放”还是“未上传”——必须选
- 人分析设置基础币种与汇率、店铺时区、两期窗口（按最晚日期预填）、可选的财务控制总额
- 程序规范化与校验转成统一输入格式；非数字、日期越界、声明冲突直接报错，指出文件名与行号
- 程序确定性计算去重完全相同的行 → 汇率折算 → 两期汇总 → 贡献利润 → 利润桥逐项对账到分 → 与控制总额对账
- 程序报告每个数附快照编号与文件行号；口径定义；7 项质量检查；高 / 中 / 低可信；声明清单
- AI解读与追问只能通过工具取数；回答里的数字逐个核对（见下一节）
演示页走的是同一条后半段流程：7 个场景各是一份已经写好的规范输入（manifest.json + 订单 CSV + 广告 CSV），直接进入第 5 步。
03 · AI LOOP
03AI 问答与数字核对回路
模型看不到原始明细，也不允许自己算数；它能拿到的每个数字都来自程序。
人提问“哪个 SKU 对利润影响最大？”
↓
AIDeepSeek系统提示含报告摘要与 6 条规则：不自行计算、不断言因果、降级时不给利润结论……
↓ 需要数字时
程序确定性工具breakdown：按 SKU / 周 / 日 / 币种 / 广告活动拆分任一指标两期变化
top_orders：列出某指标最大的订单行（带文件行号）最多 6 轮
top_orders：列出某指标最大的订单行（带文件行号）最多 6 轮
↓
AI草稿回答
↓
程序数字核对抽出回答中的每个数字（含“万”、百分比），与报告和工具结果比对；日期、编号、小计数不计
✓ 全部找得到原样展示，标注“数字已核对”
↺ 有找不到的把这些数字告诉模型，要求只引用原始结果重写一次
⚠ 重写后仍找不到照常展示，但把这些数字标黄，提示“请勿采信”——不隐瞒
04 · BOUNDARIES
04职责边界、置信度与失败降级
缺失必须被声明，不能被推断；数据不全时宁可少说，也不给错的结论。
程序负责
- 所有金额的计算、汇总、换算
- 利润桥精确对账（差 1 分就拒绝出结论）
- 数据校验与行号定位
- 置信度评定、数字核对
模型负责
- 建议字段对应关系（人确认后生效）
- 用业务语言解读报告
- 决定该调用哪个工具来回答追问
模型不负责
- 产生任何新数字
- 补齐缺失值
- 判断因果（“广告导致利润下降”）
- 给出投放、定价决策
高可信所有检查通过：成本、退款、币种齐全，两份控制总额对账为 0
中可信结论成立但有提醒：未提供控制总额、按汇率折算、去除了重复行、窗口外有数据
低可信 · 降级关键数据缺失或对账不符：暂停利润差额与利润桥，只展示已核对指标
出现什么情况系统怎么做
缺商品成本 / 退款未结算该项记为未知（不当 0），暂停利润结论，列出缺失的订单
广告报表中断或未上传保留 ERP 销售结论，广告花费与利润结论暂停，写明原因
外币订单没有汇率这些订单不参与汇总，销售差额与利润结论暂停
与财务控制总额对不上显示差额，暂停利润结论
格式错误（非数字、日期越界）拒绝分析，指出文件名与行号
空白与缺列含义未声明拒绝分析，逐项提示需要声明的地方
AI 数字核对不通过重写一次，仍不通过则标黄提示勿采信
DeepSeek 不可用或额度用完AI 功能关闭，确定性报告照常可用
05 · EVALUATION & SCOPE
05最小评估集与第一版不做的事
每次改动计算引擎，都要求演示场景的输出与改动前逐字段一致。
7演示场景标准 · 缺成本 · 广告中断 · 重复订单 · 币种不一致 · 退款未结算 · SKU 结构变化
24基准用例关键数字的期望值：销售差额、利润差额、利润桥合计、完整率、降级状态……
38自动测试解析、声明、汇率、隔离、过期清理、AI 工具循环、数字核对与重写、额度（假模型，不依赖网络）
2“脏”样例导出GBK 中文表头、负数佣金、美元订单、按日英文广告报表——页面可下载试用
第一版明确不做
实时 API 对接店铺净利润与税费SKU 级广告归因因果推断与预测自动调价 / 投放多店铺汇总Excel 直接上传账号体系