dsh-mermaid-smooth 0.2.1 → 0.2.3

package/README.md

@@ -2,10 +2,14 @@
 
 English | [中文](README.zh.md)
 
-Render mermaid code fences in DeepSeek Harness (dsh) web chat as diagrams by
-default, with smooth zoom and pan, a per-fence diagram/code toggle at each
-card's top-right, a persisted per-fence preference, dark-mode follow, and a
-fully bundled offline engine (zero CDN).
+Render mermaid code fences in DeepSeek Harness (DSH) Web chat and the DSH
+Desktop app as diagrams by default, with smooth zoom and pan, a per-fence
+diagram/code toggle at each card's top-right, a persisted per-fence
+preference, dark-mode follow, and a fully bundled offline engine (zero CDN).
+
+The Desktop app is an Electron shell around the complete DSH Web application,
+so it loads the same Web frontend and the same plugin bundle — one client
+build serves both, with no Desktop-specific code path.
 
 ## Supported diagram types
 
@@ -68,12 +72,12 @@ to screen readers via `aria-live="polite"`.
 
 ## Install
 
-dsh-mermaid-smooth is a plugin for the DeepSeek Harness (dsh) web UI. Before
-proceeding, make sure the dsh CLI and web environment are installed and set
-up.
+dsh-mermaid-smooth is a plugin for the DeepSeek Harness (DSH) Web UI and the
+DSH Desktop app. Before proceeding, make sure DSH is installed and set up.
 
-Four ways — pick one, then restart DSH Web (the current session ends, but DSH
-sessions are persisted on disk and can be resumed after restart).
+Six ways — pick one, then restart DSH Web or the Desktop app (the current
+session ends, but DSH sessions are persisted on disk and can be resumed after
+restart).
 
 **1. npm package (recommended, simplest)**
 
@@ -97,18 +101,34 @@ history page); later changes on `main` will not silently alter installed code.
 The source is installed and built at install time (`prepare` runs the esbuild
 bundle), so git and Node.js ≥ 20 are required.
 
+pnpm ≥ 10 blocks that `prepare` build for git-hosted packages until you
+allowlist it: the first install fails with `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`
+and prints the exact key to add. Copy that key verbatim (it embeds the
+codeload URL with the full commit sha — a bare package name does not match)
+under `allowBuilds` in the profile's `pnpm-workspace.yaml`, then re-run:
+
+```yaml
+allowBuilds:
+  dsh-mermaid-smooth@https://codeload.github.com/gitByteFree/dsh-mermaid-smooth/tar.gz/<full-commit-sha>: true
+```
+
+This is the same trust decision as any build-time script: only allowlist
+packages whose source you have reviewed. If you would rather not run
+build-time code at all, use methods 1 or 3, which ship the prebuilt bundle
+and need no `allowBuilds` entry.
+
 **3. From a release tarball (offline / where git is inconvenient)**
 
-Download `dsh-mermaid-smooth-0.2.0.tgz` from this repo's
+Download `dsh-mermaid-smooth-0.2.1.tgz` from this repo's
 [Releases](https://github.com/gitByteFree/dsh-mermaid-smooth/releases) (it
 contains the prebuilt `lib/client.js`, so no `prepare` script runs at install
 time), then run from the directory you downloaded it to:
 
 ```sh
-dsh plugin --profile web add ./dsh-mermaid-smooth-0.2.0.tgz
+dsh plugin --profile web add ./dsh-mermaid-smooth-0.2.1.tgz
 ```
 
-`0.2.0` above is a real filename, not a placeholder — match the version you
+`0.2.1` above is a real filename, not a placeholder — match the version you
 downloaded and drop any `<...>` brackets (zsh reads a bare `<...>` as input
 redirection and fails with "no such file or directory"). Keep the `./`
 prefix: `dsh plugin add` anchors `./`-relative paths to your current
