dsh-plugin 2.3.8 → 2.3.9

package/README.en.md

@@ -6,7 +6,7 @@
 
 # DSH Plugin Hub - Download & Install DeepSeek Harness Plugins
 
-**The community hub and directory for DeepSeek Harness (DSH) plugins: 20,000+ plugins indexed on the site, including 5,000+ published to npm that install in one click from the Plugin Hub (all hand-verified). Updated daily — browse, search, download and install by category, free and fully sourced.**
+**The community hub and directory for DeepSeek Harness (DSH) plugins: 23,000+ plugins indexed on the site, including 6,000+ published to npm that install in one click from the Plugin Hub (all hand-verified). Updated daily — browse, search, download and install by category, free and fully sourced.**
 
 [![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
 [![npm](https://img.shields.io/npm/v/dsh-plugin.svg?style=flat-square)](https://www.npmjs.com/package/dsh-plugin)
@@ -26,17 +26,17 @@
 
 ## What is DSH Plugin Hub
 
-DSH Plugin Hub is a **community plugin marketplace for DeepSeek Harness**: an open-source plugin built to the official plugin development spec. Installed under **Settings → Plugin Hub**, it lets you browse, search and install community plugins without leaving the app. This is an independent community project, not affiliated with DeepSeek Harness.
+DSH Plugin Hub is a **community plugin marketplace for DeepSeek Harness**: an open-source plugin built to the official plugin development spec. Installed under **Settings → Plugin Hub**, it lets you browse, search and install community plugins without leaving the app. It works in both the official web version (`dsh web`) and the official desktop app. This is an independent community project, not affiliated with DeepSeek Harness.
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-market-en.png?v=2.3.4" alt="DSH Plugin Hub plugin market UI" width="840">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-market-en.png?v=2.3.8" alt="DSH Plugin Hub plugin market UI" width="840">
 </p>
 
 ## Plugin Hub Features
 
 **One-click everything · fully visualized**
 
-- **One-click install** — click and done: a serial background queue with live progress in the dialog, cancellable anytime; most plugins take effect on page refresh, no restart needed
+- **One-click install** — click and done: a serial background queue with live progress in the dialog, cancellable anytime; changes take effect right away, with only the hub itself and top-level bundles asking for a restart
 - **One-click upgrade** — new versions are detected automatically; the card turns into "Update" and overwrite-installs in one click
 - **One-click uninstall** — fully visualized with live progress; changes take effect immediately
 - **Full trace** — every install / upgrade / uninstall, success or failure, is recorded in the notification center for later review
@@ -48,46 +48,46 @@ DSH Plugin Hub is a **community plugin marketplace for DeepSeek Harness**: an op
 
 **Rich catalog · human-curated**
 
-- Indexes **20,000+** community plugins on the site, **5,000+** of which ship an npm package and install in one click from the Plugin Hub; curated daily by [dsh-plugin.org](https://dsh-plugin.org), with every installable entry hand-verified
+- Indexes **23,000+** community plugins on the site, **6,000+** of which ship an npm package and install in one click from the Plugin Hub; curated daily by [dsh-plugin.org](https://dsh-plugin.org), with every installable entry hand-verified
 - Covers UI & experience, sessions & messages, memory & context, tooling and more — browse by category or search straight to it
-- Every plugin shows its verification status (verified), star / fork ratings, version and last-update time — fully sourced
+- Only verified plugins are listed; every card shows star / fork ratings, version and last-update time — fully sourced
 
 **Bilingual · easy to filter**
 
 - The UI follows your system language by default and switches manually anytime from the top-right; copy and plugin data switch together
-- Sort by popularity / newest / earliest indexed, with bilingual descriptions and capability tags at a glance
-- Filter by installed / not installed and search across names, descriptions and tags
+- Sort by stars / forks / last updated / newest indexed (click to flip the direction), with bilingual descriptions and capability tags at a glance
+- Search across names, descriptions and capability tags to land on the right plugin
 
 **Always in sync · lightweight & private**
 
 - Same data source as the website; the catalog updates automatically, no manual upgrade needed
-- Browser-side only, no host dependencies, no telemetry, no data collection
+- Ships its own host-side service: catalog proxy, install queue, settings and logs all run locally — no telemetry, no data collection
 
 ## Feature Highlights
 
 **Installed plugins · Custom install**
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-installed-en.png?v=2.3.4" alt="Installed plugins" width="400">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-custom-install-en.png?v=2.3.4" alt="Custom install" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-installed-en.png?v=2.3.8" alt="Installed plugins" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-custom-install-en.png?v=2.3.8" alt="Custom install" width="400">
 </p>
 
-Manages every installed plugin with search, source filters and sorting, plus update / uninstall and reveal-in-Finder per row · Installs a plugin outside the catalog by npm package name or an npm / pnpm install command; GitHub-source and git installs are no longer offered
+Manages every installed plugin with search, source filters and sorting, plus update / uninstall and reveal-in-file-manager per row · Installs a plugin outside the catalog by npm package name or an npm / pnpm install command; GitHub-source and git installs are no longer offered
 
 **Settings · System logs**
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-settings-en.png?v=2.3.4" alt="Settings" width="400">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-system-logs-en.png?v=2.3.4" alt="System logs" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-settings-en.png?v=2.3.8" alt="Settings" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-system-logs-en.png?v=2.3.8" alt="System logs" width="400">
 </p>
 
-Centralizes update checks, npm mirror, proxy channel, trust toggles, diagnostics and log location · Records install / uninstall / settings / diagnostics trails, filterable by category and level, with a built-in viewer
+Centralizes update checks, npm mirror with automatic fallback, HTTP proxy, the npm-install switch, diagnostics and log location · Records install / uninstall / settings / diagnostics trails, filterable by category and level, with a built-in viewer
 
 **Confirm install · Confirm uninstall**
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-install-confirm-en.png?v=2.3.4" alt="Confirm install" width="400">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-uninstall-confirm-en.png?v=2.3.4" alt="Confirm uninstall" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-install-confirm-en.png?v=2.3.8" alt="Confirm install" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-uninstall-confirm-en.png?v=2.3.8" alt="Confirm uninstall" width="400">
 </p>
 
 Shows the plugin, its source repo and the command before anything runs; the install starts only after confirmation · Shows what will be removed and its source; nothing is removed until the user confirms
@@ -95,15 +95,15 @@ Shows the plugin, its source repo and the command before anything runs; the inst
 **Confirm update · Notifications**
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-update-confirm-en.png?v=2.3.4" alt="Confirm update" width="400">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-notifications-en.png?v=2.3.4" alt="Notifications" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-update-confirm-en.png?v=2.3.8" alt="Confirm update" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-notifications-en.png?v=2.3.8" alt="Notifications" width="400">
 </p>
 
 Pops up when a newer version is found; confirming overwrite-installs in place to the latest release · Gathers install / remove / update history, live task progress and pending-restart reminders in one place
 
 ## Website Overview
 
-The hub's catalog is curated and published by [dsh-plugin.org](https://dsh-plugin.org) and stays in sync with the site; on the website you can also see plugin details, ratings and links back to their GitHub sources.
+The hub's catalog is curated and published by [dsh-plugin.org](https://dsh-plugin.org) and stays in sync with the site; on the website you can also see plugin details, install commands and links back to their GitHub sources.
 
 **Homepage · Browse by category**
 
@@ -116,7 +116,7 @@ Same data source as the hub — human-verified, updated daily · Browse every in
 
 ## Why DSH Plugin Hub
 
-The DSH Plugin Hub lists **5,000+** npm-installable DeepSeek Harness plugins (out of **20,000+** indexed on the site), all hand-verified — updated daily, browse, search, download and install for free by category, fully sourced.
+The DSH Plugin Hub lists **6,000+** npm-installable DeepSeek Harness plugins (out of **23,000+** indexed on the site), all hand-verified — updated daily, browse, search, download and install for free by category, fully sourced.
 
 ### Always Fresh
 
@@ -124,12 +124,19 @@ Newly released DSH plugins are indexed as soon as possible; descriptions, catego
 
 ### Human-Verified
 
-Every DSH plugin is manually checked by a professional team — install commands, compatibility status (verified / unconfirmed) and target DSH version (dshTarget) are verified one by one, with capability categories labeled. Quality is guaranteed.
+Every DSH plugin is manually checked by a professional team — install commands, compatibility and target DSH version (dshTarget) are verified one by one, with capability categories labeled. Only entries that pass verification are listed.
 
 ### Fully Sourced
 
 Every DSH plugin links back to its GitHub source repository with stars, forks and last-update time; data is compiled from the DeepSeek Harness official site, official architecture docs and official repos — everything is traceable.
 
+## Requirements
+
+- **DeepSeek Harness**: the official web version (`dsh web`) or the official desktop app — the hub lives under **Settings → Plugin Hub**
+- **Node.js >= 22.6**: declared in the package's `engines`; both the host and the command-line `dsh` must satisfy it
+- **pnpm**: `dsh` uses pnpm to manage profile plugins, and installs are blocked without it — run `npm install -g pnpm` first
+- **A reachable npm registry**: follows your local npm config by default; if it is unreachable, switch the mirror, enable automatic fallback, or set an HTTP proxy under **Settings → Plugin Hub → Update Settings**
+
 ## Install DSH Plugin Hub
 
 Install from npm:
@@ -138,7 +145,7 @@ Install from npm:
 dsh plugin --profile web add dsh-plugin
 ```
 
-The plugin is published to the npm registry as `dsh-plugin` — one command installs and it just works, no build step required.
+The plugin is published to the npm registry as `dsh-plugin` — one command installs and it just works, no build step required. This command targets the official web version (web profile); in the official desktop app, install straight from **Settings → Plugin Hub** — the desktop profile is managed exclusively by the app, so the command-line `dsh` cannot write to it.
 
 > **npm installs only**: source and git installs depend on each repository's own build scripts, which are written inconsistently and fail often (git packages are routinely rejected by pnpm's build gate), and the resulting behaviour varies — so they are no longer offered. The browser bundle ships with the package, so an npm install needs no build step; restart `dsh web` and open Settings → Plugin Hub.
 
@@ -169,23 +176,60 @@ dsh plugin --profile web remove dsh-plugin
 dsh plugin --profile web add dsh-plugin
 ```
 
-> Restart `dsh web` after updating for the changes to take effect.
+> Restart `dsh web` after updating for the changes to take effect. In the desktop app, update from the in-app Plugin Hub (the desktop profile is app-managed, so the CLI steps above do not apply).
 
 > **Marketplace missing after an update/reinstall?** If you unchecked `dsh-plugin` under Settings → Plugins, the profile's `dsh.profile.bundles` no longer lists it — the dependency stays in `node_modules` but is not composed, so the marketplace will not appear after a restart. Re-check `dsh-plugin` under Settings → Plugins, or add `"dsh-plugin"` back to `dsh.profile.bundles` in `~/.dsh/profiles/<profile>/package.json`, then restart the host.
 
+## Uninstall DSH Plugin Hub
+
+On the web version:
+
+```bash
+dsh plugin --profile web remove dsh-plugin
+```
+
+In the desktop app: disable or remove `dsh-plugin` under **Settings → Plugins** (the desktop profile is managed exclusively by the app, so the CLI does not apply).
+
+Uninstalling only removes the hub itself and leaves your other plugins untouched; afterwards restart `dsh web`, or quit and reopen the desktop app.
+
 ## Getting Started: browse & install in DeepSeek Harness
 
-Restart `dsh web` after installing, then open **Settings → Plugin Hub** to browse and install plugins. The catalog is same-source and in sync with [dsh-plugin.org](https://dsh-plugin.org).
+On the web version, restart `dsh web` after installing; in the desktop app, quit and reopen the app. Then open **Settings → Plugin Hub** to browse and install plugins. The catalog is same-source and in sync with [dsh-plugin.org](https://dsh-plugin.org).
+
+## Troubleshooting
+
+- **Hub missing, or gone after an update**: most likely `dsh-plugin` was unchecked under Settings → Plugins — re-check it (see "Marketplace missing after an update/reinstall?" above)
+- **Cannot reach the registry / installs time out**: switch the npm mirror, enable "Switch mirrors on failure", or set an HTTP proxy under **Settings → Plugin Hub → Update Settings**; System Diagnostics checks npm registry, GitHub and the catalog site in one click
+- **"Your npm is too old"**: npm crashing while resolving dependencies is a known npm bug — upgrade and retry with `npm install -g npm@latest`
+- **"pnpm is missing"**: run `npm install -g pnpm`, make sure it is on your PATH, then retry
+- **Installed but not active**: the hub itself and top-level bundles need a host restart — use "Restart now" on the web version, or quit from the app menu (or tray) and reopen the desktop app
+- **Need more detail**: **Settings → Plugin Hub → System Logs** filters by category and level and exports the full log; attach it to an issue to speed up diagnosis
 
 ## Submit your DSH plugin
 
 Publish your plugin to GitHub and add the `dsh-plugin` topic — it will be discovered and indexed automatically. Requirements and the submission flow are on the [Submit a Plugin](https://dsh-plugin.org/submit) page.
 
+## Development
+
+This repository holds the full source and can be built, tested and debugged locally:
+
+```bash
+npm ci
+npm run check    # typecheck + test + build
+npm run reload   # restart the local host and load the new client bundle
+```
+
+Development requires Node.js >= 22.6 (`npm test` relies on native type stripping). See [docs/architecture.md](docs/architecture.md) for the layering and directory structure, [docs/development.md](docs/development.md) for the day-to-day workflow and release steps, and [CONTRIBUTING.md](CONTRIBUTING.md) for commit and PR conventions.
+
 ## Contributing
 
 - **Add your plugin**: tag it with the `dsh-plugin` topic to be auto-discovered — start on the [Submit a Plugin](https://dsh-plugin.org/submit) page
 - **Fix data / suggest features**: open an [Issue](https://github.com/dshplugin/dsh-plugin-hub/issues)
-- **Contribute code**: fork the repo and send a Pull Request
+- **Contribute code**: fork the repo and send a Pull Request — read [CONTRIBUTING.md](CONTRIBUTING.md) first
+- **Security issues**: do not open a public issue — report privately per [SECURITY.md](SECURITY.md)
+- **Changelog**: per-release changes live in [docs/releases](docs/releases) and on GitHub [Releases](https://github.com/dshplugin/dsh-plugin-hub/releases)
+
+This project follows our [Contributor Code of Conduct](CODE_OF_CONDUCT.md).
 
 ## Related
 

package/README.md

@@ -6,7 +6,7 @@
 
 # DSH Plugin 插件市场 - DeepSeek Harness Plugin (DSH) 下载与安装 · 插件大全
 
-**DeepSeek Harness Plugin（DSH）插件市场与插件大全：主站收录 20,000+ 个插件，其中 5,000+ 个已发布 NPM 包、可在插件市场一键安装（均已人工精选验证）。每日更新，免费浏览、搜索并按分类发现、下载与安装 DSH 插件，来源可溯。**
+**DeepSeek Harness Plugin（DSH）插件市场与插件大全：主站收录 23,000+ 个插件，其中 6,000+ 个已发布 NPM 包、可在插件市场一键安装（均已人工精选验证）。每日更新，免费浏览、搜索并按分类发现、下载与安装 DSH 插件，来源可溯。**
 
 [![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
 [![npm](https://img.shields.io/npm/v/dsh-plugin.svg?style=flat-square)](https://www.npmjs.com/package/dsh-plugin)
@@ -26,17 +26,17 @@
 
 ## 什么是 DSH Plugin Hub
 
-DSH Plugin Hub 是 **DeepSeek Harness 社区插件市场**：一个遵循官方插件开发规范构建的开源插件，安装进「设置 → 插件市场」后，无需离开应用即可浏览、搜索并一键安装社区插件。本项目为独立社区项目，与 DeepSeek Harness 官方无隶属关系。
+DSH Plugin Hub 是 **DeepSeek Harness 社区插件市场**：一个遵循官方插件开发规范构建的开源插件，安装进「设置 → 插件市场」后，无需离开应用即可浏览、搜索并一键安装社区插件。官方网页版（`dsh web`）与官方桌面版都支持。本项目为独立社区项目，与 DeepSeek Harness 官方无隶属关系。
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-market-zh.png?v=2.3.4" alt="DSH Plugin Hub 插件市场界面" width="840">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-market-zh.png?v=2.3.8" alt="DSH Plugin Hub 插件市场界面" width="840">
 </p>
 
 ## 插件市场特性
 
 **一键操作 · 全部可视化**
 
-- **一键安装** — 点击即装：后台队列串行执行，弹窗实时显示安装进度，可随时取消；装完刷新页面即生效，无需重启
+- **一键安装** — 点击即装：后台队列串行执行，弹窗实时显示安装进度，可随时取消；装完即生效，只有插件市场自身等顶层 bundle 会提示重启
 - **一键升级** — 目录检测到新版本自动提示，卡片按钮变为「更新」，覆盖安装一键完成
 - **一键卸载** — 卸载全程可视化，实时进度一目了然，卸载成功即生效
 - **任务留痕** — 每次安装 / 升级 / 卸载的成功与失败都会写入通知中心，随时回查
@@ -48,46 +48,46 @@ DSH Plugin Hub 是 **DeepSeek Harness 社区插件市场**：一个遵循官方
 
 **资源丰富 · 人工精选**
 
-- 主站收录 **20,000+** 个社区插件，其中 **5,000+** 个已发布 NPM 包、可在插件市场一键安装；目录由 [dsh-plugin.org](https://dsh-plugin.org) 每日收录，可安装条目均经人工审核
+- 主站收录 **23,000+** 个社区插件，其中 **6,000+** 个已发布 NPM 包、可在插件市场一键安装；目录由 [dsh-plugin.org](https://dsh-plugin.org) 每日收录，可安装条目均经人工审核
 - 涵盖界面与体验、会话与消息、记忆与上下文、工具能力等分类，按分类浏览、搜索直达
-- 每个插件标注人工验证状态（verified）、Star / Fork 评分、版本号与最近更新时间，来源可溯
+- 市场只展示核验通过（verified）的插件，卡片标注 Star / Fork 评分、版本号与最近更新时间，来源可溯
 
 **中英双语 · 直观筛选**
 
 - 界面默认跟随系统语言，右上角一键手动切换，界面文案与插件数据同步切换
-- 支持「最热 / 最新 / 最早收录」排序，双语描述、能力标签一目了然
-- 按已安装 / 未安装快速过滤，配合全文搜索精确定位目标插件
+- 支持按 Star / Fork / 最近更新 / 最新收录排序（点击切换正倒序），双语描述、能力标签一目了然
+- 全文搜索覆盖名称、描述与能力标签，精确定位目标插件
 
 **实时同步 · 轻量安全**
 
 - 数据与官网同源，安装后自动获取最新目录，无需手动升级
-- 仅浏览器端注入，无宿主服务依赖，无遥测、无隐私采集
+- 插件自带宿主端服务：目录代理、安装队列、设置与日志都在本机执行，无遥测、无隐私采集
 
 ## 功能一览
 
 **已安装插件列表 · 自定义安装**
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-installed-zh.png?v=2.3.4" alt="已安装插件列表" width="400">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-custom-install-zh.png?v=2.3.4" alt="自定义安装" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-installed-zh.png?v=2.3.8" alt="已安装插件列表" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-custom-install-zh.png?v=2.3.8" alt="自定义安装" width="400">
 </p>
 
-集中管理当前环境已装的全部插件，支持搜索、来源筛选与排序，行尾提供更新、卸载与「在 Finder 中显示」 · 手动安装目录外的插件：只接受 NPM 包名或 npm / pnpm 安装命令，不再提供 GitHub 源码与 git 安装
+集中管理当前环境已装的全部插件，支持搜索、来源筛选与排序，行尾提供更新、卸载与「在 Finder 中显示」（Windows / Linux 为「在文件夹中显示」） · 手动安装目录外的插件：只接受 NPM 包名或 npm / pnpm 安装命令，不再提供 GitHub 源码与 git 安装
 
 **设置 · 系统日志**
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-settings-zh.png?v=2.3.4" alt="设置" width="400">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-system-logs-zh.png?v=2.3.4" alt="系统日志" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-settings-zh.png?v=2.3.8" alt="设置" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-system-logs-zh.png?v=2.3.8" alt="系统日志" width="400">
 </p>
 
-集中配置更新检查、NPM 镜像源、代理通道、安全信任、系统诊断与日志存放位置 · 记录安装、卸载、设置变更与诊断轨迹，按分类与级别筛选，内置日志查看器
+集中配置更新检查、npm 镜像源与自动换源、HTTP 代理、NPM 安装开关、系统诊断与日志存放位置 · 记录安装、卸载、设置变更与诊断轨迹，按分类与级别筛选，内置日志查看器
 
 **确认安装 · 确认卸载**
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-install-confirm-zh.png?v=2.3.4" alt="确认安装" width="400">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-uninstall-confirm-zh.png?v=2.3.4" alt="确认卸载" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-install-confirm-zh.png?v=2.3.8" alt="确认安装" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-uninstall-confirm-zh.png?v=2.3.8" alt="确认卸载" width="400">
 </p>
 
 安装前展示插件名称、来源仓库与执行命令，确认后才开始安装 · 卸载前展示待移除的插件，确认后才从环境移除，避免误删
@@ -95,15 +95,15 @@ DSH Plugin Hub 是 **DeepSeek Harness 社区插件市场**：一个遵循官方
 **确认更新 · 通知中心**
 
 <p align="center">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-update-confirm-zh.png?v=2.3.4" alt="确认更新" width="400">
-  <img src="https://api.dsh-plugin.org/images/releases/2-3-4/dsh-plugin-hub-notifications-zh.png?v=2.3.4" alt="通知中心" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-update-confirm-zh.png?v=2.3.8" alt="确认更新" width="400">
+  <img src="https://api.dsh-plugin.org/images/releases/2-3-8/dsh-plugin-hub-notifications-zh.png?v=2.3.8" alt="通知中心" width="400">
 </p>
 
 检测到新版本时弹出，确认后原位覆盖安装到最新版 · 集中管理安装、卸载、更新的历史记录、实时进度与待重启提醒
 
 ## 官网一览
 
-插件市场的数据由 [dsh-plugin.org](https://dsh-plugin.org) 整理发布，两侧实时同步；在官网还可以查看插件详情、评分与 GitHub 源码链接。
+插件市场的数据由 [dsh-plugin.org](https://dsh-plugin.org) 整理发布，两侧实时同步；在官网还可以查看插件详情、安装命令与 GitHub 源码链接。
 
 **官网首页 · 分类展示**
 
@@ -116,7 +116,7 @@ DSH Plugin Hub 是 **DeepSeek Harness 社区插件市场**：一个遵循官方
 
 ## 为什么选择 DSH Plugin Hub
 
-DSH Plugin 插件市场收录 **5,000+** 个可一键安装的 NPM 插件（主站共收录 **20,000+** 个 DSH 插件），均已人工精选验证，每日更新，免费按分类浏览、搜索、下载与安装，来源可溯。
+DSH Plugin 插件市场收录 **6,000+** 个可一键安装的 NPM 插件（主站共收录 **23,000+** 个 DSH 插件），均已人工精选验证，每日更新，免费按分类浏览、搜索、下载与安装，来源可溯。
 
 ### 及时更新
 
@@ -124,12 +124,19 @@ DSH Plugin 插件市场收录 **5,000+** 个可一键安装的 NPM 插件（主
 
 ### 人工审核
 
-每个 DSH plugin 都由专业的技术团队人工核查，逐项核对安装命令、兼容状态（verified / unconfirmed）与 DSH 目标版本（dshTarget），并标注能力分类，质量有保障。
+每个 DSH plugin 都由专业的技术团队人工核查，逐项核对安装命令、兼容性与 DSH 目标版本（dshTarget），并标注能力分类；只有核验通过的条目才会进入插件市场。
 
 ### 来源可查
 
 每个 DSH plugin 都链回其 GitHub 源码仓库，并展示 Star、Fork 与最近更新时间；本站数据整理自 DeepSeek Harness 官网、官方架构文档与官方仓库，看到的信息都有据可查。
 
+## 环境要求
+
+- **DeepSeek Harness**：官方网页版（`dsh web`）或官方桌面版，安装后在「设置 → 插件市场」使用
+- **Node.js >= 22.6**：插件按该版本声明（`engines`），宿主与命令行 `dsh` 均需满足
+- **pnpm**：`dsh` 用 pnpm 管理 profile 插件，缺失时安装会被拦下，先执行 `npm install -g pnpm`
+- **可用的 npm 源**：默认跟随本机 npm 配置；连不上时可在「设置 → 插件市场 → 更新设置」里换镜像、开启自动换源或填写 HTTP 代理
+
 ## 安装 DSH Plugin Hub
 
 从 npm 安装：
@@ -138,7 +145,7 @@ DSH Plugin 插件市场收录 **5,000+** 个可一键安装的 NPM 插件（主
 dsh plugin --profile web add dsh-plugin
 ```
 
-插件已发布到 npm registry（包名 `dsh-plugin`），一条命令即可安装使用，无需任何构建。
+插件已发布到 npm registry（包名 `dsh-plugin`），一条命令即可安装使用，无需任何构建。该命令面向官方网页版（web profile）；官方桌面版直接在应用内「设置 → 插件市场」安装即可——桌面 profile 由应用独占管理，命令行的 `dsh` 无权写入。
 
 > **只提供 npm 安装**：源码 / git 安装要依赖各仓库自己的构建脚本，写法不统一、失败率高（git 包常被 pnpm 的构建脚本限制直接拦下），装出来的行为也不一致，因此不再提供。插件已内置浏览器端 bundle，npm 安装无需构建；装完重启 `dsh web`，在「设置 → 插件市场」即可使用。
 
@@ -169,23 +176,60 @@ dsh plugin --profile web remove dsh-plugin
 dsh plugin --profile web add dsh-plugin
 ```
 
-> 更新后重启 `dsh web` 即可生效。
+> 更新后重启 `dsh web` 即可生效。桌面版请在应用内的插件市场一键更新（桌面 profile 归应用管理，上面的命令行不适用）。
 
 > **更新/重装后市场不见了？** 如果你在「设置 → 插件」里取消勾选过 `dsh-plugin`，profile 的 `dsh.profile.bundles` 里就没有它了——依赖还在 `node_modules`，但不会被组合，重启后市场不会出现。到「设置 → 插件」重新勾选 `dsh-plugin`；也可以把 `"dsh-plugin"` 加回 `~/.dsh/profiles/<profile>/package.json` 的 `dsh.profile.bundles`，再重启宿主。
 
+## 卸载 DSH Plugin Hub
+
+网页版：
+
+```bash
+dsh plugin --profile web remove dsh-plugin
+```
+
+桌面版：在应用内「设置 → 插件」里禁用或移除 `dsh-plugin`（桌面 profile 由应用独占管理，命令行不适用）。
+
+卸载只移除插件市场本身，不影响已装好的其他插件；卸载后重启 `dsh web`，或退出并重新打开桌面应用。
+
 ## 快速开始：在 DeepSeek Harness 中使用
 
-安装完成后重启 `dsh web`，打开 **设置 → 插件市场**，即可浏览并安装插件。插件市场与 [dsh-plugin.org](https://dsh-plugin.org) 官网数据同源、实时同步。
+网页版安装后重启 `dsh web`，桌面版退出并重新打开应用；随后打开 **设置 → 插件市场**，即可浏览并安装插件。插件市场与 [dsh-plugin.org](https://dsh-plugin.org) 官网数据同源、实时同步。
+
+## 故障排查
+
+- **市场没出现，或更新后消失**：多半是之前在「设置 → 插件」取消勾选过 `dsh-plugin`，重新勾选即可，详见上方「更新/重装后市场不见了？」
+- **连不上源 / 安装超时**：在「设置 → 插件市场 → 更新设置」里换 npm 镜像源、开启「连不上时自动换源」，或填写 HTTP 代理；「系统诊断」可一键检测 npm 源、GitHub 与目录站点的连通性
+- **提示 npm 版本过低**：npm 解析依赖时内部崩溃是 npm 自身的已知缺陷，升级后重试：`npm install -g npm@latest`
+- **提示缺少 pnpm**：先 `npm install -g pnpm`，确认已在 PATH 中再重试
+- **装完没生效**：插件市场自身与顶层 bundle 需要重启宿主——网页版点「立即重启」，桌面版从应用菜单（或托盘）退出后重新打开
+- **需要更细的线索**：「设置 → 插件市场 → 系统日志」可按分类 / 级别筛选并导出全文；提交 Issue 时附上日志能更快定位
 
 ## 提交你的 DSH plugin
 
 将你的插件发布到 GitHub 并添加 `dsh-plugin` topic，即可被 DSH Plugin 插件目录自动发现与收录。收录要求与提交流程见官网[提交插件](https://dsh-plugin.org/zh/submit)页面。
 
+## 参与开发
+
+本仓库是完整源码，可本地构建、测试与调试：
+
+```bash
+npm ci
+npm run check    # typecheck + test + build
+npm run reload   # 重启本机宿主，加载新的客户端 bundle
+```
+
+开发需 Node.js >= 22.6（`npm test` 依赖原生 type stripping）。分层与目录结构见 [docs/architecture.md](docs/architecture.md)，日常开发流程与发布见 [docs/development.md](docs/development.md)，提交规范与 PR 流程见 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
 ## 贡献
 
 - **收录你的插件**：添加 `dsh-plugin` topic 即可被自动发现，入口见官网[提交插件](https://dsh-plugin.org/zh/submit)
 - **数据勘误 / 功能建议**：欢迎[提交 Issue](https://github.com/dshplugin/dsh-plugin-hub/issues)
-- **参与开发**：Fork 本仓库并提交 Pull Request
+- **参与开发**：Fork 本仓库并提交 Pull Request，动手前请读 [CONTRIBUTING.md](CONTRIBUTING.md)
+- **安全问题**：请勿公开提交 Issue，按 [SECURITY.md](SECURITY.md) 私下报告
+- **更新日志**：每个版本的变更见 [docs/releases](docs/releases) 与 GitHub [Releases](https://github.com/dshplugin/dsh-plugin-hub/releases)
+
+本项目遵循[贡献者行为准则](CODE_OF_CONDUCT.md)。
 
 ## 相关项目