前言¶

在 DSH / 智能体开发中，扩展能力经常依赖社区插件。插件分散在 GitHub 仓库里，手动搜索、判断类型、安装和更新容易变成碎片化流程。dsh-whale-market（鲸鱼插件市场 / Whale Market）提供统一入口，用于浏览、搜索、一键安装与更新 GitHub dsh-plugin 主题下的 DSH 社区插件。

这是什么¶

dsh-whale-market 是社区维护的 DSH 插件市场，不是 DeepSeek / 幻方官方应用商店。仓库所有者为 hoangdtdoothanh-svg，许可证为 MIT。

它运行在 DSH 的 Web 设置页中，同时为 Agent 提供四个市场工具：market_search、market_install、market_installed、market_update。

核心功能¶

市场浏览¶

市场围绕 DSH 社区插件提供四个栏目：

• 插件
• Skills
• 皮肤
• 预设

实时市场通过 GitHub Search API 拉取：

• topic:dsh-plugin
• topic:agent-skills

支持按 star 排序、分页和关键词搜索。

搜索与筛选¶

搜索和筛选能力包括：

• 按分类筛选
• 按语言筛选
• 只看收藏
• 只看已验证
• 按星标排序
• 按最近更新排序

输入中文功能词时，会自动扩展为英文同义词 OR 查询，便于从功能名找到对应仓库。

数据降级¶

市场提供四级数据降级：

实时 API → 磁盘快照 → 静态索引 → 内置种子

网络状态不佳时，仍可通过静态索引或内置种子浏览市场内容。

安装与风险确认¶

安装流程包括：

• 类型检测
• 兼容性评分
• 脚本型、非插件、手动型仓库安装前风险确认门禁
• 分形态安装：技能、预设、脚本、插件
• git 直连失败时自动回退 codeload tarball
• 分级错误提示
• 网络诊断审计

安装前会给出类型判定、兼容性评分与危险模式扫描结果，并要求用户确认。

已安装管理¶

已安装管理支持：

• 开关
• 更新
• 卸载
• 环境变量编辑
• 收藏夹与收藏更新通知
• 安装历史
• 备份 / 恢复
• WebDAV 备份
• 安装反馈生成 GitHub Issue
• 审计日志
• 市场数据大盘
• 插件作者工具
• 错标仓库适配层

界面支持双语 UI，并对齐原生 DSH 设计 tokens。

Agent 工具与接口¶

Agent 可用工具包括：

market_search
market_install
market_installed
market_update

HTTP 接口可用于查询市场列表：

GET /plugins/dsh-whale-market/list

支持参数：

kind
category
language
sort
favorite

安装与启用¶

先确认环境满足以下条件：

• Node ≥ 18
• dsh 或 whale CLI 在 PATH 上
• pnpm 在 PATH 上

执行安装命令：

dsh plugin --profile desktop add dsh-whale-market

这条命令将 dsh-whale-market 安装到 desktop profile。

安装完成后，重启 DSH，然后进入：

• 设置 → 插件 → 插件市场
• 设置 → 插件 → 已安装

典型用法¶

Agent 工具示例¶

以下工具用于搜索、安装、查看和更新插件：

market_search q=记忆 kind=plugin
market_install spec=owner/repo
market_installed
market_update name=xxx

说明：

• market_search：按关键词和类型搜索
• market_install：安装指定仓库，风险仓库会要求确认
• market_installed：查看已安装清单
• market_update：更新指定插件

市场列表接口¶

查询市场列表：

GET /plugins/dsh-whale-market/list

可通过 kind、category、language、sort、favorite 参数缩小范围。

适用场景与注意¶

适合以下使用场景：

• 在 DSH 中浏览和搜索社区插件
• 通过 Web 设置页安装、更新、卸载插件
• 用 Agent 工具完成市场搜索、安装和更新
• 在网络不佳时通过静态索引或内置种子浏览市场
• 管理插件开关、环境变量、备份与安装历史

注意事项：

• 安装第三方插件会运行第三方代码，插件以当前 DSH 进程权限运行；安装前应检查源码与许可证。
• 市场会提供类型检测、兼容性评分与危险模式扫描，并在脚本型、非插件、手动型仓库安装前要求确认。
• 安装、更新、卸载、开关后需要重启 DSH 才生效；技能热加载除外。
• 只支持安装到市场自身所在的 profile。
• 环境变量编辑不会写入备份文件，密钥不进备份。

获取¶

GitHub 仓库：

https://github.com/hoangdtdoothanh-svg/dsh-whale-market

目录页（插件线索来源）：

https://www.skillhub.cn/plugins/hoangdtdoothanh-svg/dsh-whale-market