CompatLab

CompatLab

CompatLab 会在固定版本的 JavaScript 运行时中测试已发布的 npm 构件。报告会区分观察到的加载行为、覆盖范围和环境限制，不会据此笼统宣称兼容性。

生产域名：compatlab.me。解读通过的报告前，请先阅读方法说明。

Agent 可以通过匿名 API读取现有证据，也可以使用 Streamable HTTP 将远程 MCP 客户端连接到 https://compatlab.me/mcp。只读的 check_package 和 get_report 工具会返回确切版本、运行时固定版本、覆盖范围和报告链接；它们绝不会提交扫描。请参阅 MCP 设置与验证。缺少证据并不代表兼容性结论。

本地引擎会在禁用脚本的情况下解析并准备公开的 npm 构件，封存其依赖树，并在固定版本的 Node、Bun 和 Deno 运行时中进行探测。CLI 支持有界检查，以及显式复用快照或基于锁文件重建。Worker 包含主机所有权、容量预留、恢复机制和恶意代码资格验证。PostgreSQL 目录和私有控制服务提供事务式准入、持久租约、经身份验证的结果写入和快照本地调度。匿名网站支持发现、显式扫描请求、持久进度、报告矩阵、证据和复现文件下载。系统还包含 SSH 运维控制、部署打包、异地加密备份、保留策略和发布资格门禁；公开准入默认关闭。请参阅运维手册和资格验证记录。有关限制和先决条件，请参阅网站设置、报告、编排、目录与准入、Worker 生命周期、本地执行、准备和运行时配置。

开发

命名断言和 CI 构件扩展了维护者工作流。断言使用固定到提交的离线夹具，并单独提供行为证据。Linux/runsc CLI 可以检查发布前的归档文件，并使用独立的来源标识和调用方提供的来源信息。

公开的维护者专区即将推出。其可选的账户实现使用 GitHub App 登录、加密的 OAuth 令牌、实时仓库权限检查、撤销和账户配额，但此部署中仍禁用了登录和发布监控。公开报告仍为匿名。

请使用 .node-version 中指定的 Node.js 24.21.0 和 package.json 中指定的 pnpm 12.8.1。

corepack enable
pnpm install --frozen-lockfile
pnpm check
pnpm cli --help
pnpm cli doctor --json

pnpm check 会运行格式与 lint 检查、严格的工作区构建、测试类型检查以及单元测试/CLI 测试。直接运行 CLI 或测试前请先构建。在 macOS 和 Linux 上均可进行开发检查；运行 doctor、沙箱测试和本地 PostgreSQL 测试服务器需要 Docker 守护进程。有关单独的集成门禁，请参阅数据库资格验证。

doctor 会报告 Linux amd64 Docker 服务器是否注册了 runsc 运行时。缺少先决条件时，它会返回退出代码 1，并且绝不会执行包代码。通过检查并不代表主机已获得执行不可信代码的资格。系统不会回退到在开发者的计算机上运行软件包。

在已准备好的 Linux amd64 主机上运行 runsc：

pnpm build
pnpm test:sandbox

冒烟测试会构建一个固定摘要的夹具镜像，并检查 ESM/CommonJS 完成、模块故障、伪造标准输出成功、结果缺失和异常退出。测试仅使用自编夹具。CI 会在一次性 GitHub 托管的运行器上安装校验和固定版本的 gVisor；该安装程序不适用于开发或生产机器。

仓库结构

路径	实现的职责
apps/cli	前置条件、检查、CI 归档、复现、SSH 管理和备份加密
apps/web	匿名发现、扫描请求、持久化进度和报告页面
packages/engine	注册表解析、分析、规划和有界探测编排
packages/catalog	PostgreSQL 身份、准入、租约、结果验证、恢复和缓存查询
packages/contracts	规范词汇和有界完成验证
services/worker	准备、密封存储、运行时监管和本地证据存储
services/control	绑定到私有 WireGuard 的工作器 API 和协调
harnesses	自动加载和独立命名的断言完成协议
services/maintainer	发布协调、比较和独立重试的邮件
runtime-images	固定摘要的最小运行时镜像配方
fixtures	编写的模块／协议和准备归档样例
infra	固定版本的服务打包、工作器配置、备份和恢复配置
scripts	隔离、语料库、部署和恢复资格认证
docs	架构、交付顺序、研究和决策记录

交付与贡献

十四个 PR 的交付计划涵盖公开 MVP 和受门控的维护者工作流。架构计划、PRD v1.1和研究笔记定义了设计。原始 PRD作为历史参考予以保留。

所有项目变更均使用功能分支和拉取请求。检查项和审查要求请参阅 CONTRIBUTING.md，报告安全问题请参阅 SECURITY.md。该仓库由 siddiksawani 维护，并采用 MIT 许可证。

有关公共网站的运维，请参阅生产运维和搜索发现。已延期的维护者发布监控工作流见监控与部署。