READMESource: master@5bdd73e3
dsh-whale-market 鲸鱼插件市场 🐋
浏览、搜索、一键安装与更新 GitHub dsh-plugin 主题下的 DSH 社区插件。 运行在 DeepSeek Harness（DSH / whale fork）的 Web 设置页里，同时给 Agent 提供四个市场工具。
功能总览
市场核心
- 实时市场：GitHub Search API 拉取 topic:dsh-plugin（4700+ 仓库）与 topic:agent-skills（15000+ 技能），按 star 排序、分页、关键词搜索。
- 四级数据降级：实时 API → 磁盘快照 → 静态索引（内置 registry.json.gz 4260 条 + skills.json.gz，可用 registryUrl/skillsUrl 指向自建 CI 产物走 jsDelivr CDN）→ 内置种子，任何网络状况都能浏览。
- 四个栏目：插件 / Skills / 皮肤 / 预设（静态索引分类过滤，13 个社区维护分类）。
- 筛选排序：分类、语言、只看收藏、只看已验证（索引构建期探测 package.json 是否声明 dsh 能力）、按星标/最近更新。
- 功能词搜索：输入中文功能词（看图 / 记忆 / 皮肤 / 工作流 / 翻译 …37 个别名）自动扩展为英文同义词 OR 查询（GitHub 实时 + 静态索引双通道），并有一排「按功能搜」快捷 chip。
安装体验
- 类型检测（/info）：cordis 插件 / 技能 / 预设 / 安装脚本 / 手动安装，附判定报告与根目录文件清单。
- 风险确认门禁：脚本型、非插件、手动型仓库安装前返回 409 + 判定报告，UI 弹窗确认（含危险模式扫描：下载执行 / 写启动项 / 读凭据 / 改 rc）后才安装。
- 分形态安装：技能 → ~/.dsh/skills（热加载）；预设 → ~/.dsh/.agent-presets；脚本 → 确认后执行（保留在 ~/.dsh/market/cache）；插件 → dsh plugin 官方机制（异步任务 + 进度/取消/进程树看门狗 + 密钥清洗 + bundles 自愈 + pnpm allowBuilds 自动放行重试）。
- git 直连失败自动回退 codeload tarball（隔离全局 git 代理改写，实测 ghfast.top 代理宕机场景）。
- 兼容性评分：manifest 检查（dsh 字段 / patch 文件 / main 入口 / react peer）→ ✅/⚠️/❌ + 原因。
- 分级错误提示：网络错误分类（DNS / 连接被拒 / 超时 / TLS / fetch failed）+ 中文原因 + 操作建议 + 一键重试。
- 网络诊断审计（/diagnose）：一键检查安装链路每个环节（GitHub API / raw / codeload / jsDelivr / npm registry / dsh CLI / pnpm / git / profile bundle 入口健康），✅/❌ + 耗时 + HTTP 状态，入口在「插件市场」错误卡片与「已安装」头部。
已安装管理
- 开关 / 更新（npm 最新版对比）/ 卸载 / 环境变量编辑（写入 ~/.dsh/.env，DSH_ 保留，备份不含密钥）。
- 内容安装清单（技能/预设/脚本独立管理）。
- 市场自更新（一键更新本体）。
生态与效率
- 收藏夹 + 收藏更新通知（GitHub pushed_at 对比 + 红点/横幅）。
- 安装历史 + 备份/恢复（JSON 导出/导入，批量重建）+ WebDAV 备份（config.webdavUrl）。
- 安装反馈 → GitHub Issue（config.githubToken 自动建 issue，否则预填链接）。
- 审计日志（脱敏导出）。
- 市场数据大盘（总数/分类/语言/星标分布）。
- 插件作者工具：合规脚手架（package.json + patch + host 模板）+ 发布前自查。
- 错标仓库适配层（adaptor.json 重定向）。
- 双语 UI（中/EN 切换，覆盖主要界面文案）。
- Agent 工具：market_search / market_install / market_installed / market_update（支持 kind/sort）。
- 原生 UI：对齐 DSH design tokens（--dsw-alias-* / --dsw-font-*），12px 圆角卡片、原生反色按钮、Tab 下划线指示器、胶囊徽标。
安装
依赖：Node ≥ 18、dsh（或 whale）CLI 与 pnpm 在 PATH 上。
# 方式一：本地（开发时推荐，link 方式接入）
cd dsh-whale-market
.\install.ps1 # 自动选 desktop（有则）/ web profile
# 方式二：npm 包（发布后）
dsh plugin --profile desktop add dsh-whale-market
# 方式三：GitHub
dsh plugin --profile desktop add github:QiFeng/dsh-whale-market
# 手动挂载（任一用户 patch 层）
# - insert:
# - id: whale-market
# name: dsh-whale-market
# config: {}
重启 DSH 后，进入：设置 → 插件 → 插件市场 与 设置 → 插件 → 已安装。
插件 config 选项（cordis.patch.yml 的 config）
| 键 | 默认 | 说明 |
|---|---|---|
| profile | 自动 | 强制指定管理目标 profile |
| cli | dsh→whale | 指定 CLI 二进制 |
| registryUrl | 内置 gz | 远程静态插件索引（CI 产物，走 CDN） |
| skillsUrl | 内置 gz | 远程静态技能索引 |
| agentTools | auto | Agent 市场工具开关：auto/on 注册 market_* 工具（与官方内置同名工具共存，本插件实现接管同名调用）；off 让位官方内置工具 |
| githubToken | 无 | 反馈自动建 issue 用的 GitHub Token |
| webdavUrl / webdavUser / webdavPassword | 无 | WebDAV 备份目标 |
静态索引构建（自托管 / 参与维护）
# 从社区 registry 构建（导入模式）
node scripts/build-registry.mjs --from https://cdn.jsdelivr.net/gh/bradeGithub/DSH-Plugins-Marketplace@main/registry.json.gz --kind plugin
# 全量爬取（stars 分段，GITHUB_TOKEN 可提速）
node scripts/build-registry.mjs --crawl plugin
node scripts/build-registry.mjs --crawl skill --top 2000
仓库自带 GitHub Actions（.github/workflows/registry.yml）定时爬取并提交更新索引。
Agent 工具示例
market_search q=记忆 kind=plugin # 搜索插件
market_install spec=owner/repo # 安装（风险仓库会要求确认）
market_installed # 已安装清单 + 更新状态
market_update name=xxx # 更新插件
架构
dsh-whale-market/
├─ package.json dsh.bundle.patch + dsh.client（web）声明
├─ cordis.patch.yml bundle 补丁（id: whale-market）
├─ adaptor.json 错标仓库重定向适配层
├─ lib/
│ ├─ index.js 宿主半侧（零依赖，纯 Node 内建）：
│ │ GitHub/静态索引 → 类型检测 → 安装任务 → HTTP API → Agent 工具
│ ├─ client.js 浏览器半侧（web lazy-CJS，无构建步骤）
│ ├─ categories.json 13 个分类规则（社区可维护）
│ ├─ registry.json.gz 静态插件索引（4260 条）
│ └─ skills.json.gz 静态技能索引（2000 条）
├─ scripts/build-registry.mjs 索引构建（导入/爬取双模式）
├─ .github/workflows/registry.yml CI 定时刷新索引
├─ install.ps1 一键安装脚本
├─ docs/ROADMAP.md 功能规划
└─ test/host-smoke.mjs 隔离环境端到端测试（60 项）
HTTP API（同源 + loopback + 写操作 CSRF 头）
| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /plugins/dsh-whale-market/list | 市场列表（kind/category/language/sort/favorite） |
| GET | /plugins/dsh-whale-market/meta | 分类/语言/静态索引状态 |
| GET | /plugins/dsh-whale-market/info | 类型检测 + 兼容性评分 + 危险扫描 |
| GET | /plugins/dsh-whale-market/installed | 插件 + 内容安装清单 + 自更新状态 |
| GET | /plugins/dsh-whale-market/dashboard | 数据大盘 |
| POST | /plugins/dsh-whale-market/install | 安装（409 需确认） |
| GET | /plugins/dsh-whale-market/install/status | 任务进度 |
| POST | /plugins/dsh-whale-market/install/cancel | 取消任务 |
| POST | /plugins/dsh-whale-market/set-enabled · /update · /uninstall | 管理 |
| GET/POST | /plugins/dsh-whale-market/favorites · /favorite | 收藏 |
| GET | /plugins/dsh-whale-market/history · /backup · /audit | 历史 / 备份 / 审计 |
| POST | /plugins/dsh-whale-market/restore（+/status） | 恢复 |
| GET/POST | /plugins/dsh-whale-market/env | 环境变量管理 |
| GET/POST | /plugins/dsh-whale-market/feedback | 安装反馈（GitHub Issue） |
| GET/POST | /plugins/dsh-whale-market/notifications | 收藏更新通知 |
| POST | /plugins/dsh-whale-market/self-update | 市场自更新 |
| POST | /plugins/dsh-whale-market/backup/webdav | WebDAV 备份 |
| POST | /plugins/dsh-whale-market/author/scaffold · /author/check | 作者工具 |
| GET | /plugins/dsh-whale-market/status | 市场状态（profile/CLI） |
安全与注意事项
- 安装第三方插件 = 运行第三方代码（pnpm 可能执行构建脚本 / 脚本型仓库会执行 install.sh/ps1）。安装前先审阅仓库源码；市场会给出类型判定、兼容性评分与危险模式扫描结果并要求确认。
- 安装/更新/卸载/开关后需要重启 DSH 才生效（技能热加载除外）。
- 只支持安装到市场自身所在的 profile。
- 环境变量编辑不会写入备份文件（密钥不进备份）。
更新日志
- v0.2.0（2026-08-16，第三方体检反馈落地）
- 修复危险模式扫描静默失效 bug（双重）：①
scanScriptHazards缺const text = await res.text()，正则抛错被空 catch 吞掉，危险命中恒为 0；② downloadExec 正则要求管道后紧跟 sh，真实场景多为" | sh"（带空格）永远无法命中。已拆出纯函数scanScriptText（修复正则 + 5 条单测） - 索引构建期验证：
build-registry.mjs --verify探测仓库 package.json 是否声明 dsh 能力，产出verified标记；列表支持verified=1只看已验证；meta 上报验证统计 - Agent 工具注册开关
agentTools（off 时让位官方内置同名market_*工具） - 种子索引（seed）与列表均走适配层，剔除 reactive-resume / OpenViking / zhuzhiliao / yao 等误标仓库
- 测试进 CI：syntax check + host-smoke（无 dsh CLI 时自动跳过安装类用例）
- 修复危险模式扫描静默失效 bug（双重）：①
参考与致谢
架构参考了开源生态（吸收其思路、按需取舍）并致谢：
- bradeGithub/DSH-Plugins-Marketplace — 类型检测/安全审查/反馈体系/静态索引构建
- AwesomeHou/dsh-plugin-marketplace — 异步安装任务/进度/Agent 工具
- Noob-stupid/dsh-plugin-hub — 面板 + 市场一体化
- With-With/dsh-hindsight-plugins — 零依赖宿主 + settings.plugins.tab 注入范式
License
MIT
No comments yet. Be the first to write one.