@@ -122,8 +142,52 @@ cd dsh-mermaid-smooth
 dsh plugin --profile web add .
 ```
 
-Restart the web app (`dsh web`, or your `dsh-web` service) so the new bundle
-layer is composed.
+**5. From the DSH plugin market (Discover)**
+
+This repo publishes its own market index, so the plugin can be installed from
+**Discover** without typing a package name:
+
+```text
+https://cdn.jsdelivr.net/gh/gitByteFree/dsh-mermaid-smooth@main/market/index.json
+```
+
+Open **Plugins** in the sidebar, switch on **Custom plugin markets** under
+**Experimental plugins** if it is off, then in **Discover** add the index URL
+above as a source and install **Mermaid Smooth**. The same index works in the
+Desktop app.
+
+jsDelivr serves the index because Discover needs a direct `200` without
+redirects; a release can take up to 12 hours to appear there. To pick up a
+fresh release immediately, pin an immutable commit (`@<commit>` instead of
+`@main`) or use
+`https://raw.githubusercontent.com/gitByteFree/dsh-mermaid-smooth/main/market/index.json`.
+
+**6. DSH Desktop app (Electron)**
+
+The Desktop app bundles the complete DSH Web application, so this plugin needs
+no separate Desktop build. Desktop exclusively owns the `desktop` profile, and
+only the CLI bundled with the app can manage it — an npm-installed `dsh`
+refuses it with
+`profile "desktop" is managed exclusively by the Electron application`.
+
+1. Launch the Desktop app once so it initializes `$DSH_HOME/profiles/desktop`,
+   then quit it completely.
+2. Install the app's command from the menu (**Manage dsh Command… →
+   Install**) and run:
+
+   ```sh
+   dsh plugin --profile desktop add dsh-mermaid-smooth
+   ```
+
+3. Reopen the app. You can also install from its **Plugins** page or from the
+   market index in method 5.
+
+Runtime behaviour is identical: diagrams, wheel zoom and drag, the per-fence
+switch, the persisted preference, theme follow, copy, SVG download, and
+fullscreen all run in the shared Web client.
+
+Restart the web app (`dsh web`, or your `dsh-web` service) or reopen the
+Desktop app so the new bundle layer is composed.
 
 ## License
 

package/README.zh.md

@@ -2,7 +2,9 @@
 
 [English](README.md) | 中文
 
-将 DeepSeek Harness（dsh）Web 对话中的 mermaid 代码围栏**默认渲染为图**：丝滑的缩放与拖拽，每张图右上角提供图/文案切换，偏好按围栏记忆，明暗主题跟随，渲染引擎完全本地打包（零 CDN）。
+将 DeepSeek Harness（DSH）**Web 与桌面版**对话中的 mermaid 代码围栏**默认渲染为图**：丝滑的缩放与拖拽，每张图右上角提供图/文案切换，偏好按围栏记忆，明暗主题跟随，渲染引擎完全本地打包（零 CDN）。
+
+桌面版是完整 DSH Web 应用的 Electron 外壳，加载的是同一份 Web 前端与同一份插件 bundle —— 一份客户端产物同时服务两端，没有桌面版专用的代码分支。
 
 ## 支持的图表类型
 
@@ -52,9 +54,9 @@
 
 ## 安装
 
-dsh-mermaid-smooth 是 DeepSeek Harness (dsh) Web 界面的插件。使用前请确保你已安装并配置好 dsh 命令行工具及 Web 环境。
+dsh-mermaid-smooth 是 DeepSeek Harness（DSH）Web 界面与桌面版的插件。使用前请确保你已安装并配置好 dsh。
 
-四种方式任选其一，装完重启 DSH Web 即生效（当前会话会中断，但 DSH 会话有磁盘持久化，重启后可以恢复）。
+六种方式任选其一，装完重启 DSH Web 或桌面版即生效（当前会话会中断，但 DSH 会话有磁盘持久化，重启后可以恢复）。
 
 **方式一：npm 正式包（推荐，最简单）**
 
@@ -72,15 +74,24 @@ dsh plugin --profile web add 'github:gitByteFree/dsh-mermaid-smooth#<40位commit
 
 固定到你想装的 commit（如仓库提交历史页显示的 main HEAD），之后 main 的新改动不会静默改变已安装代码。源码安装时会在本机构建（`prepare` 脚本执行 esbuild 打包），需要 git 与 Node.js ≥ 20。
 
