npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-plugin-enhance

v0.1.20

Published

Improve plugin management and batch archive workspace sessions.

Readme

插件增强 · Plugin Enhance

完善插件管理体验,支持按工作区批量归档会话。

为 DSH 的插件管理页增加「增强管理」标签页,支持检查更新、勾选批量更新、一键更新全部可更新项,以及重试失败项。优先复用 DSH 原生更新能力,为市场和 GitHub 来源提供扩展支持,包含英文与简体中文界面。

同一 bundle 内还提供可独立开关的「工作区批量归档」组件。

包名:dsh-plugin-enhance · DSH 兼容范围:>=0.2.2-rc.1 <0.3.0-0(开发与测试基准为 0.2.2-rc.1)。

允许后续 0.2.x 升级,DSH 兼容性检查也包含此范围内的预发布版本;0.3.0 及其预发布版本需另行验证。

安装

通过 DSH 官方插件管理器安装并启用。以 web profile 为例:

dsh plugin --profile web add dsh-plugin-enhance@latest

也可以按 GitHub 地址 github:urzz/dsh-plugin-enhance 安装。安装时无需额外构建。

使用

  1. 打开 DSH 的「插件 → 增强管理」。尚未检查时会自动开始检查,先展示组合包清单,再逐项显示检查结果;也可点击「检查更新」手动刷新。
  2. 默认查看全部插件,可切换「可更新」「需处理」筛选,或按插件名称、来源搜索。列表显示当前版本、目标版本、启用状态、来源与更新路径。
  3. 点击行内「更新」更新单项;也可勾选项目后点击「更新所选」,或点击「更新全部可更新项」。全选仅选择当前筛选结果中可更新的项目。
  4. 更新失败时查看原因和恢复结果,处理后点击行内「重试」或「重试失败项」。

列表按状态分组,同组内按名称排序。检查、更新进度及成功和失败结果都会保留在默认列表中;「更新须知」可展开查看更新机制与注意事项。

更新单位为 bundle(组合包):同一包中的多个插件会一起更新,并保留原启用状态;底层管理器可能改变插件选择顺序。更新队列串行执行。

原生与扩展更新

仅选择比当前版本更新、且兼容当前 DSH 的目标,不自动授予兼容性豁免。

| 路径 | 适用来源 | 目标与执行方式 | | --- | --- | --- | | 原生更新 | 官方管理器标记为可更新的 registry 组合包 | 使用官方 listVersions 查询版本,选择最新的兼容正式版,通过 updateBundle 安装;沿用官方 registry、认证、代理和兼容性策略。 | | 扩展更新 | 原生路径不适用且有市场目标的组合包 | 优先采用市场默认版本及其明确的安装目标,通过官方管理器卸载、安装。 | | 扩展更新 | 原生路径不适用且无市场目标的 GitHub 仓库 | 查询原来源对应分支、标签或 commit 的根目录 package.json,通过官方管理器卸载、安装。 |

通过 npm 安装、且被官方管理器标记为可更新的组合包,无需收录在插件市场中即可走原生更新。原生查询失败时显示原生错误,不会改走扩展路径。扩展路径市场读取失败时也会显示错误,不会静默切换到 GitHub。

GitHub 地址支持 github:owner/repo、owner/repo、GitHub HTTPS 和 SSH Git 地址,可带 #分支、#标签 或 #commit。查询使用本机 Git 的代理和认证配置,不执行仓库代码或构建脚本。

GitHub 更新以 package.json 的版本号为准,同时要求包名一致、声明 bundle 且兼容当前 DSH。相同版本下的 commit 变化不会触发更新。 更新保留原 ref,继续跟踪同一分支;固定标签或 commit 不会自动切换到默认分支。暂不支持 #semver:、子目录及其他 pnpm Git ref 扩展。

