用途:用于排查 Documenso 集成中的复杂问题,收集诊断信息并生成可安全上报的支持记录。输出为最小化脱敏诊断包,包含关联 ID、生命周期状态、环境、版本与状态证据,同时保留文档与签名机密性及审计完整性。
主要能力:提供快速连通性测试脚本(校验 DOCUMENSO_API_KEY、测试认证、测量延迟、列出最近文档);TypeScript 诊断脚本(检查 API Key、连接、读写权限并输出报告);调试日志包装器(代理 SDK 记录方法调用与耗时);支持工单模板;错误处理对照表(诊断超时、写测试失败、自托管不可达、延迟过高等)。
使用方式:需已安装 Documenso SDK,可访问日志与配置,并具备 curl 和 jq。连通性测试使用 curl 请求 ${DOCUMENSO_BASE_URL:-https://app.documenso.com/api/v1}/documents;诊断脚本运行 npx tsx scripts/documenso-diagnose.ts。
适用场景:签名失败排查、环境与权限验证、自托管实例连通性检查、向 GitHub Issues 或 Discord 提交支持工单前的信息收集。
限制:分享前须检查诊断包是否含文档内容、签署人 PII、签名链接、令牌与审计载荷;复现应仅使用合成文档并通过批准的故障/支持渠道。速率限制处理参见 documenso-rate-limits。具体版本、收费与平台信息暂未提供。