前言¶
在 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 插件目錄。
