Ddg

核心用法

ddgr 是一款基于 Python 的命令行 DuckDuckGo 搜索工具，适用于需要在终端环境中快速获取网页搜索结果的场景。用户可通过 snap run ddgr "查询词" --np 进行非交互式搜索，或直接运行进入交互模式浏览结果。工具支持时间过滤（d/w/m/y）、站点限定搜索、JSON 结构化输出、以及 DuckDuckGo 特有的 Bangs 快捷指令（如 !w 直达 Wikipedia）。

显著优点

1. 隐私优先设计：默认启用 Do Not Track，无用户画像追踪，支持 Tor 代理和 HTTPS 代理，搜索历史不留存
2. 终端原生体验：无需打开浏览器即可获取结果，JSON 输出便于脚本化处理和自动化工作流集成
3. DuckDuckGo 生态完整支持：原生集成 13,000+ Bangs 快捷搜索，大幅提升特定站点检索效率
4. 轻量部署：Snap/PPA/源码三种安装方式，依赖仅 Python 3.8+

潜在局限

• DuckDuckGo HTML 接口响应速度偶慢于主站
• 交互模式依赖终端环境，部分移动端 SSH 客户端体验受限
• 区域限制可能因网络环境导致无结果返回
• 安全搜索 --unsafe 选项需显式开启，误操作可能影响结果过滤

适合人群

• 开发者、运维工程师等高频终端用户
• 隐私敏感型用户（ journalist、安全研究人员）
• 需要自动化搜索数据抓取的脚本编写者
• 低带宽或图形界面受限的远程服务器环境使用者

常规风险

| 风险类型 | 说明 |

|---------|------|

| 网络层 | 虽支持代理，但默认直连仍暴露搜索关键词至 ISP |

| 误操作 | `--ducky` 自动打开首条结果，可能跳转至恶意站点 |

| 依赖安全 | Snap/PPA 源需信任，源码安装需审计 Python 依赖 |

| 功能局限 | 部分 DuckDuckGo 高级功能（如即时答案卡片）无法完整呈现 |

核心用法

ddgr 是一个命令行 DuckDuckGo 搜索工具，专为终端用户设计，无需打开浏览器即可执行隐私保护型网页搜索。核心使用方式是通过 snap run ddgr "搜索词" 配合各类参数实现精准检索。

基础检索模式（推荐日常使用）：

• 非交互模式：--np 参数直接输出结果到终端
• 结果数量控制：--num 5 指定返回条数（0-25）
• 时间限定：--time w/m/y 分别检索过去一周/月/年
• 站点限定：--site github.com 实现站内搜索
• JSON 输出：--json 便于程序化解析

交互模式：省略 --np 进入分页浏览，支持数字快捷键直接打开浏览器、n/p 翻页、q 退出。

DuckDuckGo Bangs 集成：支持 !w（维基百科）、!yt（YouTube）、!gh（GitHub）等快捷搜索指令，大幅提升效率。

---

显著优点

1. 隐私优先设计：默认启用 Do Not Track，无用户画像追踪，支持 Tor 代理，搜索历史不留存
2. 终端原生体验：无需切换上下文，在命令行 workflow 中无缝获取信息
3. 灵活输出格式：纯文本便于管道处理，JSON 支持自动化脚本集成
4. 丰富的筛选维度：时间、地域、站点、安全搜索等多维度精准控制
5. 轻量无依赖：仅需 Python 3.8+，Snap/PPA/源码多途径安装

---

潜在缺点与局限性

1. 功能性边界：仅返回搜索结果的标题/摘要/URL，无法渲染网页内容，复杂信息仍需跳转浏览器
2. 速度限制：DuckDuckGo HTML 接口响应慢于主站，高峰时段可能延迟
3. 地域可用性：部分地区 DuckDuckGo 服务受限，需配合代理使用
4. Snap 生态依赖：Ubuntu 推荐 Snap 安装，但 Snap 容器可能带来额外的权限管理复杂度
5. 无离线能力：完全依赖网络连接，无本地索引或缓存机制

---

适合人群

• 开发者/运维工程师：在 SSH 远程服务器或容器环境中快速查文档、搜报错
• 隐私敏感用户：避免传统搜索引擎的追踪和广告画像
• 自动化脚本编写者：通过 --json 和 --np 将搜索集成到 CI/CD 或数据管道
• 键盘操作偏好者：追求全键盘、无鼠标的高效工作流
• 教育/科研场景：需要可复现、可记录的搜索过程（命令行历史天然可审计）

---

常规风险

| 风险类别 | 说明 | 缓解建议 |

|---------|------|---------|

| 安装权限 | 文档示例含 `sudo` 命令，需用户主动授权 | 确认仅用于官方包管理器，勿执行来源不明的安装脚本 |

| 代理配置 | `--unsafe` 参数禁用安全搜索，可能返回不适内容 | 公共场合使用保持默认安全搜索开启 |

| 网络依赖 | 所有搜索实时联网，无本地备用 | 关键场景预下载或配置离线文档 |

| 第三方仓库 | 源码安装指向 GitHub 社区项目（jarun/ddgr） | 定期关注上游安全公告，优先使用 Snap/PPA 官方渠道 |

---

安全认证摘要

本 Skill 为纯文档型，无可执行代码，经 CLS-Certify v2.1.0 扫描获评 S级（95分）。所有风险项均为文档示例级别的误报（sudo 安装指引、shell 别名配置），无实际恶意行为。引用来源为 T2 级可信社区项目（jarun/ddgr，2500+ stars），符合 GDPR/CCPA 数据最小化原则。