Zat-DSH Engine
> DeepSeek Harness 的可视化插件市场。像 Wallpaper Engine 一样浏览、搜索、安装、更新和卸载社区插件。
Zat-DSH Engine 在 DeepSeek Harness 网页界面的 设置 → 插件 里新增一个 🛒 插件市场 页签。它实时列出 GitHub 上整个 dsh-plugin 主题社区,双语简介,一键安装。
功能特性
- 全社区目录 — 实时搜索 GitHub
dsh-plugin主题(1700+ 仓库,每天都在增长) - AI 找插件 — 任意对话里直接说出需求(例如"找一个让模型看图的插件"),AI 自动搜索插件市场、推荐候选,每个候选都附装前体检 + 安全扫描结论(✅/⚠️/❌),有问题如实报出、不盲目推荐
- 12 个分类 — 皮肤主题、工具终端、浏览器自动化、技能、视觉多媒体、网络 MCP、多智能体、数据存储、硬件桌面、设计文档、安全通知…
- 输入即搜 — 打字自动筛选,不需要回车;清空搜索框自动回到完整列表
- 双语简介 — 内置 999 条预生成中文简介;新插件保持英文简介(不再现场调用模型翻译,省 token、高峰时段不烧余额);英文界面显示 GitHub 原始简介
- 安装 / 更新 / 卸载 — 一键完成,底层走官方
dsh plugin的 profile 机制(pnpm) - 多插件仓库智能安装 — 一个仓库打包多个插件也能装对:只有一个插件的仓库点一下无感装好;多个插件的仓库用大白话列表让你选
- 已安装识别 — 标记你已装的插件,自动比较版本,发布新版本后显示更新徽章
- 跨平台 — Windows 与 Linux 全支持(PowerShell / sh、curl / wget 自动切换)
- 网络自适应 — 自动继承你的 VPN/系统代理来拉取和安装;GitHub 连不上时自动切到
gh-proxy.com镜像,网络恢复后再切回直连;没 VPN 也能用:代理→直连→镜像→内置请求自动降级 - 一键启用/停用 — 卡片上直接启停插件,官方组件与市场自身受保护
- 装前冲突拦截 + 🩺 一键体检 — 两个市场互装、官方包劫持、挂载行/注册名重复会被直接拦截;一键体检报告冲突、依赖矛盾、缺失依赖
- 装前体检 + 安全扫描 — 每个候选装之前先体检(入口文件、构建产物、依赖写法、网络去向、系统兼容);安全扫描抓混淆、偷凭据、可疑外发,但只提示、不误杀;入口缺失/系统不支持这些客观硬伤才拦
- 一键检测 + 一键修复 — 一键查出网络/pnpm/入口/系统/历史报错等所有问题,能修的自动修(装 pnpm、启用插件、补依赖),修不了的写清楚怎么弄
- 稳,坏了能救 — 安装/卸载/启停失败自动回滚;每次成功后自动备份,装崩了按说明一条命令恢复
- 实时进度条 — 安装/更新/卸载显示在卡片上(百分比 + 实时计数),离开市场再回来进度也不丢
- 一键星标 — 自动复用本机 git 凭据给仓库点星;卡片标签与颜色图例、提示自动消失
- 自更新 — 插件市场自身有新版本时,标题旁边出现更新按钮
安装
> ⚠️ 请用下面的命令安装,不要手动改任何 patch 文件。
> 直接把仓库地址丢给 AI、让它手动编辑 cordis.patch.yml 会导致 dsh 起不来:市场自带的 plugin-market 条目由 dsh 从随包补丁自动挂载,若再手动抄进两个地方(app.asar.unpacked/cordis.patch.yml 和 ~/.dsh/profiles//cordis.patch.yml),id 重复,启动直接失败。如果 dsh 已经起不来,删掉你 profile 的 cordis.patch.yml 里手抄的 plugin-market 那条,再用下面的命令重装即可。
从 GitHub 安装(发布后推荐)
dsh plugin --profile web add github:mishibeikejie/zat-dsh-engine
国内没有 VPN 时安装(走国内镜像,已实测可用)
dsh plugin --profile web add https://gh-proxy.com/https://github.com/mishibeikejie/zat-dsh-engine.git
两个命令任选其一,装的是同一个插件。装好之后,插件市场内部的搜索和安装自带镜像回退,不用再管网络问题。
从本地目录安装
git clone https://github.com/mishibeikejie/zat-dsh-engine.git
dsh plugin --profile web add ./zat-dsh-engine
从 npm 安装(如果后续发布到 npm)
dsh plugin --profile web add zat-dsh-engine
如果你的 profile 不叫 web,把它换成你自己的 profile 名。
> 前置要求:已安装 dsh;PATH 里有 pnpm 和 curl;profile 已初始化(第一次 dsh plugin add 会自动创建)。
使用
- 安装后重启 dsh。
- 打开网页界面 → 设置 → 插件。
- 点击插件列表右边的 🛒 插件市场 页签。
- 浏览、搜索、按分类或安装状态筛选,点卡片上的 安装。
- 重启 dsh 让安装的插件生效。
更新
dsh plugin --profile web add github:mishibeikejie/zat-dsh-engine
重新执行 add 即更新到最新版本。插件市场也会自动检测自身新版本,并在标题旁显示更新按钮。
卸载
dsh plugin --profile web remove zat-dsh-engine
常见问题
「全部」视图最多显示 1000 个插件。 这是 GitHub 搜索 API 对单次查询的硬上限。用搜索框或分类筛选可以找到任何一个插件,不受此限。
为什么有的插件没有中文简介? 插件内置了 999 条中文简介。快照之后新发布的插件保持英文简介——已移除现场翻译(DeepSeek 峰谷定价下,打开商店会对没缓存的新插件批量调用当前模型翻译,高峰时段会白烧大量余额)。
镜像安全吗? 只有直连 GitHub 失败时才走镜像,而且只拉取公开仓库的元数据。
装了某个插件之后 dsh 起不来怎么办? 市场每次成功安装/卸载/启停之后,都会把上一份可用状态自动备份到 profile 目录的 zat-backup/ 文件夹。恢复只需把里面的三个文件复制回 profile 目录覆盖。
下面命令里的 web 就是你的 profile 名:用网页版的人都是 web(除非你启动 dsh 时专门用了别的名字;不确定的话,打开插件市场看底部那行「当前 profile:」,写的是啥就填啥):
# Windows (PowerShell)
Copy-Item "$HOME\.dsh\profiles\web\zat-backup\*" "$HOME\.dsh\profiles\web\" -Force
# macOS / Linux
cp ~/.dsh/profiles/web/zat-backup/* ~/.dsh/profiles/web/
然后重新启动 dsh。恢复的是"上一次成功操作"之后的状态,那个把你带崩的插件会被移除出启用名单,profile 可以正常启动。
可以同时装两个市场类插件吗? 不可以,安装时会被直接拦截:两个市场/管理器插件会注册相同的设置页和服务,互相覆盖甚至让 dsh 起不来。想换用另一个,先卸载当前这个。
安装前会自动检查冲突吗? 会。每次安装前,市场自动检查三件事:① 官方包(@deepseek-ai/*)是否被写成普通依赖(会装出第二份拷贝劫持官方 loader,硬拦截);② 挂载行 id 是否与已装插件重复(硬拦截);③ 共享依赖的大版本是否与已装版本矛盾(不拦截,但会在结果里提示风险)。工具栏的「🩺 一键检测」可以随时对全部已装插件做一次同样的体检,报告冲突、依赖矛盾、缺失 peer 依赖、停用状态等。
权限与信任说明(安全审查视角)
这个市场本质上是一个包管理器,它的功能本身就要求一些强权限。任何安全审查都会看到下面这些行为,这里主动说明用途和边界:
- 执行 shell 命令:安装/更新/卸载插件就是跑 pnpm 命令。市场只执行自己拼装的 pnpm、curl、wget、powershell 命令;安装时 pnpm 会执行插件自己的 prepare/postinstall 脚本(所有包管理器的通用行为),市场会先扫描这些脚本,联网下载外部组件或高危模式会提前提示。
- 读取 git 凭据:只用在这两处——给仓库点星、以及在市场里"设置 GitHub Token"。凭据只发往 api.github.com,不落盘、不进日志、不发往任何其他服务器。
- gh-proxy.com 镜像:仅当直连 GitHub 失败时作为备选通道,且只用于公开仓库元数据;装完插件之后,插件自己的网络行为与镜像无关。
- 读写 profile 文件:安装/卸载/启停必须修改 profile 的 package.json 等文件;每次改动前自动备份到
zat-backup/,操作失败自动还原。 - 装前体检 + 安全扫描:对每个候选和已装插件扫描结构、依赖、安全模式(混淆、偷凭据、可疑外发、系统修改),网络去向装前全部列明;安全项只提示不拦截,入口缺失/系统不支持等客观硬伤才拦。
以上每一项都是"为了让市场能工作"的最小权限集合;如果审查时看到某个具体行为有疑问,对照本节即可。
更新日志
v0.8.2
- 对话管理删除清不干净(适配 DSH 0.1.7 的工作区注册表):0.1.7 去掉了
forgetSession,同时新增了注册表级的置顶集合,并把归档集合留在注册表里。旧实现只按detachSession逐个工作区摘除——但归档的会话不在任何工作区的sessionIds里,置顶项更是完全在工作区之外,于是删除后归档/置顶记录残留(表现为删过的会话仍在某些列表里冒头)。现在删除时显式调用 0.1.7 的unarchiveSession/unpinSession(旧版没有这两个方法,可选调用不影响),并在最后回读注册表校验:确实还残留才提示,不再一律提示"此版本缺少清理方法" - 版本号与包版本对齐:0.8.1 只改了
package.json,代码里的SELF_VERSION仍停在0.8.0,而市场自查更新用的是"远端 package.json 版本"对比SELF_VERSION——0.8.1 > 0.8.0 恒成立,于是每次打开都提示有新版本、点更新装完还提示。现在两者一致
v0.8.1
- 浏览器侧补上 DSH 0.1.7 的
create()契约(市场面板才算真正恢复):v0.8.0 只修了 host 侧的 typert 清单,client 侧的 strict codec 仍只有schema,而 0.1.7 的dsh-typert-registry与 loader 用的是同一条校验(strict codec has no create() factory)——客户端remote.$mount()第一步就抛错,entry 状态变 failed,界面报web boot: 1 entry did not activate/zat-dsh-engine: failed。现在 client 侧 codec 也带create: () => schema,两代 loader 都通过 - 去掉已不存在的 client inject:
dsh.client.inject里的@deepseek-ai/dsh-client-runtime自 DSH 0.1.2-alpha.1 起已被上游删除(0.1.1-rc.2 还留有该包),而 0.1.7 新增的浏览器侧 entry 审计会把这条无法满足的依赖判为启动失败。本引擎并未实际引用该包,已移除
v0.8.0
- 适配 DSH 0.1.7+：插件市场恢复可用:0.1.7 的 typert-loader 收紧校验,要求每个 codec 带
create()工厂(只校验存在、不调用),而本引擎的严格 codec 只写了schema——整份 typert 清单被拒收(启动日志报1 entry did not activate/parameter codec has no create() factory),22 个 pluginMarket 端点全部注册不上,市场能打开但取不到数据。现在schema与create并存:0.1.5 认schema、0.1.7 认create,两代 loader 都通过
v0.7.1
- 更多插件能装了:GitHub 仓库只放源码、构建产物发布到 npm 的插件(如 dsh-comfyui)之前被「入口文件缺失」拦截;现在会自动识别 npm 上的同源发布并改从 npm 安装
v0.7.0
- 修复更新按钮从不出现:0.6.2 起手写 wire manifest 漏了可选参数 zhLocale,更新检查 RPC 每次都被网关拒绝且客户端静默吞错;现已补上,且 RPC 错误会在界面可见显示
v0.6.9
- 更新检查更快更醒目:检查失败 10 秒后自动重试(不再干等 45 秒);切回市场页立即重查;检查成功时显示「已是最新 vX.Y.Z」
v0.6.8
- 更新检查自动重查:市场页打开期间每 45 秒自动重查一次,新版发布后不用刷新,更新按钮也会自动出现
v0.6.7
- 兼容 ZAT 启动器内置工具链:自动复用 %TEMP%\zat-tools 的 node / npm.cmd / PortableGit(存在才用),机器装没装工具都不影响安装
v0.6.6
- 修复自更新检查静默失败:镜像返回 502/503 等网关错误时不再当"确定答案",自动走直连/代理回退;检查失败会显示可见提示,不再悄悄藏起更新按钮
- 界面显示当前市场版本号:标题旁显示「vX.Y.Z」,一眼看出自己是不是最新版
v0.6.5
- 根治弹窗:Windows 下所有命令调用(pnpm/git/curl/安装/更新)直接由 node 拉起并加 CREATE_NO_WINDOW,不创建任何控制台窗口,彻底不再闪窗
v0.6.4
- 修复安装弹窗:执行安装/命令时不再弹出 PowerShell 窗口
- 没 VPN 也能装:系统代理失效时自动清除并改走国内镜像,不再被死代理卡死
- 报错不再误导:区分缺 git、网络/镜像/git 认证与真文件占用,不再误报"文件被占用"
- 构建脚本与 node 自动处理:pnpm 11 拦依赖构建脚本自动放行,无 node 机器自动用 dsh 自带 node,兼容 ZAT 启动器自举的 pnpm/node
v0.6.3
- 对话管理只显示主对话:子代理会话直接隐藏,不再出现在进行中/归档列表里
- 删除主对话级联删子代理:删主对话时其所有子代理后代一并删除,不再产生删不掉的无主孤儿
v0.6.2
- 移除新插件自动中文翻译:新插件保持英文简介,不再调用模型翻译,高峰时段不白烧余额
- 支持桌面封装端专属 profile:安装/更新/卸载自动落到桌面端真正加载的 profile
v0.6.1
- 移除误加的第三方主题依赖
@deepseek-ai/dsh-client-ui-aqua:它强制给每个安装塞进一个未审计的玻璃主题,还触发 pnpm 11 的 exotic-subdep 拦截;市场根本没用它,现在安装干净了 - 新增:手抄重复挂载行检测 — 体检会报出 profile 的
cordis.patch.yml里、与插件自带补丁同 id 的insert行(就是"AI 把条目抄进两个 patch 文件"那种翻车),一键修复自动删掉重复行,dsh 又能起来了 - 安装警告 写进 README:用
dsh plugin add装,不要手改 patch 文件
v0.6.0
- 修复安装失败：网络请求改成镜像优先 + 每条路 2~4 秒超时自动换路，代理断/超时不再把安装卡死；技能(skill)包也能一键装进
~/.dsh/skills；文件被占用/无权限的报错不再误报成"网络问题" - 「已安装」纯本地秒出(7ms)，断网/断代理都不卡；装了插件后在「全部」列表里不再显示"安装"按钮(状态实时同步)
- 进卡片详情再返回，列表停在原位置，不再跳回顶部
- 详情 README 加载失败 10 秒内给提示，不再无限转圈
- 技能安装后星数正确显示
v0.5.0
- 一键检测 + 一键修复:真查问题(网络/pnpm/入口文件/系统支持/历史报错),能修的自动修(装 pnpm、启用插件、补依赖),修不了的写清楚怎么手动弄
- 系统兼容:卡片显示「支持系统」(Windows/macOS/Linux),不支持的装前直接拦
- 分类搜索修复(不再 422)+ 搜索词加固(OR/符号/中文都正常)+ 被限流自动切镜像
- 装插件/更新走双镜像(gh-proxy + ghfast),没 VPN 也能用;更新三重兜底,不再误报降级
- 安全扫描只提示、不误杀(通知类插件不再被冤枉);报错全改一句话:出什么问题 + 怎么解决
- 纯 npm/本地装的插件在「已安装」里可见可管理、可查更新(查 npm 源)、可一键更新;装完和详情页显示「怎么用」
v0.4.4
- 修复:未登录 GitHub 时不再自动弹登录页;点星也不再强制跳转登录
- 修复:装插件直连 GitHub 失败时自动走国内镜像,没 VPN 也能装;pnpm 缺失时报错更清楚
- 新增:对话管理页拆成两栏,右侧「归档管理」单独列出已归档会话,可直接删除
- 修复:纯 npm/本地安装的插件(无仓库地址)现在也会在「已安装」里显示,可卸载/启停
- 修复:安装时若入口文件缺失(构建产物没提交)直接拦截,不再跑去 pnpm 报错
- 新增:卡片显示「支持系统」(Windows/macOS/Linux),新插件自动检测;不支持当前系统的插件在体检和安装时直接拦截
v0.4.3
- 新增:任意对话说出需求,AI 自动找插件,附装前体检 + 安全扫描结果
- 体检会查出:入口缺失、依赖写错、偷凭据、可疑外发等问题,❌ 的直接装不了
- 修复:不再误报"升级到旧版本"
v0.4.2
- 修复:体检误报"装了多个市场插件"(同一插件被别名重复计数)
- 修复:更新/安装时自动查找 pnpm(nvm、corepack、npm 全局安装都能找到)
- 更新说明自动换行,不再超出界面
v0.4.1
- 新增「对话管理」页签(设置里 Agent预设 下面):列出全部会话(带标题),一键永久删除,运行中/子代理会话受保护
- 修复:中文或特殊字符搜索报 400
- 修复:更新按钮点击无反馈,现改为实时进度条 + 完成提示
- 修复:删除会话后侧边栏残留"未分组"条目
v0.4.0
- 一键启用/停用插件(卡片上直接操作,官方组件与市场自身受保护)
- 安装前冲突拦截(两个市场互装、官方包劫持、挂载行/注册名重复)+ 🩺 一键体检
- 安装/卸载/启停自动回滚,失败自动还原;每次成功后自动备份,装崩了按说明一条命令恢复
- 卡片上的实时进度条(百分比 + pnpm 实时计数),安装状态离开市场再回来也不丢
- 无 VPN 可用:系统代理→直连→国内镜像→内置请求自动降级,镜像实测约 7MB/s
- 已安装/可安装筛选直出全部结果、翻页去重
- 一键星标、卡片标签与颜色图例、提示自动消失
赞助
如果 Zat-DSH Engine 帮你省了时间,欢迎支持作者:
- GitHub Sponsors:
每一份支持都会用于维护目录数据、翻译和功能更新。
