dsh-plugin-hub

精选清单收录维护状态: 活跃

wingsky-1/dsh-plugin-hub

DSH（DeepSeek Harness）Web GUI 插件合集：通知、provider 用量、局域网代理、MCP 管理器、空闲归档、文件预览。安装：dsh plugin --profile web add @wingsky-1/dsh-plugins-all

前往 GitHub

$ dsh plugin add dsh-plugin-hub

安装

dsh 没有统一的安装命令——把该插件 README 中的配置行加入你的 profile/patch 配置，然后重启即可。

了解安装方式

星标

Fork

TypeScript

语言

MIT

许可证

2026-08-16

创建于

2026-11-04

README

dsh-plugin-hub

简体中文 | English

维护状态：有限维护

我目前已暂时停止使用 DeepSeek Harness，本项目转入有限维护阶段。后续优先评估用户反馈的可复现缺陷，尤其是安全、数据完整性与核心功能问题；上游 rc 版本适配按实际需求、改动成本和个人精力评估，不保证逐版跟进，也不承诺固定的响应、修复或发布时间。

新功能、全面重构与 1.0.0 重写计划暂时搁置。仓库与已发布包继续保留，欢迎社区修复、fork 或讨论接手维护；PR 按精力评审，不保证及时合并。兼容范围以本 README 和对应发布说明为准，不承诺 alpha 兼容。

完整说明与交接讨论见维护状态公告。

DSH（DeepSeek Harness）Web GUI 插件集，npm 分发：一键装全家桶，或按需单装。

聚合包：@wingsky-1/dsh-plugins-all（一键装齐全部插件）
单插件：@wingsky-1/dsh-*（按需安装）

快速导航

使用前须知 · 最短上手 · 插件列表 · 常用配置与维护 · 验证与排障 · 详细参考 · 开发与架构

使用前须知

版本适配（只适配 rc）

本插件集当前只适配 DeepSeek Harness 0.2.1-rc.2。

pnpm-workspace.yaml 的官方类型层 catalog 是权威版本事实源；各包 peerDependencies 是维护流程生成的精确版本投影，锁定 dsh 0.2.1-rc.2；其他 DSH 版本不在本轮支持范围
安装/更新时若 DSH 版本不匹配，npm/pnpm 会给出 peer 提示——先发布/安装与目标 DSH 精确匹配的插件版本，再切换 DSH 本体；不要用 allow-version 绕过不兼容
每版的具体适配基线、破坏性变更与升级指南见 Release Notes
catalog 更新前，不对 alpha、旧 runtime 或其他版本作兼容承诺

独立安装与全家桶：二选一

独立包与聚合包的 patch id 相同（dsh-*）。请只选一种安装方式—— 同时装 dsh-plugins-all 与任一 @wingsky-1/dsh-lan-proxy 等独立包会导致同名 entry 重复，dsh web 启动时报 duplicate 错误（可发现，不代表损坏）。需要调整时：卸载聚合包，或卸载对应独立包，重启即可。

逐插件安全说明

dsh-lan-proxy 装完即在 0.0.0.0 开放 HTTP/HTTPS 端口，局域网所有设备可访问你的 dsh——不需要时请卸载
dsh-lan-proxy 的启动令牌自动注入（injectToken）默认开启：局域网内任何能访问该端口的设备免 token 获得完整 dsh 控制权（等效信任整个局域网，bash 直通宿主机）——仅在可信内网开启，不可信网段务必在设置卡片关闭
dsh-mcp-manager 的 stdio 子进程继承宿主权限，只配置可信的 MCP 服务器
插件管理路由有 loopback 围栏（非回环 403 / 方法错 405）；经 dsh-lan-proxy 转发的请求按设计视为受信，并不隔离局域网客户端。
dsh-notifier 自持配置文件；设置响应掩码频道凭据，但通知正文与出口错误详情不打码，可能进入日志、历史与推送服务。
dsh-provider-usage 的 API 密钥留在宿主端，不进浏览器。
dsh-verify-isolated 使用临时 DSH_HOME、独立 profile、端口与浏览器实例；这是验证隔离边界，不是全局安全承诺。

