前言¶
在智能體開發中，處理用戶輸入時需要防範 XSS 攻擊。DeepSeek Harness (DSH) 採用插件化架構，允許用戶擴展本地能力。dsh-html-escape 是一個用於 HTML 實體編解碼的工具插件，旨在解決用戶輸入中特殊字符與 HTML 實體之間的轉換問題。
插件簡介¶
該插件由 uckkk 維護，是一個純 Node.js 實現，用於轉義或反轉義 HTML 特殊字符與常用實體。
安裝與配置¶
安裝插件需要在本地終端執行以下命令：
dsh plugin add github:uckkk/dsh-html-escape
安裝完成後，需在 profile 的 package.json 文件中，將 "dsh-html-escape" 加入 dsh.profile.bundles 配置項，插件方可生效。
此外，安裝該插件需要滿足以下 Peer Dependencies：
* @deepseek-ai/cordis (^4.0.1)
* @deepseek-ai/dsh-tools (>=0.1.0-rc.6)
核心功能¶
插件提供兩個核心工具函數：
- html_escape：用於轉義 HTML 特殊字符。具體處理範圍包括
&、<、>、"和'。 - html_unescape：用於反轉義 HTML 實體。
使用示例¶
在 DSH 會話中調用上述工具函數即可使用。例如，將一段包含腳本標籤的用戶輸入進行轉義以防止 XSS：
html_escape(text="<script>alert(1)</script>")
注意事項¶
該插件爲純 Node 實現。安裝即在本機運行第三方代碼，請自行審閱源碼。
