DeepSeek Harness Plugin

Vesna-Strivozha-cn/dsh-modpack-kit

Stars ★ 0 Downloads (30d) 314 Category Plugin Markets & Managers Added 2026-11-16 npm dsh-modpack-kit

Pack several DeepSeek Harness plugins into one .dshpack and install them in one pass. Both formats ship a standalone installer, so a machine with only a bare DSH can install (payloads go to a local vendor folder, installed plugins are skipped unless --replace). Packing always scans for secrets and risky code; high-risk hits pause until you confirm, then the same job resumes without scanning again. Installing shares the progress dock, skips plugins you already have and then lets you replace them with the packed versions; when you are online the market version is preferred. Packs can be opened with a file or folder picker, any directory, an imported-packs list or a link. Categories, search, paging and same-name entries come from the plugin-market catalog.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-modpack-kit

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

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

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

This plugin publishes its README in Chinese only.

为 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 条)。

Content from the project README on GitHub ↗

Links

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.