# Usales 元销 · 交互原型交付包(v6.0)

AI 原生销售系统的高保真、可点击、可编辑、完全本地的原型。从 Demo v5.2(单文件手写 HTML)按「完整 App 原型交付标准」重做:页面与状态清单先行、统一设计系统、主路径端到端可点、工作台外壳(页面地图 / 聚焦交互 / 全部页面 / 标注)、板图 + 清单 + 源码 + 文档。

- 目标设备:桌面 Web(应用画面固定 1280×800,工作台外壳自适应桌面宽度)
- 语言:简体中文;样例数据固定为 2026-07-06(周一),所有数据本地、确定性
- 依赖:无。不接 API、不用 CDN、不用远程字体、不做登录、不埋点
- 状态数:5 个旅程 · 40 个页面状态(见 `SCREEN-MANIFEST.csv`)

## 怎么打开(从最简单的开始)

1. **双击 `interactive.html`**(或根目录的 `Usales-中文版交互原型.html`)——单文件,内联 JS/CSS,任何浏览器直接打开,不需要服务器和 Node。
2. `index.html` —— 静态交付页:板图画廊 + 页面清单,链接到 `interactive.html`。
3. 根目录 `打开 Usales 本地原型.command` —— macOS 双击即用系统默认浏览器打开上面的单文件。

工作台用法:左侧页面地图按旅程编号(A01…E06),点任一条即把应用预置到该状态,画面内所有按钮可点;右侧是标注;顶部可切「全部页面」看 40 个状态的静态板;`?screen=B05` 可直接定位,`?view=all` 打开全部页面模式。

## 包内文件

```
interactive.html        无服务器的可点击原型(与根目录单文件字节一致)
index.html              静态交付页:板图画廊 + 页面清单
README.md               本文件
PRD.md                  产品范围与需求(从属北极星 V1.3 / PRD V2.3 / 三引擎规格 V1.1)
DESIGN.md               设计系统:颜色角色、字阶、间距、组件、文案与交互规则
SCREEN-MANIFEST.csv     40 个状态:ID → 旅程 / 状态 / 进入 / 动作 / 退出 / 数据状态 / 自主度 / 板图
artifacts/              overview.png、studio-all-pages.png、board-*.png(每板 ≤ 6 个状态)
source/                 可编辑源码快照(React + TypeScript + esbuild)
```

## 修改与重建(可选,只有改源码时才需要)

```bash
cd source
npm install            # esbuild / react / typescript
npm run typecheck      # tsc --noEmit
npm test               # 清单与交付一致性测试
npm run build          # 生成单文件 HTML
node scripts/write-manifest.mjs
node scripts/export-boards.mjs     # 用本机 Chrome 无头导出板图
node scripts/write-index.mjs
npm run validate
```

改页面清单只需要改 `app/screens.ts`:工作台页面地图、全部页面板、CSV、测试全部从它派生。

## 已知边界(有意为之)

- 原型只模拟决策核心与三引擎的产出,不含真实 LLM / ASR / RAG 调用;处理中状态用定时器模拟异步。
- 客户详情的完整事件流、决策链、辩证共识以「宁波精模注塑」为样例;其他客户显示简化详情。
- 管理者页的「管理 / 调整参数 / 编辑规则」等次级入口以 toast 标示为示意,未展开二级页。
- 未做移动端;未做登录 / 权限矩阵(PRD V1 非目标)。