dsh-license-audit:DSH 插件包与依赖的静态许可证清单

前言

在 DeepSeek Harness(DSH)里开发或维护插件时,package.json 和已安装的 node_modules 会堆叠大量第三方包。发布前或接入 CI 前,若仍靠人工逐个打开 package.json 看 license 字段,既慢也容易漏掉强 copyleft 或缺失许可证信息的依赖。下面介绍社区插件 dsh-license-audit(维护者 lengrufeng2008,分类 admin-security):对插件包根目录与已安装的一级依赖做静态清点,并对强 copyleft、未知许可证等条目打上需人工复核的标记。说明:输出仅供审查参考,不构成法律意见。

这是什么

dsh-license-audit 是一句定位很清楚的工具:对 DSH 插件包及其已安装依赖做静态许可证清单(static license inventory),并标记强 copyleft 与 unknown 类许可证以便复核。仓库:https://github.com/lengrufeng2008/dsh-license-audit;社区目录页:https://www.skillhub.cn/plugins/lengrufeng2008/dsh-license-audit。插件自身采用 MIT 许可证(见仓库 Provenance);当前 package 版本为 0.1.0,要求 Node.js >= 20。

DSH 生态遵循「一切皆插件」的思路;SkillHub 为独立社区目录,与 DeepSeek / 幻方无官方从属关系。安装任何 admin-security 类插件前,应自行审阅源码与许可证,并记住插件以当前 dsh 进程权限运行。

核心功能

经 README 与 package 描述核实,能力边界如下。

  1. 读取范围
    - 插件根目录的 package.json。
    - 已安装的一级依赖:node_modules/*/package.json,含 @scope/name 形式的作用域包。

  2. 审查侧重
    - 对强 copyleft 与未知许可证等情况做标记,便于人工跟进。
    - 文档明确:REVIEW 表示「建议进一步查看」,不是法律结论。

  3. 运行特性
    - 无网络:扫描不发起外连。
    - 不做完整传递依赖树、 bundled 源码扫描或 SPDX 解析器级分析。

安装与启用

已抓取资料中未给出形如 dsh plugin add … 的固定安装命令;具体安装步骤请以 SkillHub 目录页 为准。完成安装并进入插件包目录后,可直接用仓库提供的 CLI(见下一节)。

在 DSH 会话中,README 给出的用法为:

Use license_audit on this package.

即在当前插件包上下文中调用 license_audit 能力,对「这个 package」做清单(与 CLI 面向同一类输入:根 package.json 与一级 node_modules)。

典型用法

命令行

在插件包根目录(路径 . 表示当前目录)执行:

node bin/dsh-license-audit.mjs .

需要机器可读输出时使用 --json,便于脚本或 CI 消费:

node bin/dsh-license-audit.mjs . --json

在 DSH 里

对正在开发的 DSH 插件包,在 Harness 中按 README 提示使用 license_audit(见上一节引用的 Use license_audit on this package.),可在不离开工作流的情况下快速过一遍许可证字段与标记项。

开发与自测

维护者提供的测试命令:

npm test

对应 package.json 中的 node --test test/*.test.mjs。

适用场景与注意

适合谁

  • 在发布或合并前,需要对 DSH 插件自身声明与已安装一级依赖的 license 字段做快速盘点的开发者或仓库维护者。
  • 希望在本地或 CI 里做轻量合规预审、再决定是否深入法务或 SPDX 工具链的团队。

务必知道的限制

项目 说明
依赖深度 仅一级 node_modules,不含完整传递依赖树
解析能力 非 SPDX 解析器;复杂 SPDX 表达式需人工或其它工具
网络与 bundle 不联网;不扫描 bundled 源码
结论性质 标记为 REVIEW 的条目需人工判断;非法律建议

安装 admin-security 插件前请阅读源码与 MIT(插件本体)及 NOTICE;运行环境权限与 dsh 进程一致,勿在未审计的情况下用于不可信目录。

结尾

dsh-license-audit 用静态、离线的方式补齐「插件包 + 一级依赖」的许可证清单,并把强 copyleft 与 unknown 许可证推到 REVIEW,适合作为 DSH 插件交付链路上的第一道人工复核入口。细节与更新以仓库 README 为准。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