GitZhiQing ddgs-web-access：Web 搜索与网页抓取
基于 ddgs 的极简封装，只做文本搜索与网页抓取（图片 / 新闻 / 视频搜索不在范围内）：
| 命令 | 用途 |
|---|---|
ddgs-web-search |
按关键字搜索网页，返回 标题 / URL / 摘要 |
ddgs-web-fetch |
抓取指定 URL 的正文（默认转 Markdown，支持批量） |
对应原生工具的用法迁移：WebSearch ≈ ddgs-web-search（域名限定在关键字中加 site:example.com）；WebFetch ≈ ddgs-web-fetch（没有 prompt 参数——正文已是 Markdown，从中自行提取答案，长文用 --start 分段读）。
调用方法
标准形式（<skill_dir> 为本 skill 目录；命令不依赖当前工作目录）：
bash "<skill_dir>/bin/ddgs-web-search" "<关键字>" -m 5
bash "<skill_dir>/bin/ddgs-web-fetch" "<url>"
bash "<skill_dir>/bin/ddgs-web-fetch" "<url1>" "<url2>" # 批量抓取，以 ===== <url> ===== 分隔
等价形式：uv run --project "<skill_dir>" ddgs-web-search ...；Windows cmd/PowerShell 用同目录 .cmd 变体。全量参数见 --help。
常用参数
- 搜索：
-m结果数（默认 10，5-10 够用即可）；-t d/w/m/y时效过滤；-b bing|brave|duckduckgo|wikipedia指定引擎；--urls只输出链接、每行一个（适合串联批量抓取）；--format json结构化输出。 - 抓取：
--max-chars截断长度（默认 5000，长文按需调大，0 为不限）；--start N跳过前 N 字符，与--max-chars配合分段读长文；--no-cache绕过 15 分钟抓取缓存；--curl强制用系统 curl 抓取（默认模式失败时已会自动回退到 curl，一般无需手动指定）。
输出解读
搜索结果每项为 3 行块：序号+标题 / URL / 摘要，结果之间空行分隔。无结果时 stdout 为空、stderr 提示 no results found.、退出码为 0。stderr 出现 cache hit（缓存命中）、retrying（自动重试）、truncated ... (continue with --start N)（截断续读）均属正常提示，不是错误。引用来源时带上 href 链接；抓取到的正文默认是 Markdown，其中的链接与标题可直接引用。
稳定性与纪律
已内置：抓取失败自动改用系统 curl 重试（404/410 死链除外）；搜索遇瞬时异常自动重试一次（间隔 2s）。
仍需遵守（ddgs 是多引擎聚合，请求过频会被限流，表现为"连续空结果"）：
- 连续两次调用之间至少间隔 2 秒；
- 连续 2 次空结果或报错：等待 10-30 秒重试一次，仍失败则向用户说明网络/代理问题；
- 同一 URL 不要重复抓取，优先复用已获取的内容。
代理
需要代理时加 --proxy "http://127.0.0.1:7890"；未指定时依次回退 DDGS_PROXY → HTTPS_PROXY → HTTP_PROXY 环境变量。
故障排查
- 首次调用耗时 30-60 秒是正常的（uv 正在安装依赖），后续调用会快很多；
HTTP 404：页面不存在；TimeoutException：网络慢，可加--timeout 15重试；- 反复空结果：先检查网络与代理，再按限流退避处理；
- 安装、卸载与多 agent 分发见仓库
README.md。