1. 产品概述
工艺报价智能体-PQA（PQA） 面向机加报价与工艺编制场景： 上传零件图纸后，自动完成 特征识别 → 工艺编排 → 工时与费用核算，并支持在 Web 界面中核对、修正与导出报价。
上传 STEP / DWG→
特征识别（PMI）→
工艺策略编排→
工时 / 材料费 / 加工费→
导出报价 Excel
适合谁用
- 操作员：日常上传图纸、核对材料与工艺、导出报价
- 工艺/成本管理员：维护设备库、刀具库、工艺策略与工时方案
- 系统管理员：用户角色、应用品牌、AI 大模型与日志
2. 登录与账号
打开系统后进入登录页，界面中央为登录卡片，顶部为品牌 Logo 与产品名称。
登录要点
- 支持勾选 记住密码（保存在浏览器本地，仅限当前终端）。
- 后台新建账号的默认密码为
12345678。 - 若策略要求「首次登录强制改密」，会进入 首次登录请修改密码 面板：填写原密码、新密码、确认新密码，点击 修改密码并进入系统。
- 密码策略默认：至少 8 位，同时包含字母、数字和符号（可在系统管理 · 用户管理 · 密码策略中调整）。
进入系统后的账户区
顶栏右侧显示「你好，显示名」，提供：
- 个人信息：修改显示名称、修改登录密码
- 退出登录：结束会话并返回登录页
3. 界面总览
主界面采用深色工业风布局，与登录页视觉一致。整体分为：顶栏、左侧栏、主工作区、左下角版本号与右下角 AI 助手。
| 区域 | 界面元素 | 说明 |
|---|---|---|
| 顶栏 | Logo、标题、副标题、三大导航、账户区 | Logo / 标题 / 副标题可在「系统管理 · 应用配置」自定义 |
| 左侧栏 | 随顶栏变化；右侧有 ‹ 收起按钮 | 工作台下列出工作包；配置下列出七大库菜单 |
| 主工作区 | 各功能视图 | 未选工作包时提示「请选择左侧的工作包，或新建一个工作包开始。」 |
| 左下角 | 版本号胶囊 | 若前端与服务端版本不一致，版本号会变为琥珀色并提示刷新 |
| 右下角 | AI 助手悬浮按钮 | 自然语言查询规则、导入策略等（受权限与大模型配置影响） |
顶栏三大模块
| 顶栏 | 侧栏内容 | 典型用户 |
|---|---|---|
| 工作台 | + 新建工作包、我的工作包列表 | 日常报价操作 |
| 基础配置 | 设备库、工艺库、刀具库、材料库、工艺策略、工时策略、报价策略 | 工艺 / 成本管理员 |
| 系统管理 | 用户、角色、应用配置、AI 大模型、日志、任务计时 | 系统管理员 |
无相应菜单权限时，顶栏按钮会自动隐藏，这是正常现象。
4. 工作台
工作台是日常使用的核心：管理项目（工作包）、上传图纸、查看识别与报价结果、修正材料/数量并导出 Excel。
4.1 工作包
- 点击侧栏 + 新建工作包。
- 在弹窗中填写：
- 项目号（选填）、订单号（选填）
- 工作包名称（必填）
- 描述（选填）
- 保存后，在「我的工作包」列表中点击该项进入主区。
删除工作包会清除其下全部零件与识别结果，请谨慎操作。列表项通常提供编辑 / 删除入口。
4.2 图纸上传
选中工作包后，主区上方为可收起的 图纸上传 卡片（见图 2 上方虚线拖放区）。
| 项目 | 说明 |
|---|---|
| 支持格式 | .step / .stp（3D）、.dwg / .dxf / .pdf（2D）、以及 .json |
| 同名归并 | 同名的 2D 与 3D 图纸会自动归为同一零件 |
| 主按钮 | 上传并解析计算：上传后依次执行识别、编排、成本核算 |
| 清空待传 | 仅清除尚未上传的待选文件列表 |
| 进度提示 | 表格上方浮动进度条，阶段包括：图纸上传 → 图纸解析 → 工艺编排 → 成本核算；可点 全部停止 |
4.3 零件汇总表
筛选栏
表上方可按 零件图号 / 零件类型 / 材料 / 表面处理 / 热处理 筛选，并提供 清空筛选。零件类型、材料、表面处理支持下拉多选（材料面板内可搜索过滤候选项）。
工具栏（批量与显示）
| 控件 | 作用 |
|---|---|
| 批量删除 | 删除选中零件的上传图纸及相关解析结果（不可恢复） |
| 重新解析计算 | 对选中零件重跑识别 + 编排 + 计价 |
| 重新编排计算 | 不重解析图纸，只按当前策略重编排并计价 |
| 重新计算 | 主要重算工时与费用（不重跑图纸识别） |
| 工艺路线格式 | 「工艺代码+工艺名」/「仅工艺代码」/「仅工艺名」 |
| 加工策略 | 效率最优 / 品质最优 / 两者兼具（与「进给量调节表」联动，切换后会重新计价） |
| 导出报价 | 下载 {工作包名}_报价明细.xlsx（按当前可见列） |
| 显示缩略图 | 勾选后加载预览图；零件很多时可能略慢 |
| 列设置（网格图标） | 勾选显示列、拖拽排序、固定到左侧；默认隐藏：表面积、开料尺寸、材料重量 |
默认列说明
| 列 | 交互与含义 |
|---|---|
| 选择 / # | 批量勾选、行号 |
| 零件图号 | 显示 3D 2D / JSON 徽标；有权限时可点击 3D/2D 打开查看器；问题行左侧彩色竖条 |
| 缩略图 | 开启后可点击打开 2D/3D 查看器 |
| 零件类型 / 外包络 | 识别得到的类型与外形尺寸 |
| 材料 | 双击编辑，支持材料库联想；可见材料状态标签 |
| 数量 | 双击编辑（1–99999），一般仅已完成零件可改 |
| 热处理 / 公差 / 表面处理 | 工艺属性摘要 |
| 工艺路线 | 可点击查看路线详情 |
| 材料费 / 加工工时 / 加工费 | 单击打开明细弹窗；有问题时带警告标 |
| 操作 | 详情 / 重新计算 / 删除 |
零件表与工具栏的真实布局见图 2；筛选栏、批量按钮、问题过滤、「导出报价」与费用列均在同一卡片内。
4.4 问题过滤与材料标签
工具栏右侧五个问题过滤按钮用于快速定位异常行（可再次点击取消过滤）：
| 按钮 | 筛选范围 |
|---|---|
| 解析问题 | 2D/3D 图纸解析存在问题的零件 |
| 材料问题 | 材料为未知 / 待补充 / 待确认 |
| 工艺编排问题 | 编排失败、未匹配或需人工确认 |
| 工时计算问题 | 加工工时测算存在问题项（缺刀/未命中策略等）或计算失败 |
| 费用计算问题 | 材料费或加工费缺失、警告或计算失败 |
材料列标签含义
| 标签 | 含义 | 建议操作 |
|---|---|---|
| 未知材料 | 图纸未识别到有效材料 | 双击材料列，从材料库选择正确牌号 |
| 待补充 | 图纸上的材料在材料库中不存在，等待 AI 补全 | 等待顶部浮动「AI正在获取待补充材料…」完成，或手动录入材料库后再选 |
| 待确认 | AI 已补全材料信息，需人工确认 | 在弹窗中核对单价等 → 确认并计算（或 稍后处理） |
零件图号列左侧色条快速提示：红=综合问题，
紫=未知材料，青=待确认材料。
4.5 零件详情与费用弹窗
零件详情（操作列 · 详情）
- 展示零件元数据：图号、类型、外形、厚度、材料、数量、开料、表面积、重量、热处理、公差、表面处理等
- 查看 2D / 3D 图：打开嵌入式特征查看器
- 整零件加工工艺路线：工艺库未匹配段落会以红色提示；可能出现「待人工确认」横幅
- 详细编排过程：按特征组展示匹配状态徽章（已匹配规则 / 放宽公差需复核 / 并入去毛刺 / 未匹配需复核等）
- 可 下载工艺报告(.txt)
费用类弹窗（单击费用或工时单元格）
| 弹窗 | 主要内容 |
|---|---|
| 材料费明细 | 开料体积 × 密度 → 重量 × 单价 的构成 |
| 加工工时详情 | 分阶段切削/辅助工时；特征组问题导航 |
| 加工费明细 | 基础加工费、阶梯报价档位、最终加工费 |
| 工艺路线详情 | 整条路线展开查看 |
4.6 导出报价
- 确认工作包内零件状态正常（材料已确认、费用无红色警告）。
- 按需调整「列设置」与「工艺路线格式」。
- 点击 导出报价，浏览器下载
{工作包名}_报价明细.xlsx。
5. 基础配置
顶栏切换至 基础配置 后，左侧列出七个维护入口。无维护权限时按钮可能只读或隐藏。
5.1 设备库、工艺库、刀具库、材料库
设备库
- 搜索：设备名称 / 编码 / 说明
- + 新增设备：编码、名称、子类型、单价、物理边界长宽高、精度（常规/极限）、说明
- 列表操作：编辑 / 删除
工艺库
- 可由设备库编码与名称初始化；字段含工艺名称、工艺类别、策略关键词、用途、工艺代码
- 工具：同步设备编码、+ 新增工艺
- 行操作：复制 / 编辑 / 删除
刀具库 / 刀具仓库
- 刀具库管理：按分类展开规格；字段含直径、R 角、螺距、底孔、长度、刃长、柄径、转速、进给、切深、启用等
- 入口：+ 新增刀具、刀具仓库
- 刀具仓库：导入 Excel 工作簿、查看按类型划分的表结构、维护 刀具名映射表（可双击改俗称/模糊叫法），然后 返回刀具库
- 转速、进给、切深等参数会被切削策略 / 计算去除率方案读取
材料库
- 维护：类别、名称、别名、加工属性（磁性/线切割/电火花等）、加工系数、密度、单价、精料单价、说明
- 工具：类别筛选、开料规则 中心、+ 新增材料
- 开料规则：名称、优先级、状态、描述、版本；用于生成开料尺寸与材料重量
5.2 工艺策略
标题示意：工艺策略表（从特征到加工工艺）。含两个 Tab：
- 工艺策略表：按零件类型、加工特征、外形、厚度、热处理、尺寸与公差范围等匹配到「加工方法」
- 工艺路线标准：常规工艺顺序相关配置
工具栏常见操作：检索、刷新、分页、+ 新增工艺策略、特征映射。
统计徽标通常区分：系统内置 / 用户自定义 / 待确认（导入批次需确认后才生效）。
特征映射弹窗用于维护「加工特征 ↔ 几何特征」对应关系，支持同步工艺策略特征、导入/导出 Excel、PMI 覆盖检查，
并可从
pmi-feature-ref.html 参考表选择特征。
5.3 工时策略
页顶先选择 工时计算方案（影响全系统工时核算口径）：
| 方案 | 界面说明 | 注意 |
|---|---|---|
| 设置去除率 | 准确度一般 | 使用「设置去除率」表中的效率与辅助参数 |
| 计算去除率 | 准确度较高 | 结合选刀/选规/切削策略与刀具参数推算；可出现 辅助工时设置 |
| 历史数据学习 | 准确度最高 | 界面标注「算法待接入」，暂不可作为生产口径 |
子页签
| 页签 | 做什么 |
|---|---|
| 选刀策略 |
选型策略：按加工类型/特征/阶段推荐刀具类型，支持从「可插入刀具类型」拖拽插入，双击编辑；可 同步刀具库表名。 选规策略：刀直径规则、刃长规则；可 同步切削策略。 |
| 切削策略 | 策略号、加工类型、特征名、加工阶段，以及进刀比 / 轴向切深 / 余量（双击编辑）。支持新增、导入 Excel、下载模板、导出。 |
| 进给量（F）调节表 | 范围调整系数（约 80–120%）；选择策略与工作台「加工策略」一致：效率最优 / 品质最优 / 两者兼具；支持特征覆盖检查（拖入未覆盖特征或按加工类型添加）；可导入 Excel。 |
| 设置去除率 | 材料去除效率、编程/装夹/换刀/对刀、每特征辅助、系数、关联工艺代码；可 恢复默认。 |
| 工时测算测试 | 指定材料、加工类型、特征、工艺与参数后 执行测算 或 按完整工艺链测算，核对选刀命中、切削参数、去除率与工时（需相应权限）。 |
切换「计算去除率」时系统依赖刀具库参数与选刀/选规是否命中。工作台加工工时明细若提示缺少刀具、未命中选规或切削策略，请优先检查本页相关表，而不是只改报价系数。
5.4 报价策略
| 页签 | 内容 |
|---|---|
| 工艺成本核算策略 | 按工艺代码维护核算方式、单价、单位、系数、说明。支持搜索、新增、同步工艺库、导入/导出 Excel、下载模板。 |
| 报价参数与阶梯报价 | 税费(%)、管理费(%)、物流费(元)；自定义参数；按数量区间设置阶梯系数（档位名、最小/最大数量、报价系数）。完成后点 保存报价策略（或放弃修改）。 |
6. 系统管理
| 菜单 | 功能摘要 |
|---|---|
| 用户管理 | 创建用户（默认密码 12345678，默认可设有效期）；编辑 / 分享 / 重置密码 / 启用·禁用 / 删除；进入 密码策略 |
| 角色权限 | 为角色勾选菜单与按钮权限。内置角色见第 9 章 |
| 应用配置 | 应用名称、Logo 文字或图片、副标题；展示只读版本与产品代号 |
| AI大模型设置 | 启用对话、材料自动获取；厂商、Base URL、模型、API Key、Temperature、超时；保存 AI 大模型设置 |
| 登录日志 | 账号、显示名称、登录时间 |
| 操作日志 | 图纸上传与解析等相关操作记录 |
| 任务计时 | 每次上传解析总耗时，以及零件级上传/解析/编排/报价分段耗时 |
7. AI 助手
主界面右下角悬浮 AI 助手。在配置好大模型且具备相应权限时，可用自然语言完成例如：
- 查询 / 新增 / 修改工艺策略规则
- 查询材料、设备、工艺库
- 查看工作包与零件状态、缺口统计
- 导入 Excel 模板、查看规则、导入成本策略等面板工具
助手能力与 REST/CLI 共用同一套系统 action，详细清单见 docs/ai-actions.md。无权限的操作会被拒绝。
8. 特征查看器与其它页面
| 页面 | 用途 |
|---|---|
viewer.html |
零件加工特征可视化：3D/2D、特征树 / 工艺树、高亮选中特征。工作台「查看 2D/3D」以弹窗 iframe 方式嵌入；嵌入时可隐藏独立上传/配置区。 |
pmi-feature-ref.html |
PMI 几何特征参考表（名称/代码/大类），支持搜索与刷新，供特征映射选择。 |
login.html |
登录与首次改密。 |
查看器弹窗常见控件：关闭、重置视角、线框显示等（以实现版为准）。需要 特征查看 权限，否则会提示无权查看。
9. 角色与权限
内置角色
| 角色 | 默认能力 |
|---|---|
| 超级管理员 | 全部菜单与按钮权限；账号不可禁用/删除 |
| 操作员 | 工作台相关：新建工作包、上传、解析、编排、删除、特征查看；默认无基础配置与系统管理 |
常用权限（界面中文名）
| 权限名 | 影响的界面 |
|---|---|
| 工作台 | 进入工作台、导出报价 |
| 新建工作包 / 上传图纸 / 重新解析 / 重新编排计算 / 删除零件 | 侧栏新建与工作台对应按钮 |
| 特征查看 / 一键检测 | 详情查看器相关能力 |
| 测试·临时工艺策略表 | 工艺路线详情中的零件级预筛候选表（测试专用，默认收缩） |
| 每类特征工时明细 | 加工工时详情中按特征组展开的工时明细与问题跳转 |
| 基础配置 + 各库维护 | 基础配置侧栏与增删改、导入导出 |
| 工艺策略表 / 工艺策略维护 / 特征映射表 / 特征映射维护 | 工艺策略与特征映射 |
| 工时策略 / 切削策略表维护 / 进给量表维护 / 加工工时测算测试 | 工时策略各 Tab |
| 报价策略 / 报价策略维护 | 报价策略页 |
| 用户管理 / 角色权限 / 应用配置 / 日志查看 / 任务计时查看 | 系统管理各页 |
10. 推荐端到端流程
- 登录 → 如需则修改默认密码。
- （管理员）在 基础配置 确认材料库、刀具库、工艺策略、工时方案与报价策略已就绪；在 系统管理 配置 AI（如需材料自动补全）。
- 进入 工作台 → + 新建工作包 → 选中该包。
- 拖入同名 STEP + DWG（或单文件）→ 上传并解析计算 → 观察浮动进度直至完成。
- 若弹出 确认 AI 补全的材料：核对后 确认并计算。
- 用「材料问题 / 工艺编排问题 / 工时计算问题 / 费用计算问题」过滤异常；双击修正材料与数量；点开工时/费用明细核对。
- 需要看结构特征时：操作列 详情 或缩略图 → 查看 2D / 3D 图。
- 按需切换「加工策略」（效率/品质/兼具），待重新计价完成。
- 点击 导出报价 得到 Excel。
登录→
新建工作包→
上传并解析→
确认材料→
核对工时费用→
导出报价
11. 常见问题
Q：顶栏看不到「基础配置」或「系统管理」？
当前账号角色没有对应菜单权限。请联系超级管理员在「角色权限」中勾选，或使用管理员账号。
Q：材料列显示「待补充」或顶部一直「AI正在获取…」？
检查「AI大模型设置」是否启用材料自动获取且 Key/模型可用；也可在材料库手工新增该牌号后，回到工作台双击材料列改选。
Q：加工工时或加工费为「-」或带警告？
点击单元格打开明细，查看是材料未确认、工艺未匹配，还是工时策略未命中（选刀/选规/切削策略/刀具参数）。可按第 5.3 节排查。
Q：「重新解析」和「重新编排」「重新计算」有何区别？
- 重新解析计算：图纸识别重跑，最完整也最耗时
- 重新编排计算：沿用已有特征结果，只按当前工艺策略重排
- 重新计算：侧重费用/工时重算（策略或材料变更后常用）
Q：切换「加工策略」后数字变了？
正常。工作台的效率/品质/兼具与「进给量（F）调节表」联动，会影响进给与工时，从而改变加工费。
Q：左下角版本号变成琥珀色？
表示前端静态资源与服务端版本可能不一致，建议强制刷新浏览器（或清理缓存后重新打开）。
在线帮助：/help.html ·
截图目录：/manual-images/