DeepSeek Harness (DSH) 采用插件化架构,扩展能力通过插件实现。在研究与分析类场景中,手动跨平台搜集资料、交叉验证和生成报告效率较低。dsh-harvest 是一款原生多平台调研流水线插件,提供从发现、抓取、验证到审计的全链路自动化能力,支持在 Windows / macOS / Linux 三平台运行。
该插件由用户 toustifer 维护,开源协议为 MIT。它提供五个原生工具,构成 scout → extract → verify → audit 的数据流,输出结构化 JSON 与文本供 Agent 读取。
核心能力¶
插件提供以下五个原生工具,每个工具都有明确的失败策略,确保单点故障不影响整体流水线:
harvest_scout:多平台并行发现候选来源。支持 GitHub、Web、Twitter、Reddit、小红书、YouTube、B站、V2EX、LinkedIn、Telegram、LINUX DO 共 11 个数据通道。若单个通道失败(如未安装对应 CLI 或未登录),会记[SKIP]并继续运行,不阻塞后续步骤。harvest_deep_research:异步端到端深度调研。用于生成长篇综合研报与信源,具备超时/异常安全回退机制。harvest_extract:逐条抓取正文。支持 RSS 解析与小宇宙播客转写(需 groq key),具备自动升级抓取策略(如 Jina Reader)与 paywall/unreachable 标记能力。harvest_verify:跨源交叉验证断言。对关键断言进行一致性比对,输出一致/弱/未证实三种状态。harvest_audit:来源可信度五维审计。对来源进行评分,输出可信/谨慎/弃用状态。
数据通道与依赖¶
插件通过底层 CLI 工具连接各平台。未安装对应 CLI 时,通道会自动跳过。
必需的 CLI 工具¶
- gh:GitHub 搜索。
- mcporter:Web/Exa 搜索与 LinkedIn 招聘信息抓取。
- opencli:Twitter、Reddit、小红书等社交平台抓取。
- yt-dlp:YouTube 视频抓取。
- bili-cli:B站视频抓取(注意:这是第三方非官方客户端,需从可信来源获取)。
- mcp-telegram:Telegram 搜索(需配置 Python 环境或指定路径)。
- linuxdo-mcp:LINUX DO 搜索(需配置 Cookie)。
- feedparser:RSS 解析(Python 包)。
平台差异与注意事项¶
- Windows:小宇宙通道不可用;
mcporter/opencli需经 PowerShell 垫片调用。 - macOS / Linux:若通过 Finder 或 LaunchAgent 启动 DSH,可能遇到 PATH 问题(如找不到
/opt/homebrew/bin下的工具),建议从终端启动或显式配置 PATH。 - B站:依赖非官方客户端
bili-cli,存在合规与安全边界风险,请自行核验。
安装与启用¶
推荐使用 DSH 原生市场或 CLI 命令安装。
- 安装插件:
dsh plugin --profile web add @stifer/dsh-harvest
- 配置启用:
在<dshHome>/profiles/web/cordis.patch.yml中追加以下内容:
- insert:
- id: harvest
name: '@stifer/dsh-harvest'
典型用法¶
以下是插件提供的主要接口调用示例:
- 全平台广播发现:
harvest_scout(query="最新 AI 项目", limit=8)
- 定向通道发现:
harvest_scout(query="DeepSeek 优化实践", platforms=["github", "linuxdo", "telegram", "web"], limit=5)
- 端到端深度调研:
harvest_deep_research(input="深入剖析大模型推理与架构演进")
- 正文穿透抓取:
harvest_extract(urls=["https://…", "https://…"])
- 跨源交叉验证:
harvest_verify(claims=["DeepSeek 出了视觉模型"], sources=[…])
- 来源可信度审计:
harvest_audit(sources=[{title, url, type}])
配置说明¶
插件支持通过环境变量或 DSH 原生凭据管理配置 Tavily 等服务。
1. 深度情报通道配置¶
Telegram 与 LINUX DO 需要配置 Python 解释器路径及会话信息:
TELEGRAM_PYTHON:驱动 Telegram 的 Python 解释器路径。TELEGRAM_MCP_PATH:mcp-telegram项目目录。LINUXDO_PYTHON:驱动 LINUX DO 的 Python 解释器路径。LINUXDO_MCP_PATH:linuxdo-mcp项目目录。LINUXDO_COOKIE:LINUX DO 的会话 Cookie,未提供时自动跳过。
2. Tavily 深度调研配置¶
支持 DSH 凭据管理或系统环境变量。在 ~/.dsh/settings.yaml 中配置:
harvest:
tavilyApiKeyEnv: TAVILY_API_KEY
tavilyEndpoint: https://search.cliproxyapi.xyz/search
tavilyResearchEndpoint: https://search.cliproxyapi.xyz/research
随后在 ~/.dsh/.credentials.yaml 中保存 Key。
总结¶
dsh-harvest 通过将多平台调研流程标准化,降低了 Agent 调研的复杂度。它通过模块化的工具集和优雅的降级策略,支持在混合环境中稳定运行。插件目录页:https://dshfind.com/zh/plugins/toustifer/dsh-harvest
代码仓库:https://github.com/toustifer/dsh-harvest