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.
217 lines
24 KiB
Markdown
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 连接、邮箱管理、助手设置、系统健康、团队账号和操作记录。右上角可修改个人密码或退出登录。
|
|
|
|
- **管理员**:管理连接、账号和业务配置,可执行受权限门控的恢复、归档和邮件操作。
|
|
- **操作员**:查看其有权访问的业务数据并处理分配给自己的异常;不能管理系统配置或账号。
|
|
- **只读成员**:查看有权访问的页面和记录,不能提交配置或业务状态变更。
|
|
|
|
页面会根据角色隐藏或禁用操作。连接、订单和异常信息仍受负责人及数据授权范围限制。
|
|
|
|
## 页面功能
|
|
|
|
### 业务首页
|
|
|
|

|
|
|
|
显示订单数量、受阻订单、结果待核实和未终结批次等概况;展示当前北京时间处理窗口、下一发送时点、自动处理/自动邮件开关,以及待验证的 BPM、PDF 和归档能力。业务阻塞区可跳转异常或原批次。首页是状态汇总,不会主动执行扫描、导出、归档或发信;“待验证”不代表接入失败,也不代表功能已通过现场验收。
|
|
|
|
### 订单中心
|
|
|
|

|
|
|
|
按订单号、标题、类别、来源连接、状态及北京时间接收日期筛选订单。详情可核对分类结果、受阻原因、采集证据、订单摘要、PDF/归档回执、所属邮件批次和关联异常。管理员及有权限的操作员可以发起“扫描并处理订单”;它读取授权待办并尝试采集和后续处理,但服务端会按 BPM、字段、PDF、存储和发送条件逐项阻断未就绪能力。BPM 节点的提交或结束始终由人工办理。
|
|
|
|
### 邮件批次
|
|
|
|

|
|
|
|
切换待发送、已发送或全部,按订单/标识/主题、类别、来源连接、状态和时间窗口筛选。打开批次可查看收件人、冻结正文、HTML 预览、附件和关联订单。尚在收集且可编辑的批次,管理员可在截止前修改本批邮件内容;这不会改写模板。失败批次的人工补发和结果未知批次的人工核验仅向管理员开放。SMTP 接受不等于最终送达,结果未知时必须先查证,系统不会自动重发。
|
|
|
|
### 流程到达记录
|
|
|
|

|
|
|
|
查看 BPM 流程到达/扫描记录,可按当前或归档范围、订单或知会类型、连接、标题和日期筛选,并分页查看详情。这里是来源记录查询,不等同于订单资格认定;看到流程记录不表示已生成 PDF、归档或邮件批次。旧数据保留供追溯,不会因查看而自动补处理。
|
|
|
|
### PDF 导出记录
|
|
|
|

|
|
|
|
汇总查询手工导出任务和订单自动归档回执,可按订单号、项目、状态筛选并分页。下载前会复核当前文件可用性、访问权限和内容哈希;“已归档”表示存在持久回执,不保证文件此刻仍可访问。PDF 归档与邮件发送相互独立,PDF 不会自动作为邮件附件。
|
|
|
|
订单页在已登录的 BPM 订单页面上配合 Chrome 扩展,可以手工导出当前订单 PDF。扩展使用本机桥接服务;安装和版本要求见 [README](../README.md)。
|
|
|
|
### DSH 助手
|
|
|
|

|
|
|
|
助手采用 DSH 原生交互适配的三栏工作区:左侧搜索/切换个人会话,中间阅读回答和本轮过程,右侧查看概况、证据、操作及记录。输入区固定在中栏底部;手机通过“会话列表”和“上下文”按钮打开侧栏。顶部“返回工具”使用 SVG 返回图标,手机上也保留;与会话栏、右侧栏 SVG 控件统一为 40px 高度。右侧栏既可通过顶部图标切换,也可用栏内固定的收起按钮关闭。输入区附件、命令、模型及发送控件统一高度,长模型名完整换行。
|
|
|
|
每条会话右侧的 `⋯` 可归档、恢复或移至回收站;会话范围可切换活跃、已归档、回收站。回收站历史只读,支持恢复或经确认永久删除,没有自动清空。删除不会退回当日调用额度,独立操作审计及已延续到其他会话的上下文保留。回复/操作进行中需先停止回复或等待操作结束。继续新对话带入最近三轮上下文;父会话删除后子会话仍可继续。归档/回收站标题搜索覆盖最近 2000 个,超出时明确标注范围。
|
|
|
|
可直接描述连接、扫描或归档异常,也可输入 `/` 打开固定命令菜单。`/help` 展示帮助,`/status` 只刷新本机授权概况;`/bpm`、`/storage`、`/archive` 选择可见目标后填入诊断草稿,发送才调用模型。输入区模型控件与 `/model` 可按供应商选择管理员已启用的模型,下一轮生效;每轮回答旁显示实际使用的供应商/模型。移除或停用所选模型后须重新选择。模型目录会在短时间内复用,避免反复打开选择器时重复等待。运行包、供应商密钥和模型配置完整即可使用,无需启用总开关。发送按钮为圆形向上箭头,空输入时置灰;回复中显示停止方块。概况刷新不会自动检查外部连接,未知命令不会作为提示词发送。未配置模型时仍可查看授权概况。
|
|
|
|
过程按真实阶段推送,断线后补读,必要时回退轮询;首版回答在完整校验后显示,不逐字输出,也不展示模型内部思考。概况是最近观测,证据页是该轮实际使用的快照,两者时间和范围可能不同。停止只针对模型回复,确认进程退出前显示“正在停止”;操作中断或结果不明显示“待核验”。
|
|
|
|
点击回答下方“查看操作”可审查目标、影响和操作编号,再点执行。允许的动作仍由管理员及工作台权限限定;断线、刷新、重新诊断都不会自动执行或重放旧操作。管理员代码修复入口在右栏“记录 → 提出代码修复”,先展示修改前后,测试通过后仍待审查。操作与结果保留审计。
|
|
|
|
助手不是 BPM 自动办理入口,也不能替代业务核验。不要向对话输入密码、Cookie、完整业务表单或不必要的客户信息。
|
|
|
|
### 存储服务器
|
|
|
|

