dsh-raw-html · VCP 视觉通感协议规范插件

在 DeepSeek Harness Web GUI 中实现 VCP（Visual-Synesthesia，视觉通感）协议： 消息里的 HTML 从「一坨源码」变成真正渲染的界面，并让 agent 按一套可维护的设计规范输出。

即插即用：任何电脑、任何 agent —— 安装本插件 + 打开浏览器「</>」开关（渲染/美学双开关）→ 浏览器开始渲染 HTML，agent 开始按规范输出（设计原则 / 中文排版 / 字体搭配）。

English README · 更新记录

✨ 效果展示（Gallery）

真实会话中的 VCP 卡片渲染效果（宣传图 5 张）：

📣 本次更新（v0.3.0 · 补丁 v6.18）

• 修复（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.3.0），随 dsh plugin 升级。
• 补丁代号：patch/ 注入模块的演进代号（当前 v6 · 子版本 v6.18），由 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-v6.cjs	推荐：自动探测 dist bundle，任意历史状态 → v6 全量补丁（幂等 + 备份回滚 + node --check 健康检查）；锚点不匹配时安全中止，不破坏环境
稳定区渲染模块	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）

文档地图（一规则一权威）

每份规范只在一处权威声明，其余位置挂指针。改规则前先找到它的权威源：

文档	唯一权威职责	读者
DESIGN.md	「怎么不崩、怎么不丑」的硬规则：字体库 / 色板 / 中文排版 / 安全铁律 §4（落笔后唯一确认点）	agent 按需读
EDITORIAL.md	「编辑感 / 数据可视化语法」：四色系 / 卡片四件套 / 明度契约 / 视觉词汇库 / 动效 / 非图表迁移	agent 按需读
BREATH.md	「为什么而画」：三步呼吸法 / 规则三层 / 破规时机 / 动笔前三问	agent 先读
FRAMING.md	「封面怎么实现」：SVG 顶栏技术要点 / 骨架 / 风格示例	agent 按需读
VCP-INTERACTIONS.md	「交互元素 + 渲染层安全白名单」	agent 按需读
PROGRESS.md	会话交接快照（进度 / 血泪教训 / 路线图）	维护者
CHANGELOG.md	变更流水（插件版本 + 补丁代号）	维护者

铁律定位：vcp-root 禁止空行 权威在 DESIGN.md §4；交互 / 安全白名单权威在 VCP-INTERACTIONS.md。新增规则先判断归属，只写进权威源，别处挂指针。

安装（任意 DSH 环境）

推荐：万能安装器（任意历史状态 → v6 全量补丁，幂等 + 备份回滚 + node --check 健康检查）：

# 1. 打补丁（v6 稳定区模块 + HTML 渲染 + 安全过滤，一条命令全量到位）
node "本插件路径\patch\install-v6.cjs"

…