WhaleDraw v0.2.7

更新内容

• Agent 实际调用鲸绘工具并连接画布后才占用画布；本轮任务结束时释放控制。人可随时进入实时只读视图，控制会话显示动画画笔和画布名称。
• 连接选项增加「打开生图工作台」与「不使用鲸绘」，仅讨论画布或代码时不再提前弹出连接选择。

首次升级说明

v0.2.2 及更早客户端首次升级前，请先退出 DSH 并完整备份对应 profile（包括 node_modules、package.json、pnpm-lock.yaml、pnpm-workspace.yaml 和 cordis.patch.yml）。先按 README 的首次升级步骤手动安装 whaledraw-0.2.3.tgz 并重启，确认新版更新器生效后，再升级到 v0.2.7。源码 link: 安装先更新源码与依赖、构建并重启，不要直接用旧版「立即更新」替换源码链接。存在未完成恢复记录时，先完成恢复再升级。

修复阶段专项回归 31 项通过；真实 DSH 桌面升级与新选项交互仍需验收。正式安装包和配套 Canvas Agent 附件将在发布工作流完成后出现在本页。

WhaleDraw v0.2.6

????????????????????????DSH ????????????????? DSH ????? 0.2.6,?? Canvas Agent ???? 0.6.1?

??:web ???? 9 ???(??????? ZIP????????????????),????????? 19 ???(??????????),web ???????????????????????,???? Release CI ???

???:??????? DSH ??????????,???? pending-test?

????:

• ??????? DeepSeek Harness?
• 0.2.2 ?????????????????????? profile(????????),????????????? Release ???????,?????;????????????????????????????????

??:whaledraw-0.2.6.tgz ? DSH ???;?? whaledraw-canvas-agent ????? CLI ??,DSH ?????????

??????:Release CI 39013826860 ????,Docker ???????????????????????:???????? 0.2.6,?? Agent ? 0.6.1,DSH ??????,????????????;???? Agent ???????GitHub Pages ?????? Pages ????,???? Release ? DSH ????????????????????

???? SHA-256:

• whaledraw-0.2.6.tgz:d6d83495b865e342b522f3a63431d9f195d422398d8697426b0af9116f55d41c
• ???? Agent ??:58fb6b819bc162761400337c9350a4a687029a5fc95d9e03f2c57474f3f464c1

WhaleDraw v0.2.5

修复 DSH 更新在「正在安装新版本」阶段长时间停滞：插件安装包现已内置 Canvas Agent 程序，不再由 pnpm 单独从 GitHub 下载 Agent 附件。应用与 DSH 插件版本为 0.2.5，配套 Agent 程序为 0.6.1。

普通运行依赖仍从包仓库安装，需要可用网络或现有缓存；本版不承诺完全离线安装，也未增加 pnpm 下载日志的界面反馈。

验证：此前修复验证共 45 项通过，包括旧包禁止远端请求时复现失败、新内置测试包成功安装并加载，以及安装器、取消、回滚和启动回归。本轮按发版流程不重复运行本地构建或测试。

正式发布核验：Release CI 38873708921 全部通过，三个正式附件均已下载并对照 GitHub SHA-256。已核对插件和前端为 0.2.5、内置 Agent 为 0.6.1，DSH 通道、相对运行入口及常规依赖声明齐备，两个独立 Agent 附件内容一致。桌面真实升级及启动仍待验收。

升级说明：

• 如果此前更新 0.2.4 已提示完整回滚，可在本版正式就绪后重新检查更新；安装完成后重启 DeepSeek Harness。
• 如果更新提示存在未完成恢复记录或回滚不完整，先确认该 profile 没有运行中的安装进程，并核对恢复记录和备份；不要删除守卫记录强行重试。
• 0.2.2 及更早客户端首次升级应退出对应宿主、备份完整 profile（保留源码链接目标），通过宿主正常安装入口使用本 Release 安装包手动升级，再重启宿主；新版保护不会追溯修复旧客户端。不要递归删除旧链接目录或源码目标。

