Files
abaishu0730 5ceffb935a fix(assistant): close review gaps in delivery and action recovery
Address PR4 comments 66-69 with safe delivery retries, capacity stops, preserved effect evidence and stale proposal rejection. Prevent archived queue snapshots from resurrecting cancelled reminders.
2026-10-29 11:51:03 +08:00

217 lines
24 KiB
Markdown

# 订单通知中心使用指南
本指南对应当前工作台。前半部分是简短上手流程,后半部分按页面介绍功能、角色和操作边界。截图来自独立空白示例环境;`demo_admin` 是虚构账号,页面中的空列表不代表实际部署数据。
## 快速上手
1. 在部署机启动 `npm start` 或双击 `启动工具.cmd`,在部署机打开 `http://127.0.0.1:18766`。首次创建管理员账号;没有默认账号或密码,新密码至少 12 位。
2. 管理员在“系统设置 → 团队账号”创建同事账号并分配角色。登录地址可使用部署机局域网 IP;跨网段访问还要求网络路由、网间策略和 Windows 防火墙允许 TCP `18766`。
3. 先配置“BPM 连接”和“字段映射”目录,再导入或维护“分类通知规则”。根据实际业务核对流程、触发节点、收件人、模板和归档要求。
4. 在“工具 → 存储服务器”添加 SMB 目录并分别检查读取和写入权限;在“系统设置 → 邮箱管理”配置托管邮箱并检查连接。
5. 在“业务设置 → 通知配置”核对发送计划、业务日历、模板和发送设置。先用真实样本和受限环境完成核验;当前自动处理和自动邮件默认暂停,未通过现场检查前不要开启正式自动处理或发送。
6. 日常查看“业务首页”“订单中心”“邮件批次”和“异常待办”。结果不明的发信先核对邮箱服务器记录,不要直接重试。
更完整的部署、规则、字段目录和备份说明见[部署与维护](deployment.md)、[分类通知规则](order-rules-guide.md)、[业务配置](business-configuration.md)、[字段映射说明](field-mappings-guide.md)及[备份恢复](backup-restore-guide.md)。
## 导航与角色
侧栏分为业务首页、订单中心、邮件批次、工具、异常待办、业务设置和系统设置。工具内可切换流程到达记录、PDF 导出记录、DSH 助手和存储服务器;业务设置内可切换分类通知规则、字段映射及通知配置;系统设置内可切换 BPM 连接、邮箱管理、助手设置、系统健康、团队账号和操作记录。右上角可修改个人密码或退出登录。
- **管理员**:管理连接、账号和业务配置,可执行受权限门控的恢复、归档和邮件操作。
- **操作员**:查看其有权访问的业务数据并处理分配给自己的异常;不能管理系统配置或账号。
- **只读成员**:查看有权访问的页面和记录,不能提交配置或业务状态变更。
页面会根据角色隐藏或禁用操作。连接、订单和异常信息仍受负责人及数据授权范围限制。
## 页面功能
### 业务首页
![业务首页](images/user-guide/overview.png)
显示订单数量、受阻订单、结果待核实和未终结批次等概况;展示当前北京时间处理窗口、下一发送时点、自动处理/自动邮件开关,以及待验证的 BPM、PDF 和归档能力。业务阻塞区可跳转异常或原批次。首页是状态汇总,不会主动执行扫描、导出、归档或发信;“待验证”不代表接入失败,也不代表功能已通过现场验收。
### 订单中心
![订单中心](images/user-guide/notification-orders.png)
按订单号、标题、类别、来源连接、状态及北京时间接收日期筛选订单。详情可核对分类结果、受阻原因、采集证据、订单摘要、PDF/归档回执、所属邮件批次和关联异常。管理员及有权限的操作员可以发起“扫描并处理订单”;它读取授权待办并尝试采集和后续处理,但服务端会按 BPM、字段、PDF、存储和发送条件逐项阻断未就绪能力。BPM 节点的提交或结束始终由人工办理。
### 邮件批次
![邮件批次](images/user-guide/notification-batches.png)
切换待发送、已发送或全部,按订单/标识/主题、类别、来源连接、状态和时间窗口筛选。打开批次可查看收件人、冻结正文、HTML 预览、附件和关联订单。尚在收集且可编辑的批次,管理员可在截止前修改本批邮件内容;这不会改写模板。失败批次的人工补发和结果未知批次的人工核验仅向管理员开放。SMTP 接受不等于最终送达,结果未知时必须先查证,系统不会自动重发。
### 流程到达记录
![流程到达记录](images/user-guide/records.png)
查看 BPM 流程到达/扫描记录,可按当前或归档范围、订单或知会类型、连接、标题和日期筛选,并分页查看详情。这里是来源记录查询,不等同于订单资格认定;看到流程记录不表示已生成 PDF、归档或邮件批次。旧数据保留供追溯,不会因查看而自动补处理。
### PDF 导出记录
![PDF 导出记录](images/user-guide/records-pdf.png)
汇总查询手工导出任务和订单自动归档回执,可按订单号、项目、状态筛选并分页。下载前会复核当前文件可用性、访问权限和内容哈希;“已归档”表示存在持久回执,不保证文件此刻仍可访问。PDF 归档与邮件发送相互独立,PDF 不会自动作为邮件附件。
订单页在已登录的 BPM 订单页面上配合 Chrome 扩展,可以手工导出当前订单 PDF。扩展使用本机桥接服务;安装和版本要求见 [README](../README.md)。
### DSH 助手
![DSH 助手](images/user-guide/assistant.png)
助手采用 DSH 原生交互适配的三栏工作区:左侧搜索/切换个人会话,中间阅读回答和本轮过程,右侧查看概况、证据、操作及记录。输入区固定在中栏底部;手机通过“会话列表”和“上下文”按钮打开侧栏。顶部“返回工具”使用 SVG 返回图标,手机上也保留;与会话栏、右侧栏 SVG 控件统一为 40px 高度。右侧栏既可通过顶部图标切换,也可用栏内固定的收起按钮关闭。输入区附件、命令、模型及发送控件统一高度,长模型名完整换行。
每条会话右侧的 `⋯` 可归档、恢复或移至回收站;会话范围可切换活跃、已归档、回收站。回收站历史只读,支持恢复或经确认永久删除,没有自动清空。删除不会退回当日调用额度,独立操作审计及已延续到其他会话的上下文保留。回复/操作进行中需先停止回复或等待操作结束。继续新对话带入最近三轮上下文;父会话删除后子会话仍可继续。归档/回收站标题搜索覆盖最近 2000 个,超出时明确标注范围。
可直接描述连接、扫描或归档异常,也可输入 `/` 打开固定命令菜单。`/help` 展示帮助,`/status` 只刷新本机授权概况;`/bpm`、`/storage`、`/archive` 选择可见目标后填入诊断草稿,发送才调用模型。输入区模型控件与 `/model` 可按供应商选择管理员已启用的模型,下一轮生效;每轮回答旁显示实际使用的供应商/模型。移除或停用所选模型后须重新选择。模型目录会在短时间内复用,避免反复打开选择器时重复等待。运行包、供应商密钥和模型配置完整即可使用,无需启用总开关。发送按钮为圆形向上箭头,空输入时置灰;回复中显示停止方块。概况刷新不会自动检查外部连接,未知命令不会作为提示词发送。未配置模型时仍可查看授权概况。
过程按真实阶段推送,断线后补读,必要时回退轮询;首版回答在完整校验后显示,不逐字输出,也不展示模型内部思考。概况是最近观测,证据页是该轮实际使用的快照,两者时间和范围可能不同。停止只针对模型回复,确认进程退出前显示“正在停止”;操作中断或结果不明显示“待核验”。
点击回答下方“查看操作”可审查目标、影响和操作编号,再点执行。允许的动作仍由管理员及工作台权限限定;断线、刷新、重新诊断都不会自动执行或重放旧操作。管理员代码修复入口在右栏“记录 → 提出代码修复”,先展示修改前后,测试通过后仍待审查。操作与结果保留审计。
助手不是 BPM 自动办理入口,也不能替代业务核验。不要向对话输入密码、Cookie、完整业务表单或不必要的客户信息。
### 存储服务器
![存储服务器](images/user-guide/storage.png)
管理员维护 SMB 服务器、共享目录和访问方式,可浏览共享目录、检查读取连接、检查写入权限,并查看归档配置与归档记录。可使用部署机 Windows 权限或明确指定凭据;凭据由工作台加密保存。检查连接不会保存草稿配置,写入检查会创建并清理探测文件。保存配置不等于自动归档已可用;启用前要确认目录、权限、文件命名和真实归档结果。
### 异常待办
![异常待办](images/user-guide/exceptions.png)
集中记录需要团队跟进的问题,可搜索标题/说明/负责人并按状态过滤。操作员可认领未分配异常、处理自己负责的事项、转交、提交核验、填写核验结果后关闭或重新打开;管理员可管理全部异常。每次状态变化都保留操作人、时间和说明。关闭异常只改变跟踪状态,不会改写邮件发送结果或重新执行订单。
### 分类通知规则
![分类通知规则](images/user-guide/order-rules.png)
以 Excel 类别维护精确的流程与触发节点配对,以及类别通知内容、To/Cc、模板、归档位置和验证状态。可搜索类别、导入规则文件、下载当前规则。导入先预览错误和变更,再一次性确认;错误行或并发版本变化会阻止整次提交。保存产生草稿,不会覆盖当前发布版本;真实待办样本检查通过且依赖完整后,管理员才可发布。字段目录须先在字段映射页采集。更新字段映射后,相关类别可能暂停并要求重新检查发布。
第04步先点击“读取已采集订单”,再选择样本并检查识别结果;它只读取已有采集记录,不会重新采集 BPM。刷新规则后如需验证,请重新读取样本。
本页检查一个真实样本不等于全部类别和表单版本都已验收。当前整体自动通知仍按首页及发送设置显示为暂停/待核验;不要把规则存在或发布描述成完整业务闭环。
### 字段映射
![字段映射](images/user-guide/rule-fields.png)
维护 BPM 实际采集到的流程和触发节点目录,供分类通知规则选择。管理员选择授权 BPM 连接后,可只读更新目录、搜索已采集流程/节点,并控制自动采集。此页当前重点是流程/节点目录和已有证据,并不是旧版任意编辑业务字段路径的页面;Excel 导入不会改目录,未知流程/节点需要先核对真实 BPM 采集结果。采集只读,不打开订单详情、不办理 BPM、不创建邮件。
目录有名称不表示对应流程字段、PDF、归档或通知都已核验。字段映射的历史设计和状态细节见[字段映射说明](field-mappings-guide.md)。
### 发送计划
![发送计划](images/user-guide/schedule.png)
管理员设置每天两个北京时间发送时点及周末是否按工作日处理。此配置决定计划窗口,不会立即发送邮件,也不会覆盖业务日历中的某日停发或调休安排。保存后由首页和批次页展示下一发送时点。
### 业务日历
![业务日历](images/user-guide/calendar.png)
按月查看公司工作日、休息日和暂停日;选择日期后可设置该日是否采集、是否发送及备注,并覆盖每周默认安排。采集和发送是分别控制的;暂停日不执行这两项计划。修改先作为页面草稿,保存后才对团队生效;每周默认时段仍在发送计划维护。
### 邮件模板
![邮件模板](images/user-guide/templates.png)
管理员可新建、编辑纯文本或 HTML 模板,预览内容并维护版本。托管邮箱也可按允许发件人名单接收模板邮件;导入后须在模板列表预览并确认生效。正文支持明确列出的订单、产品线、日期、明细和存放地址等变量;不执行模板表达式,HTML 预览会隔离脚本和远程资源。模板只定义内容,类别关联和收件人在分类通知规则维护;新模板不会自动替换正在使用的规则版本。
### 发送设置
![发送设置](images/user-guide/notification-settings.png)
管理员可分别查看/维护订单自动处理和分类邮件自动发送开关、发件邮箱及单封容量上限。两个开关相互独立;邮件启用还要求邮箱、类别和归档条件通过服务端校验。若当前存在受限稳定性测试,页面会显示其固定收件箱、归档位置、测试基线和到期信息;测试状态不是正式生产配置。保存开关不会代替真实收件、归档和 SMTP 验证。
### BPM 连接
![BPM 连接](images/user-guide/bpm.png)
管理员创建连接并指定负责人,打开受控登录窗口完成 BPM 登录,检查并保存会话;可查看连接状态、重新验证、重启会话或停用连接。BPM 会话和托管账号由部署机本地加密保存,连接负责人或管理员按权限操作。连接可用只证明相应登录/检查状态,不证明所有流程、字段、待办和通知接入均已核验。
### 邮箱管理
![邮箱管理](images/user-guide/mail.png)
维护托管 SMTP/IMAP 邮箱、连接检查、模板收信开关、允许提交模板的发件人和收信历史。连接检查只验证服务端连通性,不发送邮件;模板收信是只读读取,不会标记已读、移动或删除邮件。也可添加 IMAP 配置只读查询已发送邮件夹,查看正文、收件信息和附件名称。模板测试邮件明确发送到托管邮箱自身,业务群组邮件由独立批次控制。授权码只在工作台输入,不写入说明、命令或助手对话。
管理员可以让助手读取必要的邮箱参数、发送计划、调用额度和默认模型信息,右侧概况可查看实际提供的配置;密码、授权码、API 密钥和运行包路径不提供给模型。要求修改时,助手先生成建议卡片;点击“审查修改”查看逐字段修改前后和服务端风险说明,勾选风险确认后点击“授权并保存”。取消不保存,“拒绝本次修改”会保留拒绝记录。授权仅绑定本次建议及当前登录会话,配置变化、建议过期、权限变化后不能继续执行;结果待核实时请到原设置页核对,不能自动重试。
首轮支持既有邮箱名称、IMAP/模板收信开关、模板发件人名单、SMTP/IMAP 端口和加密方式;支持发送计划和助手超时/额度/默认模型。更换账号、服务器、凭据或权限,请在原设置页操作。设置保存不会立即发信;收信或发信等额外动作须在原页面单独授权。
附件:输入区的内联 SVG 回形针支持文本、日志、CSV、代码、PDF;视觉模型另支持 PNG、JPEG。文件先在本机解析,可预览或移除,点击发送才将脱敏正文交给所选模型;也可只发送附件。同一对话可以继续追问,新对话需重新添加。每条最多 3 个文件,每个 2 MB/20000 字,合计 40000 字;PDF 最多 50 页,仅提取文字,扫描图片或密码保护文件须先在本机处理。待发送附件加密暂存,有效期 1 小时;发送后正文随加密会话保留;图片经类型/尺寸校验、去除元数据和最长边 1600 像素规范化后加密保存,历史接口仅返回图片元数据,查看图片须验证当前用户及所属会话。永久删除会话时清理所属图片。文件内指令不是执行授权。
底部模型名完整换行显示;只为已确认支持图像输入的模型标记“视觉”,其他模型不显示能力文案。模型设置每行第 5 项可按供应商资料填写 `text` 或 `text,image`;不根据模型名称推测能力。视觉模型还可上传 PNG、JPEG,图片会作为各协议的原生图像内容块发送;未声明或未验证视觉能力的模型会在发送前拦截图片,保留草稿。文本和 PDF 文字不要求视觉能力。切换到非视觉模型后,历史图片不发送,并向模型说明仅使用文字。向上阅读历史消息时,会显示圆形向下箭头,点击回到最新消息。
### 助手设置
![助手设置](images/user-guide/assistant-settings.png)
助手设置包含“模型供应商”“默认模型”“运行与权限”。管理员可添加 DeepSeek、OpenAI、Anthropic 或自定义兼容 API,独立维护地址、协议、密钥和模型列表,设置默认模型,编辑/停用/删除供应商。支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages。模型列表每行可填 `模型 ID | 显示名 | 上下文窗口 | 最大输出 | 输入能力`,后面四项可省略;获取目录只填入草稿,检查并保存后生效。旧单模型配置会迁成 DeepSeek 供应商,保留原地址、模型和密钥。
已保存的密钥不读回输入框,留空保留;更换协议或地址需重填。供应商编辑有未保存确认,保存/获取目录期间锁定字段,避免迟到结果覆盖新输入。运行包、超时、调用上限和受控操作权限单独保存;其他成员可在自己的会话选择可用模型,不能维护供应商。
连接或密钥配置须在部署机本地或可信 HTTPS 环境维护;密钥由本地安全存储管理。打开设置页不会调用模型;保存完整配置后即可对话,无需另行启用。调用使用当轮启动时的配置,不因后续切换改变正在回复的模型;目录获取也不等同真实模型调用验证。
### 系统健康
![系统健康](images/user-guide/health.png)
查看工作台进程、独立守护/自启动、BPM 连接与同步、到达扫描、存储、邮件和其他模块的最近检查结果;“刷新健康状态”刷新工作台提供的状态快照。页面以最近已知状态为主,不会替代对 BPM、SMB 或 SMTP 的实时连通性测试。需要实际验证时,进入对应连接页面执行相应检查。
### 团队账号
![团队账号](images/user-guide/users.png)
管理员创建同事账号、分配管理员/操作员/只读成员角色、启用或停用账号,并维护负责连接和异常的交接关系。管理员可重置其他成员密码、撤销其登录;重置会使该账号旧会话失效。管理员不能在此重置自己的密码,请使用右上角“修改密码”。初始密码应通过受控渠道告知本人,并由本人修改。
### 操作记录
![操作记录](images/user-guide/audit.png)
按北京时间查看最近操作的时间、操作人、动作和详情,汇总工作台配置与业务操作记录,最多展示最近 200 条。记录用于追溯,不显示密码或密码哈希;它不是外部系统的完整日志,也不能单独证明邮件最终送达或文件仍存在。
### 个人账号
![个人账号](images/user-guide/account.png)
所有角色都可从右上角修改本人密码。需要输入当前密码和两次一致的新密码;新密码为 12–128 位,且不能与原密码相同。修改成功后此账号的其他登录会话失效,需用新密码重新登录。个人页面不会修改角色或其他成员账号。
## 安全与处理边界
- Web 工作台默认监听 `0.0.0.0:18766`;扩展桥接只监听本机 `127.0.0.1:18765`。局域网和跨网段访问还取决于主机防火墙、路由与网络 ACL。
- 数据和密钥保存在部署机本地运行状态目录,不随 Git 仓库或源码克隆复制。仓库不应提交 `config.json`、数据库、邮箱凭据、BPM 会话、业务 PDF 或运行输出。
- 本工具可读 BPM 待办,但 BPM 节点提交/结束仍由人工办理。查看历史、保存草稿、连接成功或单样本检查通过都不代表真实订单闭环已经完成。
- PDF 归档与邮件发送独立。结果未知先查明外部系统状态,再由有权限的管理员作出处理;系统不会对结果未知的发信自动重试。
- 正式自动处理和自动通知只有在真实流程、字段、存储、邮箱和发送结果完成现场核验后才可评估启用。当前状态以工作台显示和管理员配置为准。
### DSH 原生定时任务
在助手左侧点击“定时任务”打开独立管理页,汇总本人各会话的任务。可按任务名称、内容、所属会话搜索,按进行中/已结束筛选;每项任务提供“查看详情”“编辑”“删除”,新建时选择所属会话。右侧“任务”仍显示当前会话,可通过“管理全部任务”进入管理页。返回对话会保留未发送草稿。列表读取失败会保留上次结果并停用修改入口,刷新成功后恢复。支持延时一次、指定时间、固定间隔、每天、每周、五字段 Cron;时间规则由已安装的官方 DSH ScheduleService 解释。周期任务使用显式 IANA 时区,默认 Asia/Shanghai,指定时间初始使用浏览器所在时区。固定间隔至少 60 秒。
保存前确认任务内容、时间和调用风险。到点使用原会话的模型选择、历史及附件上下文,消耗调用额度并可能产生模型费用;关闭网页不会取消任务,部署机服务需要运行。原生投递和实际模型回复分别记录,“已回复”仅表示这次模型调用完成,不代表邮件或配置操作已执行。AI 也可提出任务管理卡,必须逐次审查差异、风险并授权。
每个会话最多 30 个活跃任务;账号停用、权限撤销、配额不足或配置不可用会阻断调用。原会话归档、继续新对话或移入回收站会停止原会话未来任务,恢复会话不会重建这些任务。删除任务停止未来触发,已投递消息保留。保存结果未知时先刷新任务列表核实,避免重复创建。
采样操作的结果详情会明确显示成功、受阻、缺少样本等数据;0/0 且仍缺少流程样本表示“未采集到样本”,不能当作补采成功。老记录没有保存明细时会提示到原功能页核验。
### AI 管理查询与权限边界
在助手右侧“概况”点击“AI 管理权限”,可查看当前角色允许查询的19类管理资源、服务是否就绪、配置修改字段及人工操作边界。聊天中可要求AI按资源查询,工作台会重新核验当前账号状态和数据归属,再把脱敏分页结果提供给模型。每轮最多2次查询往返、每次最多3个资源、每页最多20项;实际发生的每次模型调用均计入全局日额度。
配置建议涵盖邮箱安全字段、发送计划、助手额度和超时、新对话默认模型、单日业务日历,以及分类规则的收件人草稿。管理员须审查最终差异和风险,再逐次授权。日历仅修改一个日期;收件人仅保存一条真实分类规则的草稿并重置试运行验证,正式发布、发信和业务执行仍需人工处理。旧群组写入口不通过AI恢复。
成员与角色、凭据和登录会话、实际发信或补发、BPM节点提交、正式规则发布、任意Shell/插件/MCP/主机配置划入人工边界。只读成员没有修改权限;其他成员的连接、订单、批次和定时任务不会因AI查询而越权可见。扫描/归档查询目前分别仅覆盖最近30/100条,并返回范围标识;未查到不能证明更早记录不存在。回答仍为所标时间的快照,不等于实时系统状态。
### 定时消息恢复与容量停止
未创建调用轮次的定时消息会显示“尚未调用”,可以在任务管理页或会话右侧任务面板点击“重试未调用消息”。需要明确确认并选择本人目标会话;工作台会重新校验当前权限、消息状态和请求标识。已有调用记录、结果未知、已取消或已完成的消息不提供安全重试,不会自动重放。
会话剩余10轮起提示容量。达到100轮时,原生未来计时会停止,管理页显示“容量已满,已停止”,保留规则和未调用消息。可以确认把未调用消息转到本人其他会话,使用目标会话的模型和历史;旧附件不会自动迁移。未来周期任务须在新会话重新安排,本次消息重试不会自动复制或恢复周期规则。
操作建议即使过期、配置版本变化或操作开关关闭,原有权限范围内的所属用户仍可直接“拒绝建议”,无需先取得执行授权。已经执行或结果待核实的卡片不能用拒绝操作改变结果。固定操作已开始后,记录失败会显示“待核实”并保留已返回证据,请到原功能页核验,不要重复执行。