DSH Sketch Reference v0.7.0 · Sketch Graph

从一张草图，到一组可以继续讨论和实现的可视化需求。Sketch Graph 将页面、局部细节和原生 DSH 对话连在同一个会话里。

本版更新

• 关联多张草图：页面跳转与细节展开、元素／区域锚点、双击编辑、来源定位与重新绑定。旧草图继续作为根节点。
• 保持原生对话：右侧画板、全屏与可拖动／收起的悬浮聊天，复用原有输入、附件和会话。
• Agent 按需读取：sketch_graph_read、按 nodeId 读取结构和 PNG；根草图继续支持锚点批注、追问和经确认的修改。
• 保存与性能修复：修复合法大图 413；布局合并保存、缩略图按版本缓存、坐标校验、CAS 与失败恢复。细节关联排除根节点，短框选可重试。
• 完整备份与追加恢复：草图、关系和可编辑场景一起导出；中断恢复任务可继续，保留原根草图。

安装／升级

适用 DSH Web 0.2.1-alpha.1 / 0.2.1-alpha.2；官方 npm CLI 需要能调用 pnpm。先保存、备份并退出宿主：

dsh plugin --profile web add https://github.com/Amadeus2027/dsh-sketch-reference/releases/download/v0.7.0/dsh-sketch-reference-0.7.0.tgz
dsh web

编辑器和字体已内置，不用提前单独安装 Excalidraw，模型和认证继续使用 DSH 配置。升级保留原 profile、存储和浏览器数据。

• 直接安装包：dsh-sketch-reference-0.7.0.tgz。
• 预构建 ZIP：dsh-sketch-reference-0.7.0-installable.zip，解压得到同一个 tgz 和其校验清单。
• 源码 ZIP 方式保留：下方 Source code ZIP／固定版本源码，解压后执行 frozen install、bundle，再将目录加入官方管理器；不要求先 pack。
• 校验：外部 SHA256SUMS.txt 同时校验 tgz 和预构建 ZIP；ZIP 内的清单校验其中的 tgz。

安装与升级 · 使用指南

验证与边界

• TypeScript、25 文件／233 项单测、完整构建、发行完整性和打包检查通过。正式化不改运行源码与固定依赖；本地验收包与 CI 公开包分别记录。归档哈希及生成 CSS 标识可能因构建环境不同，以 Release 清单和实装核对为准。
• 运行代码的两版 DSH Linux 实装、实际退出重启、图／草稿恢复、失败重试、原生输入／附件、导出与主题回归已有记录。正式包安装核对见 发行检查。本次没有调用模型。
• 最多 100 节点／300 连线，满载仍会掉帧。子节点 Agent 只读，批注与修改提议限根草图；不提供图级撤销、自动布局或多人协作。强杀可能丢失最后一个布局检查点窗口。
• Windows／真实模型历史案例保留其开发快照身份，不称作正式包全面重验；不新增 Token 节省或模型质量结论。

完整更新 · 功能与实测记录 · 性能专项 · v0.6.5…v0.7.0

发行资产来源

来自 CI #39004844444，源码 114f3bf4ede6230c9bcabbd4a1eec13a72129b22。公开资产使用此 CI 包；本地安装核对包的归档哈希不作替代。

e8697a76116105ef31acd76d573a97039e20e33f1e1d9a0bf972eb4e1576ccb7  dsh-sketch-reference-0.7.0.tgz
7ccc983a12a61b4651c44586bee76b8d170945bf20eaeff5a529b3b8b7cc6529  dsh-sketch-reference-0.7.0-installable.zip

正式 CI 包已通过下载校验：431 个 lib 文件与本地验收构建比对，除生成 CSS 类名及映射顺序外其余内容一致；两处映射按对应类名规范后代码相同。该 CI 包另在 DSH alpha.2 实装，通过原生主题／会话／保存与全屏交互回归；本次无模型调用。

DSH Sketch Reference v0.6.5

面向 Windows PC 的 DSH 原生可视化协作插件。本版兼容 DSH Web 0.2.1-alpha.1 / 0.2.1-alpha.2，并完成 Windows alpha.2 实机回归。

更新内容

• 适配 alpha.2 的主题字体消息，保留实时深浅主题同步；原生工作目录变化不会改变草图所属会话。
• 正常手绘线条和箭头的临时单点状态不再触发错误条；完成后仍执行严格保存校验。
• 通知与无建议状态统一为 DeepSeek 蓝，保留明确的错误文字与恢复操作。
• 安装包内置 Excalidraw 编辑器、CSS 与九个字体族；支持预构建 tgz 和构建后的源码目录安装。
• 更新主页、使用说明与操作录屏；录屏为自动化输入，不含模型回答。