附件：whaledraw-0.2.5.tgz 为 DSH 插件包；两个 whaledraw-canvas-agent 附件供独立 CLI 使用，DSH 用户无需额外安装。

正式附件 SHA-256：

• whaledraw-0.2.5.tgz：635c60172d13553cb77b54085115a6e4426857903d74aaa8eea364d6ce68a368
• 两个独立 Agent 附件：58fb6b819bc162761400337c9350a4a687029a5fc95d9e03f2c57474f3f464c1

其他工作流：GitHub Pages 因仓库未启用 Pages 而未部署，不影响本 Release 的 DSH 安装包。

WhaleDraw v0.2.4

WhaleDraw v0.2.4

本次更新新增 DSH 专用画布通道和实时只读查看，并修复双窗口会话串线、画布存储相互覆盖及连接服务一直转圈的问题。

配套版本

• WhaleDraw 应用 / DSH 插件：0.2.4
• Canvas Agent：whaledraw-canvas-agent 0.6.1，包含 DSH 专用通道，由本仓库自行管理并在同一个 Release 分发。安装插件时一并安装配套 Agent，无需上游 npm 权限。

主要变化

• 两个 DSH 窗口分别控制各自画布，调用固定到对应会话、窗口和项目。
• 人类可进入被 Agent 控制的画布实时只读查看，支持已启用的 SVG、Markdown、HTML 等插件节点。
• 跨窗口保存合并各自修改，切换画布防止旧内容串写；存储失败保留待保存数据并提示。
• 每个窗口复用宿主事件流，改善后台会话连接阻塞；服务启动失败明确报错并允许重试。
• 本地代理源码增加来源和危险目标限制、请求体上限与响应超时；canvas-proxy 独立 npm 包未在本次发布。

升级说明

• 已安装 v0.2.3 正式包的用户可在插件内检查更新，安装完成后手动重启 DSH。
• v0.2.2 及更早版本：先退出对应宿主并完整备份 profile（保留链接，不遍历外部源码目标），再手动安装本版本正式包并重启。旧更新器遇到「旧依赖归档复查不一致」时停止重试，不会因新包发布而自动修复。未完成的恢复记录须先完成恢复，不删除记录绕过保护。
• 源码 link 安装：先更新源码、依赖和构建产物，再重启加载安全更新器；不要用旧安装器直接替换源码链接。

验证与待验收

• main 合并提交 f3a3411 的回归：198 项通过、0 失败；2 项 Unix 文件权限测试在 Windows 跳过。

• CI 已完成 Agent 与 DSH 插件的正式构建、依赖安装和附件上传。已下载并核对附件 SHA-256、Agent 0.6.1 的 DSH 通道模块，以及插件与前端 0.2.4 的版本和固定依赖。正式包安装、合并版完整浏览器及 Electron 验收仍待完成。

• 同画布继续采用单会话控制；页面强制关闭前最后一次异步写入、全局画布库缓存刷新和缺少生图 Key 的工具反馈仍为待完善项。

• 网页生产编译通过；仓库未启用 GitHub Pages，因此网页未自动部署。Docker 应用镜像及官方插件构建成功。

• 发布准备中已修复快照空值编译错误与 Agent 依赖完整性校验，最终源代码标签指向 7a0e913；提前获取过 v0.2.4 标签的开发者需重新获取该标签。

WhaleDraw v0.2.3

更新内容

• 修复 Windows 更新备份将不同文件误判为硬链接，以及目录链接恢复失败的问题；保留归档校验、逐文件复查和失败回滚。
• 更新确认后可真正取消下载；进入安装后等待当前步骤结束，再安全恢复旧依赖与配置，不强杀安装器。
• 更新弹窗实时显示步骤进度、下载大小及百分比，并反馈备份、安装、文件复查与回滚状态。
• 更新最终成功或取消后清除此前取消请求失败的旧提示。
• 应用与 DSH 插件版本统一为 0.2.3，正式构建默认仍使用 Prokint/WhaleDraw 更新源；本地假版本和测试源未包含在正式包中。

DSH 首次升级步骤（v0.2.2 及更早版本）

