前言¶
在 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 爲準。