# @99galaxy/dsh-plugin-market 中文文档

规范地址：https://npmcn.com/package/%4099galaxy/dsh-plugin-market/

版本：1\.2\.2
npm 元数据更新时间：2026-11-03T05:31:01.513Z
中文译文更新时间：2026-11-06T15:57:43.945Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%4099galaxy/dsh-plugin-market
原文对照：https://npmcn.com/package/%4099galaxy/dsh-plugin-market/?lang=original
项目主页：https://github.com/99galaxy/dsh-plugin-market#readme
源码仓库：https://github.com/99galaxy/dsh-plugin-market

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：95.1 kB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.19
- 运行依赖：0 个
- 首次发布：2026-09-18T18:34:20.856Z
- 最新版本发布：2026-11-03T05:31:00.473Z
- 近 30 天下载量：2815（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

DSH QQ: 赞-dsh-plugin 从侧边栏浏览赞-dsh-plugin目录并安装插件.

## 安装

```sh
npm install @99galaxy/dsh-plugin-market
```

也可以使用：`pnpm add @99galaxy/dsh-plugin-market`、`yarn add @99galaxy/dsh-plugin-market`、`bun add @99galaxy/dsh-plugin-market`

## README

# @99galaxy/dsh-plugin-market

**从 DeepSeek Harness 的左侧栏打开插件市场，一键安装。**

> A sidebar plugin-market page for DeepSeek Harness: browse the community catalog, see what you already have on its own tab, and install with one click.

数据来自 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 维护的 官方目录 `plugins.json` —— 约 **4,400+ 个插件、23 个双语分类**，带 Star 数、下载量、收录日期， 以及每个条目的官方安装命令。

* * *

## 它做什么

左侧栏新增 **「插件市场」** 入口，点击后在主区域打开独立页面。**页面内**有三个标签：

| 标签 | 内容 |
| --- | --- |
| **全部插件** | 完整目录。可按分类筛选、按 Star/下载量/名称/收录时间排序、搜索插件名或简介 |
| **已安装** | 只列出**你已经装过**的插件，标签上直接显示数量 |
| **可更新** | 只列出**装了但目录里有更新版本**的插件，标签上直接显示数量 |

-   **一键安装**：点「安装」装到当前 profile；未指定版本的 npm 插件先从 npm 官方 registry 查询 `latest`，再按确切版本安装，不会被包管理器的默认选版规则悄悄降到旧版。 明确指定的版本和 Git 来源保持原意；无法查询最新版时会报错，不会回退安装旧版。
-   **安装校验**：确切版本安装后会核对实际落盘版本，不会仅凭包管理器退出成功就宣告安装完成
-   **安装状态**：已安装的条目带绿色徽章；若目录名与你实际装的包名不同，会标出真实包名
-   **更新检测**：拿目录里的 `version` 和 profile 里实际装的版本比对，有更新的挂橙色徽章 「可更新 1.47.0（当前 1.46.1）」，按钮从「重新安装」变成「更新」
-   **精确更新**：更新 npm 插件时直接安装目录中的目标版本，不会因为旧的 `^` 范围而误报 「已是最新」；Git 来源更新则强制重新解析来源
-   **中英切换**：简介可切中文/英文
-   **本地缓存**：目录存到本地，**1 小时内直接复用**；过期时先显示本地内容并在后台更新， 不再用下载阻塞首屏；要立即等待最新版可点「强制重新获取」
-   **一键重载 profile**：装完插件点「重载 profile」，通过 DSH 的 HMR 重新组合当前 profile，不必重启；没有 HMR 的 profile 会提示你重启
-   **四级降级**：官方域名 → 镜像 → CDN → npm，任一条通即可

## 安装

这是一个 **DSH bundle**：装进 profile 后**重启 DSH 自动加载**。

```bash
cd ~/.dsh/profiles/web          # Web 版；DSH 桌面版换成 desktop
pnpm add github:99galaxy/dsh-plugin-market
```

