Posts

本文档记录了 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 格式如下： ...

说明： 这里的服务器是腾讯云服务器，有公网IP的服务器 思路如下： 远程服务器上使用codex如果没有代理是无法运行的，所以这里的思路是在远程服务器上搭建一个代理，然后再运行codex Phase 1：远程服务器上配置 clash 1. 首先下载 Clash for Linux 首先，从官方 GitHub 发布页面 https://github.com/doreamon-design/clash/releases 下载适合你系统的 Clash 二进制文件。对于大多数 64 位系统，请选择 clash_2.0.24_linux_amd64.tar.gz 下载之后，将压缩包上传到云服务器上，可以放在 ~ 目录下，然后解压 tar -xvf clash_2.0.24_linux_amd64.tar.gz 此命令将生成三个文件：clash（可执行文件）、README.md 和 LICENSE。只需要 clash 二进制文件。然后授予执行权限： chmod +x clash 2. 创建 Configuration Directory Clash 将其配置文件存储在 ~/.config/clash/ 中。如果此目录不存在，请手动创建它： mkdir ~/.config/clash 然后，将两个必需的文件添加到此文件夹：config.yaml（你的订阅配置文件，定义节点、规则和端口） 和 Country.mmdb（来自 MaxMind 的 GeoIP 数据库，用于识别目标 IP 的国家或地区）。 ⚠️ 注意：config.yaml 文件来自你的付费订阅。你需要先在本地获取它，然后将其上传到你的远程服务器。Country.mmdb 文件通常随订阅自动下载。 购买订阅后，你可以按如下方式找到配置文件（这些操作在你的本地机器上执行，而不是在远程服务器上）： 打开您想要上传到远程服务器的订阅。右键单击并选择“打开文件”，这里可以用VScode打开，然后再在VScode中打开这个文件夹，这将自动导航到相应的.yaml配置文件。 在上传到远程服务器之前，将其重命名为config.yaml。 对于Country.mmdb文件，你可以尝试在父目录中查找。如果它没有随您的订阅自动下载，您可以选择下面列出的一种方法： 自动下载它： cd ~/.config/clash/ wget -O Country.mmdb "<https://cdn.jsdelivr.net/gh/Loyalsoldier/geoip@release/Country.mmdb>" Manually download it from MaxMind GeoIP Releases and then upload it to ~/.config/clash/. ...

环境介绍 建站工具：Hugo + Github + Netlify + Aliyun + CloudFlare 电脑环境：MacOS Sonoma (14.3.1) Hugo: Hugo Netlify: Netlify HUGO 安装 准备工作，安装： Git Go Dart Sass 接下来开始正式安装hugo, 使用homebrew进行安装 brew install hugo 安装好后查看版本信息 hugo version 创建一个 site hugo new site Bob_L # 创建了一个名为 Bob_L 的 site cd quickstart # 进入 site git init # 初始化 git git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke.git themes/ananke # 加入你的主题 echo "theme = 'ananke'" >> hugo.toml # 修改成你的主题 hugo server hugo server 之后，通过查看终端的 url 就可以看到你的网页了 注意：这里是使用 submodule ，因为如果使用 clone，可能会出错 加入 content hugo new content posts/my-first-post.md Hugo 会在 content/posts 目录下创建你的 content，最开始在 front matter 中 draft 的值是 true . 默认状态下， Hugo 并不会在建站过程中发布 draft 内容 ...

[[]]+++ title = ‘Hugo Learning’ date = 2025-04-21T14:09:03+08:00 draft = false Tags = [“Hugo”] +++ 个人主题配置 概述 这里选用的是 hugo-PaperMod PaperMod 有三种不同的模式（3 Modes）: Regular Mode. Home-Info Mode. Profile Mode. 主题安装 安装详细内容可以参考 hugo-PaperMod/wiki/Installation Make sure you install Hugo >= v0.112.4 主题的安装路径：/Users/bingxil/Bob_L_Hugo/themes PaperMode 的安装后的路径：/Users/bingxil/Bob_L_Hugo/themes/PaperMod 如果之前安装了，要重新删除的话，执行如下命令 git submodule deinit -f themes/PaperMod git rm -f themes/PaperMod rm -rf git/modules/themes/PaperMod 安装命令: git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod git submodule update --init --recursive # needed when you reclone your repo (submodules may not get cloned automatically) 最后，还需要在 hugo.yml add: ...