From 96064c31a9c0e8b7162d10a5c4ba833d93f12ff8 Mon Sep 17 00:00:00 2001 From: Menghuan1918 Date: Fri, 14 Aug 2026 14:07:55 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20DSH=20=E5=AF=B9=20client=20=E6=94=B9?= =?UTF-8?q?=E5=8A=A8=E7=83=AD=E5=8A=A0=E8=BD=BD=EF=BC=8C=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E5=90=84=E5=A4=84=E3=80=8C=E9=87=8D=E5=90=AF=20DSH=E3=80=8D?= =?UTF-8?q?=E8=AF=B4=E6=98=8E=E4=B8=BA=E7=A1=AC=E5=88=B7=E6=96=B0=E5=8D=B3?= =?UTF-8?q?=E5=8F=AF=EF=BC=88=E4=BB=85=20host=20=E5=8D=8A=E6=94=B9?= =?UTF-8?q?=E5=8A=A8=E9=9C=80=E9=87=8D=E5=90=AF=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 2 +- README.md | 8 ++++---- README_EN.md | 6 +++--- docs/external-plugin-guide.md | 2 +- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 9220cc3..2f594bc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -484,7 +484,7 @@ function CsvGrid(props: { rows: string[][]; path: string }): React.ReactNode { / function parseCsv(text: string): string[][] { /* ... */ } ``` -**注册到 profile**：在 `~/.dsh/profiles/web/package.json` 的 `dependencies` 加 `"my-plugin": "link:<你的插件路径>"`，在 `cordis.patch.yml` 加挂载行，`pnpm install`，重启 `dsh web` + 浏览器硬刷新。 +**注册到 profile**：在 `~/.dsh/profiles/web/package.json` 的 `dependencies` 加 `"my-plugin": "link:<你的插件路径>"`，在 `cordis.patch.yml` 加挂载行，`pnpm install`，浏览器硬刷新即可（DSH 对 client 改动热加载，无需重启 `dsh web`；仅 host 半改动需要重启）。 --- diff --git a/README.md b/README.md index 2ab6547..694db07 100644 --- a/README.md +++ b/README.md @@ -49,7 +49,7 @@ curl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/s irm https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.ps1 | iex ``` -装完**重启 DSH 并硬刷新**（Cmd/Ctrl+Shift+R）即可看到侧边栏。 +装完**硬刷新浏览器**（Cmd/Ctrl+Shift+R）即可看到侧边栏（DSH 对 client 改动热加载，无需重启；仅 host 半更新时需要重启）。
指定版本 / 装完自动重启（可选） @@ -127,7 +127,7 @@ npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-better-sideba dsh plugin --profile web add dsh-better-sidebar ``` -或重跑一次一键脚本；也可把 `~/.dsh/profiles/web/package.json` 里的版本号改高后 `pnpm install`。改完**重启 DSH 并硬刷新**（Cmd/Ctrl+Shift+R）。 +或重跑一次一键脚本；也可把 `~/.dsh/profiles/web/package.json` 里的版本号改高后 `pnpm install`。改完**硬刷新浏览器**（Cmd/Ctrl+Shift+R）即可（client 改动无需重启 DSH）。
@@ -159,10 +159,10 @@ dsh plugin --profile web add dsh-better-sidebar - id: better-sidebar name: 'dsh-better-sidebar' 4. 在 ~/.dsh/profiles/web 执行 pnpm install -5. 重启 DSH 并硬刷新 +5. 硬刷新浏览器（Cmd/Ctrl+Shift+R）即可看到效果（client 改动无需重启 DSH；host 半改动才需重启） ``` -更新：`git pull && pnpm install && pnpm build` → 重启 DSH（仅 client 改动可硬刷新）。切回 npm 通道时，把依赖改回 `"dsh-better-sidebar": "^0.10.3"` 再 `pnpm install`。 +更新：`git pull && pnpm install && pnpm build` → 硬刷新浏览器即可（client 改动热加载生效，无需重启 DSH；host 半改动才需重启）。切回 npm 通道时，把依赖改回 `"dsh-better-sidebar": "^0.10.3"` 再 `pnpm install`。 diff --git a/README_EN.md b/README_EN.md index 5f43479..ec5208d 100644 --- a/README_EN.md +++ b/README_EN.md @@ -49,7 +49,7 @@ curl -fsSL https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/s irm https://raw.githubusercontent.com/omdsh-dev/DSH-better-sidebar/main/scripts/install.ps1 | iex ``` -Then **restart DSH and hard-refresh** (Cmd/Ctrl+Shift+R) to see the sidebar. +Then **hard-refresh the browser** (Cmd/Ctrl+Shift+R) to see the sidebar (DSH hot-reloads client changes; only host-half updates need a restart).
Pin a version / auto-restart (optional) @@ -127,7 +127,7 @@ The one-click script does four things, all idempotent (safe to re-run): dsh plugin --profile web add dsh-better-sidebar ``` -or re-run the one-click script; or bump the version in `~/.dsh/profiles/web/package.json` (e.g. `"^0.10.3"`) and run `pnpm install`. Then restart DSH and hard-refresh (Cmd/Ctrl+Shift+R). +or re-run the one-click script; or bump the version in `~/.dsh/profiles/web/package.json` (e.g. `"^0.10.3"`) and run `pnpm install`. Then hard-refresh the browser (Cmd/Ctrl+Shift+R) — client changes do not need a DSH restart.
@@ -162,7 +162,7 @@ To debug local changes or track the dev branch, point the dependency at a local 5. Restart DSH and hard-refresh ``` -Update: `git pull && pnpm install && pnpm build` → restart DSH (client-only changes can just hard-refresh). To switch back to the npm channel, restore `"dsh-better-sidebar": "^0.10.3"` and re-run `pnpm install`. +Update: `git pull && pnpm install && pnpm build` → just hard-refresh the browser (client changes hot-reload; only host-half changes need a DSH restart). To switch back to the npm channel, restore `"dsh-better-sidebar": "^0.10.3"` and re-run `pnpm install`. diff --git a/docs/external-plugin-guide.md b/docs/external-plugin-guide.md index 7ba2b07..b1b4564 100644 --- a/docs/external-plugin-guide.md +++ b/docs/external-plugin-guide.md @@ -598,7 +598,7 @@ function parseCsv(text: string): string[][] { /* ... */ } 1. `~/.dsh/profiles/web/package.json` 的 `dependencies` 加 `"my-plugin": "link:<你的插件路径>"`； 2. `~/.dsh/profiles/web/cordis.patch.yml` 追加挂载行（`- insert: - id: my-plugin / name: 'my-plugin'`）； 3. 在 profile 目录 `pnpm install`； -4. 重启 `dsh web` + 浏览器硬刷新（Cmd/Ctrl+Shift+R）。 +4. 浏览器硬刷新（Cmd/Ctrl+Shift+R）即可看到效果（DSH 对 client 改动热加载，无需重启 `dsh web`；仅 host 半改动需要重启）。 ---