ChromeWalk

ChromeWalk

一个真实、私密的浏览器，可供你的 AI 使用，并在你自己的电脑上运行。

让你的 AI 助手打开网页、检查网站或收集数据，ChromeWalk 就会在你电脑上的专属浏览器中完成这些操作。无需云端中继，无需隧道，也绝不会使用你的个人 Chrome 配置文件。

网站 · 文档 · 下载 · 常见问题 · 隐私 · 条款

功能

• 在真实浏览器中打开网页，包括会阻止简单下载器的网页，并将文本、状态和标题交给你的 AI。遇到验证页面时会报告，但绝不会尝试破解。
• 截取屏幕截图并收集完整证据：你需要的各种屏幕尺寸、网页加载的每个文件，以及控制台和网络日志。
• 检查网站是否存在故障：在多个页面和屏幕尺寸上快速运行自检测试，内置 12 种问题检测器，还支持通过脚本点击和登录，以访问这些页面背后的内容。
• 跨浏览器测试：在 Chromium、Firefox 和 WebKit（Safari 的引擎）中打开同一页面，并突出显示差异。你也可以使用已安装的 Chrome、Edge 或 Brave，且始终使用 ChromeWalk 自己的私密配置文件。
• 审核设计和 SEO：检查网站各处的颜色、字体、间距和组件，进行 SEO 检查并按优先级列出修复项，还可与保存的版本进行视觉比较，以发现意外变化。
• 收集商店数据：从线上商店收集商品、价格、图片、规格和筛选条件，并保存为 JSON 或 CSV。
• 尽量减少 AI 的负担：提供 35 个工具，描述简短、结果精简；大型输出会保存为你电脑上的文件。

适用对象

已经在使用 AI 助手、希望 AI 助手能访问真实网页的开发者、QA 和 SEO 团队、设计师及研究人员。

适用于在你电脑上运行的 AI 应用。 只需运行一条命令 cw connect，即可为以下 16 款应用完成 ChromeWalk 设置：Claude Desktop、Claude Code、Codex、Cursor、Windsurf、Cline、Gemini CLI、带 GitHub Copilot 的 VS Code、Zed、Continue、GitHub Copilot CLI、Kiro、Amazon Q Developer、Kilo Code、Goose 和 Visual Studio（仅限 Windows，因此 Mac 上有 15 款）。任何支持本地 MCP 服务的其他应用也可以手动设置。

暂不支持： 在云端运行的聊天应用无法访问你电脑上的程序。这包括 ChatGPT（网页、桌面或手机端）、网页或手机端的 Claude，以及 Gemini 应用。使用 OpenAI 时，请选择 Codex：它目前已经可用。

运行平台： Windows 10 和 11（x64），以及搭载 Apple Silicon 的 macOS。目前尚无 Intel Mac 或 Linux 版本。 浏览器：Chromium、Firefox 和 WebKit，以及已安装的 Chrome、Edge 或 Brave。

快速开始

1. 安装 ChromeWalk。
   • Windows（PowerShell）：powershell -c "irm https://chromewalk.com/install.ps1 | iex"
   • Mac（终端）：curl -fsSL https://chromewalk.com/install.sh | bash
   • Windows 上的 Claude Desktop：改为安装 ChromeWalk 扩展程序。
2. 连接你的 AI 应用。 在新终端中运行 cw connect。它会查找你电脑上的 AI 应用，并为每个应用添加 ChromeWalk。然后重启应用。
3. 注册并激活。 向 AI 发送提示词：“用我的电子邮箱地址为我注册 ChromeWalk。” 密钥会通过电子邮件发送给你。然后发送提示词：“使用我邮件中的密钥激活 ChromeWalk”，或者在终端中运行 cw activate <key>。

然后试试：“截取我们主页的手机和桌面屏幕截图。”

安装 ChromeWalk

下面每个客户端都会使用你计算机上安装的同一个 ChromeWalk。两个安装脚本都会下载发行文件，将其 SHA-256 与 SHA256SUMS.txt 中的值核对，不匹配时立即停止（不会安装任何内容），以普通用户身份安装（无需管理员权限），并告知你下一步操作。

Windows：

powershell -c "irm https://chromewalk.com/install.ps1 | iex"

Mac（Apple Silicon）：

curl -fsSL https://chromewalk.com/install.sh | bash

更喜欢使用安装程序？ 下载 Windows 版 ChromeWalk （ChromeWalk-Setup-Windows.exe）或 Mac 版 ChromeWalk （ChromeWalk-macOS-AppleSilicon.pkg），也可以在下载页面选择。

更新： Windows 应用会自动更新。每次更新都会经过签名和检查后再安装；如果新版本未通过自检，系统会自动恢复到之前的版本（cw update --defer <days> 可延迟几天更新）。在 Mac 上，cw update --check 会告知你是否有新版本；重新运行安装程序即可更新。Claude Desktop 扩展会在有新版本时通知你；直接安装新版本即可覆盖旧版本。 了解更多更新信息。

