前言¶
在 DSH 插件开发或智能体构建中，常遇到需要将本地图片或文件转为 Base64 编码，以便直接嵌入 HTML 或 JSON 的场景。dsh-base64-file 专为这一需求设计，提供纯 Node 实现的文件 ↔ Base64 转换能力。
是什么¶
这是一个纯 Node 实现的转换工具，归属于“联网工具”分类，由开发者 istone 维护。它解决了文件编码转换的重复劳动问题，支持将本地文件路径转换为 Base64 字符串或 data URL，也支持反向还原。
核心功能¶
file_to_base64：文件 → base64/data URLbase64_to_file：base64/data URL → 文件
安装与启用¶
使用官方安装命令：
dsh plugin add dsh-base64-file
安装完成后，需在 profile 的 package.json 的 dsh.profile.bundles 字段中加入 "dsh-base64-file"。
典型用法¶
安装后在会话中直接调用注册的工具。例如，将当前目录下的 logo.png 转为 data URL 嵌入 HTML：
file_to_base64(file="logo.png")
适用场景与注意¶
该插件适用于需要将文件内嵌于文本（如 HTML、JSON）的场景。
注意：安装即在本机运行第三方代码，请自行审阅源码与许可证（MIT）。
后续¶
以上内容介绍了 dsh-base64-file 的安装与使用方法。更多细节可参考 GitHub 仓库 或 DSH 插件目录。
