核心用法
desearch-web-search 是一个轻量级的实时网页搜索技能，通过调用 Desearch AI API 返回结构化的搜索结果（标题、URL、摘要）。核心交互方式为命令行调用，支持基础搜索和分页查询。
典型调用方式：
desearch.py web "搜索关键词" # 基础搜索 desearch.py web "关键词" --start 10 # 分页，从第 10 条结果开始
返回格式：JSON 结构，包含 title（标题）、snippet（摘要片段）、link（链接），每页最多 10 条结果。
---
显著优点
1. 极简依赖架构：零第三方依赖，仅使用 Python 标准库（urllib、json、os、argparse），彻底消除供应链攻击风险，部署极轻量。
2. 安全设计优秀：安全认证评分 92 分，S 级。无危险函数调用（无 eval/exec/os.system/subprocess），无文件系统越界访问，HTTPS 加密传输，隐私数据最小化。
3. 行为透明可控：网络请求仅指向 api.desearch.ai 官方端点，无第三方数据共享，请求超时保护（60 秒），输入参数通过 argparse 规范化解析。
4. 错误处理完善：覆盖 401（未授权/无效 API Key）、402（余额不足）等典型场景，返回结构化的 JSON 错误信息。
---
潜在缺点与局限性
1. 外部 API 依赖：核心功能完全依赖 Desearch AI 服务的可用性与定价策略，存在服务中断或价格变动风险；免费额度或余额耗尽后需付费续费。
2. 功能相对单一：仅支持基础网页搜索，无高级筛选（时间范围、站点限定、语言过滤）、无搜索结果缓存、无并发请求优化。
3. 分页限制：每次最多返回 10 条结果，需手动计算 --start 参数进行翻页，无便捷的自动翻页或结果聚合机制。
4. 来源可信度待提升：当前为 T3 级（个人开发者/社区项目），无开源代码仓库供社区审计，长期维护承诺不明确。
---
适合人群
- 需要即时网络信息的 AI 工作流：为 LLM 提供实时外部知识补充，突破训练数据时间限制。
- 轻量级自动化脚本场景：对依赖安全性要求极高、不愿承担第三方包漏洞风险的环境。
- 隐私敏感型用户：不希望搜索查询经过多个中间商或广告追踪系统的场景。
- 快速原型验证：需要快速集成搜索能力而不引入复杂依赖的开发者。
---
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 服务可用性风险 | 中 | 依赖单一外部 API，服务商故障或终止服务将导致功能完全失效 |
| 成本控制风险 | 中 | API 调用按量计费，高频使用可能产生意外费用，需监控余额 |
| API Key 泄露风险 | 低 | 需通过环境变量配置，用户若硬编码到脚本则存在泄露风险 |
| 数据隐私风险 | 低 | 搜索关键词传输至第三方服务，虽经 HTTPS 加密，但仍存在服务商层面的数据收集可能 |
| 供应链风险 | 极低 | 零第三方依赖，该维度风险几乎为零 |
缓解建议：妥善保管 API Key（使用环境变量或专用 secrets 工具）、监控 API 使用日志、评估服务商长期稳定性、考虑实现本地缓存减少重复调用。