连接你的 AI 应用

简单方式： 运行 cw connect（或 cw connect <app>，例如 cw connect codex）。它会查找你电脑上的各个 AI 应用，并将 ChromeWalk 添加到它们的设置中。可以安全地重复运行；首次修改前，它会备份设置文件；而且绝不会将你的许可证密钥写入任何应用。使用 cw connect --dry-run --json 预览操作；使用 cw connect --remove <app> 撤销更改。

要手动设置？ 每个应用使用相同的启动命令：command chromewalk，args ["mcp"]。 不要使用 cw，也不要通过 shell 启动（例如 cmd /c）。在 Windows 上，cw 是一个 .cmd 文件，AI 应用无法直接启动它。如果应用在 PATH 中找不到 chromewalk，请使用完整路径：

• Windows：%LOCALAPPDATA%\Programs\ChromeWalk\chromewalk.exe
• Mac：~/.local/bin/chromewalk（安装脚本）或 /usr/local/bin/chromewalk（安装包）

/plugin marketplace add chromewalk/app
/plugin install chromewalk@chromewalk

claude mcp add --scope user chromewalk -- chromewalk mcp

[mcp_servers.chromewalk]
command = 'chromewalk'
args = ['mcp']
startup_timeout_sec = 30
tool_timeout_sec = 1200

{
  "mcpServers": {
    "chromewalk": {
      "command": "chromewalk",
      "args": ["mcp"]
    }
  }
}

{
  "servers": {
    "chromewalk": {
      "type": "stdio",
      "command": "chromewalk",
      "args": ["mcp"]
    }
  }
}

gemini extensions install https://github.com/chromewalk/app

完整指南：https://chromewalk.com/docs/install-gemini-cli.html

{
  "mcpServers": {
    "chromewalk": {
      "command": "chromewalk",
      "args": ["mcp"]
    }
  }
}

技能： skills/ 中提供了适用于 Claude Code、Cursor 和 Codex 的现成指令（发布检查、跨浏览器测试、入门引导和故障排查）。将它们复制到你的 Agent 技能文件夹中。

许可与激活

ChromeWalk 是专有软件，需要许可证密钥。不提供无需密钥的试用：在计算机上激活密钥之前，所有会打开浏览器或检查页面的工具都会回复“需要许可证”，并告知你的 AI 如何注册。

**激活前可用的功能：**安装、连接 AI 应用、每个工具的帮助，以及以下工具： 注册和激活（register、activate）、健康检查（doctor）、进程清理（procs、reset）、 设置（config）、作业列表和取消（calls、cancel），以及保存问题备注（recommend）。

获取并激活密钥的方法：

1. 注册：访问 https://chromewalk.com/register.html，或让你的 AI 帮你注册（register 工具）。密钥 会发送到你的邮箱，并与该邮箱地址绑定。它绝不会显示在聊天中。
2. 激活：可通过以下任一方式激活：
   • 让你的 AI 帮你激活（activate 工具），或者在终端中运行 cw activate <key>，避免 将密钥输入聊天；
   • 将密钥粘贴到 Claude Desktop 扩展的 License Key 框中；
   • 设置 CHROMEWALK_LICENSE 环境变量（ChromeWalk 服务启动时读取；如果设备尚未激活，则会激活设备）；
   • 用于 CI 时，将 CHROMEWALK_LICENSE_FILE 指向密钥文件。
3. Windows：每台计算机激活一次。cw activate <key> --remember 会将密钥保存在 Windows Credential Manager 中，你的用户安装的其他所有 ChromeWalk 都会自动激活。

须知：

• **每个许可证可用于两台设备。**要换用新计算机，请在旧设备上运行 chromewalk license deactivate（或 从账户页面重置设备），然后激活新设备。
• **只需联网一次。**激活需要互联网连接。此后，ChromeWalk 会每 90 天在后台续期；如果续期失败，最多还能 离线运行 90 天。此宽限期仅适用于已激活的许可证，并非试用期。许可证一旦取消，会立即失效。

完整条款：LICENSE 和 https://chromewalk.com/LICENSE.txt。使用条款： https://chromewalk.com/terms.html。

隐私

ChromeWalk 在你的电脑上运行。它打开的页面会留在你的电脑上。

留在你电脑上的内容： 页面内容、屏幕截图和捕获的文件、文件路径、你的浏览器配置文件、登录信息和已保存的会话，以及你的代理和 Nimble 密码。

ChromeWalk 发送到 chromewalk.com 的内容：

