diff --git a/README.md b/README.md
index 7c1a25b..a789e33 100644
--- a/README.md
+++ b/README.md
@@ -55,6 +55,22 @@ https://github.com/user-attachments/assets/23187822-047e-45cc-b480-fe997bd55b86
 
 > 安装 = 依赖登记（等价 `dsh plugin --profile web add link:<路径>`）+ 一行挂载行。**DSH 以 npm 包启动（如 `npx -p @deepseek-ai/dsh@0.1.0-rc.6 dsh web`）同样可用**（v0.4.3 起实测验证）。
 
+### 通过 npm 安装（推荐）
+
+插件已发布到 npm：**`dsh-better-sidebar@0.10.0`**（`@deepseek-ai/*` 依赖已对齐宿主实际版本 `^0.1.0-rc.6` / `@deepseek-ai/cordis@^4.0.1`，同版本单实例）。挂载仍走 profile + `cordis.patch.yml`，只是依赖来源换成 npm 包：
+
+```text
+1. ~/.dsh/profiles/web/package.json 的 dependencies 写 "dsh-better-sidebar": "^0.10.0"
+2. ~/.dsh/profiles/web/cordis.patch.yml 追加：
+   - insert:
+       - id: better-sidebar
+         name: 'dsh-better-sidebar'
+3. 在 ~/.dsh/profiles/web 执行 pnpm install
+4. 重启 DSH 并硬刷新（Cmd/Ctrl+Shift+R）验证
+```
+
+更新：改版本号（如 `^0.10.1`）→ `pnpm install` → 重启。若 profile 的 pnpm 因 `minimumReleaseAge`（发布 <24h）拒绝，会在 `pnpm-workspace.yaml` 自动追加 `minimumReleaseAgeExclude` 条目，或手动加上 `dsh-better-sidebar@<版本>`。
+
 ### 更新
 
 ```text
diff --git a/README_EN.md b/README_EN.md
index 420ca7e..0dbb9be 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -55,6 +55,22 @@ Please install the dsh-better-sidebar plugin into my web profile (plugin = VSCod
 
 > Installation = dependency registration (equivalent to `dsh plugin --profile web add link:<path>`) + one mount line. **It also works when DSH is started as an npm package (e.g. `npx -p @deepseek-ai/dsh@0.1.0-rc.6 dsh web`)** (verified since v0.4.3).
 
+### Install from npm (recommended)
+
+The plugin is published to npm as **`dsh-better-sidebar@0.10.0`** (`@deepseek-ai/*` peers aligned with the host's actual versions `^0.1.0-rc.6` / `@deepseek-ai/cordis@^4.0.1`, single instance). Mounting still goes through the profile + `cordis.patch.yml`; only the dependency source becomes the npm package:
+
+```text
+1. In ~/.dsh/profiles/web/package.json dependencies add "dsh-better-sidebar": "^0.10.0"
+2. Append to ~/.dsh/profiles/web/cordis.patch.yml:
+   - insert:
+       - id: better-sidebar
+         name: 'dsh-better-sidebar'
+3. Run pnpm install in ~/.dsh/profiles/web
+4. Restart DSH and hard-refresh (Cmd/Ctrl+Shift+R) to verify
+```
+
+Update: bump the version range (e.g. `^0.10.1`) → `pnpm install` → restart. If the profile's pnpm rejects the package via `minimumReleaseAge` (<24h old), it auto-appends a `minimumReleaseAgeExclude` entry to `pnpm-workspace.yaml` — or add `dsh-better-sidebar@<version>` there manually.
+
 ### Updating
 
 ```text