支持更新本插件自身,使用相同的来源和兼容性规则,并排在本批其他项目之后执行。重载期间增强管理标签页可能短暂消失;新实例会继续显示当前进程中的队列状态。若自身安装或激活失败导致标签页未恢复,可运行 dsh plugin --profile web add dsh-plugin-enhance@latest 重新安装(其他 profile 请替换 web)。

随安装附带的内置包、不可移除包、本地路径,以及无市场目标的非 GitHub Git、压缩包 URL 和 npm alias 来源不参与更新。市场明确提供的 Git 安装目标可以使用。

更新失败与注意事项

  • 更新不是原子操作。 原生路径由官方管理器执行:移除旧版本后,若目标安装失败或取消,管理器会尝试恢复旧版本。恢复也可能失败,应查看目标失败与恢复结果;恢复旧版不代表更新成功。
  • 扩展路径先卸载旧包再安装指定目标,不自动回滚。安装失败可能留下未安装的组合包;页面会保留目标,处理原因后可重试。
  • 扩展路径无 HMR 时,仅在管理器返回 stop-profile 的情况下直接覆盖安装,并提示是否需要重启;其他卸载失败不会继续安装。原生路径遵循官方管理器的处理结果。
  • 待授权构建脚本、安装失败、激活失败或实际版本不符均不会显示为成功。构建脚本需通过官方插件管理器另行授权,本插件不会自动授权或重启 DSH。
  • GitHub 分支可能在检查与安装之间前进;如果实际安装版本与检查目标不符,会报告失败。
  • 本插件的重试队列只保存在当前进程中,重启后会丢失,不承诺跨进程恢复。此时可使用官方管理器按原包名安装所需版本。
  • 更新前会核对来源、版本及启用状态是否变化。执行更新期间,请避免同时从其他入口管理同一包。

模型工具

可以让 DSH 中的智能体使用 plugin_enhance 检查和执行更新,结果与网页共用同一更新队列,采用相同的原生优先规则。

| 操作 | 用法 | | --- | --- | | check | 检查更新,返回候选列表和 generation。 | | status | 查看队列进度与结果,包括原生更新的恢复阶段。 | | start | 使用 check 返回的 generation 及包名数组 names 启动更新。 | | retry | 重试指定 names;省略时重试所有可恢复项。 |

工具遵守 DSH 的完整访问权限与审批机制,未获授权时不修改 profile。

工作区批量归档

在侧栏工作区标题的菜单中选择「批量归档会话」,勾选该工作区中的会话后执行归档。运行中的会话不可选;执行时会重新检查状态,并逐项显示成功、跳过和失败结果。

归档复用 DSH 原生能力,不强制停止运行中的任务。可在插件组件列表中单独开关「工作区批量归档」,不影响插件更新。

会话查询迁移

跨工作区会话查询已迁至 dsh-search-plugin,本包仅保留插件更新与工作区批量归档。本节适用于包含此次迁移的版本;升级前请确认目标版本已包含新查询组件,再按 dsh-search-plugin README 的迁移入口操作。

| 项目 | 旧标识 | 新标识 | | --- | --- | --- | | 模块入口 | dsh-plugin-enhance/session-query | dsh-search-plugin/session-query | | 隔离 group | dsh-plugin-enhance-session-query | dsh-search-session-query | | 查询子组件 | dsh-plugin-enhance-session-query-tool | dsh-search-session-query-tool |

迁移前先记录旧 group 和子组件的 disabled 状态、子组件配置的 timeoutMs(默认 30000),再停用旧查询组件。在新组件启用前恢复这些配置与状态,原来禁用的组件仍应保持禁用。工具名 session_search_enhance、session_event_read_enhance、session_query_enhance 保持不变,不要同时启用两份同名工具。本次不自动修改用户 profile。

配置

在对应插件条目的配置中覆盖以下字段:

| 组件 | 字段 | 默认值 | 说明 | | --- | --- | --- | --- | | dsh-plugin-enhance | lookupTimeoutMs | 20000 | GitHub 元数据查询超时,单位为毫秒。原生版本查询使用官方管理器配置。 |