• 许可证检查：你的密钥、你提供该密钥时填写的电子邮件（如有）、你的机器 ID 的加盐哈希、你的安装 ID、ChromeWalk 版本和操作系统；在你激活许可证和续期时发送到许可证服务器。
• 更新检查：你的发布渠道和已安装版本。
• 使用事件，与你的许可证关联。这是许可证的使用条件，无法关闭。每条事件都包含：
  • 一个安装 ID、你的机器 ID 的加盐哈希，以及你的许可证密钥的 SHA-256 哈希（license_hash），绝不会包含密钥本身；
  • 运行的工具、它是从命令行还是 AI 应用运行、退出代码和大致耗时；如果出错，只包含错误类型和固定的失败标签；
  • 所用选项的名称，绝不包含其值；
  • 工具处理的网页地址及其域名；登录信息、端口、查询字符串、# 后的所有内容和看起来像机密信息的路径部分会先在你的电脑上移除；
  • 你的 ChromeWalk 版本、操作系统和 CPU 类型、已安装的浏览器引擎、CPU 核心数和内存范围；安装和激活时还会包含你的语言、时区偏移、OS 构建版本、ChromeWalk 是否以管理员身份运行、磁盘空间范围，以及安装至今经过的天数。
• 反馈，仅当你使用 chromewalk feedback 发送时。

绝不会发送： 页面内容、屏幕截图、文件、文件路径、选项值、查询字符串、密码、代理或 Nimble 凭据、你的用户名或机器名，或使用事件中的许可证密钥。

仅在你启用时： 使用 Nimble 网络选项时，浏览器流量会通过你自己的 Nimble 账户；使用 Nimble 云回退时，Nimble 会代你打开页面。

运行 cw telemetry status，即可查看你的安装具体会发送哪些内容。完整字段列表： https://chromewalk.com/docs/privacy-telemetry.html。隐私政策：https://chromewalk.com/privacy.html。

验证下载文件

每个 GitHub Release 都包含一个 SHA256SUMS.txt，其中列出了每个发布文件的 SHA-256：ChromeWalk-Setup-Windows.exe、ChromeWalk-Claude-Extension.mcpb、ChromeWalk-macOS-AppleSilicon.pkg、install.ps1 和 install.sh。安装脚本会为你检查；如果要手动检查，请先比对哈希并阅读脚本，然后再运行。

Windows：

irm https://chromewalk.com/SHA256SUMS.txt -OutFile SHA256SUMS.txt
irm https://chromewalk.com/install.ps1 -OutFile install.ps1
(Get-FileHash install.ps1 -Algorithm SHA256).Hash.ToLower()      # must equal the install.ps1 line in SHA256SUMS.txt
Select-String install.ps1 SHA256SUMS.txt
powershell -ExecutionPolicy Bypass -File .\install.ps1 -DryRun   # verifies the installer, installs nothing
powershell -ExecutionPolicy Bypass -File .\install.ps1

Mac：

curl -fsSLO https://chromewalk.com/SHA256SUMS.txt
curl -fsSLO https://chromewalk.com/install.sh
shasum -a 256 install.sh && grep install.sh SHA256SUMS.txt       # the two hashes must match
bash install.sh --dry-run                                        # verifies the package, installs nothing
bash install.sh

安装程序文件： 下载文件和 https://chromewalk.com/SHA256SUMS.txt，然后将 Get-FileHash <file> -Algorithm SHA256（Windows）或 shasum -a 256 <file>（Mac）的结果与 SHA256SUMS.txt 中对应的行进行比对。

各工具的参考文档：https://chromewalk.com/docs/（每个工具对应一个 tool-*.html 页面，例如 https://chromewalk.com/docs/tool-fetch.html）。

README.md                        - this file
LICENSE                          - licence notice (full EULA at chromewalk.com/LICENSE.txt)
SECURITY.md                      - how to report a vulnerability
CHANGELOG.md                     - where to find the release notes
server.json                      - MCP Registry server descriptor
gemini-extension.json            - Gemini CLI extension manifest
GEMINI.md                        - context file loaded by the Gemini CLI extension
.mcp.json                        - example Claude Code project MCP config
.claude-plugin/plugin.json       - Claude Code plugin manifest
.claude-plugin/marketplace.json  - Claude Code marketplace listing
skills/                          - skills for Claude Code, Cursor and Codex
.github/ISSUE_TEMPLATE/          - bug report and feature request templates
docs/cursor-directory-listing.md - Cursor directory submission text

支持与链接

• 网站：https://chromewalk.com
• 什么是 ChromeWalk：https://chromewalk.com/docs/what-is-chromewalk.html
• 文档：https://chromewalk.com/docs/
• 常见问题：https://chromewalk.com/faq.html
• 安装或打包问题：此仓库的问题跟踪器
• 许可或账户问题：隐私政策 和使用条款中的联系信息
• 安全性：SECURITY.md
• 许可：LICENSE