dsh-visualizer-widget
DeepSeek Harness 的会话流「内联可视化」插件：模型产出 SVG / HTML 源码后，交给浏览器渲染成一张可交互的内联卡片，源码只进卡片、不回灌模型上下文。
能做什么
插件注册两个工具，并提供一条会话命令：
| 工具 | 作用 |
|---|
render_visual | 把 SVG / HTML 源码渲染成会话流内联卡片（预览/源码切换、高度档位、浅色/深色底、弹出全屏查看、重跑、下载、保存为图片、复制） |
get_visualizer_spec | 按需返回统一渲染规范全文（viewBox 基准 680、字号/字重约束、9×7 色板、明暗配色、图类型路由、导出陷阱等） |
完整卡片作为消息流一等行渲染（自定义 Chat Node，锚定在工具调用行之后），源码经 iframe srcdoc 沙箱隔离渲染；工具调用块本身只留一行紧凑状态提示，规避宿主对工具块的高度限制。
效果预览
dsh-visualizer-widget 会话流内联可视化卡片效果
设计要点
- 源码与模型上下文解耦：
render_visual 的 output.render 只回一行摘要（格式 / 字符数 / 高度），完整源码只留在工具结果与卡片里，不进入模型上下文。
- 渲染规范随包分发：
get_visualizer_spec 返回的规范固化的内联可视化设计规范，生成源码时据此保持统一视觉。
- 安全隔离：iframe 沙箱只给
allow-scripts allow-popups allow-forms，不带 allow-same-origin，卡片内脚本拿不到主页面 DOM / storage。
- 提示词注入默认关闭：把「何时该画 + 怎么画」写进系统提示词是可选增强，默认不开启；提示词正文保存在 profile 目录的
.visualizer-widget/prompt.md（可在设置页编辑，或直接改文件，下一轮生效），不再把大段文本写进 cordis.patch.yml。
安装
Web / CLI
# GitHub
dsh plugin --profile web add github:lovezi0/dsh-visualizer-widget
# npm
dsh plugin --profile web add dsh-visualizer-widget
# 卸载
dsh plugin --profile web remove dsh-visualizer-widget
桌面版（DSH Desktop）
- 推荐直接填包名
dsh-visualizer-widget（走 npm registry，装完重启应用即可）。
- 也可填
github:lovezi0/dsh-visualizer-widget。
构建
npm run build
产物 lib/index.js（host 半）与 lib/client.js（client 半单文件 bundle）已随包提交，github: 安装拉到的源码自带 lib/，加载即用。
使用
默认行为：本插件默认不往系统提示词注入任何内容。不开启注入时，模型仍会在你说「画一个柱状图看板」「渲染这段 SVG 原型」时按工具描述自行调用 render_visual；生成复杂图表前可先调 get_visualizer_spec 核对规范。
按次触发：/visual <需求描述>
在输入框敲 /visual 加一句需求（例：/visual 画一个三栏架构图），需求会作为一条用户消息立即交给模型，并要求它用 render_visual 内联渲染。这条命令不依赖注入开关，适合「只想这一次渲染」的场景；Web / 桌面版的斜杠菜单里可直接发现它（留空参数会返回用法提示，不产生消息）。
每轮都优先渲染：开启提示词注入
想让模型每一轮都优先使用内联卡片（而不是输出 SVG/HTML 代码或写文件），到插件设置页（设置 → 插件 → dsh-visualizer-widget）打开「启用提示词注入」；关掉即回到默认。
提示词正文在 $DSH_HOME/profiles/<profile>/.visualizer-widget/prompt.md，首次启动自动生成；可在设置页直接编辑并保存，或直接修改该文件，下一轮生效。0.4.0 起不再读取旧配置里的 prompt 字段（破坏性变更），该键可从 cordis.patch.yml 删除。
版本历史
- 0.4.0
- npm publish v0.4.0
- 0.4.0-alpha.1
- 💥提示词落盘位置迁移
- 💪优化内置提示词
- 💪优化
/visual 命令前缀
- 通过github workflow 发布npm包
- 0.3.1
- dsh peer [0.1.7 ... 0.2.0]
- 0.3.0
- 🔥增加会话命令手动触发Agent使用viz插件
- 💥内置提示词注入默认不启用
- 💥移除可视化card 弹出dialog 拖拽平移功能
- 🐛修复内置提示词保存失败的问题
- 0.2.0
- 徽标核验线更新至 0.1.7-rc.1
- npm publish
- 0.2.0-alpha.1
- 💪适配deepseek harness 0.1.7-alpha.1
- 🐛修复某些情况下浅色的色块渲染成纯黑
- 💪visual card 现在将在回复块中显示
- 💪visual card 现在支持弹出预览
- 0.1.0
