Skip to main content
A

dsh-sketch-reference

amadeus2027/dsh-sketch-reference

Visual sketchboard for DeepSeek Harness: draw with Excalidraw, let AI agents inspect and annotate sketches, and review proposed edits.

Install

dsh plugin --profile web add github:amadeus2027/dsh-sketch-reference

README

DSH Sketch Reference

画出想法,交给 DSH

Release CI License: MIT Tested DSH Ask DeepWiki

下载插件 · 快速开始 · 使用指南 · English

画布局、讨论细节、在工作区实现。 Sketch Reference 把 Excalidraw 接入 DeepSeek Harness,让 Agent 按需读取草图、定位批注、提出修改;画板修改先预览,再由你确认。

v0.6.5 画板操作录屏:Excalidraw 手绘风格布局、撤销重画、PNG 附件与返回聊天

画草图 → 调整布局 → 加入参考 → 回到聊天。查看静态图

演示与案例说明

画板演示为 v0.6.5 连续录屏,输入由自动化驱动,展示绘画、保存、PNG 附件与返回聊天;未调用模型或发送聊天消息。录制来源与参数

网页、UI 与 PPT 案例来自各自记录中的真实 DSH Agent 实验,版本和运行结果见案例链接。完整真人/真实 DeepSeek 多轮开发录像仍待 Windows 录制。录制清单

下表比较草图沟通与编辑流程;模型质量、速度和 Token 消耗未作对照测量。

使用前与使用后

对比同一个任务:“按这个布局做页面,接着调整这里。”

仅原生聊天+普通 PNG加上 Sketch Reference
表达布局:写文字,或在其他工具画图后上传会话内画图:草图自动保存,和当前任务放在一起
讨论局部:说明“右边那个框”,或另做标记图点选定位:元素批注绑定真实图形,菜单追问或纠正
更新参考:修改原图,再导出、附上新版按需读取:Agent 获取当前保存版本的结构与 PNG
修改画板:在绘图工具中手动调整预览确认:Agent 提议 → 前后预览 → 你确认 → 原生撤销

草图表达、局部讨论和修改确认,接在 DSH 的原生聊天与工作区工具上。

一张草图,三种协作方式

  • 画好就问。 直接在原生聊天说:“按当前草图实现一个网页。”无需先做独立 AI 分析。
  • 指着位置继续聊。 让 Agent 标注某个区域,从批注菜单「追问 / 纠正 / 修改这里」起草下一条消息;你编辑后自行发送。
  • 看过再改。 Agent 通过受限工具提出画板修改,同视角预览后确认应用。旧版本提议不能覆盖新草图。

草图与批注按会话保存。绘图、悬停、翻页不会触发模型;没有额外 AI 服务或独立密钥配置。

批注与追问菜单

v0.6.3 的紧凑批注栏、图形锚点与追问菜单

v0.6.3 菜单示例,批注为演示用固定样例。素材说明

你可以拿它做什么

场景在同一会话继续做
网页 / UI画布局 → 实现页面 → 围绕搜索、导航与返回行为纠正。运营看板与三屏 UI
PPT画出分区关系 → 制作可编辑幻灯片 → 调整指定页布局。5 页 PPTX 与局部纠正
手绘画物品或示意图 → 读图讨论 → 补充说明。无文字杯子草图与协作闭环

插件提供可持续编辑的草图与参考图,DSH Agent 在工作区继续完成网页、UI 和 PPT。

快速开始

源码 ZIP 和预构建包两种方式都支持。 都通过 DSH 官方管理器加入插件,无需提前单独安装 Excalidraw。

1. 安装插件

方式一:源码 ZIP 解压后加入 DSH

点击 Code → Download ZIP,解压后进入包含 package.json 的项目目录。先安装依赖并构建,再把这个目录加入 DSH;无需先生成 .tgz:

pnpm install --frozen-lockfile
pnpm run bundle
# 等待草图保存并退出正在运行的 DSH,然后加入解压后的项目目录
dsh plugin --profile web add "/绝对路径/dsh-sketch-reference-main"
dsh web

此方式会链接源码目录,请保留该目录及其中的 lib、node_modules。更新源码后重新构建并重启 DSH;换到新目录时重新执行 add。Windows 路径示例及升级说明见 安装指南。

方式二:预构建安装包(无需本地构建)

  • ZIP 下载:进入 成功的构建记录,下载页面底部的 dsh-sketch-reference-installable ZIP,解压得到 .tgz 和 SHA256SUMS.txt。
  • 直接下载:从 正式发行 获取对应版本的 .tgz 和校验清单。

取得对应版本的 .tgz 和同包 SHA256SUMS.txt 后,等待草图保存并退出宿主,然后执行:

dsh plugin --profile web add /绝对路径/dsh-sketch-reference-0.6.5.tgz

运行 dsh web 即可使用。预构建包已包含编辑器和字体,无需克隆源码、另装 Excalidraw 或手动构建。

环境:DSH Web 0.2.1-alpha.1 / 0.2.1-alpha.2,npm CLI 管理器可调用 pnpm。升级保留原 profile、存储与浏览器数据。安装与升级指南

2. 从一张简单草图开始

  1. 选择工作区并创建会话,点击输入框旁的 「参考板」,画图并添加用途。
  2. 等待 「已保存」,返回原生聊天提问;也可点 「作为参考发送」 将 PNG 加入输入框。
  3. 接着讨论、添加批注或请求修改。画板修改检查预览后确认,聊天消息由你发送。

模型与认证沿用 DSH 配置,图片读取需模型支持视觉输入。绘图、保存和导出可独立使用。使用指南

兼容性、数据与功能边界
  • v0.6.5 两版 Web 宿主功能回归来自 Linux 隔离环境;Windows/真实模型仍需验收。其他宿主版本、移动端、非默认工具模式和所有插件组合不作兼容承诺。
  • 无法可靠定位时保留文字建议,不猜测位置。模型可能误读草图或返回无效参数;数学正确性无保证。重点按版本绑定,不限制其他宿主工具或清除聊天历史。
  • 画板修改受图形白名单限制,不任意修改锁定、绑定、成组元素或样式;跨刷新撤销历史不保证恢复。
  • 草稿与图片在本地 DSH 存储;模型读取时发送至已配置的服务。历史附件尚无自动回收机制;升级/卸载前请导出草图备份。
  • 同步断线后用 「⋯ → 同步批注」 或重开画板。没有内置网页/PPT 生成器,也没有草图与代码自动双向绑定。

宿主兼容报告 · v0.6.5 验证范围

一起把草图协作做得更好

如果你希望 DSH 能持续理解同一张草图,欢迎 Star 关注更新。欢迎带着脱敏草图和复现步骤来 反馈问题、提出场景。

从源码构建、验证记录与开源许可

源码 ZIP 解压后可以按上方方式直接加入项目目录。需要完整检查或生成便于分发的 .tgz 时,在项目目录运行:

pnpm install --frozen-lockfile
pnpm run typecheck
pnpm test
pnpm run bundle
pnpm pack

贡献流程 · 0.6.5 验证记录 · 复用说明 · 第三方许可

社区插件,采用 MIT。绘图能力来自 Excalidraw,宿主能力来自 DeepSeek Harness;第三方许可与验证记录见上方链接。

Related plugins