DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

Vesna-Strivozha-cn /

Vesna-Strivozha-cn/dsh-modpack-kit

Verified

DSH 也要整合包:把多个 DeepSeek Harness 插件打成 .dshpack 一次装好;打包强制查敏感信息与风险代码,安装前校验完整性与兼容性。

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@2c9eaa23

dsh-modpack-kit(DSH 整合包)

为 DeepSeek Harness 提供类似 HMCL / PCL 这类「我的世界启动器」的整合包打包与安装能力:把多个插件连同各自的配置与数据打成一个 .dshpack,一次安装到位。

  • 懒人包与轻量包:懒人包(完整包)自带插件本体,目标机器只需安装 DSH 本体,按包内 README.txt 或 install/ 独立安装器即可完成安装;轻量包只记录插件名与版本,安装时按记录从插件市场取包,体积更小。两种包都附独立安装器。
  • 逐插件定制:每个插件单独选「基础配置」(上游原版代码 + 插件默认配置)或「本地改动」(本机的代码、配置条目、数据快照),同一个整合包里可以混用。
  • 配置与数据保真:配置按原结构回填到 cordis.patch.yml,只改目标条目、其它字节保留;数据快照写回 ~/.dsh/<目录>/,默认不覆盖本机已有文件。疑似凭据替换为 ${REDACTED},其余自定义项原样保留。
  • 打包前强制检测:对敏感信息与风险代码做静态扫描,命中只留掩码、原文不落盘;高风险停在「等决定」,确认后在同一任务里从检测点续跑。安装前再校验 sha256 完整性、兼容性与许可证。
  • 与插件市场同步版本:分类、搜索、分页与条目来自市场目录(首屏只列已安装插件);本机插件若在市场有同名条目,可切换市场版本打包,联网安装时也可优先按市场版本取包。
  • 三处入口:设置页、侧边栏、插件页内各一个独立开关,改动即时生效;至少保留一处,最后一个不可关闭。

建议先安装插件市场(dshmarket)以启用完整的发现能力,但不是必须:不装也能打包、装包、检测与回填配置,差别见下文「与插件市场:联动,以及没有它时差在哪」。

项目地址:https://github.com/Vesna-Strivozha-cn/dsh-modpack-kit —— 如果它省了时间,欢迎在仓库点个 Star。

安装

在已装 DSH 的机器上:

dsh plugin --profile desktop add dsh-modpack-kit

也可以从 GitHub 直接装(不经过 npm):

dsh plugin --profile desktop add github:Vesna-Strivozha-cn/dsh-modpack-kit

装完重启 DSH,左侧栏出现「整合包」。

与插件市场:联动,以及没有它时差在哪

建议先装插件市场(dshmarket),但本插件不依赖它。 装不装都能用,区别只落在「发现与取包」这一层。

联动的地方

  • 目录同源:直接读插件市场自己的目录包 dsh-plugin-catalog(先走 CDN 的 index.json,取不到退回 npm tarball),23 个分区、条目数、排序规则都跟市场一致;市场没装也能用,只是少了它的界面。
  • 安装同路:都走 dsh plugin --profile <p> add,两边装的插件互相可见,不需要各记一份状态。
  • 已装插件会用目录补齐描述与分区,标出「市场版 vX」以及是否有更新;同名条目行末出现「(切换市场版)」。
  • 三处入口里「插件页内」那一栏,跟市场的 Discover 栏并排,互不占位。

有市场 / 没市场对照

能力 装了插件市场 没装插件市场
打包(完整版 / 轻量版)、强制安全检测 ✅ ✅ 完全一样,全在本地跑
装包、完整性校验、兼容检测、许可证检查 ✅ ✅ 一样
配置回填、装好先不启用 ✅ ✅ 一样
侧边栏 / 设置里 / 插件页内三处入口 ✅ ✅ 一样(这些槽位是 DSH 核心声明的,不是市场插件)
分类胶囊、搜索、服务端分页 ✅ ✅ 只要建过一次目录索引就行(5~30 秒,看网络)
已装插件补齐描述、分区、市场版版本 ✅ ✅ 建过索引后一样
「(切换市场版)」按上游原版打包 ✅ ✅ 建过索引后一样
轻量包安装时按版本取包 ✅ ✅ 只要有 npm registry 网络
市场 Discover 栏、市场自己的更新入口 ✅ ❌ 没有(用本插件或 dsh plugin 装同一个包即可)