+pnpm ≥ 10 默认拦截 git 来源包的 `prepare` 构建脚本：首次安装会报 `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`，并把需要加白名单的精确键名打印在报错里。把该键**原样**复制（内嵌 codeload URL 和完整 commit sha，只写短包名匹配不上）到 profile 的 `pnpm-workspace.yaml` 的 `allowBuilds` 下，再重新执行安装：
+
+```yaml
+allowBuilds:
+  dsh-mermaid-smooth@https://codeload.github.com/gitByteFree/dsh-mermaid-smooth/tar.gz/<40位commit>: true
+```
+
+这与任何构建期脚本是同一种信任决定：只对你审查过来源的包放行。如果不想在安装时执行构建代码，请用方式一或方式三 —— 它们内置预构建产物，无需任何 `allowBuilds` 条目。
+
 **方式三：从 Release tarball 安装（离线 / 不便走 git 的环境）**
 
-从本仓库 [Releases](https://github.com/gitByteFree/dsh-mermaid-smooth/releases) 下载 `dsh-mermaid-smooth-0.2.0.tgz`（内含构建好的 `lib/client.js`，安装时无需执行任何 prepare 脚本），进入下载目录后执行：
+从本仓库 [Releases](https://github.com/gitByteFree/dsh-mermaid-smooth/releases) 下载 `dsh-mermaid-smooth-0.2.1.tgz`（内含构建好的 `lib/client.js`，安装时无需执行任何 prepare 脚本），进入下载目录后执行：
 
 ```sh
-dsh plugin --profile web add ./dsh-mermaid-smooth-0.2.0.tgz
+dsh plugin --profile web add ./dsh-mermaid-smooth-0.2.1.tgz
 ```
 
-命令里的 `0.2.0` 是**真实文件名**，不是占位符 —— 请改成你实际下载的版本，并去掉一切 `<...>` 尖括号（zsh 会把裸的 `<...>` 当作输入重定向，报「没有那个文件或目录」）。保留 `./` 前缀：`dsh plugin add` 只把 `./`、`../` 开头的路径锚定到你当前所在目录，裸文件名会在 profile 目录里查找。
+命令里的 `0.2.1` 是**真实文件名**，不是占位符 —— 请改成你实际下载的版本，并去掉一切 `<...>` 尖括号（zsh 会把裸的 `<...>` 当作输入重定向，报「没有那个文件或目录」）。保留 `./` 前缀：`dsh plugin add` 只把 `./`、`../` 开头的路径锚定到你当前所在目录，裸文件名会在 profile 目录里查找。
 
 **方式四：克隆后从本地路径安装（开发迭代）**
 
@@ -90,7 +101,36 @@ cd dsh-mermaid-smooth
 dsh plugin --profile web add .
 ```
 
-安装后重启 web 应用（`dsh web` 或你的 `dsh-web` 服务），使新 bundle 层生效。
+**方式五：从 DSH 插件市场（Discover）安装**
+
+本仓库自带一份插件市场索引，因此可以在 **Discover** 里直接安装，无需手输包名：
+
+```text
+https://cdn.jsdelivr.net/gh/gitByteFree/dsh-mermaid-smooth@main/market/index.json
+```
+
+打开侧边栏 **Plugins**，若 **Experimental plugins** 下的 **Custom plugin markets** 未开启则先打开；随后在 **Discover** 中把上面的索引 URL 添加为来源，再安装 **Mermaid 丝滑图表**。桌面版同样可用这份索引。
+
+索引走 jsDelivr 分发，因为 Discover 要求直接返回 `200` 且不重定向；新版本可能需要最多 12 小时才会出现在上面。想立刻拿到刚发布的版本，可以把索引 URL 钉到不可变 commit（用 `@<commit>` 代替 `@main`），或改用
+`https://raw.githubusercontent.com/gitByteFree/dsh-mermaid-smooth/main/market/index.json`。
+
+**方式六：从 DSH 桌面版（Electron）安装**
+
+桌面版内置了完整的 DSH Web 应用，因此本插件无需单独的桌面版构建。`desktop` profile 由桌面版独占，只有桌面版自带的 CLI 能管理它 —— npm 全局安装的 `dsh` 会直接拒绝：
+`profile "desktop" is managed exclusively by the Electron application`。
+
+1. 先启动一次桌面版，让它初始化 `$DSH_HOME/profiles/desktop`，然后**完全退出**应用。
+2. 从应用菜单 **Manage dsh Command… → Install** 安装 CLI，然后执行：
+
+   ```sh
+   dsh plugin --profile desktop add dsh-mermaid-smooth
+   ```
+
+3. 重新打开桌面版即可。也可以通过应用内 **Plugins** 页或方式五的市场索引安装。
+
+两端运行时行为一致：成图、滚轮缩放与拖拽、按围栏切换、偏好记忆、主题跟随、复制、SVG 下载、全屏都跑在同一份 Web 客户端里。
+
+安装后重启 web 应用（`dsh web` 或你的 `dsh-web` 服务）或重新打开桌面版，使新 bundle 层生效。
 
 ## 许可
 

package/icon.svg

@@ -0,0 +1,17 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" width="64" height="64" role="img" aria-label="Mermaid Smooth">
+  <rect x="1" y="1" width="62" height="62" rx="14" fill="#111827"/>
+  <g fill="none" stroke="#5eead4" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round">
+    <path d="M32 20 L32 28"/>
+    <path d="M32 28 L18 28 L18 36"/>
+    <path d="M32 28 L46 28 L46 36"/>
+  </g>
+  <g fill="#1f2937" stroke="#f472b6" stroke-width="2.5">
+    <rect x="21" y="8" width="22" height="12" rx="4"/>
+    <rect x="9" y="36" width="18" height="12" rx="4"/>
+    <rect x="37" y="36" width="18" height="12" rx="4"/>
+  </g>
+  <g stroke="#5eead4" stroke-width="2" stroke-linecap="round">
+    <path d="M14 42 L22 42"/>
+    <path d="M42 42 L50 42"/>
+  </g>
+</svg>

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Mermaid Smooth",
+    "description": "Mermaid fences in DSH Web and Desktop chat render as diagrams by default: smooth zoom and pan, a per-fence diagram/code switch, dark-mode follow, and a fully bundled offline engine."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Mermaid 丝滑图表",
+    "description": "DSH Web 与桌面版对话里的 mermaid 围栏默认成图：丝滑缩放拖拽、按围栏切换图/源码、明暗主题跟随，引擎本地打包完全离线。"
+  }
+}

