@anionex/dsh-vision-toolkit 0.1.34 → 0.1.35

package/README.md

@@ -53,6 +53,22 @@ dsh plugin --profile web add @anionex/dsh-vision-toolkit
 
 **Upstream toolkit:** [Anionex/agent-vision-toolkit](https://github.com/Anionex/agent-vision-toolkit) · **Project website:** [agent-vision.anionex.me](https://agent-vision.anionex.me)
 
+## ❤️ Sponsor
+
+> Want to sponsor this project? See [FUNDING.md](FUNDING.md) or email davidyang042@gmail.com.
+
+<details open>
+<summary>Click to collapse</summary>
+
+<table>
+<tr>
+<td width="220"><a href="https://aihubmix.com/?aff=5wj6sgx8"><img src="assets/logo_aihubmix.png" alt="AIHubMix" height="48"></a></td>
+<td>Thanks to <a href="https://aihubmix.com/?aff=5wj6sgx8">AIHubMix</a> for sponsoring this project! AIHubMix is a stable, high-concurrency AI model API gateway that connects Claude, GPT, Gemini, DeepSeek, and other mainstream models through a single API key, compatible with multiple protocols, with <b>free model options</b> available. Users in China can use it via the <a href="https://inferera.com/?aff=5wj6sgx8">China entry</a>, and users abroad via the <a href="https://aihubmix.com/?aff=5wj6sgx8">Global entry</a>.</td>
+</tr>
+</table>
+
+</details>
+
 **Contents**
 
 - [Highlights](#highlights)
@@ -63,6 +79,7 @@ dsh plugin --profile web add @anionex/dsh-vision-toolkit
 - [Toolbox](#toolbox)
 - [Configuration and limits](#configuration-and-limits)
 - [Troubleshooting](#troubleshooting)
+- [Donation](#donation)
 - [Development and community](#development-and-community)
 
 ## Recent updates
@@ -147,6 +164,16 @@ You can install it into a Headless Profile too:
 dsh plugin --profile headless add @anionex/dsh-vision-toolkit
 ```
 
+Using DSH Desktop? It bundles its own `dsh` CLI and intentionally does not add it to your system PATH. Open **DSH Terminal** from the tray and run the command there, targeting the Desktop profile:
+
+```sh
+dsh plugin --profile desktop add @anionex/dsh-vision-toolkit
+```
+
+Then restart DSH Desktop. The built-in plugin marketplace in DSH Desktop 2.0.1 has known installation issues; the terminal command above is the reliable path until a fixed Desktop release is available.
+
+For the full Desktop install, update, and troubleshooting walkthrough, see [Installing and updating in DSH Desktop](docs/dsh-desktop-install.md).
+
 ### 2. Restart and check it
 
 Restart a running Web Profile, then open **Settings → Vision Toolkit**. The free provider is already configured; run **Test vision model** to confirm it is reachable.
@@ -291,6 +318,7 @@ For advanced setups — overriding `runtime.python`, using `runtime.mode: extern
 | A custom Credential is missing | Enter the API key in **Settings → Vision Toolkit** and confirm the Credential name matches the provider configuration |
 | First-time runtime setup fails | The standalone-Python download needs network and disk access. Check connectivity or package-cache access, or install Python 3.11+ / configure `runtime.python` in Settings, then retry the model test |
 | Chrome is not found | Install Chrome, Chromium, or Edge. Only HTML screenshot rendering is unavailable; the other tools still work |
+| DSH Desktop says `dsh` is not recognized, or its built-in marketplace install fails | Open **DSH Terminal** from the tray, run `dsh plugin --profile desktop add @anionex/dsh-vision-toolkit`, then restart DSH Desktop. The Desktop 2.0.1 marketplace has known install issues, so the terminal command is the reliable path for now |
 | An artifact cannot be previewed | Use **Open file** or the workspace path in the result. Preview URLs exist only while the Web route is available |
 
 ## FAQ
@@ -299,6 +327,12 @@ For advanced setups — overriding `runtime.python`, using `runtime.mode: extern
 
 No. Each inspection sends only the necessary intent and the image to the multimodal model, and context does not accumulate across calls, so the added cost stays small. To reduce it further, a locally deployed small multimodal side model (for example the Gemma 4 or Qwen 3.5/3.6 series) can provide the vision capability.
 
+## Donation
+
+If this project is valuable to you, you are welcome to buy the developer a coffee ☕️
+
+<img width="240" alt="WeChat reward code" src="assets/wechat-reward.png" />
+
 ## Development and community
 
 - Read [CONTRIBUTING.md](CONTRIBUTING.md) before contributing.

package/README.zh.md

@@ -52,6 +52,22 @@ dsh plugin --profile web add @anionex/dsh-vision-toolkit
 
 **上游工具箱：** [Anionex/agent-vision-toolkit](https://github.com/Anionex/agent-vision-toolkit) · **项目网站：** [agent-vision.anionex.me](https://agent-vision.anionex.me)
 
+## ❤️ 赞助
+
+> 想赞助本项目？详见 [FUNDING.md](FUNDING.md) 或发送邮件到 davidyang042@gmail.com。
+
+<details open>
+<summary>点击折叠</summary>
+
+<table>
+<tr>
+<td width="220"><a href="https://aihubmix.com/?aff=5wj6sgx8"><img src="assets/logo_aihubmix.png" alt="AIHubMix" height="48"></a></td>
+<td>感谢 <a href="https://aihubmix.com/?aff=5wj6sgx8">AIHubMix</a> 赞助本项目！AIHubMix 是稳定、高并发的 AI 大模型 API 聚合平台，一个 API Key 即可接入 Claude、GPT、Gemini、DeepSeek 等主流模型，兼容多种协议，并提供<b>免费模型选择</b>。国内用户请通过<a href="https://inferera.com/?aff=5wj6sgx8">国内入口</a>使用，海外用户请通过<a href="https://aihubmix.com/?aff=5wj6sgx8">海外入口</a>使用。</td>
+</tr>
+</table>
+
+</details>
+
 **目录**
 
 - [亮点](#亮点)
@@ -62,6 +78,7 @@ dsh plugin --profile web add @anionex/dsh-vision-toolkit
 - [工具一览](#工具一览)
 - [配置与限制](#配置与限制)
 - [常见问题](#常见问题)
+- [赞赏](#赞赏)
 - [开发与社区](#开发与社区)
 
 ## 最近更新
@@ -147,6 +164,16 @@ Headless Profile 也可以安装：
 dsh plugin --profile headless add @anionex/dsh-vision-toolkit
 ```
 
+使用 **DSH Desktop 桌面版**？桌面版自带 `dsh` 命令行，但有意不写入系统 PATH，请不要在系统终端里执行上面的命令。请从托盘打开 **DSH 终端（Open DSH Terminal）**，在桌面版自己的终端中安装到 Desktop Profile：
+
+```sh
+dsh plugin --profile desktop add @anionex/dsh-vision-toolkit
+```
+
+安装完成后重启 DSH Desktop。DSH Desktop 2.0.1 内置插件市场的“一键安装”存在已知问题，修复前请优先使用上面的终端命令安装。
+
+完整的桌面版安装、更新与排查步骤见 [DSH Desktop 安装与更新指南](docs/dsh-desktop-install.zh.md)。
+
 ### 2. 重启并确认
 
 重启正在运行的 Web Profile，打开 **设置 → 视觉工具**。默认免费服务已经配置好；你可以直接运行**测试视觉模型**确认连接。
@@ -289,6 +316,7 @@ API Key:  https://agent-vision.anionex.me（自动填写）
 | 自定义 Credential 缺失 | 在 **设置 → 视觉工具** 填写 API Key，并确认 Credential 名称与配置一致 |
 | 首次运行时准备失败 | 自动下载托管 Python 需要网络和磁盘权限；失败时检查网络或包缓存，也可以安装 Python 3.11+ 或在 Settings 中配置 `runtime.python`，然后重新测试 |
 | 找不到 Chrome | 安装 Chrome、Chromium 或 Edge；只有 HTML 截图不可用，其他工具不受影响 |
+| DSH Desktop 提示找不到 `dsh` 命令，或内置插件市场安装失败 | 从托盘打开 **DSH 终端**，运行 `dsh plugin --profile desktop add @anionex/dsh-vision-toolkit`，再重启 DSH Desktop。桌面版 2.0.1 的内置市场存在已知安装问题，当前请优先使用终端安装 |
 | 产物无法预览 | 使用“打开文件”或结果中的工作区路径；预览 URL 只在 Web 路由可用时存在 |
 
 ## FAQ
@@ -297,6 +325,12 @@ API Key:  https://agent-vision.anionex.me（自动填写）
 
 不会。每次检查只把必要的意图和图片发给多模态模型，调用之间不会累积上下文，因此额外成本很小。想进一步降低成本，可以用本地部署的小型多模态侧模型（例如 Gemma 4 或 Qwen 3.5/3.6 系列）提供视觉能力。
 
+## 赞赏
+
+如果本项目对你有价值，欢迎请开发者喝杯咖啡☕️
+
+<img width="240" alt="微信收款码" src="assets/wechat-reward.png" />
+
 ## 开发与社区
 
 - 贡献前请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。

package/assets/skill/UPSTREAM.json

@@ -3,7 +3,7 @@
   "repository": "https://github.com/Anionex/agent-vision-toolkit",
   "commit": "77c24ad5b5d7a123119862893129f939307f1d3f",
   "patch": "patches/vision-tools-dsh.patch",
-  "patchSha256": "ebbd49035945f094be9a582c5095d3e1689879d2501a7c82d0ca4517e38abf1b",
+  "patchSha256": "29f596fc36b476ecfe9b138ec4778f10c81fcfb550beb340cb3fc472f8cdb05f",
   "sourceFiles": [
     {
       "path": "SKILL.md",
@@ -64,8 +64,8 @@
     },
     {
       "path": "references/restore-ui.md",
-      "bytes": 10197,
-      "sha256": "8cd479a195c526098733ac518cb9928ffdafdbb3ad93e08864efe4fd7bd312b3"
+      "bytes": 10341,
+      "sha256": "447068bbc967497f02a409b091267afd1277980bfd50b859131976b7a09e1d81"
     }
   ]
 }

package/assets/skill/references/restore-ui.md

@@ -10,9 +10,11 @@ structured diagram, read `restore-structure.md`.
 ## Choose the restore mode
 
 - Use **fast restore mode** when the user asks for a quick, rough,
-  approximate, prototype, or first-pass reconstruction, or explicitly values
-  speed over fidelity. Its target is a recognizable screenshot in about three
-  minutes when the project already runs.
+  approximate, prototype, or first-pass reconstruction, explicitly values
+  speed over fidelity, or the reference image itself shows a floating
+  speed-intent control such as "快速还原为 HTML" / "快速生成" / "quick
+  restore" overlay. Its target is a recognizable screenshot in about
+  three minutes when the project already runs.
 - Use the **standard restore workflow** below when the user asks for close,
   precise, pixel-level, or production-ready alignment, or does not opt into a
   faster approximation.

package/docs/dsh-desktop-install.md

@@ -0,0 +1,67 @@
+# Installing and Updating dsh-vision-toolkit in DSH Desktop
+
+This guide explains how to install, verify, and update `dsh-vision-toolkit` in **DSH Desktop**.
+
+> Why a separate guide? DSH Desktop bundles its own `dsh` CLI but intentionally does **not** add it to the system PATH. Running `dsh` in a system shell (PowerShell, cmd, or the macOS Terminal) reports "command not found" by design — this is not a plugin issue. Always use the **DSH Terminal** opened from the desktop tray.
+
+## 1. Open the DSH Terminal
+
+1. Find the **DSH Desktop** icon in the system tray (bottom-right on Windows, top-right menu bar on macOS).
+2. **Right-click** the icon and choose **Open DSH Terminal**.
+3. Verify the environment in the opened terminal:
+
+```sh
+dsh --version
+```
+
+If the version prints, the terminal environment is ready. If the command is not found, make sure the app is v2.0+ and try fully quitting and relaunching DSH Desktop first.
+
+## 2. Install the plugin
+
+Run the following command in the **DSH Terminal**:
+
+```sh
+dsh plugin --profile desktop add @anionex/dsh-vision-toolkit@0.1.34
+```
+
+Notes:
+
+- `--profile desktop` targets the default `desktop` profile; replace `desktop` with `web` to install into a `web` profile.
+- **Pin an exact version** (currently `0.1.34`). The DSH 1024Store marketplace catalog lags behind npm, so a one-click marketplace install can land on an older version; an explicit version guarantees the latest release.
+- If the active profile is already the target profile, you can omit `--profile desktop` and run `dsh plugin add @anionex/dsh-vision-toolkit@0.1.34` directly.
+
+## 3. Restart and verify
+
+1. **Fully quit DSH Desktop**: right-click the tray icon → **Quit** (closing the window only hides it).
+2. Reopen DSH Desktop.
+3. Open **Settings → Vision Toolkit** and click **Test vision model** to confirm the built-in free vision service works.
+4. Paste an image into the conversation and ask directly, or invoke `/vision-skills` for the full vision workflow.
+
+## 4. Update to a new version
+
+1. Check the latest version on the [npm page](https://www.npmjs.com/package/@anionex/dsh-vision-toolkit).
+2. In the **DSH Terminal**, rerun the install command with the new version:
+
+```sh
+dsh plugin --profile desktop add @anionex/dsh-vision-toolkit@<new-version>
+```
+
+3. **Fully quit and reopen DSH Desktop** so the new version takes effect.
+
+If you installed without pinning an exact version, the official `dsh plugin update` command also works; with a pinned version such as `@0.1.34`, use the explicit-version command above.
+
+## Troubleshooting
+
+| Problem | What to do |
+| --- | --- |
+| `dsh` is not recognized in a system shell | Expected. Open **DSH Terminal** from the tray instead of using system PowerShell/cmd/Terminal |
+| No Open DSH Terminal in the tray menu | Make sure the app is v2.0+; this entry exists only in v2 and later |
+| The built-in marketplace fails with "cannot confirm the operation result" | DSH Desktop 2.0.1 has known marketplace install issues; use the DSH Terminal command in this guide instead |
+| Plugin does not show up after install | Confirm the command targeted the right profile and **fully quit and restart** DSH Desktop |
+| Want to install into the web profile | Replace `desktop` with `web` in the command, then restart DSH Desktop and switch to the web profile |
+
+## Links
+
+- [Project website](https://agent-vision.anionex.me)
+- [npm package](https://www.npmjs.com/package/@anionex/dsh-vision-toolkit)
+- [DSH Desktop user guide](https://github.com/anywhere-labs/deepseek-harness-desktop/blob/master/docs/user-guide.en.md)

package/docs/dsh-desktop-install.zh.md

@@ -0,0 +1,67 @@
+# DSH Desktop 安装与更新指南
+
+本指南说明如何在 **DSH Desktop（桌面版）** 中安装、验证和更新 `dsh-vision-toolkit`。
+
+> 为什么需要单独一份指南？DSH Desktop 自带 `dsh` 命令行，但**不会写入系统 PATH**。在系统终端（PowerShell、cmd、macOS 终端）里运行 `dsh` 会提示找不到命令，这是桌面版的设计行为，不是插件问题。请始终使用桌面版托盘提供的 **DSH 终端**。
+
+## 1. 打开 DSH 终端
+
+1. 找到系统托盘中的 **DSH Desktop** 图标（Windows 在右下角，macOS 在右上角菜单栏）。
+2. **右键**图标，选择 **Open DSH Terminal**（或 **打开 DSH 终端**）。
+3. 打开的终端里先确认环境可用：
+
+```sh
+dsh --version
+```
+
+能看到版本号就说明终端环境正常。如果提示找不到命令，请确认应用版本是 v2.0+，并完全退出桌面版后重新打开再试。
+
+## 2. 安装插件
+
+在 **DSH 终端** 中运行以下命令：
+
+```sh
+dsh plugin --profile desktop add @anionex/dsh-vision-toolkit@0.1.34
+```
+
+几点说明：
+
+- `--profile desktop` 表示安装到桌面版默认的 `desktop` Profile；想装到 `web` Profile 时把 `desktop` 换成 `web`。
+- **建议带精确版本号**（当前为 `0.1.34`）。DSH 1024Store 插件市场的目录数据有滞后，市场里一键安装可能装到旧版本；显式写版本号能确保装到最新版。
+- 如果当前激活的 Profile 就是要装的 Profile，也可以省略 `--profile desktop`，直接运行 `dsh plugin add @anionex/dsh-vision-toolkit@0.1.34`。
+
+## 3. 重启并验证
+
+1. **完全退出 DSH Desktop**：托盘右键 → **退出**（关闭窗口只是隐藏，不算退出）。
+2. 重新打开 DSH Desktop。
+3. 进入 **设置 → 视觉工具**，点击 **测试视觉模型**，确认默认免费视觉服务可用。
+4. 在会话中**粘贴一张图片直接提问**，或调用 `/vision-skills` 使用完整视觉工作流。
+
+## 4. 更新到新版本
+
+1. 在 [npm 页面](https://www.npmjs.com/package/@anionex/dsh-vision-toolkit) 查看最新版本号。
+2. 在 **DSH 终端** 中，把安装命令里的版本号换成新版本后重新执行：
+
+```sh
+dsh plugin --profile desktop add @anionex/dsh-vision-toolkit@<新版本号>
+```
+
+3. 再次**完全退出并重启 DSH Desktop**，新版本才会生效。
+
+如果当初安装时没有锁定精确版本，也可以使用官方更新命令 `dsh plugin update`，但精确版本安装（`@0.1.34` 这种写法）下请使用上面的显式版本号方式升级。
+
+## 常见问题
+
+| 问题 | 处理方式 |
+| --- | --- |
+| 系统终端里找不到 `dsh` 命令 | 正常。请从托盘打开 **DSH 终端**，不要用系统 PowerShell/cmd/终端 |
+| 托盘菜单里没有 Open DSH Terminal | 确认应用是 v2.0+ 版本；v2 才开始提供该入口 |
+| 内置插件市场安装失败，提示“无法确认操作结果” | DSH Desktop 2.0.1 的市场安装链路有已知问题，请改用本文的 DSH 终端命令安装 |
+| 装完插件没生效 | 确认命令装到了正确的 Profile，并**完全退出后重启**桌面版 |
+| 想装到 web Profile | 把命令中的 `desktop` 换成 `web`，重启桌面版后到 web Profile 使用 |
+
+## 相关链接
+
+- [项目主页](https://agent-vision.anionex.me)
+- [npm 包](https://www.npmjs.com/package/@anionex/dsh-vision-toolkit)
+- [DSH Desktop 用户指南](https://github.com/anywhere-labs/deepseek-harness-desktop/blob/master/docs/user-guide.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anionex/dsh-vision-toolkit",
-  "version": "0.1.34",
+  "version": "0.1.35",
   "description": "DeepSeek Harness-native integration for agent-vision-toolkit: image Q&A, OCR, grounding, UI restoration, pixel diff, Artifacts, and Web UI.",
   "keywords": [
     "deepseek",

package/patches/vision-tools-dsh.patch

@@ -803,10 +803,33 @@ index 3261fcf..68025be 100644
     nodes, labels, groups, edges, directions, and edge labels.
  6. Generate the Mermaid, Graphviz, or requested structure from that inventory.
 diff --git a/references/restore-ui.md b/references/restore-ui.md
-index f9ec11a..69627895161fc1b57c6241665255fdf86ae1c1e5 100644
+index f9ec11a..bfc63c0e4eacbd3a5eaf9453ec542d3b5380875a 100644
 --- a/references/restore-ui.md
 +++ b/references/restore-ui.md
-@@ -28,17 +28,18 @@
+@@ -10,11 +10,13 @@
+ ## Choose the restore mode
+-
+-- Use **fast restore mode** when the user asks for a quick, rough,
+-  approximate, prototype, or first-pass reconstruction, or explicitly values
+-  speed over fidelity. Its target is a recognizable screenshot in about three
+-  minutes when the project already runs.
+-- Use the **standard restore workflow** below when the user asks for close,
+-  precise, pixel-level, or production-ready alignment, or does not opt into a
+-  faster approximation.
+-
++
++- Use **fast restore mode** when the user asks for a quick, rough,
++  approximate, prototype, or first-pass reconstruction, explicitly values
++  speed over fidelity, or the reference image itself shows a floating
++  speed-intent control such as "快速还原为 HTML" / "快速生成" / "quick
++  restore" overlay. Its target is a recognizable screenshot in about
++  three minutes when the project already runs.
++- Use the **standard restore workflow** below when the user asks for close,
++  precise, pixel-level, or production-ready alignment, or does not opt into a
++  faster approximation.
++
+ ## Fast restore mode: first screenshot in about three minutes
+@@ -28,17 +30,18 @@
  1. Inspect the existing frontend stack, component library, icon set, source
     assets, and design tokens before writing code, but stop searching as soon as
     a usable local primitive is found.
@@ -833,7 +856,7 @@ index f9ec11a..69627895161fc1b57c6241665255fdf86ae1c1e5 100644
  
  ### Build the approximation
  
-@@ -47,8 +48,9 @@
+@@ -47,8 +50,9 @@
     when zoomed in.
  2. Reuse the project's existing components and CSS tokens. If its frontend or
     icon library contains a reasonably similar component or icon, use it
@@ -845,7 +868,7 @@ index f9ec11a..69627895161fc1b57c6241665255fdf86ae1c1e5 100644
  3. Use nearby existing palette tokens or visually similar CSS values. Exact
     sampled hex values, gradients, subtle borders, and shadow opacity are out of
     scope unless one of them defines the whole composition.
-@@ -57,7 +59,7 @@
+@@ -57,7 +61,7 @@
  
  ### Render once, fix once, deliver
  
@@ -854,7 +877,7 @@ index f9ec11a..69627895161fc1b57c6241665255fdf86ae1c1e5 100644
     existing browser setup.
  2. Inspect the screenshot once. If there is an obvious structural failure such
     as a missing major region, broken wrapping, or a wildly wrong scale, make
-@@ -66,7 +68,7 @@
+@@ -66,7 +70,7 @@
     small color, icon, font, shadow, radius, or spacing differences.
  
  A practical time box is roughly 30 seconds for project inspection plus
@@ -863,7 +886,7 @@ index f9ec11a..69627895161fc1b57c6241665255fdf86ae1c1e5 100644
  rendering, one correction, and screenshot delivery. Dependency installation or
  a project that does not already run may extend that target; do not compensate
  by silently switching back to a long precision loop.
-@@ -112,18 +114,19 @@
+@@ -112,18 +116,19 @@
  ### 2. Establish the coordinate system
  
  Record the reference image dimensions and the target viewport. Screenshots may
@@ -891,7 +914,7 @@ index f9ec11a..69627895161fc1b57c6241665255fdf86ae1c1e5 100644
  
  Treat model boxes as approximate handles. Use them to organize the page, but
  do not mistake their final few pixels for measured boundaries.
-@@ -141,15 +144,11 @@
+@@ -141,15 +146,11 @@
  extraction, tighten the final region to the visual's own ink; adjacent text or
  rules inside the region can become foreground components too.
  
@@ -912,7 +935,7 @@ index f9ec11a..69627895161fc1b57c6241665255fdf86ae1c1e5 100644
  ```
  
  Inspect the transparent result before use. Confirm that the whole visual is
-@@ -162,8 +161,8 @@
+@@ -162,8 +163,8 @@
  - Follow the project's existing framework and component patterns.
  - Build content, interaction, responsive layout, borders, shadows, and simple
    shapes natively.
@@ -923,7 +946,7 @@ index f9ec11a..69627895161fc1b57c6241665255fdf86ae1c1e5 100644
  - Place extracted assets with explicit logical dimensions. Preserve their
    aspect ratio and avoid baking surrounding whitespace into the asset.
  - Match structure and proportions before tuning small spacing.
-@@ -172,10 +171,10 @@
+@@ -172,10 +173,10 @@
  
  For an existing implementation, start here.
  
@@ -936,7 +959,7 @@ index f9ec11a..69627895161fc1b57c6241665255fdf86ae1c1e5 100644
     spot or explain.
  3. Fix material discrepancies: missing or wrong content, incorrect hierarchy,
     broken wrapping, visibly wrong alignment or scale, wrong component state,
-@@ -185,7 +184,7 @@
+@@ -185,7 +186,7 @@
     rasterization, antialiasing, subpixel placement, or another imperceptible
     rendering detail.