Web-Access Skill 完全指南
本文档记录了 web-access skill 在 opencode 环境下的安装、配置过程，以及遇到的问题和解决方案。 目录 什么是 web-access skill 核心原理 安装步骤 CDP 模式配置 遇到的问题与解决方案 针对 Dia/opencode 的修改清单 API 参考 使用示例 最佳实践 什么是 web-access skill web-access 是一个为 AI Agent 提供完整联网能力的 skill，它补足了 Agent 在以下方面的能力： 能力 说明 联网工具自动选择 WebSearch / WebFetch / curl / Jina / CDP，按场景自主判断 CDP Proxy 浏览器操作 直连用户日常浏览器，天然携带登录态，支持动态页面、交互操作 并行分治 多目标时分发子 Agent 并行执行，共享一个 Proxy，tab 级隔离 站点经验积累 按域名存储操作经验，跨 session 复用 GitHub: https://github.com/eze-is/web-access 核心原理 架构图 ┌ │ └ ┌ │ │ │ │ │ └ ┌ │ │ └ ┌ │ │ └ ┌ │ │ └ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┌ │ │ └ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ 浏 ( ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ 览 S ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ 哲 K ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ 学 I ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ L ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ L ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ . ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ m ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │ d ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ) ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ C W ─ ─ ─ ─ ─ ─ ─ │ ─ ─ ─ ─ ─ h e ─ ─ ─ ─ ─ ─ ┐ │ ┘ ─ ─ ─ ─ r b ─ ─ ─ ─ ─ ─ 工 ─ ─ ─ ─ o S ─ ─ ─ ─ ─ ─ 具 ─ ─ ─ ─ m o ─ ─ ─ ─ ─ ─ ┌ 选 │ └ ─ ─ ─ ─ e c ─ ─ ─ ─ ─ ─ w ─ 择 ─ ─ ─ C l ─ ─ k ─ ─ 用 天 ─ ─ ─ ─ e ─ 策 ─ ─ ─ D o ─ ─ D e ─ ─ 户 然 ─ ─ ─ ─ b ─ 略 ─ ─ ─ P c ─ ─ e t ─ ─ 浏 携 ─ ─ ─ ─ - ─ ─ ─ ─ a ─ ─ v ─ ─ 览 带 ─ ─ o ─ ─ a ─ ─ ─ ─ P l ─ ─ T 连 ─ ─ 器 登 ─ ─ p ─ ─ c ─ │ ─ ─ ─ r h ─ ─ o 接 ─ ─ 录 ─ ─ e ─ ─ c ─ ─ ─ ─ o o ─ ─ o 到 ─ ─ ( 态 ─ ─ n ─ ─ e ─ ─ ─ ─ x s ─ ─ l 浏 ─ ─ D ─ ─ c ─ ─ s ─ │ ─ ─ ─ y t ─ ─ s 览 ─ ─ i ─ ─ o ─ │ ▼ ─ s ─ ─ ─ │ ▼ ─ : ─ │ ▼ ─ 器 ─ │ ▼ ─ a ─ ─ d ─ ─ ─ 站 ─ ─ ─ ( 3 ─ ─ P ─ ─ / ─ ─ e ─ ─ s ─ 点 │ ─ ─ ─ H 4 ─ ─ r ─ ─ C ─ ─ ─ ─ k ─ 经 ─ ─ ─ T 5 ─ ─ o ─ ─ h ─ ─ A ─ ─ i ┐ 验 ┘ ─ ─ T 6 ─ ─ t ─ ─ r ─ ─ g ─ ─ l │ ─ ─ P ─ ─ o ─ ─ o ─ ─ e ─ ─ l ─ ─ ─ ─ c ─ ─ m ─ ─ n ─ ─ ┌ ( └ ─ ─ A ─ ─ o ─ ─ e ─ ─ t ─ ─ ─ r ─ ─ ─ P ─ ─ l ─ ─ / ─ ─ ─ ─ ─ e ─ ─ ─ I ─ ─ ─ ─ A ─ ─ ─ ─ ─ f ─ ─ ─ ) ─ ─ ( ─ ─ r ─ ─ ─ ─ ─ e ─ ─ ─ ─ ─ C ─ ─ c ─ ─ ─ ─ ─ r ─ ─ ─ ─ ─ D ─ ─ ) ─ ─ ─ ─ ─ e ─ ─ ─ ─ ─ P ─ ─ ─ ─ ─ ─ ─ n ─ ─ ─ ─ ─ ) ─ ─ ─ ─ ─ ─ ─ c ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ e ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │ s ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ / ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ) ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │ ─ ─ ─ ─ ─ │ ─ ─ ─ ─ ─ │ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │ ─ ─ ─ ─ ┐ ┘ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ │ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ┐ ┘ ┐ │ │ ┘ ┐ ┘ ┐ ┘ ┐ ┘ │ │ │ │ │ 关键组件 SKILL.md: 核心 skill 文件，包含浏览哲学、工具选择策略、操作指南 cdp-proxy.mjs: Node.js 服务，提供 HTTP API 来操控浏览器 check-deps.sh: 环境检查脚本，验证依赖并启动 proxy references/: 参考文档和站点经验存储 工具选择策略 场景 推荐工具 搜索摘要或关键词结果 WebSearch URL 已知，需要从页面提取特定信息 WebFetch URL 已知，需要原始 HTML 源码 curl 需要登录态、交互操作、动态页面 浏览器 CDP 安装步骤 1. 克隆仓库到 opencode skills 目录 # 创建 skills 目录（如果不存在） mkdir -p ~/.config/opencode/skills # 克隆 web-access 仓库 git clone https://github.com/eze-is/web-access.git ~/.config/opencode/skills/web-access 2. 验证目录结构 ls -la ~/.config/opencode/skills/web-access/ # 预期输出： # SKILL.md # scripts/ # ├── cdp-proxy.mjs # └── check-deps.sh # references/ # ├── cdp-api.md # └── site-patterns/ 3. 设置执行权限 chmod +x ~/.config/opencode/skills/web-access/scripts/*.sh chmod +x ~/.config/opencode/skills/web-access/scripts/*.mjs 4. 验证 skill 已被识别 opencode 会在启动时自动扫描 ~/.config/opencode/skills/*/SKILL.md，skill 的 frontmatter 格式如下： ...