前言¶
DeepSeek Harness（DSH）采用插件化架构，旨在将决策逻辑与执行能力解耦。在开发智能体时，一个常见的问题是“何时该联网搜索”难以通过 Prompt 严格约束，容易导致模型凭记忆回答，或产生幻觉。
dsh-see-world 是一个 DSH 决策层插件，它解决的核心问题是：强制“先搜后答”。它不负责执行搜索，只负责判断消息是否需要联网，并将决策结果注入到对话流程中。
插件定位¶
该插件由 windygo123 维护，开源协议为 MIT。它位于决策层，负责判定“这条消息需不需要新鲜信息”，而不是“怎么搜”。它将“靠自觉”的搜索策略转变为“靠机制”的强制执行，同时确保本地任务（代码、文件、计算）不受干扰。
核心功能¶
根据已核实的功能列表，该插件具备以下能力：
- 先搜后答：判定需要联网的消息，强制在回答前执行搜索，并引用来源。若搜不到，会明确标注“不确定”。
- 零打扰：纯本地任务（代码、闲聊等）默认毫秒级放行，不上网、不闪屏、不消耗判定资源。
- 当前信息优先：针对时效性强的查询（如行情、版本、政策），默认优先联网核实。
- 故障不崩：当搜索插件未安装、判定器出错或超时（8秒）时，插件会静默降级，不中断对话流程。
- 决策可观测：提供本地 JSONL 日志，记录判定理由、耗时、成本及是否搜索。
- 隐私友好：判定默认复用会话模型；支持本地 Ollama 模型进行判定，数据不离开本地机器。
安装与启用¶
安装该插件需要管理员权限。安装完成后，建议重启 DSH GUI 以确保设置卡片和状态条加载生效。
dsh plugin --profile web add dsh-see-world
典型用法¶
插件开箱即用，默认触发档位为“宁多勿漏”（不确定即触发）。用户可以通过消息前缀或自然语言指令精确控制行为：
- 强制禁止搜索：消息以
不搜开头，本条消息将跳过搜索判定。 - 强制搜索：消息以
先搜开头，本条消息将强制执行搜索后再回答。 - 自然语言：使用
这个不用搜或先查一下也能生效。
在触发搜索的回合，回复末尾会自动附带 🔍 已搜索 N 个来源 的标记。
配置与生态¶
可视化配置¶
插件支持在 DSH GUI 的设置页面中进行可视化配置（命名空间 open-eyes），包括判定模型选择、搜索预算、白名单/黑名单等。修改配置后，下一回合立即生效。
依赖说明¶
该插件不自带搜索引擎。它依赖于 DSH 的搜索能力层插件（如 Tavily、SearXNG provider 或内置 web_search）来执行实际的搜索动作。若未安装任何搜索能力插件，该插件会静默降级，仅记录日志而不执行搜索。
隐私与日志¶
决策日志默认存储在本地 ~/.dsh/dsh-open-eyes/decisions/ 目录，格式为 JSON Lines。默认只保存摘要，开启 log_input_verbatim 后才会保存判定输入的原文。这些日志不上传服务器。
适用场景¶
适合需要严格把控信息时效性的 DSH 工作流开发场景。通过该插件，开发者可以强制模型在处理新闻、技术文档更新、实时数据等任务时先联网核实，避免使用过时信息。
