用途:在改动 Docyrus 应用后,用真实浏览器做端到端自测——无头登录、驱动 UI、读取运行时问题,形成“验证→修复→重跑”的循环。
主要能力:结合三部分工具。docyrus auth sso-session 生成短期令牌实现免密登录;docyrus browser 工具负责导航、快照、点击、填写、截图;@docyrus/devtools 是页面内诊断层,收集失败请求、API 误用与 console 错误。
使用方式:先确认上下文 docyrus auth who、docyrus env which、docyrus auth tenants use;再生成令牌 docyrus auth sso-session --clientId <appClientId>(可选 --targetOrigin、--scope);然后带令牌导航 docyrus browser nav "<appUrl>?sso_token=<token>",应用会自动登录并清除参数;接着用 snapshot/click/fill/wait 驱动流程;最后用 docyrus browser devtools issues|errors|console --level error 拉取问题。浏览器工具有 CLI 与桌面 pi-tool 两种等价形式。
适用场景:验证 Docyrus 后端应用改动后的真实行为,捕获被吞掉的 4xx、重复请求、慢请求、重复查询等肉眼难见的问题。
限制:令牌短期有效且单次使用,需在导航前即时生成;clientId 必须与应用一致;环境或租户不匹配是最常见失败原因;devtools 需已安装并启用,生产构建可能被关闭。资料未提供收费、价格与平台信息。