前言¶
在智能体开发中，处理用户输入时需要防范 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 实现。安装即在本机运行第三方代码，请自行审阅源码。
