前言¶
在 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 描述核实,能力边界如下。
-
读取范围
- 插件根目录的package.json。
- 已安装的一级依赖:node_modules/*/package.json,含@scope/name形式的作用域包。 -
审查侧重
- 对强 copyleft 与未知许可证等情况做标记,便于人工跟进。
- 文档明确:REVIEW表示「建议进一步查看」,不是法律结论。 -
运行特性
- 无网络:扫描不发起外连。
- 不做完整传递依赖树、 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 为准。