前言¶
在 DeepSeek Harness（DSH）里改本地 HTML、图片或文档预览，常见做法是截图或口述「改左上角那块」。截图会丢像素、难对齐原文件；纯文字又说不清具体元素。社区插件 dsh-region-edit（维护者 a961282799-crypto）面向桌面客户端：在右侧预览中点选网页元素，或自由圈选图片与文字，写下修改要求后发给当前会话，不截图、不录屏；图片修改请求直接使用原文件。v0.5.x 起对本地 HTML 还提供修改记录、前后静态预览与一键回滚。
这是什么¶
dsh-region-edit 是 DeepSeek Harness 的桌面插件（npm 包名 dsh-region-edit，当前资料中的工作区版本为 v0.5.1）。它复用宿主界面，通过公开的 slots、documentPreviews、sessions 等接口工作，没有独立服务或第二套模型 API；视觉识别走当前会话已选模型与现有登录，无需另配密钥。
分类上属于 客户端 插件；在 SkillHub 目录页 与 GitHub 仓库 均可查看来源与发布物（资料中 GitHub 星标为 6）。
核心功能¶
本地 HTML：点选修改与源码上下文¶
在 HTML 预览方式中选择 圈选预览，再点 点选修改。鼠标悬停显示边框，点击锁定元素；可用 选择外层 / 返回内层 调整范围。填写要求后发送，或先 放入输入框。
定位信息默认折叠，展开后可查看原始 HTML 行列、class 和关键样式。请求会带上 class、关键样式、CSS 变量和父布局，优先复用现有样式。v0.4.0 起保留悬停高亮、外层/内层切换、源码片段等能力；开发服务器、React/Vue 源码映射及自动多视口检查在 README 中标注为后续阶段。
图片与其他预览：自由圈选与视觉识别¶
在文件预览工具栏点击 圈选修改，沿目标画出任意轮廓，松开后自动闭合（不必画矩形）。图片交给当前会话的视觉模型读取原图，填入圈中对象名称；可纠正名称或 停止识别，手动指定，再写修改要求，发送修改（或 Ctrl+Enter）或 放入输入框。
文字、Markdown、代码及带可读文字层的预览可直接按轮廓定位文字和元素。PNG、JPEG、WebP、GIF 识别与发送时使用原图，不生成裁剪图或标记图。
v0.5.0 起：修改记录、对比与回滚（本地 HTML）¶
发送或放入输入框前保存原内容；要求进入当前会话对应轮次后开始跟踪，轮次结束自动保存结果。工具栏 修改记录 可查看左右静态预览、受影响文件列表，以及按行 diff（删增着色、未改动折叠）。回滚本次修改 在核对后通过宿主写回已备份的 UTF-8 文字文件；若文件在本轮结束后又被编辑，会报冲突并停止；v0.5.1 起已结束记录保存在本机（Windows 为 %APPDATA%\dsh-region-edit\history），重启 Harness 仍可查看与回滚。
对比为冻结内容的静态预览，不执行页面脚本；图片圈选流程不提供图片文件回滚。记录与容量限制见 README「第二阶段的范围」（例如最多 8 条记录、单侧文件与体积预算等）。
安装与启用¶
已适配的桌面版本在 README 中写明为 DeepSeek Harness 0.2.1-rc.3 / Windows（与插件 v0.5.1 对应）。安装包与 SHA-256 在 GitHub Releases，同版本也发布在 npm。
下面命令来自仓库 README，请将路径替换为本机下载的 .tgz 完整路径：
& 'D:\deepseek harness\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add '插件包的完整路径\dsh-region-edit-0.5.1.tgz'
安装后重新打开桌面客户端。无需改宿主程序、开调试端口或起独立服务。插件以当前 DSH 进程权限运行；安装前应自行查看源码、MIT 许可证 与发布包校验和。
自行构建时可在仓库内执行 npm run pack:plugin（需 Node.js 22.18+），安装包生成于 artifacts/dsh-region-edit-0.5.1.tgz。
典型用法¶
改本地网页某一块¶
- 打开本地 HTML，预览方式选 圈选预览，点 点选修改。
- 悬停并点击目标；必要时用外层/内层切换范围。
- 填写自然语言要求，发送或放入输入框。
- 轮次结束后打开 修改记录 查看 diff；需要时用 回滚本次修改（注意 README 中的冲突与覆盖范围说明）。
改图片中的区域¶
- 在当前会话右侧打开图片预览，点 圈选修改。
- 沿目标自由画圈，确认或纠正识别出的目标名称。
- 发送修改 或 放入输入框；Harness 预览监听会在文件变更后重新载入。
Esc 取消圈选；发送失败时保留输入便于重试。调整窗口或预览大小后旧选区失效，已写的修改要求会保留，重新圈选即可。
适用场景与注意¶
适合： 在 DSH 桌面端里，基于本地预览精确指向 DOM 或图片区域，把结构化上下文（源码位置、样式、原图与轮廓）一并交给当前会话的编辑工具；本地 HTML 迭代后需要可回滚的修改记录。
限制（均来自 README）： 圈选预览只加载本地文件及受限关联资源，不访问网络；依赖 CDN、远程接口或复杂动态页面的场景应继续用宿主原有预览。无文字层的 PDF、Canvas、外部网站标签等暂不支持。点选使用临时元素标识，节点被替换后需重选。独立 Web 客户端（无桌面桥接）不启用本插件。
DeepSeek Harness 社区插件目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；安装第三方插件前请核对维护者与仓库内容。
结尾¶
dsh-region-edit 把「指哪改哪」落在桌面预览里：HTML 点选带源码与样式上下文，图片自由圈选带原图与轮廓，本地 HTML 还可对比与回滚。进一步了解能力与版本说明见 GitHub README 与 目录页。
