web-access
This skill should be used when the user needs to access the web beyond simple search or static page fetching — including logging into sites, interacting with dynamic pages, scraping content behind authentication, automating browser operations, or performing any task that requires operating a real browser. Triggers include: "帮我登录", "抓取这个页面", "自动点击", "浏览器操作", "需要登录才能看", "动态页面", "截个图", and similar web interaction requests.
Quellinformationen
- Repository
- gyjiang/workbuddy-memory
- Letzte Quellaktivität
- 20. April 2026 um 09:43
- Erkannte Sprache von SKILL.md
- Chinesisch
- Sterne
- 0
- Forks
- 0
Installationsoptionen
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
Datei-Explorer
4 DateienSKILL.md wird angezeigt
SKILL.md
Quellanweisungen · Schreibgeschützte Vorschau- name
- web-access
- description
- This skill should be used when the user needs to access the web beyond simple search or static page fetching — including logging into sites, interacting with dynamic pages, scraping content behind authentication, automating browser operations, or performing any task that requires operating a real browser. Triggers include: "帮我登录", "抓取这个页面", "自动点击", "浏览器操作", "需要登录才能看", "动态页面", "截个图", and similar web interaction requests.
# web-access
完整联网能力扩展：三层通道调度 + 浏览器 CDP 直连 + 并行分治。
## 前置检查
开始任何浏览器 CDP 操作前，先运行环境检查脚本确认就绪：
```bash
node ~/.workbuddy/skills/web-access/scripts/check-deps.mjs
```
若检查未通过，引导用户完成设置：
- **Node.js 22+**：必需（使用原生 WebSocket）。低于 22 可用但需安装 `ws` 模块。
- **Chrome remote-debugging**：在 Chrome 地址栏访问 `chrome://inspect/#remote-debugging`，勾选 **"Allow remote debugging for this browser instance"**，可能需重启浏览器。
检查通过后，在回复中向用户直接展示以下须知，再执行 CDP 操作：
```
温馨提示：部分站点对浏览器自动化操作检测严格，存在账号封禁风险。已内置防护措施但无法完全避免，继续操作即视为接受。
```
## 浏览哲学
**像人一样思考，兼顾高效与适应性完成任务。**
执行任务时不过度依赖预设步骤，而是带着目标进入，边看边判断，遇到阻碍就解决，发现内容不够就深入——全程围绕「我要达成什么」做决策。
## 联网工具选择
确保信息真实性，一手信息优于二手信息。
| 场景 | 工具 |
|------|------|
| 搜索摘要或关键词结果，发现信息来源 | **WebSearch 工具** |
| URL 已知，需定向提取特定信息 | **WebFetch 工具** |
| URL 已知，需要原始 HTML 源码 | **execute_command: curl** |
| 非公开内容，或已知静态层无效的平台 | **浏览器 CDP** |
| 需要登录态、交互操作，或需要在浏览器内自由导航探索 | **浏览器 CDP** |
**Jina**（可选预处理层）：第三方服务，可将网页转为 Markdown，节省 token 但可能有信息损耗。
`curl -s "https://r.jina.ai/https://example.com"`
## 浏览器 CDP 模式
通过 CDP Proxy 直连用户日常 Chrome，天然携带登录态，无需启动独立浏览器。
### 启动 Proxy
```bash
node ~/.workbuddy/skills/web-access/scripts/check-deps.mjs
```
check-deps.mjs 会自动检测 Chrome 调试端口并以后台守护进程方式启动 cdp-proxy.mjs（监听 localhost:3456）。Proxy 启动后保持运行，重启需 Chrome 重新授权。
### Proxy API 调用（通过 execute_command 执行 curl）
```bash
# 列出用户已打开的 tab
curl -s http://localhost:3456/targets
# 创建新后台 tab
curl -s "http://localhost:3456/new?url=https://example.com"
# 执行任意 JS（POST body 为表达式）
curl -s -X POST "http://localhost:3456/eval?target=TARGET_ID" -d 'document.title'
# 截图保存到本地
curl -s "http://localhost:3456/screenshot?target=TARGET_ID&file=/tmp/shot.png"
# 点击元素（CSS 选择器）
curl -s -X POST "http://localhost:3456/click?target=TARGET_ID" -d 'button.submit'
# 滚动页面
curl -s "http://localhost:3456/scroll?target=TARGET_ID&y=3000"
# 关闭 tab
curl -s "http://localhost:3456/close?target=TARGET_ID"
```
详细 API 参考：加载 `references/cdp-api.md`
### 三种点击方式
1. `/click` — JS 层面 `.click()`，简单快速，覆盖大多数场景
2. `/clickAt` — 真实 CDP 鼠标事件，可触发文件对话框、绕过部分反自动化检测
3. `/setFiles` — 直接设置文件 input，绕过文件选择对话框
## 并行调研：子 Agent 分治策略
任务包含多个独立调研目标时，合理分治给子 Agent 并行执行，提升效率。
## 信息核实类任务
核实目标是**一手来源**，而非更多二手报道。
## 站点经验
操作中积累的特定网站经验，按域名存储在 `~/.workbuddy/skills/web-access/references/site-patterns/` 下。
确定目标网站后，读取对应站点经验文件（如存在）：
```
~/.workbuddy/skills/web-access/references/site-patterns/{domain}.md
```
## References 索引
- `references/cdp-api.md`：需要 CDP API 详细参考时加载
- `references/site-patterns/{domain}.md`：确定目标网站后读取对应站点经验
Auf GitHub ansehen