前言¶
在 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 许可证开源的。