也可以显式用 HTTPS 地址：

```bash
pnpm add https://github.com/99galaxy/dsh-plugin-market
```

装进来的**包名**是 `@99galaxy/dsh-plugin-market` —— 与仓库名不同，所以下面层列表里要写这个 带 scope 的名字。

> DSH 0.2.x 桌面版跑的是 `desktop` profile。插件会通过 `ctx.profileContext.name` 自动识别当前 profile，所以页面里的「安装」不需要你在命令里写死 `--profile`。

然后把它加进 `package.json` 的层列表 —— **声明了 `dsh.bundle` 的依赖才会被加载**：

```json
{
  "dsh": {
    "profile": {
      "bundles": ["...", "@99galaxy/dsh-plugin-market"]
    }
  }
}
```

重启 DSH。

> `github:` 前缀在部分 git 配置下会被解析成 `git+ssh`，而匿名 HTTPS 不需要任何凭据。 若 pnpm 报找不到仓库或索要 SSH 密钥，改用上面的 HTTPS 形式。

## 使用

1.  点击左侧栏的 **插件市场**
2.  浏览或搜索；点卡片右侧「安装」
3.  安装完成后点工具栏的「**重载 profile**」；没有启用 HMR 的 profile 仍需重启 DSH

「已安装」标签里可以确认某个插件是否已经在你的 profile 里；「可更新」标签里是可以升级的那些。

> **关于「更新」**：它执行的仍是**目录里那条安装命令**，所以装的是目录指定的那个来源 —— 一个用 `github:` 装的插件，如果目录对应的条目是 npm 包名，更新后会变成 npm 包。 想留在固定 commit 上就别点更新。
> 
> **判断不了的插件**：目录里没有 `version`、或目录根本没收录的插件，无法判断有没有更新。 它们不会出现在「可更新」标签里，但标签内会单独说明有多少个 —— 免得把「判断不了」误读成「已经是最新」。

## 架构

```
┌─ 浏览器半边 ────────────────────────────────────────────────┐
│  window.__ModuleLoader__.load({ id, factory(require) })     │
│  require('react')；槽位服务由 ctx 注入                       │
│  sidebar.panellist → 左侧栏「插件市场」入口                  │
│  main → 独立的「DSH 插件市场」页面                          │
│      页面内三个标签：全部插件 / 已安装 / 可更新              │
│  筛选、排序、分页、更新比对全部在宿主侧完成                  │
└───────────────┬─────────────────────────────────────────────┘
                │ fetch()  ← 不是动态插件的私有 RPC，也不是 ctx.remote
┌───────────────▼─────────────────────────────────────────────┐
│  宿主半边  index.js                                          │
│  ctx.inject(['webServer']) →                                │
│    GET  /dsh-plugin-market/list                             │
│    POST /dsh-plugin-market/install                          │
│    POST /dsh-plugin-market/reload                           │
│  子进程输出经**文件描述符**捕获（非管道、非 shell）           │
└───────────────┬─────────────────────────────────────────────┘
                │ spawn(node, [market-core.mjs, …])
┌───────────────▼─────────────────────────────────────────────┐
│  market-core.mjs（真实文件，可单独运行）                      │
│    catalog   抓取/缓存目录（官方 → 镜像 → CDN → npm）         │
│    installed 读 profile 依赖 + node_modules + 已装版本        │
│    install   优先用 DSH 提供的包管理器；CLI 回退到 pnpm       │
└─────────────────────────────────────────────────────────────┘
```

### 为什么用 HTTP 而不是 `ctx.remote`

浏览器半边要调用宿主能力，但 `ctx.remote.<ns>` 的方法来自 DSH 的 **Typert 代码生成** —— 本地手写的插件无法注册自己的命名空间（`ctx.remote.$mount()` 只接受生成的贡献）。 而 webserver 的命名路由注册是公开服务：

```js
ctx.inject(['webServer'], (host) => {
  host.webServer.register({ kind: 'exact', path: '…', handler: (req, res) => {} })
})
```