package/package.json

@@ -1,30 +1,57 @@
 {
   "name": "dsh-mermaid-smooth",
-  "version": "0.2.1",
-  "description": "Render mermaid fences in dsh web chat as diagrams by default with smooth zoom/pan, per-fence diagram/code toggle at top-right, persisted per-fence preference, dark-mode follow, and full offline (bundled engine, zero CDN). DSH 对话 mermaid 围栏默认成图：丝滑缩放拖拽、图右上角图/文案切换、按围栏记忆偏好、明暗主题跟随、引擎本地打包完全离线。",
+  "version": "0.2.3",
+  "description": "Render mermaid fences in DeepSeek Harness (Web and Desktop) chat as diagrams by default with smooth zoom/pan, per-fence diagram/code toggle at top-right, persisted per-fence preference, dark-mode follow, and full offline (bundled engine, zero CDN). DSH Web 与桌面版对话中的 mermaid 围栏默认成图：丝滑缩放拖拽、图右上角图/文案切换、按围栏记忆偏好、明暗主题跟随、引擎本地打包完全离线。",
   "license": "MIT",
+  "author": "chris",
+  "homepage": "https://github.com/gitByteFree/dsh-mermaid-smooth#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/gitByteFree/dsh-mermaid-smooth.git"
   },
+  "bugs": {
+    "url": "https://github.com/gitByteFree/dsh-mermaid-smooth/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "mermaid",
+    "diagram",
+    "flowchart",
+    "markdown",
+    "visualization",
+    "offline"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "dsh": ">=0.2.1-rc.2"
+  },
   "type": "module",
   "main": "lib/index.js",
   "exports": {
     ".": "./lib/index.js",
     "./client": "./lib/client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
     "./package.json": "./package.json"
   },
   "files": [
     "lib/index.js",
     "lib/client.js",
     "cordis.patch.yml",
+    "icon.svg",
+    "locale/*.json",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "build": "node scripts/build.mjs",
     "prepare": "node scripts/build.mjs",
-    "test": "node --test \"test/*.test.mjs\""
+    "test": "node --test \"test/*.test.mjs\"",
+    "market": "node scripts/market.mjs"
   },
   "devDependencies": {
     "mermaid": "^11.17.2",