如何阅读 DSH Hunt 静态证据报告
了解如何核对源代码版本、理解静态发现与覆盖状态、识别分析边界,并为 DSH Hunt 报告提交证据纠错。
DSH Hunt 报告记录的是与特定源代码版本和分析方法相关的具体观察。阅读时,请结合来源、覆盖范围、结果标签和分析边界一起判断。每项发现都是需要核对的证据,并不是对项目的定论。
从证据来源开始
当前插件分析配置会读取软件包 Manifest、获准读取的 cordis.patch.yml,以及至多一个受支持且大小不超过 64 KiB 的根目录 README。每项发现都会在来源路径和定位信息可用时提供链接。目录树观察可以记录指定许可证文件或 shell 文件路径是否存在,而不读取文件内容。请查看报告的覆盖范围,确认该报告实际采集了哪些输入。
GitHub 仓库元数据是带有采集时间的观察记录。只有部分报告会采集精确版本的 npm Registry 元数据;如有采集,它会单独记录时间。下方 DSH Notify 示例没有查询 Registry。Registry 中的身份字段既不能验证 tarball 的实际字节,也不能证明软件包来自所链接的提交。请逐一打开来源链接,不要将页面上的不同证据视为一个没有区分的结论。
将报告与它的确切版本对应起来
完整的 commit SHA 标识报告中指定的仓库版本。先打开该提交,再打开同一版本下的 Manifest 或 Patch。分支或标签之后可能指向其他版本;通过 SHA,仍可回看报告实际观察到的内容。
更新的提交属于另一个源代码快照,不会改变旧报告当时观察到的内容。提交本身也不能证明 Registry 中的 tarball 由该源代码构建。npm 的 gitHead 字段是发布者提供的声明,不是可复现构建的证明。
用状态理解已知信息的边界
状态描述的是字段或文件的采集结果,不能与否定性的发现混为一谈。
- 已观察 / 已读取
- 报告采集了固定提交中的指定文件或字段。这不描述该范围之外的文件或行为。
- 未观察 / 未读取
- 该项不在已采集的证据中。这不能证明仓库中没有相应文件、声明或行为。
- 待处理 / 未采集
- 采集尚未完成,或观察结果未被保留。请核对原因和来源字段,不要将它视为不存在。
- 未知
- 记录无法确定某个值,例如分类或新鲜度状态。“未知”与已观察到的不存在、检查失败都不同。
查看证据状态定义,了解完整的发布与采集状态。
将发现视为有范围限制的观察
当规则匹配分析配置已采集输入中的数据时,就会产生一项发现。通过证据路径和定位信息,可以对照来源核查解释。请同时阅读规则名称、解释、建议,以及该结果不能证明什么;发现数量不是风险评分,也不是排名。
在提交 8f386ca5d66e8549119466c4a2ede15154aad577 上,DSH Notify 报告有三项信息性发现:两项记录了 peer 依赖的版本范围,但没有测试运行时兼容性;另一项指出缺少 homepage 声明。它们描述的是 Manifest 事实和规则边界,不能说明插件是否可用或安全。
理解静态证据无法证明的事项
DSH Hunt 不执行插件代码、安装器、生命周期脚本或构建命令。Manifest 声明不等于运行时行为。静态证据无法证明安装成功、兼容性,也无法确定代码是良性还是恶意。
覆盖范围决定了能够得出结论的范围。如果没有读取入口源代码、README、许可证正文或 shell 源代码,或者没有进行运行时测试,请核对报告的覆盖范围。“没有发现”只意味着没有已覆盖的规则匹配采集到的输入,不代表项目已经通过安全检查。
报告被 DSH Hunt 收录或发布,不代表推荐、安全认证或兼容性认可。
阅读采集方法,了解当前分析配置的覆盖范围。
核对声明,避免将声明当作背书
请区分 GitHub 仓库许可证标记与软件包 Manifest 中的许可证。前者是在某个采集时间观察到的标记,后者是在固定文件中声明的值;两者都不是法律审查。请阅读未知原因和来源链接,不要用其中一个值推断另一个。
dshEngine、nodeEngine 和 peerDependencies 等字段都是 Manifest 声明。可以将它们与你的环境进行比较,但版本范围匹配不等于通过了兼容性测试。分析器版本和分析配置说明的是所用的规则与输入范围。
核对一份真实的插件报告
DSH Notify 页面展示了固定提交、源文件链接、三项信息性发现、分析器版本,以及覆盖不完整的提示。打开报告后,请将结果标签与证据对照,并核对其中注明的未检查范围。
DSH Notify
插件静态分析- 已发布的插件报告
- dsh-browser-notify-plugin
- 仓库
- classfieldseason-cmd/dsh-notify-plugin
- 分析配置
manifest-patch-v1- 分析器版本
- 规则集
static-v1;源代码分析器0.2.0 - 发现
- 3 项发现;3 项信息性发现;覆盖不完整
- Manifest 文件
- package.json
本示例使用报告中记录的 manifest-patch-v1 分析配置。其 README 未读取。与当前分析配置比较时,请先核对这份报告的覆盖范围。
软件包结构属于另一类报告
这份获准发布的 ReMe 软件包报告记录了它自身固定提交中的结构与 Manifest 字段,不包含插件静态分析结果。因此,软件包层面的观察与插件发现不应被描述为同一类报告。
ReMe
软件包结构- 软件包层面的报告
- @agentscope-ai/reme-dsh-plugin
- 软件包 ID
680d388e1a913555b194e6816c35a8702c249527072ffbf1d9093b950e5f2d27- Manifest 来源
- integrations/dsh/package.json
用一手证据提出疑问或纠正报告
纠正事实字段时,请注明页面和字段,复制当前显示的值,说明建议修改后的值,并附上相关版本的公开一手来源链接。如果页面能够提供,证据纠错表单会包含报告标识和固定提交。请链接到源文件,不要粘贴私有代码或大段受版权保护的文本。
针对具体分类或规则结果,请使用误报申诉;建议调整分析方法时,请提交方法反馈。每条 GitHub Issue 都是公开的,请不要包含凭证、私有代码、个人信息或敏感漏洞细节。DSH Hunt 不承诺响应时间。
打开示例软件包报告的纠错表单将在 GitHub 打开公开 Issue 表单;打开表单不会提交请求。网站变更前,审查就可能已获接受。“接受”表示已审查拟议更新的证据,不等于已发布、安全背书或运行时认可。只有在版本上线且受影响页面经过检查后,才能标记为已发布。阅读任何报告时,请同时参考采集方法与状态定义。