旧客户端运行的是旧更新器，新包的修复不会追溯保护首次安装过程。若遇到「旧依赖归档复查不一致」，停止在旧页面重试，不要关闭校验或删除恢复记录绕过。

1. 退出对应 DSH 宿主，核对使用的 profile，并完整备份 profile（包括 node_modules、package.json、pnpm-lock.yaml、pnpm-workspace.yaml 及已有 cordis.patch.yml）。保留目录链接，避免遍历或删除外部源码目标。
2. 正式包安装用户下载本 Release 的 whaledraw-0.2.3.tgz，再按插件 README 的安装包流程手动安装；保留备份。已有 rollback-incomplete 或其他未完成恢复记录时，先完成恢复再升级。
3. 源码 link 安装用户不要直接用 CLI 把链接替换为安装包；先更新源码、按开发流程补齐依赖与构建，再重启加载新版安全更新逻辑，后续升级先在独立副本验收。
4. 重启 DSH，刷新插件页面，确认版本为 v0.2.3、已有画布仍在。之后的页面更新才使用新版备份、复查和回滚逻辑。

完整说明见 插件 README。

验证范围

相关 33 项测试及 3180 独立 profile 的本地假包更新、取消、回滚、文件校验与重启验收已通过。这些结果不代表旧客户端已获得新保护，也不代表正式发布包或 Electron 宿主已完成验收。本次发版不另行运行本地编译、测试或构建；附件由 GitHub 发布工作流生成。

WhaleDraw v0.2.2

• [修复] DSH 插件更新在备份前阻断遗留安装运行记录，并保留原生依赖检查基线，避免并发写入和无关插件导致更新失败。

• [修复] DSH 接管画布时保留本页尚未保存的新项目、编辑与删除，避免重载丢失新画布或延迟回写旧副本；连接提示改用稳定状态码识别。

• [优化] 画布占用或当前会话未连接时作为正常状态返回，由对话说明原因与下一步选择，不再将整轮对话标为红色运行失败。

• [调整] DSH 画布先采用独占控制，第二个会话或页面连接、打开已占用画布时提示占用原因，关闭原画布后可重试；同画布多会话协同暂缓。

• [新增] DSH 插件保活已打开的 WhaleDraw 画布，切换会话后连接不再中断，后台运行中的会话仍可继续读取和修改自己的画布。

• [优化] DSH 画布在接手已释放的页面及后台工具操作前检查磁盘内容，避免沿用过期的画布副本。

安装与升级

• DSH 安装附件为 whaledraw-0.2.2.tgz，内部插件名仍为 dsh-infinite-canvas。安装后手动重启 DSH，并刷新已有页面。
• 一个画布同时只允许一个会话或页面控制；切换到后台仍保留占用，关闭原画布后其他会话可以重试。同画布多会话协同编辑暂缓。
• v0.1.3 及更早版本首次升级：先备份 profile 的依赖目录、package.json、pnpm-lock.yaml、pnpm-workspace.yaml 及已有 cordis.patch.yml，再手动安装正式包并重启。旧客户端首次升级不会自动获得新版安装保护。
• 源码 link: 用户先在源码目录更新代码、安装依赖并构建，然后重启；不要用旧更新器或 CLI 安装包直接替换源码链接目标。升级验收使用独立副本。

验收范围

本次发版准备未执行本地编译、测试或构建；安装包由 GitHub Actions 生成。画布功能的已有浏览器验收范围见仓库 pending-test；最新更新事务守卫的新增用例及新正式包安装升级仍待独立 profile 验证。更新过程会增加临时磁盘占用，不同页面交叉保存仍为待验收项。

WhaleDraw v0.2.0

更新内容

• 仓库、应用界面、DSH 入口和文档统一为 WhaleDraw，保留上游署名与许可证。
• 更新来源为 Prokint/WhaleDraw，正式安装附件为 whaledraw-0.2.0.tgz；内部插件身份、MCP、路由和本地数据库标识保持不变。
• 中英文 Render 部署入口使用本仓库。
• 更新备份采用同步 tar 归档，解决实际依赖树异步归档停滞；保留备份、隔离、逐文件复查及失败回滚。

