dsh-image-canvas
DSH 桌面版右侧栏的无限画布：打开任何格式的图片都会落到同一张可平移缩放的画布上，支持拖动/缩放/旋转/锁定/撤销、框选与涂抹批注、一键把批注变成给 Agent 的提示词、导出 PNG，并可用本机 ComfyUI 直接改图/出图。所有能力本地完成，不调用任何外部 AI 服务。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Link-h1j/dsh-image-canvas#63cb9e50cda6fdce26f9c1228cfa329e250f1f9a
Image Canvas 以 dsh-image-canvas 发布，当前版本为 0.4.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 桌面版右侧边栏的「无限画布」：打开的图片会落到同一张可平移缩放的画布上，可以在图上批注、 用本机 ComfyUI 直接改图/出图，一键把批注变成给 Agent 的提示词。除 ComfyUI 推理外全部本地完成， 不需要任何云端 API Key。
灵感与交互参考自 KaichenCurry/dsh-design-mode（画布 + 图上批注 + 版本树）， 但那个是整仓 fork（0.1.1-rc.2，需要跑独立实例）；本插件是为 DSH 桌面版 0.2.x 重写的独立插件， 走官方右侧栏 tab 契约，直接装进你现在用的桌面版。
| 选中与工具条 | 批注 |
| 选中图片：上方浮出操作条，可编辑 / 回正 / 原尺寸 / 引用生成 / 锁定 / 消除 | 标记批注：编号徽标 + 说明，标记列表与「复制批注」 |
| 图片右键菜单 | 画布右键菜单 |
| 图片 / 多选右键：复制·粘贴·剪切·删除 + 改图 / 同目录铺开 / 锁定 | 画布空白右键：粘贴 / 全选 / 适应视图 / 导出 PNG / 清空画布 |
| 本地改图 | |
| 本地 ComfyUI 改图浮层：整图重绘 / 按批注重绘 / 生成新图 |
（截图由插件自带的 tools/preview.mjs 渲染生成，示例图片为占位图，不含任何个人素材。）
| 能力 | 说明 |
|---|---|
| 图片自动汇入 | 在对话/文件树/交付物里打开 png/jpg/jpeg/gif/webp/bmp/ico/svg/avif/apng，都会落到同一张画布上；同一张图重复打开不会重复添加 |
| 无限画布 | 滚轮以指针为中心缩放、手/中键拖动平移、适应视图、真实百分比显示 |
| 节点操作 | 单选时四周 8 个缩放手柄（4 角 + 4 边中点：角上等比、按住 Shift 放开比例、边上只改一个方向）+ 右上角外侧的旋转点（圆形箭头图标，Shift 吸附 15°）；拖动、锁定、删除、F 聚焦 |
| 撤销/重做 | Ctrl+Z / Ctrl+Y，最多 60 步 |
| 批注 | 点 / 框选 / 涂抹三种锚点；编号标记；每条可写说明；列表在「标记」浮层里，可删除 |
| 本地改图（ComfyUI） | 三种动作：整图重绘（img2img）、按批注重绘（框选/涂抹当掩码做局部重绘）、生成新图（txt2img）。结果自动作为新节点落在源图右边 |
| 交给 Agent | 一键把批注整理成提示词复制到剪贴板（带画布坐标），粘贴进对话即可让模型按意见处理 |
| 导出 | 把可见图片合成为一张 PNG 下载（含旋转，本地合成） |
| 持久化 | 按会话保存：宿主路由 <DSH_HOME>/storages/dsh-image-canvas/<会话>.json，宿主不可用时回落 localStorage；AI 产出图片落在同目录 out/<会话>/ 并由插件路由取回 |
| 面板外右键 | 在画布面板以外（聊天/文件树）的内容图上右键：放入无限画布 / 复制图片地址 |
前置：DSH 桌面版（0.2.x；在 0.2.0-rc.2 上开发验证）、可选的本机 ComfyUI（默认 127.0.0.1:8189）、Node.js ≥ 20（仅开发自检需要）。
把仓库克隆到本地任意目录（不要放进 profile 的 node_modules）：
git clone https://github.com/Link-h1j/dsh-image-canvas.git D:\plugins\dsh-image-canvas
DSH 左侧栏 插件 → 添加插件，填该目录的绝对路径（例如 D:\plugins\dsh-image-canvas），
按提示启用。插件管理器支持本地目录（bundle）安装；也可以让 DSH Agent 用插件管理器从目录安装。
若右侧栏面板迟迟不出现，请完整重启一次桌面版——宿主半边（探活路由）要重启才会挂载； 浏览器半边（画布 UI）会自动热更。
# 1) 宿主路由是否挂上（端口换成你本机 DSH Web GUI 的实际端口）
Invoke-RestMethod http://127.0.0.1:<端口>/plugins/dsh-image-canvas/probe
# 期望：{"ok":true,"plugin":"dsh-image-canvas","version":"0.4.0","store":"...storages\dsh-image-canvas"}
# 2) 插件是否进了 profile
(Get-Content "$env:USERPROFILE\.dsh\profiles\desktop\package.json" -Raw | ConvertFrom-Json).dsh.profile.bundles -contains 'dsh-image-canvas'
# 期望：True
┌──────────────────────────────────────────┐
│ │
│ 画布占满整块面板 │
│ （滚轮缩放 · 手/中键拖动平移） │
│ ┌──────────────┐ │
│ │ ▸ 标记 │ │ ← 悬停/点分组 → 向上展开成员
│ │ ▢ 框选 │ │
│ │ ✎ 涂抹 │ │
│ └──────────────┘ │
│ ┌──────────────┐ │
│ │✨ ▸◣ ◉◣ ⤢ ⋯ │ │ ← 右下角 5 个按钮（分组带小三角）
│ └──────────────┘ │
│ 标记 3 82% │ ← 状态胶囊（点 = 适应视图）
└──────────────────────────────────────────┘
Ctrl+C / Ctrl+X / Ctrl+V 同效点右下角 ✨ 打开「生成 / 改图」浮层：选模型 → 写提示词 → 点动作按钮。 步数 / CFG / 重绘强度 / 负面提示词收在 高级 里。三个动作：
| 按钮 | 走什么 | 适用 |
|---|---|---|
| 整图重绘 | img2img（源图上传 → VAEEncode → KSampler） | 整体改风格/配色/氛围，靠重绘强度（默认 0.6）控制幅度 |
| 按批注重绘 | inpaint（框选/涂抹变成掩码 → SetLatentNoiseMask） | 只改指定区域，其余像素不动 |
| 生成新图 | txt2img（832×1216 空潜变量） | 从零出一张，落到画布上继续改 |
结果作为新节点插在源图右边（名字前缀 AI ·），图片存在 <DSH_HOME>/storages/dsh-image-canvas/out/<会话>/，
刷新/重启后依然在。用的是最通用的核心节点（CheckpointLoaderSimple / CLIPTextEncode / KSampler /
VAEEncode / ImageToMask / SetLatentNoiseMask / VAEDecode / SaveImage），不依赖自定义节点；
SD1.5 / SDXL / Flux 的 checkpoint 都能选。
插件不负责启动 ComfyUI，用你平时的方式启动即可（默认连 http://127.0.0.1:8189）：
$env:PYTHONUTF8 = "1" # Windows 中文控制台是 GBK，自定义节点打 emoji 会让 ComfyUI 崩掉
python main.py --port 8189
在 Windows 上如果没设
PYTHONUTF8=1，会看到UnicodeEncodeError: 'gbk' codec can't encode character ...直接把 ComfyUI 干掉（实测）。
要换地址设环境变量 DSH_IMAGE_CANVAS_COMFY（宿主半边启动时读取，改完需重启桌面版）。
| 变量 | 默认值 | 说明 |
|---|---|---|
DSH_IMAGE_CANVAS_COMFY | http://127.0.0.1:8189 | ComfyUI 服务地址（宿主重启生效） |
DSH_IMAGE_CANVAS_JSDOM_ROOT | <插件>/../apps/dsh-design-mode | 开发自检：含 jsdom 的工程目录 |
DSH_IMAGE_CANVAS_REACT_ROOT | <插件>/../apps/infinite-canvas/web | 开发自检：含 react/react-dom 的工程目录 |
画布跟随系统配色（prefers-color-scheme）：浅色系统白底、深色系统深底。
「主题」在 ⋯ 菜单里，循环切换 跟随系统 → 浅色 → 深色，选择会记住（localStorage）。
导出 PNG 的底色也跟主题走；图上批注的高对比色保持不变。
| 键 | 作用 |
|---|---|
| 滚轮 | 以指针为中心缩放 |
| 手工具 / 中键拖动 / Alt 拖动 | 平移画布 |
| 拖动图片时 | 自动磁吸对齐（边/中线/视口中心，屏幕 7px 内）+ 参考线；按住 Alt 关掉磁吸 |
| 选择工具：空白处左键拖动 | 拉框多选 |
选择工具：Shift 点图片 | 加选 / 减选 |
| 右键图片 / 右键空白 | 图片菜单 / 画布菜单 |
Ctrl+C / Ctrl+X / Ctrl+V | 复制 / 剪切 / 粘贴选中的图片（内置剪贴板） |
F | 聚焦选中节点（多选时铺满整组包围盒） |
Delete / Backspace | 删除选中节点 |
Ctrl+Z / Ctrl+Y | 撤销 / 重做 |
Esc | 依次收：右键菜单 → 分组浮层 → ⋯ 菜单 → 取消选择 / 回到选择工具 |
dsh-resource://file/session/...）；absolute scope 没有会话，不会被接管。node tools/build-client.mjs # 改完 lib/client.body.js 必须跑这个（带语法闸门）
node tools/build-client.mjs --check # 只核对产物是否最新
node tools/selftest.mjs # 客户端半边：jsdom + 真 React 渲染，202 项断言
node tools/selftest-host.mjs # 宿主半边：路由 / 探活 / 原子写 / 容错，15 项断言
node tools/selftest-comfy.mjs # 真实 ComfyUI 端到端：文生图 → 图生图 → 局部重绘（需 ComfyUI 在跑）
node tools/probe-comfy.mjs # 只读探测：ComfyUI 版本/设备/节点/可用模型
node tools/preview.mjs # 视觉预览：jsdom 渲染 → 静态 HTML → 本机 Chromium 截图（12 个状态）
node tools/restore-body.mjs # 意外改坏 client.body.js 时，从 lib/client.js 反解恢复
tools/preview.mjs / tools/selftest.mjs 需要 jsdom 与 react/react-dom，可用
DSH_IMAGE_CANVAS_JSDOM_ROOT / DSH_IMAGE_CANVAS_REACT_ROOT 指向包含它们的工程目录（默认指向作者的开发布局）。--out 目录的 img/ 下（任意 png），截图落到同一目录。lib/client.body.js，lib/client.js 是生成物（HMR 也只看它）。require / module.exports），只能 require 平台模块表里的包（本插件只用了 react）。lib/index.js）改动必须完整重启桌面版才生效；浏览器半边改完约 1 秒自动热更。Get-Content/Set-Content 改这些无 BOM 的 UTF-8 中文文件（会按 GBK 解释并丢字）。插件管理器里移除即可；如有残留，删除 $DSH_HOME/storages/dsh-image-canvas（画布快照）与浏览器里的 dsh-image-canvas:* localStorage 键。
见 CHANGELOG.md。
MIT © 2026 Link-h1j