个人项目 UI/API 探活与质量监测
PulseGuard
公司多个项目实际应用
自研并应用于公司多个项目的前端与 API 探活。统一管理健康状态、失败证据、告警与跨网络执行节点,支持公共脚本库和 MCP 诊断。
- 类型
- 个人项目
- 状态
- 公司多个项目实际应用
- 我的角色
- 独立设计 / 全栈开发 / 部署与维护
- 获取方式
- 开源免费
- 技术栈
- FastAPI
- SQLite WAL
- Playwright Python
- React
- TypeScript
- Docker Compose
- WebSocket Relay
- MCP
关于项目
PulseGuard 是本地优先的 UI/API 探活与轻量监测控制台,由我独立设计、实现和维护,已在公司多个项目中用于前端页面与 API 探活。它将任务调度、运行历史、健康状态、失败证据和告警集中管理,并通过本机、局域网和主动出站的 Relay 节点覆盖不同执行环境。
公司实际应用
已在公司多个项目中用于前端页面与 API 探活。我的工作涵盖产品设计、前后端实现、部署与持续维护;公开资料介绍通用能力,具体业务地址、账号、运行数据和内部资产不在站内展示。
让健康状态可判断
使用健康、疑似故障、故障、疑似恢复和健康的状态转换,同时保留未知、观测陈旧等状态。浏览器崩溃、节点不可用或依赖异常归类为 Runner 异常,避免被误计为目标故障;失败记录保留截图、响应内容与可选 Trace。
跨网络执行
主控台统一管理任务、调度、告警和主数据,本机、直连 Worker 与 Relay Worker 承担实际执行。Relay 节点主动出站连接,适配不能开放入站端口的环境;多节点结果按同一次运行分组展示。
公共脚本与执行一致性
以项目公共方法库复用登录准备、签名和解析逻辑,保存前检查 Python 编译、导出与引用。新运行使用最新源码,已经开始的运行及重试继续使用捕获的源码快照,减少配置变更引入的诊断歧义。
AI 诊断入口
独立的本地 stdio MCP 服务按项目查询任务和运行、比较成功基线并读取保留截图。连接默认只读;明确启用执行后可在授权范围内运行已有任务。
适用范围
面向个人、小团队和内网环境,采用单实例主控与本地优先存储。它提供持续探活和轻量监测;完整 E2E 回归、复杂值班管理与公开状态平台各有独立职责。
项目要点
已在公司多个项目中用于前端页面与 API 探活,补充自动化回归之外的持续可用性检查。
通过健康状态机、冷却和恢复通知处理抖动;区分目标故障与浏览器、节点等 Runner 异常。
统一管理本机、直连 Worker 和主动出站的 Relay Worker,内网节点可不开放入站端口。
失败保留截图、响应内容和可选 Trace,按执行节点、请求耗时、规则结果和错误摘要辅助定位。
项目公共 Python 方法库提供保存校验与引用检查;运行及重试绑定源码快照,保持在途执行一致。
MCP 默认只读,可查询项目任务、失败证据和成功基线;启用执行后仍需在用户授权范围内运行已有任务。
相关主题
- 监控
- 自动化测试
- Playwright
- FastAPI
- 运维工具
- 多节点
On the loom — screens
项目实览
Evidence — behind the work
背后的思考
-
PulseGuard:把多个项目的前端与 API 探活纳入日常质量工作
独立研发并应用于公司多个项目的 UI/API 探活平台。围绕持续检查、失败归因、跨网络执行和证据诊断,把分散的可用性检查整理为可维护的质量工具。