前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的架构：能力扩展依赖社区仓库，而不是内置应用商店。开发者通常需要自己去 GitHub 找带 dsh-plugin topic 的仓库，复制安装命令，处理网络、依赖和 profile 配置。仓库数量在增长，手动维护已安装列表和版本也变得麻烦。
Zat-DSH Engine 由 mishibeikejie 维护，是一个客户端插件，在 DSH Web GUI 的 Settings → Plugins 页面增加 Plugin Market 标签页，把 GitHub 上 dsh-plugin topic 的社区目录做成可浏览、可搜索、可一键安装的可视化市场。它与 SkillHub 等社区目录站点相互独立，并非 DeepSeek 或幻方官方应用商店。
这是什么¶
Zat-DSH Engine（mishibeikejie/zat-dsh-engine）是面向 DeepSeek Harness 的可视化插件市场。它在设置页的插件列表右侧增加市场入口，实时拉取 GitHub 上 dsh-plugin topic 的仓库目录，展示双语简介，并通过官方 dsh plugin profile 机制完成安装、更新与卸载。
当前版本 0.7.0，MIT 许可证，分类为客户端插件。
核心功能¶
社区目录与搜索¶
市场通过 GitHub 搜索 API 实时列出 dsh-plugin topic 下的社区仓库（README 称该 topic 下有 1700+ 仓库，且仍在增长）。支持按分类筛选，共 12 类：Theme、Tools、Browser、Skills、Vision、Network、Agents、Data、Hardware、Design、Security 等。输入关键词即可过滤，无需按 Enter；清空搜索框回到完整列表。
插件卡片附带双语简介：内置 999 条预翻译的中文介绍；快照之后发布的新插件保留英文描述。英文界面显示 GitHub 原始 description。
安装、更新与卸载¶
安装、更新、卸载均基于官方 dsh plugin profile 机制，底层使用 pnpm。单插件仓库静默安装；monorepo 仓库会弹出选择器，让你挑选要安装的子插件。已安装的插件会被标记，并做版本比对，有新版本时显示更新徽章。卡片上可直接启用或禁用插件（官方核心插件和市场自身受保护，不可误关）。
安装、更新、卸载过程中，卡片上显示实时进度条（百分比与计数），离开市场页面再回来进度仍保留。
AI 插件查找¶
在任意对话中描述需求（例如「帮我找一个能让模型看图片的插件」），AI 会在市场中搜索、推荐候选，并对每个候选报告安装前健康检查与安全扫描结果（✅/⚠️/❌）。有问题会如实说明，不会盲目推荐。
安装前检查与安全扫描¶
安装前会执行冲突检测与健康检查：阻止同时安装两个市场类插件、官方包劫持、重复 patch 行或注册名冲突等问题。每个候选插件在安装前做健康与安全扫描，检查入口文件、构建产物、依赖风格、网络目标、OS 支持等；安全扫描可识别混淆、凭据窃取、外泄等行为（仅警告，避免误报）；客观问题（缺少入口、不支持当前 OS）会被阻断。
提供一键检查与修复：检测网络、pnpm、入口、OS、历史错误等问题，能自动修复的（如安装 pnpm、启用插件、补齐依赖）会自动处理，其余给出说明。
网络与跨平台¶
继承系统 VPN/代理设置。GitHub 不可达时，请求自动回退到 gh-proxy.com 镜像。链路顺序为：代理 → 直连 → 镜像 → 内置 fetch 回退，无 VPN 也可使用。完整支持 Windows 与 Linux（PowerShell / sh，curl / wget，系统代理感知）。
其他能力¶
- 一键 star：复用本地 git 凭据为仓库加星。
- 自更新：市场自身有新版本时，标题旁出现 Update 按钮。
- 安全回滚：安装/卸载/切换失败时自动回滚；profile 目录下
zat-backup/保存最近一次成功操作后的状态，可一键恢复。
安装与启用¶
请使用下方命令安装，不要手动编辑
cordis.patch.yml。README 说明：手动把plugin-market行写入app.asar.unpacked/cordis.patch.yml和~/.dsh/profiles/<profile>/cordis.patch.yml两处会导致 id 重复，DSH 无法启动。
环境要求：已安装并可运行的 dsh；pnpm 和 curl 在 PATH 中；profile 已初始化（首次执行 dsh plugin --profile web add 时会创建）。
从 GitHub 安装（推荐）¶
dsh plugin --profile web add github:mishibeikejie/zat-dsh-engine
国内无 VPN 时（经 gh-proxy 镜像）¶
dsh plugin --profile web add https://gh-proxy.com/https://github.com/mishibeikejie/zat-dsh-engine.git
两条命令安装的是同一插件。安装后，市场自身的搜索与安装路径已内置镜像回退。
从本地 checkout 安装¶
git clone https://github.com/mishibeikejie/zat-dsh-engine.git
dsh plugin --profile web add ./zat-dsh-engine
若你使用的 profile 不是 web（例如 headless），把命令中的 web 换成实际 profile 名。可在市场页脚查看 Profile: 行确认。
安装完成后重启 dsh。
典型用法¶
- 重启 dsh。
- 打开 Web GUI → Settings → Plugins。
- 在插件列表右侧点击 Plugin Market 标签页。
- 浏览、搜索、按分类或安装状态筛选，在卡片上点击 Install。
- 再次重启 dsh 以激活已安装的插件。
更新¶
dsh plugin --profile web add github:mishibeikejie/zat-dsh-engine
重复执行 add 即更新到最新 commit。市场也会在检测到自身新版本时显示 Update 按钮。
卸载¶
dsh plugin --profile web remove zat-dsh-engine
用对话找插件¶
在任意会话中直接描述你需要的功能，AI 会在市场中检索并给出候选及每项的安装前扫描结果，再决定是否安装。
适用场景与注意¶
适合谁
- 经常在 DSH 里试用社区插件、不想手动翻 GitHub topic 的用户。
- 需要在一处浏览分类、比对版本、批量管理安装状态的用户。
- 网络环境不稳定、希望自动走代理或镜像回退的用户。
使用限制
- All 视图最多显示 1000 个插件，这是 GitHub Search API 的单次查询上限；用搜索或分类筛选可触达更多仓库。
- 不能同时安装两个市场类插件；切换前需先卸载当前市场插件。
- 镜像仅在直连 GitHub 失败时用于拉取公开仓库元数据。
安全提示
该插件本质是包管理器，需要执行 shell 命令（安装/更新/卸载时调用 pnpm、curl 等）、读写 profile 文件、访问 GitHub 与镜像。插件以当前 dsh 进程权限运行，安装任何社区插件前请检查源码与许可证。安装前扫描会阻断部分客观风险，但不应替代你自己的审查。
故障恢复
若安装某插件后 dsh 无法启动，可从 profile 目录的 zat-backup/ 恢复：
# macOS / Linux
cp ~/.dsh/profiles/web/zat-backup/* ~/.dsh/profiles/web/
# Windows (PowerShell)
Copy-Item "$HOME\.dsh\profiles\web\zat-backup\*" "$HOME\.dsh\profiles\web\" -Force
恢复后重新启动 dsh。
链接¶
- SkillHub 目录页：https://www.skillhub.cn/plugins/mishibeikejie/zat-dsh-engine
- GitHub 仓库：https://github.com/mishibeikejie/zat-dsh-engine
Zat-DSH Engine 把分散在 GitHub dsh-plugin topic 下的社区插件收进 DSH 设置页，用可视化方式完成浏览、搜索、安装与版本管理，并内置网络回退和安装前检查。若你已在用 DSH 扩展能力，可以把它当作日常装插件的入口。
