StatePort

产品简介

StatePort 是一款面向 Web 开发者的调试状态管理工具，目前处于 1.0.0-beta 公测阶段。它要解决的问题非常具体：开发者在排查一个复杂 Bug 时，往往需要先完成一长串前置操作——切换用户角色、修改权限设置、填写表单、绕过校验——才能真正触达那个出错的界面。等修完一个问题、重启一次应用，这些精心铺垫的现场全部消失，下次还得从头再来一遍。StatePort 的做法是把这套「触达 Bug 所需的完整环境」整体保存下来，变成一张可以反复打开的状态卡片。

核心功能

• 现场捕获（Capture）：记录触达 Bug 所需的页面路由、浏览器上下文（角色、权限、表单进度等）以及关键 API 响应，形成一份可复用的起始状态。
• 状态卡片（State Card）：把捕获结果固化成一张卡片，作为回到目标应用状态的「预制入口」，无需每次手动重建角色、表单、开关和边界条件。
• 复用式打开（Reopen）：支持在当前运行中的本地应用与当前代码上重新打开卡片，按指定目标路由执行，代码变了也能直接对着新代码复现。
• API 行为控制：可以选择保持支撑性接口的响应稳定，也可以只把正在调查的服务或路由冻结，便于隔离问题变量。
• 干净会话（Clean Session）：提供不带历史痕迹的全新会话，用于验证保存状态是否真正生效，产出可信的复现证据。
• 本地优先的安全边界：登录凭据独立存放在本地认证边界之后，不会被写进保存的卡片文件；给编码 Agent 的 MCP 接口也只传递安全状态与运行时控制，不暴露原始密码或令牌。
• 面向编码 Agent 的 MCP 接口：Agent 可以基于已经人工审核过的卡片开展工作，在明确授权下也能创建新卡片，但必须经过有界捕获与强制复核环节。

特色优势

StatePort 的定位介于「屏幕录制」和「测试脚本」之间。屏幕录制只能看、不能操作，测试脚本写起来成本高且容易随代码变动失效，而 StatePort 保存的是应用状态本身——一个可重新打开的起点。它把「捕获一次、反复调试」变成了默认工作方式，让开发者把节省下来的时间真正放到修复代码上。所有运行时状态写在项目本地的目录中，卡片 JSON 是唯一事实来源，且工具会拒绝覆盖被人工修改过的产物，避免误操作破坏现场。

应用场景

1. 复杂多角色 Bug 复现：需要先切换角色、开权限、走完表单才能触发的报错，一次捕获即可反复回到现场。
2. 修复过程中的多轮验证：改一行代码就想跑一遍完整复现路径，避免每次手动重走十步操作。
3. 前端与后端联调：冻结出问题的接口响应，稳定其他依赖，专注定位真正的故障点。
4. 编码 Agent 协作调试：让 Agent 基于已审核的状态卡片参与复现，人机分工更清晰。
5. 回归验证与证据留存：以干净会话跑一遍卡片，作为「确实修好了」的可信证据。

适用人群

主要面向需要频繁排查复杂业务 Bug 的 Web 前端与全栈开发者、负责联调的测试工程师，以及希望把编码 Agent 纳入调试流程的技术团队。对于只做简单页面开发的用户，收益相对有限。

出品方与更新动态

StatePort 由独立开发团队打造，当前版本为 1.0.0-beta.22，提供 macOS arm64 的 DMG 安装包与 Linux x64 的 DEB 安装包，Windows 版本暂未开放。下载不需要绑定信用卡，免费捕获功能在试用或付费权限结束后依然可用；通过邮箱验证后可主动开启为期 14 天的开发者试用，用于在本地代码上重新打开卡片。团队级共享工作区、成员管理与组织策略目前仍在规划中。

官网链接

https://stateport.dev/