|
|
|
|
管理员维护 SMB 服务器、共享目录和访问方式,可浏览共享目录、检查读取连接、检查写入权限,并查看归档配置与归档记录。可使用部署机 Windows 权限或明确指定凭据;凭据由工作台加密保存。检查连接不会保存草稿配置,写入检查会创建并清理探测文件。保存配置不等于自动归档已可用;启用前要确认目录、权限、文件命名和真实归档结果。
|
|
|
|
### 异常待办
|
|
|
|

|
|
|
|
集中记录需要团队跟进的问题,可搜索标题/说明/负责人并按状态过滤。操作员可认领未分配异常、处理自己负责的事项、转交、提交核验、填写核验结果后关闭或重新打开;管理员可管理全部异常。每次状态变化都保留操作人、时间和说明。关闭异常只改变跟踪状态,不会改写邮件发送结果或重新执行订单。
|
|
|
|
### 分类通知规则
|
|
|
|

|
|
|
|
以 Excel 类别维护精确的流程与触发节点配对,以及类别通知内容、To/Cc、模板、归档位置和验证状态。可搜索类别、导入规则文件、下载当前规则。导入先预览错误和变更,再一次性确认;错误行或并发版本变化会阻止整次提交。保存产生草稿,不会覆盖当前发布版本;真实待办样本检查通过且依赖完整后,管理员才可发布。字段目录须先在字段映射页采集。更新字段映射后,相关类别可能暂停并要求重新检查发布。
|
|
|
|
第04步先点击“读取已采集订单”,再选择样本并检查识别结果;它只读取已有采集记录,不会重新采集 BPM。刷新规则后如需验证,请重新读取样本。
|
|
|
|
本页检查一个真实样本不等于全部类别和表单版本都已验收。当前整体自动通知仍按首页及发送设置显示为暂停/待核验;不要把规则存在或发布描述成完整业务闭环。
|
|
|
|
### 字段映射
|
|
|
|

|
|
|
|
维护 BPM 实际采集到的流程和触发节点目录,供分类通知规则选择。管理员选择授权 BPM 连接后,可只读更新目录、搜索已采集流程/节点,并控制自动采集。此页当前重点是流程/节点目录和已有证据,并不是旧版任意编辑业务字段路径的页面;Excel 导入不会改目录,未知流程/节点需要先核对真实 BPM 采集结果。采集只读,不打开订单详情、不办理 BPM、不创建邮件。
|
|
|
|
目录有名称不表示对应流程字段、PDF、归档或通知都已核验。字段映射的历史设计和状态细节见[字段映射说明](field-mappings-guide.md)。
|
|
|
|
### 发送计划
|
|
|
|

|
|
|
|
管理员设置每天两个北京时间发送时点及周末是否按工作日处理。此配置决定计划窗口,不会立即发送邮件,也不会覆盖业务日历中的某日停发或调休安排。保存后由首页和批次页展示下一发送时点。
|
|
|
|
### 业务日历
|
|
|
|

|
|
|
|
按月查看公司工作日、休息日和暂停日;选择日期后可设置该日是否采集、是否发送及备注,并覆盖每周默认安排。采集和发送是分别控制的;暂停日不执行这两项计划。修改先作为页面草稿,保存后才对团队生效;每周默认时段仍在发送计划维护。
|
|
|
|
### 邮件模板
|
|
|
|