没索引、也没网时会怎样(这种情况页面会明说,不会静默装错)

  • 首屏照旧只列本机已装插件,打包与安装不受影响。
  • 分类胶囊只剩「全部」,已装行的分类退回内置兜底规则,与市场 23 类的 id 不完全对得上——按 theme / memory 之类筛会漏几条。点「建立目录索引」跑一次就恢复。
  • 搜索、市场版版本对比、「(切换市场版)」按钮不出来。
  • 轻量包装不了(它不带源码,必须联网按清单里的版本取包);完整版照装。

分类、搜索与分页

  • 分类就是插件市场的 23 个分区(全部 / AGI 架构探索 / UI 增强 / 用量与计费 / 主题与外观 / 模型与账号接入 / 身份与通信 / 会话与消息 / 记忆 / 工具与能力 / WSL 与 Windows 互操作 / 浏览器与网页 / 视觉与多模态 / 语音与音频 / 文档与渲染 / 技能包 / 工作流与自动化 / Git 与代码评审 / 通知与集成 / 开发与运行时 / 安全与权限 / 远程与移动端 / 插件市场与管理 / 娱乐),名字和条目数都从市场目录里读。
  • 首屏只列本机已装的插件,不联网、不卡顿。搜索框右侧提供「全部加入」(一次选中本机已装全部插件,均按「基础配置」)与「清除选择」。输入关键词或点分类才去目录里搜,结果是服务端分页,一页 20 条(设置里可改),底部「加载更多」再取下一页。
  • 排序照抄市场的规则:已装优先,再按相关度(整字段命中 > 包含 > 其它词;包名权重最高,其次所有者、仓库,描述与分类最低),同分保持目录原序。本机独有、目录里没有的插件也能被搜到。
  • 本机已装的插件如果在目录里有同名条目,行末会显示小字「(切换市场版)」:选择后改用上游原版代码 + 默认配置打包,结果与从插件市场安装一致;再选一次「(切回本机版)」恢复本机快照。同名不代表一定是同一个插件,因此默认仍打包本机那份。

显示位置(三处独立开关)

设置页底部三个开关,各自独立,改了立刻生效,不用重启:

开关 显示在哪
在设置里显示 设置页内一栏「整合包」(含插件的插件设置 tab)
在侧边栏显示 左侧栏「整合包」入口
在插件页内显示 插件的插件页里,跟插件市场同一位置,单开一栏「整合包」

三个全关会被拒绝(POST /settings 返回 400)——否则就再没有入口能把它关回来了;只关侧边栏是允许的,那时从设置页进。

逐插件:基础配置 / 本地改动

打包时每个插件可以单独选:

  • 基础配置:上游原版代码 + 插件默认配置,不含本地改动(按版本从 registry 重新下载并校验 sha512)。
  • 本地改动:本机当前的代码、配置条目与数据快照一并打包。

选中某个插件后,行内才会出现「基础配置 / 本地改动」两个按钮,默认是「基础配置」;结果里会标明每个插件实际用了哪种。搜索框右侧另有「全部加入」(把本机已装的全部插件一次加入选择)与「清除选择」。

两种包

版本 内容 适用
完整版 full 清单 + 插件文件 + 配置 + 检测报告 目标机器未安装本插件时也可按包内 README 安装;离线可用
轻量版 lite 清单 + 配置 + 检测报告 体积小,安装时联网按版本取包

两者都带 integrity.json(sha256)、security/report.txt 与不依赖本插件的手工安装说明。

两种包都额外带一个独立安装器 install/(install.mjs + Windows 的 install.cmd + shell 的 install.sh),所以一台干净到只剩 DSH 本体的机器也能装:

# 解压后进包目录,任选其一
./install.sh                      # 或双击 install.cmd(Windows)
node install/install.mjs --profile desktop
node install/install.mjs --profile desktop --dry-run      # 只看要做什么
node install/install.mjs --profile desktop --no-bundles   # 装文件但不启用
node install/install.mjs --dsh "「DSH 安装目录」/DeepSeek Harness.exe"  # 指定 DSH 可执行文件

