开发¶

设置¶

npm install
npm run build
node dist/cli.js --help

日常指令¶

npm run typecheck
npm run lint
npm run format:check
npm run server:validate
npm run audit:prod
npm test
npm run build
npm run check

源代码布局¶

src/
  cli.ts                  CLI entry point
  server.ts               outer MCP proxy server
  bridge/
    config.ts             Playwright MCP config generation
    env.ts                env parsing helpers
    paths.ts              upstream package path resolution
    tools.ts              local Cloak introspection tools
  runtime/
    consoleFallback.ts    compatibility patch source strings
  project/
    metadata.ts           package and MCP metadata

已移除的原生适配器/工具注册表实现不应重新引入。上游 Playwright MCP 负责浏览器工具的行为。

本地 Docker¶

npm run docker:build
npm run docker:smoke
docker run --rm --init -i -v "$PWD/artifacts:/data" cloakbrowser-mcp:dev

文档¶

npm run docs:install
npm run docs:assets
npm run docs:serve
npm run docs:build