在 DeepSeek Harness (DSH) 的原生聊天中描述布局或 UI 细节时，通常依赖文字或外部截图，信息传递效率较低。dsh-sketch-reference 插件通过接入 Excalidraw，将可编辑的草图板直接集成到 DSH 工作区中。它允许 Agent 按需读取草图、定位批注并提出修改，实现从构思到落地的可视化协作闭环。
核心功能¶
接入 Excalidraw 编辑器，提供可持续编辑的草图与参考图。绘图、保存和导出功能独立可用，DSH Agent 可在此基础上继续完成网页、UI 和 PPT 的开发。
Agent 具备按需读取能力，能够理解当前草图的结构与内容，定位具体的批注区域，并基于这些信息提出修改建议。画板修改操作受图形白名单限制，Agent 提议修改后，会展示同视角预览，需用户确认后才应用。
安装与启用¶
插件通过 DSH 官方插件管理器安装，无需提前单独安装 Excalidraw。安装前请确保 DSH Web 环境版本为 0.2.1-alpha.1 或 0.2.1-alpha.2。
安装完成后，执行以下命令：
dsh plugin --profile web add /绝对路径/dsh-sketch-reference-0.6.5.tgz
运行 dsh web 启动服务即可使用。
典型用法¶
创建会话并画图
1. 选择工作区并创建会话。
2. 点击输入框旁的「参考板」按钮。
3. 在画板中绘制草图，并添加用途说明。
4. 点击「已保存」返回聊天，或点击「作为参考发送」将草图以图片形式加入输入框。
直接对话与修改
1. 在原生聊天中直接输入指令，例如：“按当前草图实现一个网页”。
2. 选中画板上的元素，使用批注菜单的「追问 / 纠正 / 修改这里」功能，起草下一条消息。
3. Agent 标注某个区域后，可从菜单中发起修改请求。
4. Agent 提出画板修改时，系统会展示预览。用户确认后，修改才会应用到草图中。
注意事项¶
模型与权限
图片读取功能需要模型支持视觉输入。模型与认证沿用 DSH 配置。插件以当前 DSH 进程权限运行，安装前请检查源码与许可证。
修改限制
画板修改受图形白名单限制，不会任意修改锁定、绑定、成组元素或样式。
数据存储
草图与图片存储在本地 DSH 中。模型读取时，这些数据会发送至已配置的服务。历史附件尚无自动回收机制，升级或卸载前建议导出草图备份。
功能边界
插件不包含内置网页或 PPT 生成器，也不支持草图与代码的自动双向绑定。
