内容
[한국어.ko.md) | 中文 | [日本語](README.ja.md) | [Español](README)
<div align="center">
# 超级**无论浏览器任务是什么，您的代理都会完成它。 如果您被授权，超级伪装就会完成。**
一款适用于AI代理节奏隐身浏览器，CloakBrowser](https://github.com/CloakHQ/CBrowser) 在 [Playwright MCP](https://github.com/microsoft/playwright-mcp) 后台运行。无需手动需“页面加载”半成品 - 它会证据完成。
<p>
<img src="img.shields.io/badge/Claude_Code-D97757?logo=claude&logoColor=white" alt="Claude Code">
<img src="https.shields.io/badge/Codex-000000?logo=openai&logoColor=white" alt="Codex">
<img src="https://img.shields.io/badge/Cursor-6E56CF" alt="Cursor">
src="https://img.shields.io/badge/OpenCl1F6FEB" alt="OpenCl <img src="https://img.shields.ioermes-8957E5" altes">
<img src="https://img.shields.io/badge/Node.js-%E2%89%A5-3FB950?logo=nodedotjs&logo" alt="Node.js >= 20">
<img src="https://img.shields.io/badge/authorized_use-only-F0B72F" alt="仅限授权使用">
img src="https.shields.io/badge/license-MIT-blue"MIT">
</p>
</div>
⚡ 安装
**Claude Code** — 将此仓库添加为插件市场，然后安装插件：bash
/plugin marketplacepox/hyper-cl
/plugin install hyper-cloaking
```
**Codex** 读取 `.agents/plugins/marketplace.json` 处镜像的清单 — 通过 Codex 插件界面添加市场并启用 `hyper-cloaking`。
**任何 AgentSkills 客户端**（Cursor、OpenClawes 等）— 使用 `skills` CLI 安装，或将 `skills/hyper-cloaking/` 复制到客户端加载的技能根目录：
```bash
npx skills add . --list # 查看源提供的内容
npx skills add . # 安装到当前项目
```
需要 **Node.js ≥ 20** 和网络访问来获取 `cloakbrowser` 和 `playwright-core`。技能会在首次运行时安装和修复其余部分。
## 💬 试用
无需学习命令。像平常一样询问您的代理 -会在您将其指向浏览器任务时启动： *"使用 CloakBrowser 检查我的产品页面在移动设备上是否正确渲染并截图。"*
> *"的 cookie 登录我的 Instagram 账户并提取我的最近 12 篇帖子。"*
> *"监控我拥有的仪表板并报告部署状态是否更改为失败。"预期：** 代理会询问几个设置问题，启动人类节奏隐身浏览器，完成任务，并在有证据时- 截图，提取的文本，确认的状态更改 -** 保存在 `~/.hyper-cloaking/evidence。
## 🌐 兼容
**Claude Codex · Cursor · Open · Hermes Agent · G** — 任何加载 `SKILL.md` 的具有 MCP 功能的代理。内置元数据提示适用于 **Naver · Reddit · Instagram · You X**，以及有权测试的任何站点的 `generic` 模式。
## ⚙️ 为什么有效
- **真正的隐身浏览器修补 User-Agent**在 Playwright MCP 后台驱动 CloakBrowser 的 Chromium，具有真正的浏览器指纹而的头部。
- **默认人类节奏** — 每个操作运行都强制 `humanize: true`：人类节奏移动，输入和滚动，因此长时间的自动化流程不会任务中途中断。
- **启动前检查 目标安全分类，授权依据，允许的来源检问题在浏览器打开前发生 *。
- **有证据才算完成** — 页面加载永远不是“完成”。在结果得到证明时完成，并以结构化的结果报告。
- **零麻烦设置** — 它验证 Node.jscloakbrowser`，`playwright-core` 和 Playwright安装或修复缺少的内容。
## 🆚 普通浏览器 vs `+ 超级伪装`
| 您 | 普通 MCP 浏览器 | `+ 超级伪装` |
| :--- | :--- | :--- |
| 自动化 **** 已登录账户 | ✖ 触发自动化指 ✓ 人类节奏 + 安全 cookie 加载 |
| 在执行任务已授权 | ✖ 无检查 | ✓ 启动前安全 + 预检检查 |
| 重用站点 cookie 而不泄露它们 | ✖ 手动，原始值 | ✓，编辑，绝不提交 |
| 信任“完成”意味着完成 | ✖ 页面加载算作成功 | ✓验证结果 |
| 启动隐身浏览器 | ✖ 手动安装和连接 | ✓ 自动安装/修复 + MCP| **绕过登录，验证码，欺诈系统 ✖ | ✖ **拒绝，按设计（见边界）** |
普通浏览器无法做的是顶行：**像人类一样在您实际有权运行的任务上表现**。
## 🔁 工作原理
像 *"使用 Cloak此站点"* 这样的请求变成了一个有界限的，十步的工作流程。
<details>
<summary><strong>完整的 gate-to-evidence 流水线 - 详细信息</strong></summary>
1. **目标安全门** — 将目标分类为允许/拒绝/需要澄清，并记录授权依据和允许的来源。
2. **预检问题门** —结构化问题界面收集目标 URL，允许的来源，无头模式，cookie 模式/帐户和保持开启的偏好。
3. **设置门** — 验证 Node.js，`cloakbrowser`，`playwright-core` 和 MCP；安装或修复缺少的内容。
4. **运行时工作区** — 初始化 `~/.hyper-cloaking存储 `cookie.yml`，配置文件，下载，证据，日志和状态。
5. **cookie 处理** — 通过专用帮助程序标准化并加载站点匹配的 cookie（Chrome 导出 JSON，Playwright 数组，多帐户条目），从不在中存储原始值。
6. **可执行文件 在 `~/.hyper-cloaking/cache/cl/` 下定位缓存的 CloakBrowser Chromium 二进制. **人类启动** — 在每个操作运行中强制 `humanize: true`（人类节奏的鼠标，输入和滚动）。
8. **MCP 配置** Codex TOML，JSON `mcpServers`（Claude Code / Cursor），OpenClaw `mcp`，Hermes `mcp_servers` 或直接发出配置，将 `@playwright/mcp` 指向 CloakBrowser 可执行文件。
9. **任务执行 +** — 驱动请求的任务，仅当证据证明结果时完成（页面加载本身永远不是完成）。
10. **结构化报告** — 返回 `targetSafety`，``failure`，`contentBoundary` 和 `learning`；在 `~/.hyper-cloaking/evidence保存报告和截图。
浏览器 DOM，页面文本，控制台输出被视为 **不受信任的数据，无指令权限</details>
## 🔒 边界
超级 **授权浏览** 工具，而不是一种绕过访问控制的方式。
- **适用于** 授权的 QA，个人账户自动化和您有权测试的属性的诊断。
- **不适用于** 绕过访问控制，逃避欺诈系统，解决 CAPT抓取或未经授权的账户自动化。
性化减少了自动化指纹 - 它 **不** 取消任务被授权的要求。
- cookie 被标准化，在日志中编辑，并且从不提交。技能永远不会创造它未被赋予的授权，未知的提供者会关闭。
---
## MCP 配置代码一旦 CloakBrowser Chromium 二进制文件被解析，就将 Playwright MCP 指向它。默认启动是 **headless** 和 **sandboxed**；删除 `--headless` 以进行可见浏览。
**直接命令**
```bash
npx @playwright/mcp@latest --headless --sandbox \
--executable-path ~/.hyper-cloaking/cache/cloakbrowser/chromium-146.0.7680.177.3/chrome
```
**Codex (`~/.codex/config.toml`)** — 使用完整路径：
```toml
[mcp_servers.hyper-cloaking]
command = "npx"
args = ["@playwright/mcp@latest", "--headless", "--sandbox", "--executable-path", "/Users/you/.hyper-cloaking/cache/cloakbrowser-146.0.7680.177.3/chrome"]
```
**Cl / Cursor (`mcpServers` JSON)**
```json
"mcpServers": {
"hyperaking": {
": "npx",
"args": ["@playwright/mcp@latest", "--headless", "--sandbox", "--executable-path", "/Users/you/.hyper-cloaking/cache/cloakbrowser/chromium-146.0.7680.177.3/chrome"]
}
}
}
```
**OpenClaw (`mcp.servers.<name>`)** 和 **Hermes (`mcp_servers.<name>` in `~/.hermes/config.yaml`)** 遵循相同的命令/参数形状。
使用以下命令可确定性任意一个：
```node skills/hyper-cl/engine/cli.mjs mcp-config --json
node skills/hyper-cl/engine/cli.mjs mcp-config --client codex --json
node skills/hyper-cloaking/engine/cli.mjs mcp-config --headed
```
## 程序
运行时帮助 `skills/hoaking/engine/` 下支持的接口。
| 帮助程序 | 目的 |
|---|---|
| `engine/cli.mjs` | `validate` / `smoke` / `mcp-config` / `live` 命令；渲染 MCP 配置并运行包含的实时验证。 |
| `engine/cookie.mjs` | 导入，检查，编辑和注入 cookie（Chrome ，Playwright 数组，`cookie.yml` 站点/帐户条目）。 |
| `engine/browser-utils.mjs` | 初始化 `~/.hyper-cloaking/`，使用 `humanize: true` 启动 CloakBrowser，并提供 `humanMove` / `humanClick` / `humanType` / `humanScroll` / XPath 帮助程序。 |
```bash
node skills/hyper-cloaking/engine/browser-utils.mjs init
node skills/hyper-cloaking/engine/cookie.mjs inspect --url https://www.instagram.com/example/ --site instagram --json
node skills/hyper-cloaking/engine/cli.mjs mcp-config --help
```
<details>
<summary><strong>提供者和 Instagram 操作模块 - 详细信息</strong></summary>
**提供者（仅元数据）。** `engine/cli.mjs live --provider <id>` 选择 **仅元数据** — 域名/来源和 cookie/配置文件提示，适用于 `naver`，`reddit`，`instagram`，`youtube`，`x` 或 `generic`。提供者永远不会授权更广泛的来源或绕过安全，重查或预检门；未知提供者会关闭。
**Instagram 操作模块。** 用于自动化 **您自己的** 已认证 Instagram 帐户的可重复使用的 JS 驱动程序流程位于 `engine/providers/instagram/` 下。它们需要一个真正的 Playwright `page`（不是 Playwright-MCP 模式）并配备内置的防护措施：默认情况下，写入是，DM 回复仅针对现有对话，批量回复有上限，限速，人工确认和可恢复
import { buildInstagramSession, instagramActions } from './engine/providers/instagram/index.mjs';
const session = buildInstagramSession(page, { stateDir: paths.stateDir, interactive: true });
const posts = await instagramActions.getUserPosts(session, 'nasa', { limit: 12 });
await instagramActions.likePost(session, 'https://www.instagram.com/p/ { dryRun: false });
```
</details>
## 运行时工作区
所有运行时状态都位于 `~/.hyper-cloaking/` 下（仅限沙箱测试，请覆盖 `HYPER_CLOAKING_HOME`）：
```
~/.hyper-cloaking/
├── cookie.yml # 站点/帐户 cookie 条目（从不提交）
├── profiles # 持久浏览器配置文件
├── downloads/ # 下载的文件
├── evidence/ # 报告和截图
├── logs/ # 运行日志
├── state/ # 速率限制窗口，可恢复状态
└── cache/cloakbrowser/ # 下载的隐身 Chromium 二进制文件
```
## 仓库布局
```
skills/hyper-cloaking/ # 规范技能（SKILL.md，引擎，规则，引用）
plugins/hyper-cloaking/ # 插件包装的副本，用于市场
.claude/skills/hyper-cloaking/ # Claude Code 技能镜像
.agents/skills/hyper-cloaking/ # AgentSkills 镜像
.claude-plugin/marketplace.json # 市场清单
.agents/plugins/marketplace Codex 市场清单
scripts/validate.m # 结构 + 镜像奇偶校验验证
```
技能目录保持字节对字节的镜像。使用 `npm run validate` 验证奇偶校验和元数据。
## 开发
```bash
npm run validate # 结构和镜像奇偶校验检查
npm run lint # 插件和脚本上的 oxlint
npm run format # prettier 写入
node skills/hyper-cloaking/engine/cli.mjs validate --json # 引擎自检（无网络）
```
测试与 `*.test.mjs` 文件一起位于 `engine/` 下，可以使用 `node --test` 运行。
---
<div align="center">
**MIT © alpox** — 构建于 [CloakBrowser](https://github.com/CloakHQ/CloakBrowser) + [Playwright MCP](https://github.com/microsoft/playwright-mcp)，仅限授权浏览。
</div>