各插件的威胁模型与加固细节见其 README 安全章节。

最短上手

前提：已安装 DeepSeek Harness 且 dsh web 可正常启动（未全局安装 dsh 见下方「未全局安装 dsh」）。

安装插件（add）

# 一键装全家桶（推荐）
dsh plugin --profile web add @wingsky-1/dsh-plugins-all

# 或单独安装（按需）
dsh plugin --profile web add @wingsky-1/dsh-notifier
dsh plugin --profile web add @wingsky-1/dsh-lan-proxy

安装 / 卸载 / 更新后都需重启一次 dsh web（bundle 层只在启动时组合），侧边栏/设置页才反映变化。

访问与验证

重启 dsh web，打开启动时给出的 URL，在「设置 → 插件」确认已安装插件的卡片。notifier 可发送测试通知；局域网访问按 lan-proxy 访问与健康检查验证。

插件列表

包名	功能	文档	状态
`@wingsky-1/dsh-notifier`	浏览器、宿主 toast、Bark 与 Webhook 任务事件通知。	README · 架构图解	已发布
`@wingsky-1/dsh-provider-usage`	支持自定义适配器的多 provider 用量、趋势与报告。	README · 适配器开发指南 · 架构图解	已发布
`@wingsky-1/dsh-lan-proxy`	带 TLS、压缩与保活的局域网 HTTP/HTTPS/WebSocket 转发。	README · 架构图解	已发布
`@wingsky-1/dsh-mcp-manager`	按工作空间管理 MCP 配置与中间层工具接入。	README · 架构图解 · 升级修复	已发布
`@wingsky-1/dsh-verify-isolated`	为 DSH 插件开发提供隔离环境浏览器验证。	README · 架构图解	已发布

常用配置与维护

在「设置 → 插件」进入对应卡片；各插件的配置与存储边界不同，请按对应 README 操作。

卸载插件（remove）

dsh plugin --profile web remove @wingsky-1/dsh-notifier

更新插件（update）

# 更新单个插件到最新
dsh plugin --profile web update @wingsky-1/dsh-notifier

# 更新全家桶（聚合包 + 其拉齐的子包）到最新
dsh plugin --profile web update @wingsky-1/dsh-plugins-all

# 更新当前 profile 下全部插件
dsh plugin --profile web update

安装 / 卸载 / 更新后都需重启一次 dsh web（bundle 层只在启动时组合），侧边栏/设置页才反映变化。

验证与排障

安装后未出现插件时先重启 dsh web；出现 duplicate entry 时，检查是否同时安装聚合包与独立包。

升级后历史会话打不开？ 当前版本只写 producer-owned V4 source。旧插件留下的历史产物不属于业务兼容范围，需先用维护脚本修复 source 元数据：
# 落盘前先停 dsh web；正在写入的日志不保证可安全重写
node scripts/maintenance/repair-mcp-catalog-sessions.mjs          # 预演
node scripts/maintenance/repair-mcp-catalog-sessions.mjs --apply  # 落盘并自动备份，随后重启 dsh web
详见升级与历史会话边界 · issue #723

升级与历史会话边界（mcp-catalog）

当前 dsh-mcp-manager 只生成 producer-owned V4 source： kind: "plugin:@wingsky-1/dsh-mcp-manager"。业务代码不提供旧 V0/V2/V3 parser，也不承诺旧格式兼容。

历史 mcp-catalog source 属于一次性维护边界。脚本只把旧 source 元数据修为 V3 wrapper，保留消息正文与事件序列；它不写 V4，也不实现 v3→v4 迁移。修复后由目标 dsh（版本见 catalog）的官方迁移链依次恢复并转为 V4，当前 V4 产物不动。执行前先停止 dsh web，先用默认预演模式核对，再加 --apply 落盘。

详见 dsh-mcp-manager README。

详细参考

功能详解

在 GitHub 阅读完整 README →