dsh-tool-encoding 使用指南

为 AI Agent 提供零依赖、纯函数的 UTF-8 文本编解码工具（base64/base64url/url/hex、哈希摘要、UUID v4），毫秒级返回字符串结果。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add github:omdsh-dev/dsh-toolkit#path:packages/dsh-tool-encoding

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

这个插件能做加解密或签名吗？

不能。插件只做单向摘要（md5/sha1/sha256/sha512）和对称编解码，没有 HMAC、加盐、密钥派生、对称加密这些能力，机密材料也不要交给它（参数会进会话日志）。

能不能处理任意二进制（图片、压缩包这类）？

当前 v1 是 UTF-8 文本工具：二进制内容只能先转成 hex 字符串再处理。任意二进制编解码需 v2 的 output: "utf8" | "hex" 模式。

base64url 编码会输出带 = 填充的字符串吗？

默认无 padding（JWT 风格），但解码端兼容带 padding 的输入。带 padding 时必须完整（残缺会拒绝），无 padding 时按数据长度自动补齐。

输入有大小限制吗？

有的。输入上限 1MB（1,000,000 UTF-8 字节），输出上限 4MB（按最坏膨胀率预检，超了直接拒绝不截断），工具单次超时 1000 毫秒。

URL 编码用的是 application/x-www-form-urlencoded 那种语义吗？

不是。url_encode/url_decode 用 component 语义（encodeURIComponent），空格变 %20 而不是 +，!'()* 也不被转义；表单编码（空格 → +）需 v2 独立 action。

如何卸载这个工具？

与 DSH profile bundle 卸载一致：dsh plugin --profile web remove tool-encoding，web 与 headless 是两个独立 profile，需各自卸载。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则