前言¶
DeepSeek Harness (DSH) 采用了插件化架构，允许开发者扩展其能力。在 HR 技术与招聘背调场景中，决策往往依赖主观判断或未经核实的宣传口径。dsh-scout（司察 Scout）旨在引入「证据驱动」的工作流，帮助开发者或用户在 DeepSeek Harness 中建立一套标准化的尽调流程，将结论与真实来源绑定，并区分「已核验」与「待核验」状态。
插件简介¶
dsh-scout 是一个面向 DeepSeek Harness 的证据驱动型公司与岗位尽调 / 背调插件。其核心价值在于强制要求每一个结论都挂靠真实的来源，并限制结论的强度不能超过其证据等级。它不替代浏览器进行深度抓取，也不把公司自述或融资新闻当成已核实的事实。
插件由 MaxHou-infinity 维护，开源协议为 MIT。
核心概念：证据等级¶
插件引入了 E0 到 E3 四级证据约束机制，所有结论的 evidenceLevel 不能超过其引用的最强来源：
- E0：无来源 / 模型推断。没有来源支撑的猜测，只能标记为
unknown或needs_verification。 - E1：用户提供。用户自己从内部渠道拿到的信息。
- E2：权威第三方。独立媒体、招聘平台（BOSS/猎聘）、工商聚合库（天眼查/爱企查）、维基百科。
- E3：官方一手。国家企业信用信息公示系统（gsxt.gov.cn）、监管公告、官方备案。
插件强制执行以下纪律：
1. 结论的 evidenceLevel 不能超过引用的最强来源。
2. 没有来源的高影响结论必须标记为 unknown 或 needs_verification。
3. 主体核验（scout_verify_identity）必须挂接 E3 官方登记来源。
4. 决策默认保守，只要主体未核验或有阻断级结论未核实，就保持 VERIFY。
工具链¶
插件提供了一套完整的尽调工具链，覆盖从案例创建到报告生成的全过程：
scout_start：创建尽调案例。scout_search：调用 Web Provider 搜索并自动登记结果来源。scout_ingest：批量登记采集结果，可自动推断来源类型与证据等级。scout_add_source：手动登记来源（指定sourceType和evidenceLevel）。scout_add_claim：添加结论（受证据边界约束）。scout_verify_identity：用 E3 官方源核验公司主体。scout_verify_claim：用更强证据提升主张为 verified。scout_report：渲染当前 Markdown 报告。scout_questions：生成面试问题清单。scout_compare：多个案例并排对比。scout_export：持久化五文件导出。scout_import：从导出目录恢复案例。
典型用法¶
以「判断某公司 HR 岗位是否值得推进」为例，工作流如下：
1、创建案例
scout_start(caseId=acme-hr, companyName=某科技公司, roleTitle=HRBP, location=深圳)
2、登记来源
scout_add_source(sourceId=s1, sourceType=company_registry, evidenceLevel=E2)
scout_add_source(sourceId=s2, sourceType=company_official, evidenceLevel=E2)
3、添加主张
scout_add_claim(claimId=c1, status=verified, evidenceLevel=E2, content="薪资范围符合市场水平")
对于没有来源支撑的高影响项（如汇报线），标记为 unknown。
4、核验身份
scout_verify_identity(...)
5、导出报告
scout_export
安装与启用¶
插件要求 Node.js 版本 ≥ 22.19，并且面向 DeepSeek Harness 0.1.2-rc.1、@deepseek-ai/dsh-tools 0.1.2-rc.1 与 @deepseek-ai/cordis 4.0.2+。
安装命令如下：
dsh plugin --profile scout-demo add github:MaxHou-infinity/dsh-scout#<commit>
dsh --profile scout-demo --dump-config # 验证工具挂载
配置（可选）¶
在 DSH profile 的 cordis.patch.yml 中配置 dsh-scout：
- id: dsh-scout
config:
scoutDir: /path/to/scout-cases # 默认导出目录
autoPersist: true # 每次变更后自动写五文件
scoutDir未配置时，默认路径为./dsh-scout/<caseId>/。autoPersist: true时，在scout_start、scout_add_source等操作后自动落盘。
数据持久化¶
案例默认在内存中，按会话隔离。scout_export 会将案例写为五个文件：
* case.json：案例主体与决策状态
* sources.json：来源清单
* claims.json：结论台账
* events.jsonl：可回放的事件流
* report.md：当前报告快照
scout_import 可从导出目录恢复案例并重新计算决策。
适用场景与注意¶
本插件适用于需要严谨证据链的招聘背调与尽职调查场景。使用时请注意以下边界：
- 内置的
scout_search仅做搜索到来源的登记，不替代专用浏览器或 MCP Provider 的深度抓取。 - 不会替你把融资信息、公司自述或招聘启事当成已核实的事实。
- 不构成法律、投资或医疗建议。
- 主体核验依赖 E3 官方源（如 gsxt），若无法访问，报告会如实标记「待核验」。