保留用户确认、原生撤销、revision / focus / CAS、会话隔离；未升级固定 Excalidraw / React，未增加后台模型请求。

安装与升级

安装条件：DSH Web CLI 0.2.1-alpha.1 或 0.2.1-alpha.2，pnpm 可在 PATH 中使用。先导出草稿备份并退出宿主，再执行：

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

下载附件中的安装包与 SHA256SUMS.txt 配对校验，无需单独安装 Excalidraw。模型沿用 DSH 自身配置。

Windows 验收

2026-10-15，Node 24.14.1、Edge 155.0.4283.45、DSH Web alpha.2 实装：

• 9 组浏览器回归通过：绘图保存/导出、批注与自然追问、视觉缓存、受控修改/确认/撤销、Agent 失败恢复、focus、原生 working_directory 与性能。包含 1280×720、1920×1080、分栏、实时主题和原有文字/PNG 保留。
• alpha.1＋0.6.3 → alpha.2＋0.6.5：原草图、两类批注及状态、待应用提议、PNG 缓存、视口和未发送文字逐项一致。
• 无测试覆盖层的官方新装、移除及重启通过：单一入口、资源 200；移除后入口消失、资源 404。
• 250 元素单轮测量：保存请求约 33–41 ms，50 帧平移没有保存，三次同版 PNG 请求仅栅格化一次。不是相对性能提升或长期无泄漏结论。

工程 Agent 回归使用固定响应；本次真实 DeepSeek 请求数为 0，不替代模型理解质量验证。同一运行源码此前 Windows typecheck、21 文件/193 项测试、bundle、pack 通过；main GitHub Actions #38267192996 成功。本轮没有复现需修改产品运行代码的缺陷，只修正测试等待并补充安装回归。

完整 Windows 验收报告见本次附件；主页和测试维护见 PR #31，待维护者合并。

已知边界

真实模型仍可能误读或输出无效工具参数；未声称解决 MALFORMED_RESPONSE 根因。图片附件历史不自动回收；同步断线可用「⋯ → 同步批注」或重开恢复。未新增真实模型、1950 元素/数小时压力、Desktop GUI、PTC 及其他宿主版本验收。

发行源码：bbedb5c539124de1fd89db7f42fba25f1dcd937d。完整变化：v0.6.3...v0.6.5。

DSH Sketch Reference v0.6.3

面向 Windows PC 的 DeepSeek Harness 原生可视化协作插件。本版在 v0.6.0 基础上集中打磨批注、画板视角恢复和原生界面体验，包含 0.6.1–0.6.3 的改进。

更新内容

• 批注去除重复摘要与正文：顶部保留标题，详情与追问、纠正、修改操作集中在画板内卡片的「⋯」菜单。
• 数字标记改为清晰的直立字体与圆角标签；每条批注保留画布入口，选中状态更明确。标题超过三个时可左右切换，不再强制三条建议；没有值得讨论的问题时可以不生成建议。
• 关闭重开画板，恢复同一浏览器、同一会话的缩放与平移。
• 「刷新批注」移到「作为参考发送」右侧的「⋯」，更名为「同步批注」，提供成功反馈；同步只读取已有批注，不调用模型。标记显示/隐藏位于批注栏最右侧。
• 建议模型使用 DSH 官方模型目录的真实名称和型号；图片能力继续由宿主校验。
• 标题与保存状态对齐，「Find on canvas」中文化为「在画布中查找」。参考板按钮与选区成功提示复用 DSH 原生蓝色，深浅主题保持一致。
• 整理 README 与首次使用指南，保留 MIT、DSH、DeepWiki 入口。

保持会话隔离、revision / focus / CAS 校验、自动保存、用户确认和原生撤销；不升级固定依赖，不新增后台 AI 请求。

安装与升级

已验证环境：Windows PC、DSH 0.2.1-alpha.1、Excalidraw 0.18.1。下载附件 dsh-sketch-reference-0.6.3.tgz，退出宿主后在实际使用的 profile 安装：

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

若使用其他 profile，请替换 web。升级前建议下载草图备份，安装后重启宿主。模型在 DSH 内配置；图片读取需要支持图片输入的模型。

验证与边界

