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 安装。安装时无需额外构建。
使用
- 打开 DSH 的「插件 → 增强管理」。尚未检查时会自动开始检查,先展示组合包清单,再逐项显示检查结果;也可点击「检查更新」手动刷新。
- 默认查看全部插件,可切换「可更新」「需处理」筛选,或按插件名称、来源搜索。列表显示当前版本、目标版本、启用状态、来源与更新路径。
- 点击行内「更新」更新单项;也可勾选项目后点击「更新所选」,或点击「更新全部可更新项」。全选仅选择当前筛选结果中可更新的项目。
- 更新失败时查看原因和恢复结果,处理后点击行内「重试」或「重试失败项」。
列表按状态分组,同组内按名称排序。检查、更新进度及成功和失败结果都会保留在默认列表中;「更新须知」可展开查看更新机制与注意事项。
更新单位为 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 元数据查询超时,单位为毫秒。原生版本查询使用官方管理器配置。 |
