前言¶
在 DSH 插件生態中,開發或調試智能體時,經常需要快速查看 JWT Token 的內部結構或驗證其過期狀態。通常的做法是使用外部命令行工具,或者編寫臨時的解析腳本。dsh-jwt 插件直接在 DSH 環境內提供了這一能力。
插件說明¶
dsh-jwt 是一個由 uckkk 維護的插件,歸屬於 admin-security 分類。它是一個純 Node 實現的工具,主要功能是解析 JWT 的 header 和 payload,並判斷 Token 是否過期,但不會進行簽名驗證。
安裝與啓用¶
安裝命令如下:
dsh plugin add dsh-jwt
安裝成功後,該插件會被添加到 profile 的 package.json 的 dsh.profile.bundles 字段中。
核心功能¶
該插件提供以下能力:
* 解析 JWT 的 header/payload
* 判斷是否過期(不驗籤)
* 提供工具:jwt_decode
典型用法¶
在會話中,可以通過調用 jwt_decode 工具來查看 Token 內容及狀態。
示例用法:
jwt_decode(token="eyJhbGci...")
這將返回 Token 的解碼內容,幫助判斷其有效性和包含的數據。
適用場景與注意¶
該插件適合在開發調試階段使用,用於快速驗證 Token 的結構。需要注意的是,該插件以當前 DSH 進程的權限運行,屬於第三方代碼。在安裝前,建議自行審閱源碼,確保符合安全要求。它是基於 MIT 許可證開源的。