dsh-base64-codec

dsh-base64-codec

DeepSeek Harness 编解码插件：base64 / base64url / hex / url 百分号编码互转，JWT 解码（不验签）。零运行时依赖。

安装

npm install dsh-base64-codec

使用说明

encode_text —— 文本编码

把 UTF-8 文本编码为四种格式之一：

用户：把 "Hello 世界" 编码成 base64

原文 10 字节 → base64（20 字符）：
SGVsbG8g5LiW55WM

参数：text（必填）、encoding（base64 | base64url | hex | url，默认 base64）。结果超过 4000 字符自动截断展示。

decode_text —— 文本解码

把编码文本还原为 UTF-8，自动处理常见脏输入：

• 空白与换行：base64/hex 输入中的空白、换行自动忽略（支持邮件式折行粘贴）。
• 字母表兼容：base64url 的 - _ 自动映射回 + /，两种字母表互相可解。
• 二进制兜底：解码结果不是合法 UTF-8 时，提示「可能不是文本」并给出前 64 字节的 hex。

用户：解码这个：SGVs\nbG8g5LiW55WM

解码结果（10 字节）：
Hello 世界

参数：text（必填）、encoding（同上，默认 base64）。

decode_jwt —— JWT 解码（不验签）

拆解 JWT 三段结构，展示 header/payload 的 JSON，自动把 iat/nbf/exp 时间戳转为 ISO 时间并标注是否过期。

用户：帮我看看这个 token 里存了什么、什么时候过期

⚠ 本工具不校验签名，结果不可用于鉴权决策，仅用于查看内容。

header：{ "alg": "HS256", "typ": "JWT" }

payload：{ "sub": "user-123", "exp": 1779000000, ... }

时间字段：
  iat = 1778996400 → 2026-09-18T01:00:00.000Z
  exp = 1779000000 → 2026-09-18T02:00:00.000Z（未过期）

signature：sig_nature…（11 字符，未校验）

参数：token（必填，三段式 JWT）。

统计口径

• 字节数按 UTF-8 编码计（Hello 世界 为 10 字节：5 ASCII + 2 汉字 × 3 字节）。
• 位置/长度展示均为字符数（UTF-16 码元）。
• url 编码按 encodeURIComponent 语义（空格 → %20）；解码时 + 视为字面加号而非空格。
• 输入上限 1MB；base64 长度非法（%4 === 1）与非法字符均拒绝。

安全边界

decode_jwt 不校验签名，也不做 alg 混淆等攻击检测。它只回答「这个 token 里写了什么」，绝不回答「这个 token 是否可信」。鉴权决策必须在服务端用密钥验签后作出。

版本历史

• 0.1.0：初始版本——encode_text / decode_text（四编码互转、空白容忍、字母表兼容、二进制兜底）、decode_jwt（时间标注、不验签声明）。

FAQ

Q：为什么 base64url 的结果和 base64 有时一样？ 只有当编码结果含 + / 或填充 = 时两者才不同；纯字母数字内容（如 Hello 世界 的编码）两者恰好一致。

Q：解码出来是乱码怎么办？ 看输出末尾的 ⚠ 提示：若提示「无法按 UTF-8 解析」，说明原文是二进制（图片/压缩包等），本插件只给 hex 兜底，不做二进制预览。

Q：能帮我验证 token 是否有效吗？ 只能看 exp 是否过期（会标注）。签名校验涉及密钥，本插件不做也不应做。

许可证

MIT