关于 CARBON
CARBON 为编码 Agent 提供本地证据运行环境和基于风险的测试工作流。它指导对授权项目进行检查并记录发现,实际调查由 Agent 使用自身工具完成。
主要功能
- 01基于风险的项目评估
- 02定向缺陷与无障碍检查
- 03记录证据并生成实时报告
- 04导出 HTML 和 JSON
- 05八种测试工作流
适用场景
- 01发布前评估项目风险
- 02调查特定功能或缺陷
- 03检查无障碍并记录限制
MCP 相关
MCP 服务提供测试工作流工具和报告访问能力;它不会独立开展调查或生成发现。编码 Agent 使用自身可用的浏览器、终端或 API 工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @testers-ai/carbon-mcpCARBON_ANALYTICSOptional content-free analytics. Off by default; set off to force-disable.DO_NOT_TRACKSet 1 to disable analytics regardless of preferences.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
6收录的工具列表 · 更新于 1 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| root | string | 是 | |
| title | string | 是 | |
| checks | array | 否 | |
| target | string | 否 | |
| command | enum | 是 | carbon | carbon-demo | carbon-test | carbon-issues | carbon-accessibility | carbon-map | carbon-help | carbon-settings | j | jay | carbon-background | carbon-pro | full |
详细介绍
Testers.ai CARBON 测试框架
Agent 的计划。你的本地工作区。
使用你已有的模型访问权限。 在 Claude Code、Codex 和其他编码 Agent 中,CARBON 的默认测试工作流使用宿主配置的模型访问权限。如果宿主使用符合条件的订阅,CARBON 会使用该订阅额度——无需单独提供 CARBON 模型 API 密钥。如果宿主使用 API 凭据或公司 LLM 代理,则适用相应的计费和数据政策。套餐限制和额外使用费用仍然适用;CARBON Pro 许可证另行计算。
本地执行和本地报告——不承诺数据不会离开你的设备。 对于本地运行,项目文件、测试证据和报告都会存储在你的本地工作区中。你的编码 Agent 可能会将选定的代码、屏幕截图、提示词和其他上下文发送给其配置的模型提供商。本地 CARBON 不会自动处于离线或物理隔离状态。云端运行、外部集成和可选的直接模型检查具有各自独立的数据流,也可能产生额外费用。不同版本的命令使用情况分析各不相同;请查看相应版本的隐私政策和设置。
要确认计费方式,请在 Claude Code 中检查 /status,或在 Codex 中运行 codex login status。已配置的 API 密钥可能会选择 API 计费,而非订阅额度。独立 MCP 客户端必须自行提供模型访问权限和执行工具;安装 MCP 服务不包含模型订阅。
轻量版。 在 Claude 中进行 AI 软件测试与质量保障。
在编码 Agent 中进行 AI 测试。由 testers.ai 打造。
CARBON 为你的编码 Agent 提供基于风险的测试指令和本地证据运行环境。Agent 会检查你有权访问的项目,使用可用的浏览器、终端或 API 工具运行检查,并在实时报告中记录发现。CARBON 的 MCP 服务不会独立执行调查,也不会编造结果。
1.32.22-free.7 版新增内容
四种精简的报告视图,助你从决策快速查看相应证据:
- 发布简报: 所选检查项的发现、后续操作和结果。
- 证据视图: 与检查项、复现步骤和修复方案关联的页面屏幕截图。
- 流程地图: 记录的路径和步骤结果,不会虚构关联。
- 实时调查: 当前检查项、检查目的和最新活动。
缩放屏幕截图,只需单击即可查看完整记录,并导出可移植的 HTML/JSON。实时报告会保留最近一次成功的快照,并在中断后自动静默重新连接。未知和延期的检查项仍会与通过的检查项区分开来。
基于角色的 AI 测试团队
AI 测试经理 Jay 现在会介绍评估内容,并出现在报告中。专业角色采用基于角色的名称,并使用全新的浅色/深色图标标识,而非人名和照片。它们代表的仍是 AI 视角,而非人工审核人员。请参阅 AI 测试团队、视觉资料库、命令指南和 MCP 工具参考。 八条命令的范围、许可证、数据处理方式和权限边界均保持不变。
八种工作流
| 技能 | 用途 |
|---|---|
carbon | 有界的基于风险的评估,包括业务价值和角色旅程 |
carbon-demo | 创建一个一次性示例项目,然后对其进行评估 |
carbon-test | 测试一项指定的行为、功能或变更 |
carbon-issues | 排查 Bug,至少将一半预算用于有状态探索和角色探索 |
carbon-accessibility | 有针对性地调查无障碍问题,并提供证据和限制说明 |
carbon-map | 探索当前评估中的截图、检查项和发现 |
carbon-help | 选择合适的 Free 工作流 |
carbon-settings | 更改本地规划默认值和分析偏好 |
所有记录的发现、角色旅程、HTML/JSON 导出文件和当前运行地图都会一并提供。无需 CARBON 账户、付款或解锁发现内容。你的编码 Agent 订阅或 API 用量另行计算。通常默认的 20 分钟/20 项检查规划可调整,并不代表覆盖范围保证或硬性运行配额。
在 Claude Code 中安装并启动
要求:Node.js 22 或更高版本;如需使用可选的演示创建工具,则需要 Python 3.10 或更高版本。 MCP 运行时无需执行 npm install。浏览器自动化取决于编码 Agent 可用的工具。可选的演示测试有各自的文档化依赖项。
git clone https://github.com/jarbon/carbon-free.git
claude --plugin-dir /absolute/path/to/carbon-free
将路径替换为你的检出目录。Claude Code 通常会在插件技能名称前加上插件名称。试试以下三个示例:
/carbon:carbon— 评估当前项目。如果文件夹为空或目标不明确,Jay 会询问要测试什么:URL、文件夹/代码库、API、应用/功能或需求。目标明确时,他会执行广泛评估,并报告发现、基于证据的置信度、差距和后续步骤。/carbon:carbon-issues ./my-app— 在获授权的项目中排查 Bug,包括状态转换和多步骤旅程。/carbon:carbon-accessibility http://localhost:3000— 测试你控制的应用;分别报告实际证据和未测试的标准。
使用 /carbon:carbon-map 查看最近一次评估,或使用 /carbon:carbon-settings 调整默认值。名称和内嵌浏览器支持可能因宿主/版本而异;请使用宿主的技能选择器。每次仅安装一个 CARBON 版本,因为各版本共用 carbon 命名空间。本代码库并不声称获得 Anthropic 批准或上架。
此软件包还包含一个 Codex 清单。其他 MCP 宿主可以启动
node /absolute/path/to/carbon-free/server/index.mjs,然后通过其支持的机制提供捆绑的技能。
无法访问本地进程/浏览器的聊天宿主无法提供相同的运行时行为。请测试你打算使用的交互界面。
运行、写入和连接的内容
- 声明的 MCP 入口点是
server/index.mjs,使用 Node 标准库。 - 创建演示会通过 Python 调用捆绑的
runtime/carbon/scripts/carbon_demo.py。 其中的固定示例均为合成示例,有些还刻意保留了不完善之处;切勿将其部署为生产应用。 - 证据和报告快照保存在你项目的
.carbon/free/下。 现有报告会予以保留。卸载不会清除证据。 - 实时报告和设置视图绑定到
127.0.0.1,并使用随机访问令牌。 在支持的情况下,Agent 会使用自己的浏览器/面板工具打开这些视图。运行时停止后,已保存的 HTML 仍可使用。分享前请检查导出内容。 - 匿名命令分析功能默认启用,会向
https://cdn.usefathom.com/发送固定的命令事件名称。不会发送提示词、源代码、目标 URL、屏幕截图、发现的问题、凭据或稳定的用户标识符。 网络元数据对该服务可见。请在启动前设置CARBON_ANALYTICS=off,或在设置中关闭分析功能。仅导入模块不会发送遥测数据。 - 全局分析偏好和发送诊断信息使用用户主目录下的
.config/carbon/。项目证据不会自动过期;保留期限由你掌控。 - 你的编码 Agent 的模型提供商仍会处理你分享给它的上下文。 浏览器/API 检查会联系已获授权的目标及其可能涉及的第三方。本地优先不代表与外部网络隔离。
有关数据处理、保留期限和联系方式,请参阅隐私政策。 此捆绑包不包含私有基准测试获取功能、审核服务、远程 MCP 后端或 Pro 解锁码。
解读结果
只显示已记录的证据。未执行的测试仍会标记为受阻或延期;疑似问题会与已证实的故障区分开来。置信度是适用于特定范围的工程判断,并非对整个产品正确性的校准概率。 AI 人设反馈是模拟结果,并非人工研究。无障碍结果不构成认证或法律意见。此 Free 运行时不会生成正式的 DOCX 合规性文档,也不会运行持续自动修复。
故障排除与支持
- 缺少工具:使用
node --version检查 Node,重新加载插件,并检查宿主的 MCP 连接状态。在代码检出目录中运行claude plugin validate .。 - 实时链接已过期:使用
carbon_report重新打开已保存的运行结果,或打开已保存的 HTML。 - 没有可用的浏览器:运行已获授权的静态/API 检查,并说明未经测试的 UI 范围。
- 演示设置失败:检查
python3 --version和所选固定示例的 README。 - 请勿在公开问题中发布私有代码、报告令牌、屏幕截图或客户记录。
产品/安全支持:[email protected]。 可复现的非敏感问题:GitHub issues。
运行时回归检查
在代码库根目录运行 node tests/smoke.mjs .。检查使用临时合成项目,并禁用分析功能。它们会测试 MCP 接口、演示复制、报告生命周期、证据导出、设置持久化、身份验证、跨源请求拒绝和符号链接防护。这些检查不认证被测应用的无障碍性、安全性或性能。
许可证和产品信息
CARBON Light 在 Claude 和 Codex 上均采用 MIT License 开源。请阅读 LICENSE 和 NOTICE.md。 产品版本信息请参阅 CARBON 网站。
与 Jay 对话
| 对话入口 | 用途 |
|---|---|
/jay | 直接与 Jay 讨论测试、风险、结果和后续步骤。 |
/j | 同一 Jay 对话的简短别名。 |
使用 /jay 或 /j,直接与 Jay · AI Test Manager Agent 对话。MCP
提示词路由器也接受 J。技能名称均为小写;如果宿主无法解析 /J,请使用 /j。Claude 通常会为这些命令添加前缀 /carbon:jay 和
/carbon:j;Codex 可能会显示带插件前缀的命令,或在技能选择器中显示 $jay。
该插件无法在每个宿主中保留全局斜杠命令名称。
/jay What should we test next?— 讨论风险以及我们掌握的证据。/j Test this project— 运行本版本的常规 CARBON 评估。/jay Explain the last report— 解读已记录的结果,不重新运行测试。/carbon仍是直接进行全面测试的命令。
Jay 会以第一人称、坦率务实的语气回复,其风格受 Jason Arbon 启发。 他是一个 AI 人设,并非 Jason。若没有明确的测试目标,他会询问 URL、 文件夹/代码仓库、API、应用/功能或需求。除非用户提出要求,否则他不会创建演示。 提问不会自动启动测试,修复仍需获得授权。Lite 保留现有功能;这两个是对话入口, 并非两种新的测试工作流,也不是升级到 Pro。
在兼容的命令选择器和 CARBON 报告视图中,会显示 Jay 随附的图标。 宿主控制聊天头像和图片尺寸;纯文本聊天会使用 “Jay · AI test manager”,而不是大图。
可选的 Jay 后台检查
在针对每个项目明确选择并信任宿主钩子后,Jay 会在休息期间检查已更改的代码。默认值:空闲延迟 2 分钟,每次运行 3 分钟,每次运行最长 10 分钟,1 个工作进程,每个 UTC 日跨项目运行 3 次并预留 10 分钟。不自动修复,也不测试在线站点。本地检查和结果计数仅保留在此设备上。仅限 Claude 的可选 AI 源码审查,需要另外同意由服务提供方处理数据并使用额度。Codex 检查不会启动 Claude。使用 carbon-background 可在所有位置启用、暂停、查看或禁用。参见行为、控制和隐私。不受支持的宿主仍可手动测试。
探索 CARBON Pro
运行 /carbon-pro,打开 CARBON Pro 功能和定价。
在 Claude Code 或 Cowork 中,带插件前缀的命令为 /carbon:carbon-pro。
在 Codex 中,从插件技能选择器中选择 carbon-pro(或使用 $carbon-pro)。
MCP 客户端会公开 carbon-pro 提示词;完整运行时也接受 carbon_pro。
这是所有版本均可使用的导航快捷方式,并非付费测试工作流。
它不会运行测试、启动结账、安装 Pro,也不会公开客户下载内容。
可选使用情况分析
分析记录固定的命令名称、首次启用、评估生命周期、报告/设置使用情况、版本类型和版本号。绝不会包含提示词、代码、项目路径、目标 URL、屏幕截图、发现结果、凭据或持久性用户标识符。启用后,事件会发送到 Fathom:https://cdn.usefathom.com/;该服务必然会获取 IP 地址等连接元数据。
Claude 版本默认启用分析功能。Codex 版本默认关闭;启用前必须由用户明确选择。运行 node <plugin>/scripts/usage-analytics.mjs status、on 或 off。全局 CARBON_ANALYTICS=off、DO_NOT_TRACK=1 或全局禁用分析设置会覆盖版本偏好设置。若未设置 DO_NOT_TRACK,显式设置 CARBON_ANALYTICS=on 即可启用分析功能。
发送失败的事件会在后续活动中重试,本地事件记录最多保留 200 条,保留期限为 7 天,存储位置为 ~/.config/carbon/usage/。禁用分析功能后,待发送事件会在下次调用辅助程序时清除。系统不会在后台上传数据。HTTP 接收成功并不能证明数据已写入仪表板;不确定是否成功时进行重试,可能导致接收方的计数重复。每个版本/本地配置只记录一次首次启用,而非每次安装或每位独立用户。安装量来自发布者仪表板。命令遥测尽力而为:不执行技能辅助程序的宿主无法计入。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。