安装器只依赖 node 与 dsh 命令:先找 --dsh/DSH_CLI,再找 PATH 里的 dsh,最后试常见安装路径;完整版会先把插件复制到 ~/.dsh/dsh-modpack/vendor/<包名>-<短hash>/ 再装(这样解压目录删了也不会断),轻量版按 name@version 从 npm 取。装完把 configs/ 里的条目并进 profile 的 cordis.patch.yml,最后提示重启 DSH。它不会自动执行任何包里带的脚本。

目标目录固定是本机的 ~/.dsh:DSH 的命令行只认自己的家目录(实测不认 DSH_HOME / USERPROFILE),安装器不去猜别的位置。--profile 写一个没建过的名字也行,DSH 会在第一次装插件时自动初始化它。

开发

EXE="/d/大肥鱼/DeepSeek Harness.exe"
# 单测 / 宿主路由 / 联网烟测
ELECTRON_RUN_AS_NODE=1 "$EXE" test/run.mjs
ELECTRON_RUN_AS_NODE=1 "$EXE" test/host-smoke.mjs
ELECTRON_RUN_AS_NODE=1 "$EXE" test/live.mjs
# 改完源码:同步到 profile 副本(file: 依赖是硬链接拷贝,cp 会 EBUSY)并校验
ELECTRON_RUN_AS_NODE=1 "$EXE" dev/tools/sync.cjs
ELECTRON_RUN_AS_NODE=1 "$EXE" dev/tools/verify.cjs

本机没有独立的 node:用 ELECTRON_RUN_AS_NODE=1 借 DSH 自带的 Node 跑脚本。

dev/tools/sandbox-e2e.mjs 是端到端演练:从本机挑一个真实插件打包 → 读回校验 → 装进临时 profile modpack-sandbox-tmp(先不启用)→ 断言依赖写入、bundles 仍为空、desktop profile 逐字节未变 → 最后删除临时 profile 与临时目录;全程不修改 desktop profile。

dev/tools/e2e-suite.mjs 是整套流程自测:随机挑本机 3 个插件(SEED=xxx 可复现)→ 打包 full(混合「基础配置 / 本地改动」)→ 读回校验清单与完整性 → 篡改一个载荷确认会被抓住 → 「有插件」路线用 installPack 装进临时 profile → 「无插件」路线解压后跑包内独立安装器(--no-bundles)→ 轻量版按版本从 registry 取包再装 → 最后清理 3 个临时 profile、vendor 新目录与临时目录,并用 sha256 确认 desktop 的 package.json 与 cordis.patch.yml 一字未动。

dev/tools/risk-e2e.mjs 专测风险流程:市场查不到的高危包停在 paused 可删可确认、市场收录的高危包确认后在同一任务里续跑出包。

装插件优先交给宿主的插件管理器(pluginManager.installBundle,和 dsh plugin add 同一套 pnpm 实现,失败会自己回滚 package.json 与锁文件),管理器不可用或报错时自动退回命令行,两种路径都会写进 dsh-modpack.log(via=manager / via=cli)。

dev/dsh-refs/ 是官方插件文档的本地参考副本,不参与发布(files 里没有 dev)。dev/tools/check-categories.mjs 只读核对分类分布与「哪些已装插件在市场里有同名条目」。

