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-*（按需安装）

快速导航

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

<a id="使用前须知"></a><a id="user-content-使用前须知"></a>

使用前须知

版本适配（只适配 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 安全章节。

<a id="最短上手"></a><a id="user-content-最短上手"></a>

最短上手

前提：已安装 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 访问与健康检查 验证。

<a id="插件列表"></a><a id="user-content-插件列表"></a>

插件列表

包名	功能	文档	状态
@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 · 架构图解	已发布

…