于是宿主暴露三条路由，浏览器半边用 `fetch` 调用。

### HTTP 接口

| 方法 | 路径 | 入参 | 出参 |
| --- | --- | --- | --- |
| `GET` | `/dsh-plugin-market/list` | `bypass, category, q, sort, only, limit, offset`（`only` 取 `all` / `installed` / `notinstalled` / `updatable`） | `{ ok, payload: { items, categories, count, total, matched, installedTotal, updatableTotal, unknownTotal, offset, sort, only, category, q, catalogFromCache, fetchedAt, catalogUpdated, source, note } }` |
| `POST` | `/dsh-plugin-market/install` | `{ install, name?, version?, update? }` | `{ ok, spec, seconds, log }` |
| `POST` | `/dsh-plugin-market/reload` | `{}` | `{ ok, warnings, pending, restartReason }` |

`items` 里的每个条目除了插件本身，还带 `installed` / `installedAs` / `installedVersion` / `update`。 `updatableTotal` 是可更新数，`unknownTotal` 是**判断不了**的数（目录里没有版本，或目录没收录已声明的 bundle）；普通 profile 依赖不计入。 更新判断只比对目录里的 `version`，不额外发任何网络请求。

`bypass=1` 是**唯一**的强制重新抓取旗标；只有「强制重新获取」按钮发它，其余调用都只做新鲜度检查。 三个标签都是**页面内的**：插件注册一个 `sidebar.panellist` 入口和对应的 `main` 页面，标签由页面自己渲染。

三条路由只接受**同源**调用（校验 `Sec-Fetch-Site` 与 `Origin`），安装和重载接口还要求 `Content-Type: application/json` —— 直接挂在 webServer 上的路由不受 DSH `/api` 那道 browser-trust fence 保护，所以插件自己拦。安装命令里的包名若以 `-` 开头会被拒绝 （它会成为 pnpm 的一个**选项**而不是包名）。

重载走 DSH 的 `hmr` 服务：`hmr.runExclusive(() => hmr.reconcileProfile())`，会把新装的 bundle 重新组合进运行中的 Loader 树。返回里的 `pending` 是仍需重启才能替换的模块， `restartReason` 是 profile 级重启原因；两者都为空才会自动刷新页面。安装进行中会拒绝重载。

## 包内容

```
package.json          声明 dsh.bundle.patch 与 dsh.client.platform
cordis.patch.yml      把自己插进 profile 的层栈
index.js              宿主半边：三条 HTTP 路由
market-core.mjs       市场逻辑（生成物，请勿手改）
client/client.js      浏览器半边：左侧栏入口 + 主区域页面 + 页内三个标签
```

`market-core.mjs` 由源生成后一并提交，所以 clone 下来即可安装，不需要任何构建步骤。

## 许可

[MIT](https://npmcn.com/package/%4099galaxy/dsh-plugin-market/LICENSE)

## 常见问题

### @99galaxy/dsh-plugin-market 是什么？

DSH QQ: 赞-dsh-plugin 从侧边栏浏览赞-dsh-plugin目录并安装插件\.

### 如何安装 @99galaxy/dsh-plugin-market？

在项目目录运行 npm install @99galaxy/dsh-plugin-market，或使用 pnpm add / yarn add / bun add。

### @99galaxy/dsh-plugin-market 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/99galaxy\_\_dsh-plugin-market 是否存在。

### @99galaxy/dsh-plugin-market 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @99galaxy/dsh-plugin-market 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.19。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @99galaxy/dsh-plugin-market 可以商用吗？

@99galaxy/dsh-plugin-market 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @99galaxy/dsh-plugin-market 的下载量有多少？

根据 npm 官方下载统计，@99galaxy/dsh-plugin-market 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,815 次，日均约 94 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @99galaxy/dsh-plugin-market 还在维护吗？

最新版本 1\.2\.2 发布于 2026/11/03（4 天前）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/09/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。