系统使用说明书(水木东方 · 医疗器械 AI 协同工作台)
面向终端用户与系统管理员的完整使用说明书,覆盖:从 0 进入系统、登录/注册、管理员配置角色与权限、项目使用、AI 对话、文档工作台、审批全流程、FAQ。全部截图为 dev 环境真实操作采集(含真实 PI Agent 对话)。
文件说明
| 路径 | 说明 |
|---|---|
| manual.md | 说明书主文档(Markdown 源,SSOT) |
| images/ | 全部 UI 截图(PNG,编号对应章节) |
| dist/系统使用说明书.html | HTML 版(单文件,图片已嵌入,浏览器直接打开) |
| dist/系统使用说明书.pdf | PDF 版(A4) |
| dist/系统使用说明书.docx | Word 版 |
| scripts/capture-screenshots.mjs | 截图采集脚本(Playwright,需 dev 环境运行在 8080) |
| scripts/build-formats.mjs | 格式生成脚本(pandoc + playwright) |
重新生成
# 重新采集截图(dev 环境需在运行,会创建「说明书演示」前缀的演示数据)
node docs/user-manual/scripts/capture-screenshots.mjs
# 重新生成 HTML / PDF / DOCX
node docs/user-manual/scripts/build-formats.mjs
注意:dist/ 在根 .gitignore 中被忽略,本仓库通过 git add -f 强制纳入版本管理;本地重新生成后需同样 git add -f docs/user-manual/dist。
依赖:pandoc(brew install pandoc)、playwright docker 镜像 mcr.microsoft.com/playwright:v1.63.0-noble(PDF 打印在容器内执行,主机缺 chromium 系统依赖)。