# 青石云演示说明书：上传项目清单并解析
> 适用产品：青石云 · 智慧预算
> 演示入口：`智慧预算` → 打开预算 → `预算平铺表`
> 演示时长建议：8～12 分钟（含计算与结果讲解）
> **前端在线访问：** [/shuomingshu/](/shuomingshu/) · [图文版](/shuomingshu/演示说明书-上传项目清单与解析-图文版.html)
> **图文版文件：** [演示说明书-上传项目清单与解析-图文版.html](./演示说明书-上传项目清单与解析-图文版.html)
---
## 1. 演示目标
向客户讲清一件事：
**上传一份工程清单 Excel → 系统自动识别并解析项目行 → 落到预算平铺表 → 一键开始计算（工艺拆解 + 定额匹配）→ 得到可核对的计价结果。**
讲解时强调两个阶段，避免误解「上传即算完」：
| 阶段 | 用户动作 | 系统结果 |
|------|----------|----------|
| A. 清单解析 | 上传并确认 | 项目进入平铺表（只落库，不算价） |
| B. 智能计算 | 点击「开始计算」 | 工艺拆解 → 定额匹配 → 表格展示结果 |
---
## 2. 演示前准备
### 2.1 账号与环境
- 已登录 [青石云](https://app.qingshiyun.cn)
- 账号下已有可用的**企业定额库**（或演示专用定额库）
- 建议使用干净的演示预算单，避免历史任务干扰讲解
### 2.2 演示素材（建议提前备好）
| 素材 | 格式 | 说明 |
|------|------|------|
| 项目清单 | `.xlsx` / `.xls` / `.xlsm` | 含「项目名称」「工程量」等列；可多 sheet |
| （可选）补充要求 | Excel / PDF | 表头含「材料」「品牌」，用于约束匹配偏好 |
| （可选）难例清单 | 同上 | 列名不标准，用于演示「手动处理」 |
### 2.3 讲解话术（开场 30 秒）
> 「传统做法是造价员对着清单逐条翻定额。青石云支持直接上传项目清单，系统先把清单解析成结构化项目，再按『项目 → 工艺 → 定额』做智能匹配，把重复劳动交给系统，人工只做核对与调整。」
---
### 2.4 支持的解析表格样式
**不强制固定模板。** 语义识别 + 手动映射兜底，可覆盖市面 **90% 以上**常见工程量清单 / 预算表样式（含多级标题、项目特征长文本、多 sheet 工作簿等）。
| 常见样式特征 | 系统处理方式 |
|--------------|--------------|
| 标准表头（项目名称、工程量、单位等） | 自动识别为「可导入」 |
| 多级分部标题 / 分部说明行夹在清单中 | 识别层级结构，提取可计价项目行 |
| 项目特征、做法说明等长文本列 | 一并解析，供后续工艺拆解参考 |
| 一个工作簿多个楼层 / 分区 sheet | 扫描后按 sheet 勾选导入 |
| 列名不标准或列序混乱 | 「手动处理」映射关键字段后导入 |
示例（真实装修公区清单截图）：
**讲解点：** 演示时可打开客户自己的清单对照——不必改成固定模板，系统先自动读；读不全再手动补映射。
---
## 3. 演示流程（逐步操作）
### 步骤 0：进入智慧预算平铺表（约 30 秒）
1. 左侧/导航进入 **智慧预算**
2. 新建一单，或打开已有预算
3. 进入 **预算平铺表**（路径形如 `/budget-quote/flat-table/{预算编码}`）
**讲解点：** 平铺表是清单导入、计算、核对的主工作台。
---
### 步骤 1：打开上传弹窗（约 20 秒）
1. 点击右上角（或工具栏）**上传清单**
2. 弹出 **「上传清单与补充要求」**
弹窗三段结构，演示时可按顺序指一下：
1. **项目清单**（必做）
2. **补充要求**（可选）
3. **选择定额库**（可此时选，也可放到计算前再确认）
> 若该预算已开始过计算/进入历史模式，按钮文案可能变为 **历史清单**，弹窗标题为「历史上传的清单与补充要求」。
---
### 步骤 2：上传项目清单并扫描 Sheet（约 1～2 分钟）
1. 点击或拖拽 Excel 到虚线区域（**仅支持 1 个文件**）
2. 等待提示：**正在扫描工作簿 sheet，请稍候...**
3. 扫描完成后展示 sheet 列表，关注状态徽章：
| 徽章 | 含义 | 演示说法 |
|------|------|----------|
| **可导入** | 已识别关键列，可勾选导入 | 「系统已自动读懂这个 sheet」 |
| **不可导入** / 未识别 | 缺关键列或结构异常 | 「这时用手动处理补齐映射」 |
| **手动列映射** | 已做过人工列映射 | 「人工校正后会记住映射」 |
| **已导入** | 历史上已导入过 | 增量场景可顺带提一句 |
**可选操作：**
- 勾选/取消要导入的 sheet
- 若出现「矩阵清单」提示：说明确认后会按子列拆成多个虚拟 sheet
- 点 **手动处理**：至少映射 **项目名称**、**工程量**（还可映射项目特征、单位，或「项目名称+项目特征」）
**讲解点：** 不强制固定模板；系统会做语义识别，列名不标准也能用手动映射兜底。
---
### 步骤 3：（可选）补充要求与定额库（约 1 分钟）
1. **补充要求**：上传材料/品牌约束文件（Excel 或 PDF）
- 可点 **支持的格式说明** / **下载模版** 给客户看规范
2. **选择定额库**：勾选 0～1 个企业定额库
- 可不选，**开始计算前**系统会再弹「计算前确认定额库」
**讲解点：** 补充要求影响后续匹配偏好；定额库决定「用哪套企业定额」计价。
---
### 步骤 4：确认上传 → 异步解析（约 1～2 分钟）
1. 点击 **确认**（上传中按钮会变为「上传中...」）
2. 弹窗关闭，表格区域出现遮罩：**数据解析中，请稍后**
3. 解析成功后提示：**清单解析完成，已更新表格**
4. 平铺表出现项目行（名称、工程量、单位等）
**讲解点（关键）：**
> 「这一步只是把清单变成结构化项目数据，**不会自动开始定额匹配**。这样您可以先核对项目是否齐全，再决定何时计算。」
**异常话术（如遇）：**
| 现象 | 说法 |
|------|------|
| 清单解析失败 | 「先检查 sheet 勾选与列映射，再重新上传」 |
| 解析完成但无项目 | 「多半是 sheet 未勾选或列映射缺工程量/名称」 |
| 解析较久 | 「大文件走后台任务，稍候刷新即可」 |
---
### 步骤 5：开始计算（约 2～4 分钟）
1. 在平铺表对应 sheet 区域点击 **开始计算**
2. 若尚未选定定额库，弹出 **计算前确认定额库** → **确认并开始计算**
3. 观察状态变化（可边等边讲）：
```
待计算
→ 清单项目分析 / 向量预取
→ 工艺拆解中
→ 定额匹配
→ 已完成（或可「继续计算 / 重新计算」）
```
**讲解点（架构一句话）：**
> 「匹配链路是 **项目 → 工艺 → 定额**，不是直接把项目硬绑到某条定额。这样更贴近现场施工逻辑，也便于后续核对工艺是否合理。」
可暂停任务时，界面会出现 **已暂停**；演示可提「支持中途暂停，避免误算」。
---
### 步骤 6：结果核对（约 2～3 分钟）
在平铺表中带领客户看：
1. 项目行是否齐全、工程量是否正确
2. 拆解出的工艺是否合理
3. 匹配到的定额条目与单价/合价
4. 若上传了补充要求，指出材料/品牌偏好是否体现在结果中
**收束话术：**
> 「导入解析解决『清单数字化』，智能计算解决『定额匹配与计价』。造价员从『翻书找定额』变成『审结果、调偏差』。」
---
## 4. 演示流程图
```mermaid
flowchart TD
A[智慧预算列表] --> B[打开预算平铺表]
B --> C[点击「上传清单」]
C --> D[上传 Excel 项目清单]
D --> E[扫描 Sheet
可导入 / 手动列映射]
E --> F{可选}
F --> G[上传补充要求]
F --> H[选择定额库]
E --> I[点击「确认」]
G --> I
H --> I
I --> J[异步解析
数据解析中…]
J --> K[平铺表出现项目行]
K --> L[点击「开始计算」]
L --> M[确认定额库]
M --> N[向量预取 → 工艺拆解 → 定额匹配]
N --> O[核对结果 / 继续或重新计算]
```
---
## 5. 能力边界（演示时主动说明，建立信任）
| 可以 | 暂不承诺 / 需人工 |
|------|-------------------|
| Excel 清单语义识别与多 sheet 导入；覆盖市面常见清单样式 90%+ | 非 Excel 的项目清单（如纯 CSV）不走此入口 |
| 列名不标准时手动映射 | 扫描为「不可导入」时需人工处理后再确认 |
| 解析与计算分步，可先核对再算 | 上传确认后**不会**自动开始计算 |
| 企业定额库匹配与工艺拆解 | 匹配结果需造价人员复核，尤其非常规项目 |
| 开始计算前可换清单；开始后文件锁定 | 计算中勿指望继续改源文件 |
---
## 6. 常见问答（FAQ）
**Q：必须用你们的模板吗？**
A：不必须。系统会扫描识别，可覆盖市面常见工程量清单样式的绝大多数；识别不全时用「手动处理」映射「项目名称」「工程量」等字段即可。补充要求有模版可下载。参见「支持的解析表格样式」示例。
**Q：上传后为什么没有定额结果？**
A：上传只做清单解析。需要再点「开始计算」，并确认定额库。
**Q：一个预算能传多个清单文件吗？**
A：上传区单次 1 个文件；多 sheet 可在同一文件内勾选导入。开始计算前可替换文件；开始计算后源文件锁定。
**Q：补充要求是干什么的？**
A：用材料/品牌等约束影响后续匹配偏好，不是替代项目清单。
**Q：和「企业定额 Excel 导入」有什么区别？**
A：本流程是把**项目清单**导入预算做计价；企业定额导入是把**定额条目**写入定额库，属于库建设，不是本演示主线。
---
## 7. 演示检查清单（上场前打勾）
- [ ] 演示账号可登录，智慧预算可新建/打开
- [ ] 至少一个可用定额库
- [ ] 准备好「可自动识别」的标准清单 Excel
- [ ] （加分）准备一份需「手动处理」的难例
- [ ] （加分）准备一份补充要求样例 + 已下载模版可展示
- [ ] 提前跑通一遍：上传 → 解析完成 → 开始计算 → 有匹配结果
- [ ] 网络与后台 Worker 正常（解析依赖异步任务）
---
## 8. 建议演示脚本时间分配
| 时段 | 内容 | 时长 |
|------|------|------|
| 开场 | 痛点 + 两阶段模型 | 1 min |
| 上传扫描 | 选文件、看可导入 sheet | 2 min |
| 可选能力 | 手动映射 / 补充要求 / 定额库 | 2 min |
| 解析落表 | 确认 → 解析中 → 表格出现项目 | 1～2 min |
| 开始计算 | 状态流转 + 架构一句话 | 2～3 min |
| 结果与答疑 | 核对行 + FAQ | 2～3 min |
---
*文档依据当前产品路径：智慧预算 · 预算平铺表 ·「上传清单与补充要求」弹窗。若界面文案有迭代，以线上实际按钮为准。*
`)