DeepSeek Harness（DSH）支持插件化扩展。dsh-raw-html 插件旨在解决 Agent 输出的 HTML 代码仅作为纯文本显示的问题，通过 VCP（Visual-Synesthesia，视觉通感）协议规范，将其渲染为真实 UI 界面，并支持卡片、数学公式、图表及字体渲染。
插件定位¶
这是一个 VCP 视觉通感协议规范插件。由开发者 plolpl789 维护，目前获得 65 个 Star。它将 DeepSeek Harness 的 HTML 输出转化为可交互的视觉组件，帮助 Agent 按照一套可维护的设计规范输出内容。
核心功能¶
插件提供以下核心能力：
- VCP 视觉通感协议支持：建立一套统一的视觉输出规范。
- HTML/SVG 卡片渲染：将代码块中的 HTML/SVG 渲染为界面组件。
- KaTeX 数学公式渲染：支持数学公式的可视化展示。
- Mermaid 图表渲染：支持流程图、时序图等图表渲染。
- 内置精选字体：包含 7 款开源字体（文楷/文楷细/马善政楷书/思源黑/思源细黑/思源粗黑/GreatVibes 花体），全部 OFL 授权，零配置即可使用。
- vcp-fast 缓存增量加速引擎：通过容器感知块级缓存和增量追加，显著提升渲染性能。
- 可信模式与安全过滤：提供安全过滤机制，仅放行
onclick桥接等可控事件，防止脚本注入。
安装与启用¶
安装过程分为打补丁和注册插件两步。
- 运行一键安装器（推荐）。该命令会同时安装渲染能力补丁和可信模式补丁：
node "本插件路径\patch\install-all.cjs"
- 注册插件：
dsh plugin --profile web add "本插件路径"
-
重启与刷新。重启 DSH 服务并刷新浏览器页面（建议使用 Ctrl+F5 清除旧缓存）。
-
启用开关。在浏览器界面中，打开「</>」开关以启用 HTML 渲染与美学注入。
使用方法¶
启用插件后，Agent 可以接收 VCP 协议指令：
- 浏览器开关：点击发送按钮旁的「</>」按钮，可选择「渲染 HTML」（仅渲染）或「ON」（渲染+美学）。
- 交互桥接：点击 VCP 按钮，通过
onclick="input('...')"桥接将内容填充到输入框并发送。 - 协议输出：Agent 收到协议后，会自动输出符合规范的
#vcp-root视觉容器。
重要注意¶
- vcp-root 内部禁止空行。这是 Markdown HTML 块的特性，如果
<div id="vcp-root">内部出现连续两个换行（\n\n），卡片会被解析断裂，导致样式错乱。所有子元素必须使用单个换行或单行排列。 - 安全提示。插件会对脚本和危险协议进行过滤，但样式与外部图片仍然可达。请只对可信模型开启以避免潜在风险。
维护¶
- 修改代码后，建议运行
node --check lib/client.js和node --check lib/index.js验证语法。 - 当 DSH 升级覆盖了前端文件后，需重新运行
node patch/install-all.cjs进行补丁修复。 - 所有第三方依赖必须在
package.json中显式声明，以确保模块解析的稳定性。