旧客户端首次升级

v0.1.4 及更早版本仍匹配旧仓库及旧文件名，不能依靠旧页面更新器完成本次切换。首次安装前先备份并结束使用目标 DSH 的任务。

• 正式包安装：退出目标 DSH，备份其 profile 的 node_modules、package.json、pnpm-lock.yaml、pnpm-workspace.yaml 及 cordis.patch.yml（存在时），下载本页的 whaledraw-0.2.0.tgz，在对应 profile 的插件管理流程中从本地文件安装，再重启。安装包内部仍是 dsh-infinite-canvas，不要另改依赖或存储身份。
• 源码 link 安装：不要直接通过旧更新器或 pnpm 将源码链接替换成正式包。先取得 v0.2.0 源码、补齐插件依赖、构建并重启加载安全安装逻辑；升级验收使用独立副本。具体步骤见 插件文档。
• 新保护不会追溯恢复旧安装器已经删除的文件。备份和安装器已使用的本地包需保留；安装后手动重启。

验收与已知限制

此前 3180 的 0.1.4 开发包生产构建、两次安全手动安装、24 个文件复查及真实页面加载通过，已有画布保留且 DSH 连接正常。Node 24.21.0 / DSH 0.2.0-rc.2 / pnpm 11.7 下 14 项独立副本安装测试通过。

• pnpm 11.25 的两项源码 link 转包测试未通过并已安全回滚，仍待调查；包转包在 3180 已通过。
• 同步归档期间宿主进程可能暂时暂停响应；Windows 目录占用会拒绝安装，需退出宿主后处理。
• v0.2.0 的实际模型调用、Render 云部署及 Release 页面自动升级尚未验收。Docker Compose 仍使用上游镜像，按维护安排暂缓调整。
• 本轮没有执行本地构建或测试；正式安装包由发布工作流构建并上传。本机已安装插件不会随 Release 自动升级。

合并记录：PR #12。

v0.1.4 — Infinite Canvas for DSH

v0.1.4

• [修复] DSH 更新在宿主写锁内备份旧依赖与配置，隔离源码链接；安装后对照官方包逐文件复查，失败自动回滚，恢复未完成时阻止后续更新。
• [调整] 移除右上角的小书本文档入口。
• [新增] DSH 插件实时同步宿主深浅色外观。

重要：首次升级安全提醒

v0.1.3 不包含 v0.1.4 的备份、源码链接隔离、逐文件复查与失败回滚保护。新版本的保护不会追溯修复正在运行的旧更新器。详细步骤见 插件 README。

• 正式包用户：首次升级前，备份当前 DSH profile 的 node_modules、package.json、pnpm-lock.yaml、pnpm-workspace.yaml 和已有 cordis.patch.yml；手动安装 v0.1.4 正式包，然后手动重启。加载新版后，后续页面更新才有新保护。
• 源码 link 用户：暂停旧版“立即更新”，不要直接用 CLI 将源码链接替换为包。先取得 v0.1.4 修复源码，在插件目录执行 pnpm install --frozen-lockfile，重启 DSH 加载新版更新器，再用独立副本验收。需要刷新前端时按开发流程构建。
• 已丢失文件：停止安装，保留 profile、日志和剩余文件；Git 管理的文件可从 Git 恢复，未提交或未跟踪的改动只能从已有备份恢复。重新安装不能找回个人开发改动。

曾在 Windows 桌面 Electron 运行时配合 pnpm 11.7.0 hoisted 独立复现源码目录清空，不能推断所有 v0.1.3 用户均已受影响。

---

安装包与验证

安装包 dsh-infinite-canvas-0.1.4.tgz 已由 Publish DSH Plugin 工作流 成功构建、打包并上传。已实际下载核对 SHA-256（51fc816c7462122749ace5a375e8a820c2c0f67694e813587e1c3487e319a373），包内插件版本为 0.1.4、前端标识为 v0.1.4，包含安全安装事务及其调用，旧源码 link 禁用逻辑已移除。安装后提示手动重启，不自动重启宿主。

