内容
# 思达克 — 面向 AI 编程代理的屏幕录制工具
停止为 bug 截图并输入大段解释。思达克记录任何浏览器会话 — 或者让您的代理记录它构建的内容 — 并将其转换为 **AI 编程代理可以操作的格式化上下文**：每次点击、控制台、网络请求、语音叙述和截图，所有时间同步。不仅仅是截图。不只是视频。
与 **Claude Code**、**Cursor**、**Cline**、**Windsurf** 和任何 MCP 客户端配合使用。
## 安装
```bash
npx @thinkrun/mcp
```
或者全局安装 CLI：
```bash
npm install -g @thinkrun/cli
```
CLI 自动安装原生主机二进制文件，允许 AI 工具控制 Chrome。
## 添加到您的 MCP 配置
```json
{
"mcpServers": {
"thinkrun": {
"command": "npx",
"args": ["@thinkrun/mcp"]
}
}
}
```
配置位置：
- **Claude Code**：`~/.claude/settings.json`
- **Cursor**：`.cursor/mcp.json`
- **Cline**：VS Code 设置 → Cline MCP 服务器
然后询问您的代理： *"导航到 localhost:3000 并截图结账页面"* — 或者自己记录错误并将结果交给代理。
## 为什么选择思达克
其他工具给您的代理以眼睛。思达克给予它 **结构化视图** — 上下文可以一次性解析，而不是您重新解释页面。
| | 思达克 | Playwright MCP |
|---|---|---|
| 记录会话为结构化、可重放的上下文 | ✅ | ❌ 仅驱动 |
| 将录制内容转换为 AI 可读报告（点击、控制台、网络） | ✅ | ❌ |
| 可分享链接，也支持 LLM 准备的 Markdown / JSON | ✅ | ❌ |
| 使用您的真实 Chrome — 您的 cookie 和会话 | ✅ | ❌ 仅无头 |
| 与您的浏览器一起运行，无配置文件冲突 | ✅ | ❌ 争夺 Chrome 配置文件 |
## 面向 Claude Code、Cursor、Codex 和 Gemini CLI 的代理技能
四个可移植的 [代理技能](https://agentskills.io) 包含在此仓库中，为每个主要框架镜像（`.claude/skills/`、`.cursor/skills/`、`.codex/skills/`、`.gemini/skills/`）：
- **网页浏览** — 以编程方式浏览网页：驱动真实或云浏览器以导航、交互、提取和截图。
- **用户体验审计** — 作为真实用户遍历产品 UI，截图每一步，并生成带有优先级修复列表的结构化 UX 报告。
- **thinkbrowse-cli** — 通过 `thinkrun` CLI 从 shell 脚本驱动浏览器。
- **thinkbrowse-mcp** — 通过思达克 MCP 服务器的工具驱动浏览器。
**无需克隆安装** — 仓库作为实时 MCP 服务器提供，每次提交都会自动更新：
```json
{ "mcpServers": { "thinkrun-skills": { "url": "https://mcp.skillsovermcp.com/mcp/dundas/thinkrun" } } }
```
**触发准确性经过衡量，不只是声称。** 每个技能都附带一个 20 查询触发器评估夹具，[`evals/BENCHMARK.md`](evals/BENCHMARK.md) 发布结果：在 16 个已发布的模型配置中，12 个配置的路由准确性为 79–80/80（GPT-5.4/5.5/5.6 和 Claude Sonnet/Opus/Fable 系列；异常值是记录的严格读取模式，而不是崩溃），加上目录消融运行，显示技能在安装为子集时吸收彼此的流量。使用 `bun evals/run-eval.ts build` 重新生成。
## 手动二进制安装
如果您需要使用 CLI 安装原生主机二进制文件，请从 [最新版本](https://github.com/dundas/thinkrun/releases/latest) 下载适用于您平台的二进制文件并运行：
```bash
chmod +x thinkbrowse-host-* && ./thinkbrowse-host-* --install
```
> 原生主机二进制文件目前仍保留 `thinkbrowse-host` 文件名 — 它是相同的签名二进制文件，在重命名后未更改。
## 常见问题
### 如何让 Claude Code（或 Cursor）访问我的浏览器？
添加思达克作为 MCP 服务器 — `npx @thinkrun/mcp` — 您的代理可以驱动和读取真实的 Chrome 会话，包括您的 cookie 和登录信息。请参阅上面的“添加到您的 MCP 配置”。
### 如何向 Cursor 显示 UI 错误而不是粘贴截图？
使用思达克记录错误。您的代理获得结构化工件 — 您采取的步骤、控制台错误、失败的网络请求和 DOM 状态在它损坏的那一刻 — 因此它可以修复实际问题而不是根据图片进行猜测。
### 是否有使用我的真实 Chrome cookie 和会话的 MCP 服务器？
是的。思达克通过原生主机运行在您的真实 Chrome 上，因此身份验证页面直接生效 — 无需无头重新登录，无需单独的配置文件，也无需与浏览器争夺 Chrome 配置文件。
### 如何为 AI 编程代理记录浏览器会话？
运行 `npx @thinkrun/mcp`（或 `npm i -g @thinkrun/cli`）并记录任何会话 — 或让代理记录它构建的内容。思达克将其转换为 AI 可读报告（点击、控制台、网络、叙述、截图，所有时间同步），可作为可分享的链接和 LLM 准备的 Markdown/JSON 提供。
### 如何为我的 AI 编程代理提供有关问题的信息？
交给它一个思达克录音。结构化的“发生了什么” — 操作、首次错误信号、预期与实际、以及元素状态 — 正是代理需要的上下文，以便在第一次尝试中解决修复问题。
## 更多
- [thinkrun.ai](https://thinkrun.ai?utm_source=github&utm_medium=readme&utm_campaign=thinkrun-repo)
- [隐私政策](https://thinkrun.ai/privacy)
