每一项证据,都有源码可追溯。

每份报告都会注明固定的源码修订版本。报告记录的范围与版本信息,帮助你回查观察到了什么、如何收集,以及哪些信息仍然未知。

社区目录报告分析固定版本的目录元数据;只有明确标为固定源码报告的页面才记录了目标仓库代码检查。

阅读静态证据指南
从源码到观察记录
  1. 固定源码版本

    记录精确的提交与文件路径。

  2. 记录分析范围

    记录采集的输入与使用的方法。

  3. 阅读证据

    结合限制理解每项观察。

固定修订版本

DSH Hunt 不把随时可能变化的分支 HEAD 作为永久证据。仓库可能在分析后发生变化;报告会持续保留当时观察到的精确提交,以完整的 40 字符 SHA 标识。

版本信息说明这次观察所使用的方法。具体字段取决于报告类型:

静态分析
分析器版本与分析配置
结构报告
采集器、策略与数据结构版本

分析器读取什么

当前静态分析配置使用一组明确限定的输入。每项声明层面的发现都保留对应的源码路径与定位信息。

当前静态分析配置的输入与范围
输入范围与记录的证据
包清单(Manifest)读取已声明的元数据,并为其支持的发现保留源码路径与定位信息。
已批准的补丁cordis.patch.yml。超出受支持配置的语法会暂缓处理,不会默认为有效。
根目录 README最多读取一个受支持的文件,上限为 64 KiB。分析器扫描安装与配置标题,只保存文件路径、Git Blob SHA、字节数,以及这两类标题是否存在。
选定的文件路径通过目录树元数据记录选定的许可证与 Shell 文件路径是否存在,不读取文件内容。

此分析配置不执行代码

DSH Hunt 不执行第三方插件代码、生命周期脚本、安装程序或构建命令。

此静态分析配置不查询 npm Registry。如果采集精确版本的 Registry 元数据,会将其保存为带时间戳的独立观察记录;这不会验证包产物的字节内容或来源证明。

如何解读结果

能力信号
描述观察到的能力相关迹象,不是风险评分。
静态分析标签
统计当前规则覆盖的信号,不是安全或质量评级;未发现当前规则覆盖的信号,也不能证明包是安全的。
结构有效性
不能证明运行兼容性。静态分析不等于安全审计。
仓库元数据
GitHub 仓库元数据会注明观察时间。阅读时,应将其与固定在源码提交上的证据区分开。
查看阅读指南中的示例

未知不等于不存在

未知(unknown)限制了报告能够证明的内容,并不意味着不存在或安全。请阅读字段的原因:“未读取”“未采集”和观察到不存在是不同的状态。未知也不同于检查失败。

同一份报告,不同的许可证来源

已批准的 Petdex 报告将包的源码固定到以下提交:

a1b229116968cbe9f3a9b2141634a9baa0819864
包清单(Manifest)
未声明 license 字段
同一 SHA 下的 LICENSE
独立许可证文件中写明 MIT
仓库许可证标记
仓库层面记录为 MIT

这些来源彼此独立。许可证文件和仓库标记都不能补充包清单中未声明的字段。

打开 Petdex 报告

请核对完整 SHA、路径和 Blob SHA,并阅读覆盖范围与状态原因。如果源码与页面冲突,请通过更正链接提供当前值、建议值和一手来源。 状态模型与 指南说明了相关限制。这里不提供法律、运行或安全评估。

更正与申诉

更正始终关联其所修改的证据。接受更正与公开发布是两个独立步骤。

  1. 注明字段与来源

    使用相关证据页面上的更正链接,提供字段、当前值、建议值,以及支持该更改的公开一手来源。

  2. 基于固定修订版本审查

    接受的元数据更正会绑定到该份报告及其精确的源码提交。原始观察与审查原因仍可追溯。

  3. 经发布审查后公开

    接受更正后会启动发布审查,这不意味着网站已经更新。只有发布上线且页面经过核查后,更正才算公开发布。

针对规则的误报申诉必须注明报告固定的提交。较新的提交属于另一个源码修订版本,不会抹去旧报告的观察结果。对于可复现的规则缺陷,会先添加有针对性的回归用例,再修改规则;修改会通过经过审查的报告发布生效。

选择公开报告渠道

所有 GitHub Issue 都是公开的。请勿包含密钥等机密信息、私有源码或敏感漏洞细节。

目前尚未核实任何私密安全报告渠道。询问渠道的 Issue 仍然公开,不会私密递交漏洞报告。