13 项独立临时 profile 回归通过，包含真实 pnpm、DSH 原生插件管理器和 Cordis 服务代理集成。尚未完成真实页面升级及重启后的画布保留验收。

更新期间会重建整个 profile 的插件依赖，先结束相关任务。备份保留在 profile 的 .plugin-manager/downloads，占用额外磁盘；强制退出或回滚失败可能需要人工恢复。恢复记录、旧依赖与归档均保留，不自动清理；不能恢复此前未备份且已删除的文件。

修复 PR：#11。

v0.1.3 — Infinite Canvas for DSH

重要：首次升级安全提醒

v0.1.3 不包含 v0.1.4 的备份、源码链接隔离、逐文件复查与失败回滚保护。新版本的保护不会追溯修复正在运行的旧更新器。请先阅读 v0.1.4 安装说明。

• 正式包用户：首次升级前，备份当前 DSH profile 的 node_modules、package.json、pnpm-lock.yaml、pnpm-workspace.yaml 和已有 cordis.patch.yml；手动安装 v0.1.4 正式包，然后手动重启。加载新版后，后续页面更新才有新保护。
• 源码 link 用户：暂停旧版“立即更新”，不要直接用 CLI 将源码链接替换为包。先取得 v0.1.4 修复源码，在插件目录执行 pnpm install --frozen-lockfile，重启 DSH 加载新版更新器，再用独立副本验收。需要刷新前端时按开发流程构建。
• 已丢失文件：停止安装，保留 profile、日志和剩余文件；Git 管理的文件可从 Git 恢复，未提交或未跟踪的改动只能从已有备份恢复。重新安装不能找回个人开发改动。

曾在 Windows 桌面 Electron 运行时配合 pnpm 11.7.0 hoisted 独立复现源码目录清空，不能推断所有 v0.1.3 用户均已受影响。

---

v0.1.3

• [修复] 立即更新改为 GET 下载官方插件包、核对 Release SHA-256，再由 DSH 从本地安装，避免远程 HEAD 失败导致长时间等待。
• [修复] 发布工作流重新解析不完整锁文件，补齐前端依赖和 Linux 构建模块，并处理现有组件库的 peer 依赖声明冲突。

安装与验收

dsh-infinite-canvas-0.1.3.tgz 已由 Publish DSH Plugin 工作流 成功构建、打包并上传，实际下载核对 SHA-256 与 Release 一致，包内版本和前端构建标识均为 v0.1.3，包含 GET 下载与本地安装修复。

安装成功后需要手动退出并重新打开 DSH。已发布 v0.1.2 的更新器仍使用旧下载逻辑；若无法自动升级，可手动安装本 Release 的 .tgz 附件。GitHub 原始版本文件存在缓存，刚发布后检查可能短暂显示旧版本。

本机带修复的 v0.1.2 测试插件已通过页面更新到 v0.1.3，安装日志正常结束，耗时 44.9 秒；安装包 SHA-256 与 Release 一致，23 个已安装文件匹配官方包。重启后页面版本为 v0.1.3，画布连接正常，用户确认原有画布仍在。普通正式包之间的升级、失败分支及实际生图未因本次验收而视为通过。

开发版源码 link 切换为安装包后，本机发现链接目标目录被清空，已恢复受 Git 管理的源码文件，具体原因仍待调查。开发升级测试请使用独立副本，避免将 link 指向主要源码工作区。

v0.1.2 — Infinite Canvas for DSH

v0.1.2

• [新增] 版本弹窗提供 DSH 插件「立即更新」入口，由插件端下载安装，安装后提示手动重启 DSH。
• [新增] 发布可安装的同版本插件包 dsh-infinite-canvas-0.1.2.tgz。

安装与更新

已有更新入口的 DSH 插件可在右上角版本弹窗检查更新并点击「立即更新」，安装成功后手动退出并重新打开 DSH。没有更新入口的旧插件请手动安装本 Release 的 .tgz 附件。

插件包已通过 GitHub 工作流 构建、打包并上传。读取附件确认包内版本及前端构建版本为 v0.1.2。未执行本地构建或测试，实际 DSH 安装升级与重启后的运行情况仍待验收。