plolpl789/dsh-raw-html
dsh-raw-html
VCP visual-synesthesia protocol plugin for DeepSeek Harness: render agent HTML output as real UI (cards / KaTeX math / Mermaid diagrams / built-in calligraphy fonts / zero-JS interactions), plug-and-play on any DSH environment
Install
npx @deepseek-ai/dsh plugin --profile web add "本插件路径"Restart `dsh web` after install. Bundle APIs can change during the developer preview.
README badge
[](https://dshhub.dev/plugins/dsh-raw-html)Paste this into your README. The star count updates with every catalog sync.
From the README
Excerpt from plolpl789/dsh-raw-html, cleaned of badges and images.
dsh-raw-html · VCP 视觉通感协议规范插件
在 DeepSeek Harness Web GUI 中实现 VCP（Visual-Synesthesia，视觉通感）协议： 消息里的 HTML 从「一坨源码」变成真正渲染的界面，并让 agent 按一套可维护的设计规范输出。
即插即用：任何电脑、任何 agent —— 跑一次一键安装器补丁（node patch/install-all.cjs，渲染能力+可信模式全到位）
- 安装本插件 + 打开浏览器「</>」开关（渲染/美学双开关）→ 浏览器开始渲染 HTML（含 SVG 卡片 / Mermaid 图表 / KaTeX 公式），agent 开始按规范输出（设计原则 / 中文排版 / 字体搭配）。
渲染能力（HTML/SVG/图表/公式）由补丁注入前端 bundle，插件负责开关与协议注入—— 详细步骤见下方「安装」章节。
✨ 效果展示（Gallery）
真实会话中的 VCP 卡片渲染效果（宣传图 5 张）：
📣 近期更新（v0.6.0 · 补丁 v6.38）
-
自愈层 v6.37/v6.38（2026-08-29）：卡片渲染撕裂根治——CommonMark 块级标签不能打断段落（文字+换行+
<div>撕裂）与卡片内部空行拆分问题，fixVcpBlank补空行/压缩空行，整卡回归单一 htmlFlow（稳定测试 105 断言全绿）。 -
消息主体渲染器 VCP 接管（2026-08-29）：主 markdown 渲染器接入 VCP 渲染，消息卡片从此真正渲染为界面（此前官方策略是当源码文本显示）。
-
早期更新（v0.3.0 · 2026-08-24）：
-
修复（2026-08-24）：适配新版前端 0.1.0-rc.8 / 0.1.1-rc.x（压缩器改名 Xu/jd 的新锚点组，自动探测、旧版兼容）；消除 schemastery 静态依赖导致的启动「模块找不到」故障（动态加载 + 降级，缺依赖也能正常启动）。
-
新能力（2026-08-24）：声明式配色
data-vcp-preset（内置 VCPColorEngine 确定性生成整套色板，对比度/色域闭环保证）；流式锚定锁 + ref 闭包缓存（流式更稳不抖）。 -
协议（2026-08-24）：渲染/美学双开关分层；主动视觉通感（不再被动等指令）；心流纪律常驻（实测输出 −4.6K token/轮、费用 −¥0.056）。
-
安全（P0）：修复
on*事件属性透传缺口（只放行onclick桥接）；性能计时器诊断修复；文档引用对齐。 -
性能（P1）：正则快速守卫、mermaid 监听器泄漏修复、协议文本瘦身约 74%。
-
字体（P2）：内置 12 款商业字库 → 7 款开源字体（全 OFL 授权）。
-
增强：
prefers-reduced-motion无障碍、键盘焦点态、魔数收拢。 -
完整变更见 CHANGELOG.md。
版本
- 插件版本：
package.json的version（当前 0.6.0），随dsh plugin升级。 - 补丁代号：
patch/注入模块的演进代号（当前 v6 · 子版本 v6.38），由install-v6.cjs应用到前端 bundle，二者独立演进。前端兼容 0.0.1-rc.5 ~ 0.1.0-rc.7 与 0.1.0-rc.8 / 0.1.1-rc.x 两代压缩形态（vc/hp 与 Xu/jd 自动探测适配）。 - 详细变更见 CHANGELOG.md。
组成
| 部件 | 位置 | 作用 |
|---|---|---|
| 一键安装器 | patch/install-all.cjs | 推荐：一条命令 = install-v6.cjs（渲染能力）+ trusted-patch.cjs（可信模式 vc 放行）；幂等 + 备份回滚 + node --check 健康检查，锚点不匹配安全中止 |
| 万能安装器 | patch/install-v6.cjs | 渲染能力 v6 全量补丁（install-all 的组件①）：自动探测 dist bundle，任意历史状态 → v6（幂等 + 备份回滚） |
| 稳定区渲染模块 | patch/v6-inject.js | 注入 dist bundle 的增量渲染引擎：容器感知块级缓存、流式尾巴占位、KaTeX 公式、Mermaid 查看器；onclick="input('...')" 桥接为真实交互；安全过滤 script/iframe/object/embed、on* 事件与 javascript: 协议 |
| vcp-fast 加速引擎 | patch/v6-inject.js | 容器感知块级增量：已闭合块缓存（元素引用跨帧不变 → React 跳过 diff → 动画真循环），只重渲染尾巴；实测缓存命中 1200~6800 倍、增量 12 倍 提速 |
| 插件（Host 半侧） | lib/index.js | 渲染/美学双开关状态（落盘持久化）+ 系统提示词分层注入（结构铁律必注入 + 美学工具包可选）+ /fonts 字体服务（内置精选 + 外置大库双源）+ 知识层共享（协议附带本机 DESIGN.md 路径，任何 agent 可读） |
| 插件（浏览器半侧） | lib/client.js | composer 发送按钮旁注入「</>」按钮（点击弹出设置面板，渲染/美学双开关，主题令牌适配深/浅色）+ 暴露 window.__dshInput（VCP 按钮 → 填框发送） |
| 内置精选字体 | assets/fonts/ | 7 款开源字体（woff2 子集，共约 7.6MB）随插件分发——文楷/文楷细/马善政楷书/思源黑/思源细黑/思源粗黑/GreatVibes 花体，全部 OFL 授权，任何电脑装上即可用，无需任何配置 |
| 设计系统文档 | DESIGN.md | 完整规范库：字体清单/色板/中文排版/安全铁律（知识层，agent 可按需读取） |
| 回归测试 | tests/ | 六套断言（stable 47 + security 43 + bundle + smoke + math + mermaid，共 200+ 项）：帧序列 / 安全过滤 / bundle 完整性（改引擎后必跑） |
| 性能基准 | patch/vcp-fast-bench.cjs | domino 真实 DOM 解析环境对比新旧路径耗时与提速倍数（自动下载依赖，零安装） |
| 子集化工具 | tools/subset_fonts.py | 维护者用：把新字体裁剪为常用字子集 + woff2 压缩（需 Python + fonttools + brotli） |
文档地图（一规则一权威）
每份规范只在一处权威声明，其余位置挂指针。改规则前先找到它的权威源：
…
