DSH-PackForge/dsh-pack-plugin

Project Overview项目介绍

DSH-PackForge/dsh-pack-plugin is a DSH-native pure Plan-B bundle plugin that ships as a self-contained npm package named @dsh-packforge/dsh-pack-plugin, built exclusively for the official DeepSeek Harness desktop client. It is loaded through the stock bundle mechanism by appending host entries to cordis.patch.yml and client entries to dsh.client, so the underlying apps/desktop and apps/desktop-host source trees remain untouched. The plugin only consumes DSH's own runtime services (ctx.connection, ctx.webServer, ctx.slots, ctx.locale, ctx.profileContext) plus fflate for ZIP packaging, and it vendors every remaining dependency under src/core/ and src/host-node.js instead of pulling any @dsh-packforge/* engine package.

Its core capability set covers exporting a profile (or, internally, a whole dshhome snapshot) into a single-file .dspack, installing packs from local files, HTTP(S) URLs or the bundled marketplace, verifying each pack with sha256 + size, browsing the index.json light-weight market index with lazy-loaded full manifests under packs/<owner>.<repo>/, switching between multiple profiles by repointing the profiles/desktop junction and the per-profile skills / .agent-presets slots, and persisting per-profile workspace settings as a single UTF-8 JSON file called .dshpkcfg. A non-blocking task center streams install / export / create progress (phase timeline plus process output) from an in-memory registry exposed via task/list and task/get. Typical users are operators who want to snapshot, share or swap whole DSH environments between machines; the plugin is UI plus backend only and deliberately performs no AI-driven pack-management decisions of its own.

First-run engineering flow is plain Node work: run pnpm install, then pnpm test (node --test unit suite covering profile junction repointing, the skills / .agent-presets isolation, and end-to-end migration) and finally pnpm bundle to emit lib/client.js for the renderer via esbuild. An RPC channel named /dsh-pack is mounted by the host through ctx.webServer (a frontend route guarded by ctx.connection), while the client side calls it through a silent rpc.call wrapper that emits no chat-bar tool invocations. The plugin is dual-licensed under MIT and targets Windows-class junction semantics with an explicit red line: always unlink junctions rather than rm -r, because recursive removal on Windows would delete the target directory contents. Current limits: only the profile form of .dspack export is wired into settings UI even though the dshhome pack/install/verify logic already lives in core, so end-to-end export and install still await a real profile plus pnpm environment for full validation.

DSH-PackForge/dsh-pack-plugin 是一个面向 DeepSeek Harness 桌面端的原生纯方案 B bundle 插件,自包含为独立 npm 包 @dsh-packforge/dsh-pack-plugin,通过 cordis.patch.yml 注入 host 插件、由 dsh.client 注入 client 插件。核心能力是为 .dspack 整合包提供导出、本地/URL/市场安装、sha256+size 校验、多 profile 切换(junction 换指 + 首次迁移脱管 helper)、市场浏览、.dshpkcfg 工作区配置以及非阻塞任务中心,全部挂在自建 /dsh-pack 前缀路由上。

典型工作流是先在设置面板创建或选择一个 profile,从本地文件、URL 或市场选中 .dspack 触发 install,任务中心显示阶段时间线与进程输出;导出时选定 profile 即可打成单文件包。目标用户是希望把整套环境(含 skills、.agent-presets)打包、跨机器分发或在多套配置间秒切的使用者,UI 只做编排,不做任何 AI 驱动的整合包管理决策。

运行时仅依赖 fflate 做 ZIP,其他依赖全部 vendor 进 src/core 与 src/host-node.js;不依赖任何 @dsh-packforge/* 引擎包,工程命令为 pnpm install、pnpm test、pnpm bundle。当前 UI 仅暴露 profile 形态导出,dshhome 形态的打包/安装/校验逻辑已在 core 中就绪但未在设置面板接线,export/install 端到端仍待真实 profile + pnpm 环境验证。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 24 stars - an early-stage project星标 24,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:DSH-PackForge/dsh-pack-plugin

把 DSH-PackForge/dsh-pack-plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

@dsh-packforge/dsh-pack-plugin

整合包必备 Essential for packs

DSH 整合包(.dspack)的纯方案 B 插件 bundle:一个自包含的独立 npm 包,注入官方 DeepSeek Harness 桌面端,提供 .dspack 导出 / 安装 / 多 profile 切换 / 市场浏览 / 工作区配置 / 任务中心。只做 UI + 后端,不做 AI 驱动的整合包管理。

  • 零官方源码改动:不改 apps/desktop / apps/desktop-host。
  • 零第三方插件:只依赖 DSH 出厂运行时服务(ctx.connection / ctx.webServer / ctx.slots / ctx.locale / ctx.profileContext)。
  • 自包含:运行时依赖仅 fflate(ZIP)+ proxy-agent(下载代理),其余全部 vendor 进仓库(src/core/、src/host-node.js),不依赖 @dsh-packforge/* 引擎包。
  • 加载方式:官方 bundle 机制——cordis.patch.yml 插入 host 插件,dsh.client 注入 client 插件。

完整设计见 dsh-packforge-app/docs/dsh-pack-方案.zh.md;格式契约见 specs/。

能力总览

  • 导出 .dspack:把某个 profile 打包成单文件整合包(profile 形态),或从源仓库导出(exportRepo)。UI 目前只暴露 profile 形态;dshhome(整机)形态的打包 / 安装 / 校验逻辑在 core 里就绪,未在设置面板接线。
  • 安装 .dspack:本地文件 / URL / 市场包均可;按 sha256 + size 校验完整性,pnpm 重建依赖并对账,home 级 resources 与 files[] 逐项下载落位。
  • 多 profile 切换:profiles/desktop 是激活指针(junction 换指),切换即换指 + 重启桌面,无需重装。
  • home 级 skills / .agent-presets 隔离:per-profile 槽位(junction),换 profile 时一并换指(见下文)。
  • 市场浏览:index.json 精简指针 + packs/<owner>.<repo>/ 懒加载完整清单 / README。
  • 工作区配置 .dshpkcfg:每个 profile 一份,保存 / 读取 / 自动回填。
  • 下载代理:About 页可配代理地址(存 config.proxy,覆盖一切);未配时依次回落环境变量(HTTP_PROXY / HTTPS_PROXY / ALL_PROXY / NO_PROXY)与 Windows 系统代理(含 ProxyOverride 旁路)。支持 http / https / socks / socks5,市场索引 / 包详情 / .dspack 安装 / npm 拉取统一生效。
  • 任务中心:install / export / create 非阻塞执行,设置面板内嵌视图显示阶段时间线与进程输出。

架构

host 侧(Node)                              client 侧(浏览器 bundle)
src/index.js  ─┐                             src/client.js  ── bundle ──► lib/client.js
src/rpc.js     │ registerRpc(ctx, runtime)   src/client-plugin.js(dspackforge)
src/endpoints.js  → ctx.webServer 挂 /dsh-pack 前缀路由
src/channel.js ┘                             src/client-rpc.js(rpc.call 封装)
src/profiles.js / junction.js                src/settings.js(slots 设置页:管理/导出/市场)
src/migrate.js / migrate-helper.js           src/progress.html
src/ensure-manager.js / tasks.js / progress.js
src/core/(vendored 引擎)                    src/locale(可选)

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-milestone 下一个 Next dsh-file-upload →