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 爲準。

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

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

小夜