• 本版 typecheck、20 个测试文件 / 187 项测试、bundle、pack 通过；PR #20 的 GitHub Actions 通过。
• 安装后的真实 DSH / Excalidraw 回归覆盖 1280×720、1920×1080、深浅主题、原生草稿与 PNG 保留、批注操作、视角恢复与失败恢复。自动 Agent 流程使用明确标识的固定响应设施，本轮没有新增真实 DeepSeek 请求。
• 现有隔离 DSH 升级后，已保存草图、批注及视觉缓存文件哈希保持不变。
• 模型仍可能误读或返回无效工具参数；附件历史没有插件自动回收机制；同步断线可用「⋯ → 同步批注」或重开画板恢复。其他平台、宿主版本及跨刷新撤销历史不作兼容承诺。

详见 使用指南、更新说明、本版验证记录。附件包含安装包与 SHA256SUMS.txt 校验文件。

完整变更： v0.6.0...v0.6.3

DSH Sketch Reference v0.6.0

DSH Sketch Reference v0.6.0

面向 Windows PC 的 DeepSeek Harness 原生可视化协作插件。正式包沿用冻结的 0.6.0-rc.2 运行代码，仅更新版本及发布文档，不新增功能或改变权限。发布状态以 GitHub Releases 为准。

核心能力

• Excalidraw 可编辑草图、自动保存、关闭恢复与会话隔离。
• Agent 按需读取已保存的结构与真实 PNG；用户设置的选区重点限制读取范围。
• 真实元素锚点批注，以及从批注进入 DSH 原生输入框追问、纠正或要求修改；保留原有文字和附件，不自动发送。
• Agent 生成受限修改提议，用户预览并明确确认后才能应用；保留 revision、CAS、恢复备份和 Excalidraw 原生撤销。
• 复用宿主聊天、工具卡片、主题与分栏，不提供第二套聊天界面，不因普通 UI 操作自动调用模型。

v0.6.0 阶段变化

• 独立两点箭头支持不同方向，包括水平、竖直。继续拒绝固定原生转换器无法稳定处理的极小非零跨度（≤1）。旧记录保持可读。
• 结构摘要报告有效视觉参考的实际尺寸，遵守 focus；极端转义文本遵守输出预算并标记用途截断。不猜测结构数据未提供的颜色、字体或描边。
• 配额检查缓存不可变记录的字节数，避免反复序列化全部历史；容量与记录限制不变。修改确认和忽略检查增长后的提议容量，容量不足在修改画板前拒绝。
• 成功图片分析记录原生附件引用；旧批次兼容。纯结构分析拒绝无意义图片载荷，图片及混合分析保留真实 PNG 输入。
• Windows 许可清单路径规范化；补充容量边界、取消、超时、格式错误和显式重试回归。

安装与兼容

• 锁定验证宿主：DSH 0.2.1-alpha.1，Excalidraw 0.18.1。其他宿主版本、平台及移动端不作兼容承诺。
• 在 DSH 的 Web profile 中安装发布附件 dsh-sketch-reference-0.6.0.tgz：

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

安装或升级前建议下载草图备份，退出并重启宿主。配置官方模型密钥应在 DSH 内完成，不发送到聊天或项目文件。

验证依据

冻结 rc.2 本地及 GitHub Actions 类型检查、19 个测试文件/174 项测试、构建、打包通过。Windows 安装后验证原生文字与待发 PNG 保留、focus、五类图形确认/撤销/重做、250/1950 元素保存、失败恢复，以及新装/升级/禁用/重启。正式化没有修改运行源码，沿用这些结果，不称为又一轮新的模型或实机验证。

此前真实 DeepSeek 在隔离工作区完成网页、三屏 UI 与五页可编辑 PPTX，并接收用户侧纠正；原生 PNG 对照也完成简单 UI，不能据此宣称插件的生成质量或 Token 消耗更优。

详见 rc.2 验收和测量、真实应用验证、原始反馈与截图。

已知限制

• 不同图片、失败或被替换的分析附件可能积累；记录引用不等于自动回收，固定宿主没有公开安全释放接口。
• 实时同步断线后需手动刷新批注或重开画板；绘图和保存仍可使用。
• 真实模型可能误读草图或输出无效工具参数；历史 MALFORMED_RESPONSE 没有被此版本消除。失败提示、用户纠正和修改确认仍然必要。
• 修改工具只支持现有白名单操作，不能任意编辑样式、锁定、绑定或成组图形。固定 Web 不直接消费 presentResult，保留正常原生工具卡片。
• 数小时持续运行、堆快照泄漏分析及所有历史升级组合未覆盖；不宣称长期无泄漏或全平台兼容。

后续版本优先处理实际反馈与发布缺陷，不扩张本次冻结范围。