dsh-market-peek:在 DSH 内预览插件市场条目

前言

在 DeepSeek Harness 里逛插件市场时,常见做法是点卡片标题,系统浏览器打开 GitHub 仓库或 README。内置实验性市场能看来源、版本和安装信息,却不展示 README。要判断一个插件是否值得安装,往往要在 DSH 和浏览器之间来回切换,或手动复制仓库地址。临时打开的页签、拖宽的面板、展开的右侧栏,离开市场后也不会自动还原,下次又要重新摆一遍。

dsh-market-peek 由维护者 LyuYuxin 发布,分类为客户端插件。它不把市场页面换掉,也不改市场数据;只在点击卡片时决定把仓库或 README 展示在 DSH 内部,并在离开市场后恢复原状。社区目录页:https://www.skillhub.cn/plugins/LyuYuxin/dsh-market-peek;源码与说明见 GitHub:https://github.com/LyuYuxin/dsh-market-peek。

这是什么

一句话:dsh-market-peek 在 DeepSeek Harness 的插件市场里,把「看插件仓库和 README」留在 DSH 内部——右侧栏可用时用内置浏览器打开仓库,否则在市场旁停靠 README 面板。安装、收藏、评论、截图等按钮保持原行为。

当前 npm 版本为 0.2.1,许可证 MIT。要求 DeepSeek Harness >= 0.2.1-rc.3(Desktop 或 dsh web),并已启用社区市场 dshmarket 或 DSH 内置实验市场之一。

核心功能

点击预览,不抢市场按钮

点插件标题或卡片空白处会触发预览;安装、收藏、评论、截图等控件仍走市场原有逻辑。按住 Ctrl、Cmd、Shift 或 Alt 再点,则这一次强制用系统外部浏览器打开。

两种展开方式

  1. 会话页且右侧栏可见:通过 DSH 官方的 ctx.sidebarRight 服务,在内置浏览器里打开 GitHub 仓库;连续点不同插件时复用同一个预览页签。若右侧栏原本收起,会先展开,离开市场后再收起。
  2. 整页市场且无可见右侧栏:在市场右侧停靠 README 面板,市场自动缩窄让位;可拖面板左边缘调宽,按 Esc 或面板上的 × 关闭。

README 加载与界面

README 依次尝试:GitHub API 渲染版、raw.githubusercontent.com 上四种常见文件名、jsDelivr 镜像;单次请求 12 秒超时,正文上限 2 MiB。面板跟随 DSH 主题变量与当前语言(中文 / English)。内容在无脚本权限的 iframe 中展示,并配有严格 CSP,README 内脚本不会执行。

离开即恢复

切换到其他页面、会话或离开市场后,停靠面板关闭、市场宽度恢复、预览页签关闭;解析过的 README 缓存(5 分钟、最多 24 条)同时清除。

持久化设置

设置 存储键 默认 说明
点击行为 localStorage 的 dsh-market-peek:mode here(此处展开) 面板右下角可切为 external(外部浏览器)
面板宽度 localStorage 的 dsh-market-peek:width 窗口宽度的 40% 最小 360 px,且至少给市场留 320 px

支持的插件市场

插件市场 已验证版本 触发方式
dshmarket(社区插件市场) 1.73.3 点卡片标题或空白处
@deepseek-ai/dsh-client-ui-plugin-market(DSH 内置实验市场) 0.2.1-rc.3 点卡片;详情页仍照常打开,预览通过 remote.pluginMarket 解析仓库
其他或更旧市场 — 不接管,保持原行为

内置市场卡片不带仓库 URL,首次点击需一次本地服务往返;解析失败时不拦截点击。插件只接受 github.com / www.github.com 的 https 仓库地址。

安装与启用

前提:DSH 版本满足 >= 0.2.1-rc.3,且已启用上述市场之一。

从 npm 安装(推荐):

dsh plugin --profile desktop add dsh-market-peek

从 GitHub 安装:

dsh plugin --profile desktop add github:LyuYuxin/dsh-market-peek

装好后打开插件市场,点任意插件卡片验证预览是否出现。客户端插件改动后刷新页面即可生效。

典型用法

  1. 打开插件市场,点某插件标题或卡片空白处。若当前是会话页且右侧栏可见,仓库会在右侧内置浏览器中打开;若是整页社区 dshmarket,README 面板会停靠在市场右侧。
  2. 需要对比多个插件时,连续点不同卡片;内置浏览器模式复用同一页签,停靠模式在同一面板内换内容。
  3. 若希望恢复「一点就跳浏览器」,在面板右下角把点击行为改为「外部浏览器」,或单次按住修饰键再点卡片。
  4. 看完后切到其他页面或关闭市场;面板、页签和右侧栏状态会自动还原。

适用场景与注意

适合谁: 经常在 DSH 里逛社区 dshmarket 或内置实验市场、希望少开外部浏览器、在装插件前快速扫 README 的开发者。

运行与信任: 插件以当前 DSH 进程权限在客户端注入运行;安装前应阅读源码与 MIT 许可证,确认接受其从 GitHub API、raw.githubusercontent.com、cdn.jsdelivr.net 拉取 README 的行为。未登录时 GitHub API 每小时约 60 次,超限后会回退 raw / jsDelivr;私有仓库 README 读不到。社区市场 DOM 依赖 dshmarket 的 CSS-module 约定,市场大改版时预览可能失效,插件会退回不拦截。

已知限制摘要: 仅支持 GitHub 仓库;raw 回退使用简化 Markdown 渲染;停靠模式通过 margin-right 让位,个别固定宽度页面可能与面板叠在一起,可拖窄面板或依赖右侧栏浏览器模式。

结尾

dsh-market-peek 解决的是「逛市场时不离开 DSH、看完还能还原界面」这一具体问题,不替换市场本身。若要安装或查看变更记录,请以仓库 README 与 CHANGELOG 为准。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