|
|
|
|
管理员可新建、编辑纯文本或 HTML 模板,预览内容并维护版本。托管邮箱也可按允许发件人名单接收模板邮件;导入后须在模板列表预览并确认生效。正文支持明确列出的订单、产品线、日期、明细和存放地址等变量;不执行模板表达式,HTML 预览会隔离脚本和远程资源。模板只定义内容,类别关联和收件人在分类通知规则维护;新模板不会自动替换正在使用的规则版本。
|
|
|
|
### 发送设置
|
|
|
|

|
|
|
|
管理员可分别查看/维护订单自动处理和分类邮件自动发送开关、发件邮箱及单封容量上限。两个开关相互独立;邮件启用还要求邮箱、类别和归档条件通过服务端校验。若当前存在受限稳定性测试,页面会显示其固定收件箱、归档位置、测试基线和到期信息;测试状态不是正式生产配置。保存开关不会代替真实收件、归档和 SMTP 验证。
|
|
|
|
### BPM 连接
|
|
|
|

|
|
|
|
管理员创建连接并指定负责人,打开受控登录窗口完成 BPM 登录,检查并保存会话;可查看连接状态、重新验证、重启会话或停用连接。BPM 会话和托管账号由部署机本地加密保存,连接负责人或管理员按权限操作。连接可用只证明相应登录/检查状态,不证明所有流程、字段、待办和通知接入均已核验。
|
|
|
|
### 邮箱管理
|
|
|
|

|
|
|
|
维护托管 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 文字不要求视觉能力。切换到非视觉模型后,历史图片不发送,并向模型说明仅使用文字。向上阅读历史消息时,会显示圆形向下箭头,点击回到最新消息。
|
|
|
|
### 助手设置
|
|
|
|

|
|
|
|
助手设置包含“模型供应商”“默认模型”“运行与权限”。管理员可添加 DeepSeek、OpenAI、Anthropic 或自定义兼容 API,独立维护地址、协议、密钥和模型列表,设置默认模型,编辑/停用/删除供应商。支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages。模型列表每行可填 `模型 ID | 显示名 | 上下文窗口 | 最大输出 | 输入能力`,后面四项可省略;获取目录只填入草稿,检查并保存后生效。旧单模型配置会迁成 DeepSeek 供应商,保留原地址、模型和密钥。
|
|
|
|
已保存的密钥不读回输入框,留空保留;更换协议或地址需重填。供应商编辑有未保存确认,保存/获取目录期间锁定字段,避免迟到结果覆盖新输入。运行包、超时、调用上限和受控操作权限单独保存;其他成员可在自己的会话选择可用模型,不能维护供应商。
|
|
|
|
连接或密钥配置须在部署机本地或可信 HTTPS 环境维护;密钥由本地安全存储管理。打开设置页不会调用模型;保存完整配置后即可对话,无需另行启用。调用使用当轮启动时的配置,不因后续切换改变正在回复的模型;目录获取也不等同真实模型调用验证。
|
|
|
|
### 系统健康
|
|
|
|

|
|
|
|
查看工作台进程、独立守护/自启动、BPM 连接与同步、到达扫描、存储、邮件和其他模块的最近检查结果;“刷新健康状态”刷新工作台提供的状态快照。页面以最近已知状态为主,不会替代对 BPM、SMB 或 SMTP 的实时连通性测试。需要实际验证时,进入对应连接页面执行相应检查。
|
|
|
|
### 团队账号
|
|
|
|

|
|
|
|
管理员创建同事账号、分配管理员/操作员/只读成员角色、启用或停用账号,并维护负责连接和异常的交接关系。管理员可重置其他成员密码、撤销其登录;重置会使该账号旧会话失效。管理员不能在此重置自己的密码,请使用右上角“修改密码”。初始密码应通过受控渠道告知本人,并由本人修改。
|
|
|
|
### 操作记录
|
|
|
|

|
|
|
|
按北京时间查看最近操作的时间、操作人、动作和详情,汇总工作台配置与业务操作记录,最多展示最近 200 条。记录用于追溯,不显示密码或密码哈希;它不是外部系统的完整日志,也不能单独证明邮件最终送达或文件仍存在。
|
|
|
|
### 个人账号
|
|
|
|

|
|
|
|
所有角色都可从右上角修改本人密码。需要输入当前密码和两次一致的新密码;新密码为 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轮时,原生未来计时会停止,管理页显示“容量已满,已停止”,保留规则和未调用消息。可以确认把未调用消息转到本人其他会话,使用目标会话的模型和历史;旧附件不会自动迁移。未来周期任务须在新会话重新安排,本次消息重试不会自动复制或恢复周期规则。
|
|
|
|
操作建议即使过期、配置版本变化或操作开关关闭,原有权限范围内的所属用户仍可直接“拒绝建议”,无需先取得执行授权。已经执行或结果待核实的卡片不能用拒绝操作改变结果。固定操作已开始后,记录失败会显示“待核实”并保留已返回证据,请到原功能页核验,不要重复执行。
|