用途：用于诊断 Documenso 集成相关的生产事件、处理服务中断并组织响应流程。内容覆盖 Documenso 云服务故障、自托管部署问题以及集成失败等场景。
主要能力：先声明事件范围、指挥人、受影响文档/签署人/环境与安全沟通渠道；在深入诊断前先执行经批准的暂停、吊销访问或回滚等稳定措施；仅收集脱敏的关联/状态/审计证据，保护文档与签名完整性及证据链；验证恢复、通知负责人并创建根因与预防的后续工作。输出为带时间戳的事件记录，包含范围、负责人、缓解措施、脱敏证据与已验证的恢复或升级。
严重级别：P1 完全签署中断（所有 API 调用失败）响应时间 <15 分钟；P2 功能降级（响应慢、间歇错误、Webhook 延迟）<1 小时；P3 轻微问题且有绕过方案 <4 小时；P4 非紧急，下一工作日处理。
诊断与用法：提供快速诊断命令脚本，检查云状态页、API 连通性（curl 请求 /documents）、延迟采样及自托管容器状态（docker ps 过滤 documenso）。场景处理包括：云中断（检查 status.documenso.com，确认后启用降级模式、排队请求、显示用户提示，否则检查 API Key、端点与近期部署）；自托管数据库问题（pg_isready、查看容器日志中的 error/fatal/prisma、检查迁移与健康检查）；Webhook 投递失败（检查团队设置中 Webhook 是否启用、端点 10 秒内返回 200、HTTPS、X-Documenso-Secret 匹配、ngrok 隧道等）；自托管签名证书过期（openssl 检查 .p12 有效期，替换证书后 docker compose restart documenso 并验证）。
还包含应急熔断器 TypeScript 类示例、事后检查清单与事件沟通模板。限制：需具备监控面板、Documenso 后台、应用日志访问权限并定义值班升级联系人；不共享文档、签署链接或签署人 PII。数据处理的更多细节见 documenso-data-handling。