安全检测

  • 打包前是强制的,关不掉:设置与包选项里的开关照常显示,但点击只会弹出一行红字提示(文案为「你想干什么」),五秒后消失;即使直接调用 API 写入 scanBeforePack: false,服务端也会强制改回 true,buildPack 中没有跳过扫描的分支。
  • 安装前各一次,静态读文本,不执行任何代码(安装前扫描仍可在设置里关,但默认开)。
  • 规则覆盖:私钥、云厂商/代码托管 token、模型 key、Cookie 与会话字段、邮箱/手机号/身份证、内网 IP、本机路径;curl|sh、powershell -enc、eval、可疑长 base64、关闭证书校验、安装脚本等。
  • 命中原文不落盘:报告只留规则名、文件、行号与掩码;同一文件同一行同一规则只记一条(一个文件里反复出现的 exec( 不会刷成几十行)。
  • 高风险一律先停下来等确认:不论插件能否在本地市场目录里查到,检出高危都停在「等决定」,打包页下方按插件列出命中项;点「我知道在干什么」会在同一个任务里从检测点接着跑完(不重新收集、不重复扫描),确认状态写进清单 security.acknowledged。不想继续就删掉那条记录,不会在本地留下半成品。
  • 目录里能查到的插件,提示语会说明「这批风险来自市场已收录的发行包」;查不到的会提示「这是本机插件,市场里没有对应条目,请自己确认来源」——区别只在措辞与清单里的来源标注,出口是同一条路。
  • 轻量包在「下载完、真正安装前」还会对本机刚取下来的代码补扫一遍,高危同样阻断(不是只信清单里那份报告)。
  • 包内 integrity.json 缺失或清单对不上,一律阻断(要显式 force)。
  • 解压有体积、压缩比与条目数上限,解压时还按声明长度卡输出(防 zip bomb),拒绝路径逃逸、符号链接、加密条目。
  • 只允许 https 与白名单域名下载,逐跳校验重定向。
  • 命中按来源分栏:每个插件一组、配置快照一组、数据快照一组,整合包自身的清单与安装器单独一组;整个列表可折叠,每一组也能单独折叠,带高/中/低计数(高危的组排在最前)。
  • 配置快照里疑似凭据当场擦掉:勾了「包含配置」时,键名归一化后正好是 apiKey / token / secret / password / cookie / sessionKey 这类字段,值会被替换成字面量 ${REDACTED}(apiKeyEnv 这种「环境变量名」不算,不会被误伤);值里出现 sk-、ghp_、xoxb-、AKIA 这类明文也一并替换。擦了几处、擦在哪个路径会写进配置快照的说明里——导入方要自己重填,包本身不带密钥。

打没装的插件

搜索框在插件市场目录里查到的条目,本机没装也能直接勾选打包:这类条目打的是「市场来源」——打包时按版本从 registry 取包(默认取那一条的当前版本,想钉别的版本就在版本框里写),包内清单记 source: "npm",安装时同样从市场按版本下载。

  • 「本机 / 市场 · 未装」标签区分来源;已装的行才有「基础配置 / 本地改动」与「(切换市场版)」。
  • 没装的插件没有本机代码可打,所以永远是「基础配置」语义(上游原版 + 插件默认配置)。
  • 许可证仍按允许列表校验:市场条目的 license 不在列表里时,需要勾「我确认……有权再分发」才会出包。

用「打开文件」的方式挑包,或自己挑目录

安装页不再只认插件自己的 packs 目录,也不用先知道路径:

  • 选择文件…:安装页有「选择文件…」按钮,弹系统文件选择器(只列 .dshpack),选中即读取。
  • 浏览文件夹…:目录那一行有「浏览文件夹…」按钮,弹系统目录选择器;选完目录会自动列目录内容,再勾文件即可。也可以直接在输入框里手写路径,两种方式并存。
  • 自己挑目录:填入任意目录(例如某个下载目录)后点「读这个目录」,列出该目录下的 .dshpack;选中后按绝对路径读取。点「回到默认」回到插件自己的 packs。
  • 已导入的整合包:用文件选择器或上面的方式读过的包,会留在「已导入的整合包」列表里(最多 8 份同时保留),每张卡片写着打包时的名字、作者、生成时间和描述,可以直接点「选择」切到那一份,或「移除」。列表在内存里,退出程序就清空。
  • 读取走的是 POST /pack/drop:默认发送原始字节(上限 256 MB);若环境不允许带二进制体的 POST,界面会自动退回 base64 的 JSON 重发一次,服务端两种格式都接收。目录列举走 POST /packs { dir }。两者都不写入磁盘,只有执行安装时才会修改 profile。
  • 拖拽已经去掉(外壳自己会接管文件拖放,容易两边都读不到)。

安装:也走进度、已装的先跳过、装完再决定换不换

安装现在和打包共用左下角那个进度窗:读包 → 校验完整性 → 扫描 → 逐插件装 → 登记启用清单 → 回填配置,百分比一路走完;任务同样能终止,也能和打包同时跑。

本机已经装过的插件会先跳过。 判定按插件名,不按版本——同名的、以及同一个插件但版本不同的,都算「已有」;其余插件照常装完。装完后界面上会列出这些被跳过的插件(本机版本 → 包内版本),给两个选择:

  • 直接完成:保留本机那几份,什么都不覆盖;
  • 替换为包内版本:只把列出来的那几个换成包内版本(没列出来的不动)。

轻量包(不含插件本体)走的是同一条路:打开时先从 registry 按版本取包,再按上面的规则装。

联网且插件市场存在同名条目时,优先按市场版本安装。 这是安装页上的一个开关(默认开启,对应设置项 preferMarketOnInstall):能查到就安装 名字@版本,代码来自 registry;查不到、离线、或关闭该开关时,按包内附带的版本安装。每个插件的动作记录都会标明本次走 market 还是 pack。

裸 DSH 那一侧(包里自带的独立安装器)同样默认跳过已装的插件:装的时候它会依次打印「跳过 xxx:本机已装 y」,装完再汇总列出「以下 N 个插件本机已经装了……要换成包内版本,重跑并加 --replace」:

node install/install.mjs --profile desktop              # 跳过已装的,其余照装
node install/install.mjs --profile desktop --replace    # 本机已装的也换成包内版本

打包进度与并发

点「打包」后不会卡住页面:任务转到界面的悬浮窗(默认在右下角),同一行显示当前在做什么(收集文件 / 读取插件 / 抓配置快照 / 安全检测 / 写入清单 / 压缩)与百分比,下面是进度条。点开悬浮窗能看到每个任务各占一行(标签、状态、进度条),进行中的任务带「终止」按钮;终止只在内存里停下,不会在本地留下半成品文件。

任务在安全检测阶段命中高风险时会停在「等决定」,打包页下方按插件分别列出命中项(每个插件一组:文件名、行号、规则名、级别,附高/中/低计数)。组内提供「我知道在干什么」:选择后忽略这批风险,在同一个任务里从检测点继续——进度不回退、不重新收集文件、不会再次扫描,清单记为 acknowledged,红字警告随之撤掉(该记录之后只显示状态与进度)。市场收录的插件与本机插件走同一条路径,仅提示措辞说明风险来源。不作选择时任务保持原位,记录可删除。

  • 已收尾的任务右侧提供「删除该进程」,将该条记录从列表移除;进行中的任务只有「终止」。
  • 标题栏的「清空进程」一次清除所有收尾记录——完成、失败、取消,以及「超过打包上限」这类中途报错卡住的记录一并带走;进行中的与停在风险点的保留。
  • 失败行会以红字显示原因,便于判断是哪个插件体积过大。清空后,打包页上对应的失败提示同时消失。
  • 若无响应,说明宿主仍是旧代码;界面会自动改为逐条删除。安装任务无需手动清理:结果写入安装页后会自动从进度窗移除。
  • 收尾记录自动过期:失败与取消保留十余秒;完成的按设置 jobKeepSeconds(默认 60 秒)清除;失去心跳的 running 任务(十分钟无新进度)先判为失败再收走。仅进行中的与停在风险点的任务长期保留,并照常显示进度。
  • 「清空进程」采用乐观更新:界面先移除对应行,再通知服务端删除。
  • 标题栏的「清空进程」与「收起」不再与拖动、展开争夺同一交互区域:按下这两个按钮只算点击,不触发拖动,也不会切换窗口展开状态。

打包完成后,记录上不是「终止」而是「下载安装包」:点它就切回打包页、滚到那次的结果与下载按钮(也可以在结果里选择存到本机 packs 目录)。打包结果本身放在界面进程的内存里,切页签、关掉面板再回来都还在,留到退出程序为止——插件被关掉或程序退出才清。

悬浮窗按住标题就能拖到任意位置,松手记住,下次打开还在那儿(存在浏览器本地,和服务端设置无关);拖到哪都会被限制在窗口内,不会丢到屏幕外。

没有任务时它自己收起,只在原来那个位置留一枚「进度」小按钮;点它就把窗口唤出来。有任务开跑时会自动冒出来,手动「收起」过也会被重新放出来。

打包期间可以继续选插件、改选项、再打一个包——多个任务并行跑,各自独立,互不影响。

体积上限默认 512 MB(设置里可改):这是打包结果的上限;单个下载(一个 tarball 或一份目录索引)另有更紧的 256 MB 上限,避免一次吞下过大的文件。

安装与「先不启用」

  • 安装走官方 dsh plugin add(和插件市场同一条链路):优先直接起宿主 exe + 内置 cli.js,参数不经 cmd,所以中文用户名、带空格路径都不会被引号吃掉;找不到才退回 .cmd。
  • 勾「装好先不启用」时,插件文件与依赖照装,但装完会把 dsh.profile.bundles 精确撤回原样 —— 重启也不会加载,想启用再手动加回来。
  • 解包前会先清掉 vendor/<包>/ 里的旧目录,避免上一版残留文件混进新版本。

它不是杀毒软件:静态检测会漏也会误报,装第三方插件前仍应自己看来源。

配置与数据:怎么带走,怎么放回

打包时抓两类东西,安装时原路放回:

内容 打包位置 安装去哪
补丁层配置(插件选项) configs/<name>.json 目标 profile 的 cordis.patch.yml,按条目 upsert:只动目标那一条,其它字节保留
插件自己的数据文件 data/<目录>/… 本机 ~/.dsh/<目录>/…(记忆、词库、笔记这类文本)

几条硬规矩:

  • 配置保真:嵌套对象、数组、中文与多行字符串都按原结构写回(空数组/空对象写成 []/{};用 JSON 流式写出来的配置也能读回原名)。
  • 只擦凭据,不动自定义:键名归一化后正好等于 apiKey/token/secret/password/cookie 这类才替换成 ${REDACTED},值里出现 sk-/ghp_/AKIA 这类明文也替换;apiKeyEnv(环境变量名)、endpoint、model、maxTokens、路径、权重这些原样保留。擦除路径写进说明,导入方自己重填。
  • 数据默认不覆盖:~/.dsh/<目录> 下已有同名文件时不动它,安装结果里会写「未覆盖 N 个」;要覆盖就重新装并选择覆盖数据(独立安装器用 --replace)。
  • 不碰凭证文件:credentials.json、.env、*.pem 这类文件名在数据快照里直接跳过,并记一条说明。
  • 数据快照也擦凭据:数据文件里出现 sk- / ghp_ / xoxb- / AKIA 这类明文 token,或 SESSDATA=…、password: …、api_key=… 这种键值对时,只保留键名、值替换成 ${REDACTED};正文、路径、普通笔记原样保留。包里记下命中条数,安装结果会提示哪些内容需要重填。
  • 裸 DSH 也一样:包内安装器写配置、写数据用的是同一套规则,不依赖本插件在场。

更新日志

  • 0.1.6(当前):介绍与说明口径统一为「我的世界启动器」(中英文描述、文档与市场词条同步);更新日志改为按版本汇总代码与功能改动;插件页与设置页底部展示项目地址与 Star 入口,打包生成的 README.txt 同样写入项目地址。
  • 0.1.5:配置与数据快照的保真与擦除。YAML 子集的空数组、空对象改为同行输出(key: []、key: {}),修掉回填后 cordis.patch.yml 无法解析的问题;flow 映射的带引号键按原名读回。data/ 快照支持安装写回 ~/.dsh/<目录>(清单 plugins[].dataDirs),默认只补缺、不覆盖已有文件。配置快照与清单新增 configRedacted,数据快照新增 scrubText 与 dataRedacted,明文凭据替换为 ${REDACTED}。安装优先调用宿主 pluginManager.installBundle,失败自动退回命令行。扫描按内容 sha1 去重;zip 对已压缩扩展名跳过 deflate、大文件降到 6 级;清单 schema 高于当前支持版本时提示升级。插件页与设置页底部加项目地址。
  • 0.1.4:与 0.1.3 同一份代码,仅版本号上移。
  • 0.1.3:安装进入任务队列与进度窗(可与打包并行、可终止且不生成文件);安装时先跳过本机已装插件,装完可选择保留本机版本或替换为包内版本(/install/replace);联网时优先按市场版本安装(preferMarketOnInstall)。新增独立安装器 install/install.mjs|.cmd|.sh(裸 DSH 可用,支持 --profile/--dry-run/--no-bundles/--replace/--dsh,先把插件复制到 ~/.dsh/dsh-modpack/vendor/)。风险命中按来源分组,整体与分组均可折叠;左下角进度窗显示概述、百分比与进度条,位置可拖动、空闲自动隐藏、可唤出。jobKeepSeconds 与心跳判定自动收尾(失败与取消十几秒、卡住十分钟判失败);「清空进程」改为乐观更新。取包支持「选择文件…」「浏览文件夹…」与任意目录,「已导入的整合包」可同时保留多份。打包支持市场里未安装的插件(按版本从 registry 取包)。
  • 0.1.2:市场已收录的插件出现高危时,打包改为停在「等决定」,由「我已知晓其中风险」在同一任务里继续;移除「默认打包本机修改」全局勾选,勾选默认 mode: base;插件列表加「全部加入 / 清除选择」;界面提示改为书面语。
  • 0.1.1:打包页顶部提示按是否安装插件市场分支显示;README 与描述补「与插件市场的联动」和有无市场的差异说明。
  • 0.1.0:首个版本。.dshpack 双形态——懒人包(full,自带插件本体)与轻量包(lite,只记录名字与版本);逐插件选择基础配置或本地改动;打包前强制静态扫描(敏感信息与危险代码,命中只留掩码、原文不落盘);安装前校验完整性、兼容性与许可证;配置按条目回填 cordis.patch.yml;分类、搜索与分页走插件市场目录;设置页、侧边栏、插件页三处入口独立开关。

目录

index.js            Host 侧:/dsh-modpack-kit/api/*
client.js           侧栏页面
lib/zip.mjs         自实现 zip 读写(校验、上限、防逃逸)
lib/tar.mjs         npm tarball 读取
lib/scan.mjs        敏感信息与风险代码规则
lib/semver.mjs      版本比较与范围匹配
lib/yamlish.mjs     cordis.patch.yml 子集解析与保留原样的 upsert
lib/profile.mjs     profile 读取、bundle 登记、dsh CLI 调用
lib/registry.mjs    https 受限抓取、npm 元数据、取包
lib/manifest.mjs    清单规范与 README 生成
lib/classify.mjs    没被市场目录覆盖时的兜底分类(纯字符串,无网络)
lib/market-catalog.mjs 市场目录同步、索引、分类映射、搜索与分页
lib/compat.mjs      兼容性检查
lib/pack.mjs        收集、扫描、出包
lib/install.mjs     解包、校验、安装、配置回填
docs/DETAIL.md      插件详情页
test/               自测脚本(node --test 风格,无依赖)

二次开发

  • lib/ 下每个模块都可单独 import:zip/tar 是通用读写器,scan 可接 extraRules,yamlish 只服务 cordis.patch.yml。
  • 清单里的 extensions 字段打包时原样写入、安装时原样保留,可放自定义数据。
  • 设置项 extraScanRules 会把额外规则并进扫描器。
  • 页面只消费 /dsh-modpack-kit/api/*,换 UI 不必改后端。

合规与边界

  • 只打包有权再分发的插件;许可证缺失或不在允许列表时需显式确认,最终责任由打包者承担。
  • 不要把含他人凭证的包传到公开位置;检测会拦明显的,但静态检测不是杀毒软件。
  • 不提供绕过任何平台限制或法律限制的能力;下载走 https 白名单,逐跳校验重定向。
  • 遵守所在地区法律法规与各平台条款。

状态目录:<DSH_HOME>/dsh-modpack/(settings.json、history.json、modpack.log、packs/、vendor/)。

许可

PolyForm Noncommercial License 1.0.0(仅限非商业用途) —— 全文见 LICENSE。

  • 可以:个人学习、研究、实验、私人娱乐、业余项目、非商业组织内部使用;可以改、可以分发(需带上许可证与上面的 Required Notice)。
  • 不可以:任何商业用途(含把本插件或其修改版用于收费产品、付费服务、商业部署),也不能转授权。
  • 商业授权请联系仓库作者。

声明

  • 本插件与 DeepSeek、DeepSeek Harness 官方无隶属关系,也不是官方作品;"DeepSeek Harness" 等名称归其权利人所有。
  • 它只做本地打包、检测与调用官方安装链路,不上传代码、配置或凭证到任何服务器。
  • 打包与安装时的检测是静态启发式,会漏也会误报,不构成安全担保,也不替代杀毒软件。
  • 打包他人插件时须遵守其许可证;不要把含他人凭证或私有数据的整合包公开分发。
  • 使用者应遵守所在地区法律法规与相关平台条款;作者不对因使用本插件产生的后果承担责任(见许可证 No Liability 条)。
—/ 5

No ratings yet

Verified DSH bundle

Commit 2c9eaa237295

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout