前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的思路：能力靠插件叠加，安装与启停由宿主侧的插件管理器完成。若你主要使用 VibeDev 出品的客户端增强、账号与创作类插件，逐个在 npm 或 GitHub 上查包名、对版本、再手动 dsh plugin add，容易漏依赖、装错 profile，也不方便对比「官方目录里还有哪些可选组件」。
@vibedev-si/dsh-ecosystem（社区常称 dsh-ecosystem）是 VibeDev-Si 维护的 VibeDev 插件中心：在一个面板里集中了解 VibeDev 官方插件，并通过宿主插件管理器完成检查、安装与更新。它与 DSH 自带的「插件」页是不同入口，但实际的安装、启用、停用与卸载仍由 DSH 宿主执行。
这是什么¶
- 定位：VibeDev Plugin Center —— 集中了解、一键安装和管理 VibeDev 官方插件。
- 维护者：VibeDev-Si（npm 作用域
@vibedev-si）。 - 分类：客户端类插件（在社区目录 SkillHub 上归类为「客户端」）。
- 解决的问题：把 VibeDev 维护的插件目录、版本核验与安装流程收拢到统一 UI，减少手工拼包名和重复核对依赖。
核心功能¶
下面介绍的能力均来自项目 README（经社区索引页镜像核对），只列与使用相关的部分。
插件目录与版本核验¶
- 维护团队在线目录（固定 GitHub 源），打开生态面板或点击「检查更新」时由宿主读取并校验；成功读取后缓存约 5 分钟，完整版本检查成功后缓存约 1 分钟，无后台定时轮询。
- 对目录中 VibeDev 包核对 npm 正式发布版本；优先官方 npm，失败时可降级镜像并标明状态，不会在读取失败时宣称「全部已是最新」。
- 读不到在线目录时使用本机上次可用目录或随包离线目录，并显示来源与未核验状态。
安装与管理流程¶
- 安装前列出精确版本与依赖；默认 先检查、以停用状态安装，再由你启用。
- 已安装的组件会复用；更新时若插件原本是停用状态，更新后仍保持停用。
- 支持 AI 创作套装 等组合安装、对已更名包的迁移，以及按目录安装单个 VibeDev 插件。
- 在支持热重载的新宿主上（DSH 从 0.2.1-alpha.3 起），更新可能改为「移除当前精确版本 → 安装新版本（先不启用）→ 按原状态重新启用」；新版本装不上时会尝试装回原来的精确版本。
更新提示¶
- 应用启动约 1.5 秒后会检查一次更新（不定时轮询）；侧栏「VibeDev 生态」入口可显示有待更新数量。
- 「全部」页可列出可更新插件与目标版本，并跳转到「可更新」页。
与 VibeDev Next 的关系¶
- VibeDev Next 已内置 VibeDev 生态：在「插件」页的「官方」分组中打开即可，一般无需再单独安装；在「添加插件」里输入包名会提示已安装。
- 使用官方 DSH 或自行安装时，侧栏仍有生态入口，可停用、卸载，自更新需按面板中的手动说明操作。
社区与市场说明¶
- 当前目录 不收录 第三方 DSH 社区市场（dshmarket）；已自行安装的不受影响，仍在 DSH「插件」页管理。
- 在带「发现」标签的 VibeDev 桌面版上，「社区插件」页会说明第三方社区插件在「插件 → 发现」中浏览，并提供跳转按钮；生态本身不读取社区索引。
安装与启用¶
web 是示例 profile 名，请换成你实际使用的 profile（例如 default）。
从 npm 安装（预构建包）¶
dsh plugin --profile web add @vibedev-si/dsh-ecosystem
从 GitHub 安装¶
首次安装若涉及构建脚本，pnpm 可能要求你在 profile 的 pnpm-workspace.yaml 里配置 allowBuilds；按终端提示追加键名后重试即可。仅信任你审查过的来源，必要时可 pin 到 commit（github:owner/repo#sha）。
dsh plugin --profile web add github:VibeDev-Si/dsh-ecosystem
指定精确版本（插件页推荐写法）¶
在 DSH 插件页也可按完整包名安装，例如：
@vibedev-si/dsh-ecosystem@0.1.18
对应命令形式：
dsh plugin --profile <profile> add @vibedev-si/dsh-ecosystem@0.1.18
安装完成后，在 DSH 插件管理器中 启用 该插件，并确认 layer 已生效（具体命令以你所用 DSH 版本的安装指南为准，常见做法是用 dsh --profile <profile> --dump-config 查看配置是否包含新插件层）。
典型用法¶
- 打开面板：启用生态插件后，从侧栏进入「VibeDev 生态」（VibeDev Next 内置时从「插件 → 官方」进入）。
- 浏览目录：在「全部」等页面查看 VibeDev 官方插件的双语说明、依赖、权限与费用说明；未知安装状态时卡片会显示占位，避免误点「安装」。
- 安装单个插件或套装：选择目标插件或「AI 创作套装」，按向导完成检查 → 停用态安装 → 在插件管理器中启用。
- 检查更新：点击「检查更新」或依赖启动后的自动检查，在「可更新」页对指定包执行更新；更新 VibeDev Next 内置相关组件后，需 完全退出并重新打开应用 以加载新代码（生态不会替你重启应用）。
- 社区插件：若你的桌面版支持「发现」标签，从生态内「社区插件」页跳转到「插件 → 发现」安装经 VibeDev 审查收录的社区插件。
适用场景与注意¶
适合谁
- 在独立 DSH 或 Web profile 上工作，希望系统化安装 VibeDev 官方插件的开发者。
- 需要对照在线目录、核对 npm 正式版再决定是否升级的用户。
使用前请知悉
- 插件以 当前 dsh 进程权限 运行，可访问你的文件、凭据与网络；工具审批不会把它沙箱化。安装前请阅读源码、许可证（项目声明为 MIT © VibeDev）与目录中的权限说明。
- SkillHub（https://www.skillhub.cn/plugins/VibeDev-Si/dsh-ecosystem）等社区目录是独立站点，与 DeepSeek、幻方无官方从属关系；星标与页面元数据以目录展示为准（当前 GitHub 星标为 0）。
- 在线目录与 npm 查询有超时与大小限制；网络不可达时界面会标明回退到离线目录，安装决策应结合「已核验 / 未核验」状态。
结尾¶
dsh-ecosystem 把 VibeDev 官方插件的说明、版本核验与安装步骤收到一个入口里，仍把最终信任边界交还给 DSH 宿主与你本人的启用操作。若要查看分类与简介，可打开社区目录页；源码与目录维护在 GitHub 仓库。
- 目录页：https://www.skillhub.cn/plugins/VibeDev-Si/dsh-ecosystem
- GitHub：https://github.com/VibeDev-Si/dsh-ecosystem
