前言¶

在 DeepSeek Harness（DSH）里让智能体「联网查资料」时，常见问题是：引用是否与原文一致、原始材料是否留存、结论能否对照证据复核。泛泛的网页摘要很难支撑需要出报告、要可追溯引用的任务。

下面介绍社区插件 dsh-deep-insight（仓库 genesis-agents/dsh-deep-insight）。它在当前 DSH 对话中增加一套研究工作流：采集来源、保留原件、抽取证据、分析发现并导出可读报告；获取失败或不完整的证据会保留可见，而不是被悄然抹掉。插件归类为联网工具，由 genesis-agents 维护；README 标明其为实验性插件。目录页：https://www.skillhub.cn/plugins/genesis-agents/dsh-deep-insight。

这是什么¶

dsh-deep-insight 是发布在 npm 上的 DSH 插件包（当前资料中的版本为 0.2.0-alpha.34），定位是「Evidence-based research workspaces」——在 Harness 内建立以证据为中心的研究工作区，并产出带精确引用的可读报告。

与「只在对话里贴几段摘要」相比，它强调：材料与证据分层保存、报告中的句子级上标关联证据、对话 UI 中的 Deep insight 标签页 汇总来源、证据、分析与交付检查。

核心功能¶

以下能力均来自官方 README，且可在安装后通过 deep_insight 工具的 guide action 查看工作流与输入 schema。

研究工作流¶

1. 向智能体提出需要调研的问题。
2. 通过工具与捆绑的 Python 引擎完成采集、抽取与分析；富化（enrichment）使用宿主机配置的模型与 Web 服务，嵌入模型可能在首次使用时下载。
3. 在对话的 Deep insight 标签页查看已保存的来源、证据、分析与交付检查；每个对话有独立的研究工作区，profile 下配置的分析引擎可共享。

可读项目目录与报告¶

可读的项目文件夹包含：任务、原始材料、证据、分析、交付物、更新历史与概览。报告将证据以句子级上标链接；说明可附带原始图表。执行历史有集中入口。

知识结构化与图谱¶

保存的节点与有向关系以交互图展示（relationship 与 circle 布局）。节点大小反映连接数；选中节点可高亮邻域。可切换关系标签、全屏并在图旁查看证据详情；支持按节点标签或关系搜索、缩放平移。图谱渲染失败时可重试或使用列表视图，已有结果不必重新生成。需知：自动生成的关系仍为未审阅的分析。

证据引用展示¶

每条证据引文以单独引用块呈现原文字面；过长引文默认折叠为四行并可展开。可通过「原始证据」链接单独打开来源上下文。

材料去重与归档¶

同一来源、同一项目下，若原始字节与提取文档一致，则共享一个材料文件夹；每次采集仍在该材料历史下保留来源记录。内容变更则分开保存。刷新归档时，阅览副本可能被 supersede 到 outputs/reading-room/superseded-material-views；原件、数据库记录与不可变阅览版本保持不变。

模型与宿主集成¶

标准 DSH 工具与可选的 native-agent MCP 桥接共享同一研究 schema；工具身份、模型选择与权限由执行中的智能体决定。订阅类操作依赖宿主调度器；仅在提供可选桥的宿主上才有 native-agent 完成约束。

安装与启用¶

环境要求（README 原文）：Node 24.9 或更新、DeepSeek Harness 0.2.2-rc.1、uv 与 Python 3.13。通过 DSH 支持的插件管理器安装已发布的 npm 包；亦可使用发布归档。

官方安装与初始化命令如下：

dsh plugin --profile web add dsh-deep-insight@0.2.0-alpha.34
dsh plugin --profile web exec node node_modules/dsh-deep-insight/scripts/setup-engine.mjs --profile web
dsh --profile web

setup-engine 会校验捆绑的 engine 文件，复制到带版本号的可写 profile 目录，并用冻结 lockfile 执行 uv sync。若已存在显式 deep-insight.json 配置则保持不变；若运行时文件被改动会导致错误。可选视频下载依赖可在 setup 时加 --media；PDF 按页渲染额外需要 pdftoppm。

若 pnpm 出现 ERR_PNPM_IGNORED_BUILDS，需在已安装 profile 的 pnpm-workspace.yaml 中允许下列构建依赖后，移除失败包并重新安装：

allowBuilds:
  onnxruntime-node: true
  protobufjs: true

移除并重装示例：

dsh plugin --profile web remove dsh-deep-insight

然后重复上述 add 与 setup-engine 步骤；部分安装后也可借此恢复 bundle 激活。

package.json 标明插件面向 web 客户端，并注入对话与右侧边栏 UI；与 DSH 0.2.2-rc.1+ 兼容。许可证为 MIT。

典型用法¶

1. 按上一节完成 web profile 下的安装与 setup-engine。
2. 启动 dsh --profile web，在新对话中用自然语言描述调研问题。
3. 让智能体调用 deep_insight 工具；可先查看 guide action 了解步骤与输入格式。
4. 在 Deep insight 标签页跟踪来源与证据，必要时用知识图谱或列表检视关系与引文。
5. 从可读项目目录或导出的报告中核对句子级引用与原件链接。

UI 细节（README）：节点详情可独立滚动；右侧停靠栏可折叠关闭。标题 20px、小节 18px、正文与引文 16px、元数据 14px。

适用场景与注意¶

适合：需要在 DSH 内完成「有原件、有证据链、可出报告」的调研；愿意接受实验性插件的行为与限制；已具备 Node、uv、Python 与对应 DSH 版本的环境。

限制与前提（README）：

• YouTube 嵌入可能受平台策略或宿主配置限制；仍保留原视频链接；仅有字幕不能等同于视觉理解。
• 邮件采集需要已连接的真实 collector；缺少凭证、被屏蔽来源或未满足审阅要求不构成成功研究。
• 插件不提供 PIES 应用的自动自演进。
• 可选 PIES 集成会保留既有 session 工作区路径以兼容旧布局。

安全与权限：插件以当前 dsh 进程的权限 运行，并可使用宿主机配置的模型与 Web 服务。安装前应在 GitHub 仓库阅读源码与 MIT 许可证，确认是否符合你对凭证、外联与数据落盘的要求。研究数据与凭证不应进入该仓库或发布归档（开发说明中的要求）。

社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文仅依据公开 README 与包元数据陈述事实。

结尾¶

dsh-deep-insight 把「采集—留痕—证据—分析—交付」收成一条可在对话内操作的研究链路，并用 UI 与可读文件夹让失败与不完整证据保持可见。若你要在 Harness 里做带精确引用的报告型调研，可按官方命令安装 0.2.0-alpha.34 并从 deep_insight 的 guide 起步。

• 目录页：https://www.skillhub.cn/plugins/genesis-agents/dsh-deep-insight
• 仓库：https://github.com/genesis-agents/dsh-deep-insight