关于 Subtext
Subtext 是由 Fullstory 提供的 Agent 会话回放服务,可将生产环境中的用户会话接入编码 Agent,供其审阅用户行为与排查问题。适合需要在终端内直接分析真实会话的开发者。它以 MCP 服务形式提供会话分析与隐私规则管理工具。
主要功能
- 01会话审阅,梳理用户操作流程与报错
- 02查看控制台错误与网络活动
- 03按会话内容搜索录制记录
- 04检测会话中的 PII 并管理隐私规则
- 05通过 MCP 服务接入多种编码 Agent
适用场景
- 01根据用户反馈复现并定位线上问题
- 02确认代码修复在真实界面中生效
- 03批量检查录制会话中的敏感信息并调整采集规则
MCP 相关
该项目是一个 HTTP 形式的 MCP 服务(https://api.fullstory.com/mcp/subtext),向 Claude Code、Cursor、Codex 等 MCP 客户端暴露会话审阅与隐私规则相关工具。其中隐私规则的创建、提升和删除工具会修改组织的隐私配置。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.fullstory.com/mcp/subtextclaude mcp add --transport http subtext https://api.fullstory.com/mcp/subtext{"mcpServers":{"subtext":{"type":"http","url":"https://api.fullstory.com/mcp/subtext"}}}在 Cursor 中打开{"servers":{"subtext":{"type":"http","url":"https://api.fullstory.com/mcp/subtext"}}}在 VS Code 中打开{"mcpServers":{"subtext":{"type":"http","url":"https://api.fullstory.com/mcp/subtext"}}}{"mcpServers":{"subtext":{"serverUrl":"https://api.fullstory.com/mcp/subtext"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
Subtext,由 Fullstory 打造
专为 Agent 打造的会话回放。 Subtext 是面向 Agent 的会话审查工具:它会捕获你应用的生产环境会话,并将其连接到你的编码 Agent — Claude Code、Cursor、Codex、Devin 或你自己的运行框架 — 让它能够审查真实用户的操作、重现已报告的 Bug、验证自己的 UI 更改,并管理捕获隐私规则,全程无需离开终端。
开始使用
最快的入门方式是使用设置向导。在项目目录中运行:
npx @subtextdev/subtext-wizard
只需一条命令即可完成全部设置:登录、获取你所在组织的捕获代码片段、询问你使用哪些分析工具,然后将安装交给你自己的编码 Agent — 由它为你配置捕获代码片段、MCP 服务、技能和命令。整个过程只需几分钟。
需要一个免费的 Subtext 账号 — 无需信用卡。 Subtext 是一项托管服务,用于录制和存储你应用的会话。会话保存在你的账号中,Agent 也从这里读取会话。向导打开登录页面时,只需通过 Google 一键创建账号,然后返回继续完成设置。
你将获得
完成设置后,你的 Agent 将拥有以下工具:
- 会话审查 — 将录制的会话交给 Agent,它会逐步梳理发生的情况:用户采取的操作流程、控制台错误、网络活动,以及问题出在哪里。非常适合调试用户报告的问题,或确认修复已在真实 UI 中生效。
- 隐私规则 — 检测捕获会话中的个人身份信息(PII),并直接通过 Agent 管理元素屏蔽、URL 和网络捕获规则。
驱动实时浏览器并捕获代码更改前后的证明材料,可使用配套插件 Subtext Verify。
手动设置
更喜欢自行配置?向导只是自动执行以下步骤 — 你也可以手动操作。
1. 安装插件
Claude Code
/plugin marketplace add fullstorydev/subtext
/plugin install subtext@subtext-marketplace
Cursor — 从 Marketplace 面板安装(或从导入此仓库的团队 Marketplace 安装)。
Codex — 打开 /plugins,从仓库 Marketplace 安装 subtext。
Gemini CLI
gemini extensions install https://github.com/fullstorydev/subtext
手动安装 / openskills
npx openskills install fullstorydev/subtext
…然后将 subtext MCP 服务(见下文)添加到 Agent 的 MCP 配置中。
2. 连接 MCP 服务
subtext 服务运行于 https://api.fullstory.com/mcp/subtext。它仅使用 HTTP — 无需本地进程。
3. 将捕获代码片段添加到应用
为你的组织安装 Fullstory 捕获代码片段,以便录制会话。向导会自动使用你所在组织的代码片段完成此操作;如需手动操作,可从 Fullstory 设置中获取代码片段。
注意事项
- 除
privacy-create/privacy-promote/privacy-delete/privacy-url-create/privacy-network-create外,所有工具都只进行只读分析;这些工具会修改组织隐私规则。 - 此插件捆绑了以下技能:
subtext-search(按会话中的事件查找会话)、subtext-review(结构化会话摘要)、subtext-session(review-*工具目录)、subtext-privacy(PII 检测 + 元素屏蔽、URL 和网络隐私规则)和subtext-telemetry(工作流里程碑记录),以及subtext-shared和subtext-using-subtext。 - 它还捆绑了 sightmap 技能
sightmap-authoring和sightmap-browser,用于构建和驱动.sightmap/语料库,并通过subtext-sightmap将语料库接入会话审查。这些技能从 sightmap 项目引入(见下文)— 无需额外安装,安装插件时也无需二进制文件。
维护 vendored sightmap 技能
skills/ 下的 sightmap-authoring 和 sightmap-browser 技能是从 sightmap 项目中 vendored 而来——请勿手动编辑。它们包含在 @sightmap/sightmap npm 包中;Subtext 将该包固定为 devDependency,并通过 scripts/sync-sightmap-skills.mjs 复制这些技能。
如需更新:
npm install --save-dev @sightmap/sightmap@<version> # bump the pin
npm run vendor-skills # refresh skills/ + .sightmap-vendored.json
然后提交更改。.sightmap-vendored.json 记录了来源包及 vendored 的确切版本。技能内容的修复应在上游 sightmap 仓库中进行,而非此处。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。