npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-desktop-embed

v1.3.0

Published

Embed the desktop DSH UI inside DSHA's WebView instead of handing it to the system browser: a loopback reverse proxy on the phone plus an iframe shell page.

Readme

dsh-desktop-embed

为 dsh-desktop-link 的下半场而生。 那个插件把手机送到电脑版门口;这个插件负责把门整个搬进 DSHA——桌面界面直接嵌在 DSHA 里用,不再跳外部浏览器。

它解决什么

dsh-desktop-link 的行为是「跳转」:手机上的顶层导航离开本机服务时,DSHA 按设计把它交给系统浏览器(WebPreviewActivity.shouldOverrideUrlLoading → openExternal)。于是界面进了 Chrome / 夸克,DSHA 只剩一个壳,原生外壳的价值就没了。

dsh-desktop-embed 换成另一种走法:手机上开一个回环反向代理,用一个 iframe 把电脑版界面装进来。

DSHA 的 WebView
 └── 顶层文档  http://127.0.0.1:<手机 DSH 端口>/embed      ← 始终是本机服务,DSHA 不管
      └── iframe  http://127.0.0.1:8799/                  ← 本插件的反向代理
           └── https://<你的中继>/pair-app                 ← 电脑上的 dsh web

三层里只有最里面是真的远端。中间那层由插件自己持有 dsh_pair cookie 并在服务端注入,所以浏览器侧完全不需要第三方 cookie——正好绕开 DSHA 关掉的 AcceptThirdPartyCookies。

两条 DSHA 的既有行为被这个结构利用上了:

  • shouldOverrideUrlLoading 只接管 main frame,iframe 显式放行(源码注释原文:「插件的 iframe / 内嵌预览保持 WebView 原有行为,只接管顶层导航。」)。
  • WebPreviewPolicy.loopbackBaseUrl 接受 任意回环端口(http://127.0.0.1:<1..65535>/),不只是 DSH 自己那个端口——所以 8799 也是一个合法的「本机服务」。

代理挂在根路径上,所以 /assets/…、/plugins/…、/api/… 全部照常穿过。三处路径改写是实测出来的,缺一个页面就起不来:

| 进来的路径 | 发给中继的路径 | 为什么 | |---|---|---| | / | /pair-app | 中继的 / 是「认证门」,带着有效 cookie 也只回 401;应用页在 /pair-app | | /api/… | /remote/api/… | 中继把已认证 API 挂在 /remote 下。GET 两个前缀都通,但 POST/PUT 只认 /remote/api/…,裸 /api/* 会被桌面 api-gateway 回 403 forbidden,页面就永远停在「Loading plugins…」 | | 其它 | 原样 | <base href="./"> 让资源和插件目录仍落在 /assets/…、/plugins/… |

装在哪一侧

手机侧(DSHA 内置的那个 DSH)。页面由手机自己的 DSH 提供,代理也跑在手机上。

dsh plugin --profile web add dsh-desktop-embed

装完刷新页面,侧栏底部多一个「桌面版」按钮。

第一次使用:填两个值

点侧栏的「桌面版」按钮会先打开 /embed/setup(纯表单,没有 JavaScript):

| 字段 | 填什么 | |---|---| | 中转地址 | dsh-desktop-link 那套 bridge.py 的地址,例如 http://192.168.100.2:8791 | | 中转密钥 | bridge-secret.txt 里的那串 hex | | 代理端口 | 留空用默认 8799;被占用就换一个 1024–65535 |

提交后插件会立刻向桥要一次配对链接(GET /link)、跟一次 /pair-accept,把 dsh_pair 拿在手里,然后 303 跳到 /embed。

配置落在 $DSH_HOME/dsh-embed.json(权限 0600)。也可以用环境变量覆盖:

export DSH_EMBED_BRIDGE_URL=http://192.168.100.2:8791
export DSH_EMBED_BRIDGE_KEY=<bridge-secret>
export DSH_EMBED_PORT=8799

自检

curl -s http://127.0.0.1:8799/embed/setup -H 'sec-fetch-site: none' | grep -o 'name="[a-zA-Z]*"'

手机端更直接:点按钮 → 填两个值 → 页面里出现电脑版界面,且地址栏仍是 127.0.0.1。

为什么第一次打开慢,以及 1.1.0 做了什么

手机上第一次打开要等一两分钟,主要不是「电脑慢」,是这条链路上重复了太多工作:

  • 每取一个资源都新建一条 TCP + TLS 连接;界面的框架资源有几十个,手机上每次握手几百毫秒,串起来就是一分钟。
  • 入口页引用的主 JS 单文件约 940 KB,从中继直取实测 6.05 秒。
  • 用户在点按钮之后才开始取,前面这段时间完全是干等。

1.1.0 加了四件事:

| 改动 | 效果(同一台中继上实测) | |---|---| | 连接池(keep-alive,maxSockets 16) | 同一台中继的请求复用连接,不再每次重新握手 | | 启动时预热:先把入口页和它引用的 /assets、/plugins 资源拉进内存缓存 | 点按钮时框架资源已经在本地 | | 静态资源缓存(按内容哈希为键,上限 96 MB)+ 并发请求合并 | 主 JS 941436 B:中继直取 6.05 s → 命中缓存 1.7 ms | | /embed 加载进度层(步骤文案 + 秒表 + 「已预热 n/m」) | 不再是白屏干等;实测「页面载入 → 界面就绪」约 4.5 s(缓存热) |

预热是自动的:插件启动时若已有配置就立即开始,保存设置后也会再跑一次。缓存只在内存里,DSH 重启就没了——重启后的第一次打开会慢一些,之后又是快的。

排查「为什么还是慢」:

curl http://127.0.0.1:<手机 DSH 端口>/api/dsh-embed/status

返回里的 cache.entries / cache.bytes / warm(资产数、成功数、耗时)就是预热结果;warm.ok=false 时看 warm.error。

1.2.0 修了什么(「Failed to load plugins」那次)

手机上报 Failed to load plugins、进度卡在 23%、底下列出二十几个 @deepseek-ai/dsh-client-*,看着像插件集体坏了,其实是两件事叠在一起:

一、中继在配对失效时回的是 200,不是 401。 会话过期后(桌面 dsh web 重启、重新配对都会触发),中继对任何路径都回一个 2056 字节的 text/html 页面「Pairing link invalid / 配对已失效」。浏览器把它当 application/javascript 去解析,每个插件的 chunk 都语法错误 —— 于是整片插件加载失败。1.2.0 在代理层识别这个页面(looksLikeInvalidPair,只对小于 8 KB 的 HTML 做判断,不会误伤 60 KB 的真页面),一旦命中就丢掉 cookie、重铸一次、把同一个请求重发,并清掉入口缓存;重铸还失败才回 503 页并给一个「重新配对」链接(/embed/remint)。

二、/plugins/??a,b,c 这种合并请求被缓存键串了味。 这种请求的 pathname 只有 /plugins/,真正的区别在查询串。1.1.0 的缓存键漏了查询串,于是「先取到的那一组插件」会被当成所有组的答案发给后续请求 —— 同样是整片失败。1.2.0 把 search 并进键里。

顺手还修了两个只有代理自己知道的问题:

| 问题 | 症状 | 修法 | |---|---|---| | 上游的 transfer-encoding: chunked 被原样转给下游,同时我们又写了 content-length | 客户端报 HPE_INVALID_CONTENT_LENGTH: Content-Length can't be present with Transfer-Encoding | downstreamHeaders 也过滤 HOP_BY_HOP | | 判断「是不是失效页」用的 16 KB 缓冲上限,顺手把 61 KB 的入口页也判成「太大不缓冲」 | 入口页不再注入样式、不进缓存、每次都要重新取 | HTML 单独给 MAX_HTML_BYTES = 2 MB,只有超过 2 MB 才透传不注入 |

回归测试(不碰真实桌面,假中继 + 假 bridge):

node dsha-pair/test_embed_units.mjs       # 23 项:失效页识别 / 路径改写 / 缓存键 / 资源提取
node dsha-pair/test_embed_recovery.mjs    # 17 项:失效自愈 + 缓存命中 + 合并请求键隔离

手机上的排版

iframe 与外层不同源(端口不同),外层改不了里面的 DOM,所以排版修补放在代理这一层:给经过的入口页注入一张样式表,规则全部关在 @media (max-width: 1023px) and (pointer: coarse) 里——

  • 按钮、[role=button|tab|menuitem|option] 最小 40×40,输入框最小高 40 且字号 16px(小于 16px 时 iOS / 部分安卓会放大页面)
  • 侧栏 / 抽屉最大 88vw,不再盖住全部内容
  • 表格横向滚动而不是撑破页面,图片视频限宽,正文禁止横向溢出
  • 文本域底部留 env(safe-area-inset-bottom),软键盘弹起时输入框不被顶掉

桌面上这条 media query 不匹配,所以不影响电脑端观感。

已知限制

  1. Secure cookie 不能用明文 http 送过去。 中继的 dsh_pair 带 Secure;手机 → 中继这一段如果是 https://(中继本身就是 https,正常情况都满足),代理拿着 cookie 发请求没问题。但如果你的 bridgeUrl 指向一个 http 桥,插件只是拿它当「取链接的信使」,不拿它传 cookie,所以照样可用。
  2. 中继掉线要重新配对。 令牌 600 秒过期,会话 cookie 名义上一年,但服务端会话会单独失效(桌面 dsh web 重启、重新配对之后就会失效,且失效时中继回 200 的 HTML 而不是 401)。1.2.0 起代理两种情形都能识别并自动重铸一次再重试,所以正常无感;实在不行点 /embed/remint。若中继换域名(*.trycloudflare.com 就是这样),要在 /embed/setup 里改 bridgeUrl。
  3. /embed 不接管键盘快捷键:DSHA 的返回手势会直接退出这个页面(顶层导航回对话列表),这是 WebView 的正常行为。
  4. 只支持 http://127.0.0.1:DSHA 的预览策略只认回环明文。别把代理绑到 0.0.0.0,也没必要。
  5. 中继不转发的部分插件静态资源会 403:中继只放行 /api、/assets、/plugins/??… 目录批量加载和 /pair-app;个别插件用绝对路径挂的自己的静态文件(实测 dsh-whale/widget.js、dsh-pet/pet.js、/plugins/<插件>/state)会 403。它们都是可选挂件,界面照常可用,控制台里会留几条 403。
  6. iframe 里的页面禁止混合内容(MIXED_CONTENT_NEVER_ALLOW):中继页面上的跨站资源只有一条 https 的 .webmcp/bridge.js,被同源策略挡掉,无害。

与另外两个插件的关系

| 插件 | 装在哪 | 干什么 | |---|---|---| | dsh-desktop-link | 手机 | 侧栏按钮 + /desktop-link/settings;把手机送到电脑版门口(跳浏览器) | | dsh-desktop-embed | 手机 | 侧栏按钮 + /embed;把电脑版界面嵌在 DSHA 里(不跳浏览器) | | dsh-mobile-boost | 电脑 | 让电脑版界面在窄屏触摸下真的能用 |

装 dsh-desktop-embed 之后,仍然建议在电脑 profile 里装 dsh-mobile-boost:嵌入的界面是电脑版页面,窄屏适配由它负责。

License

MIT © 2026 lzlrt

和另一个「桌面版」插件的关系

侧栏文案区分两者:桌面版 · 新窗口(本插件,交给系统浏览器)对 桌面版 · 嵌在这里(dsh-desktop-embed,留在 DSHA 里 iframe 内嵌)。

两者状态互不共享,装哪个都行,也可以同时装;两份都装的代价只是侧栏多一个按钮。完整对照表见 REMOTE-PLUGINS.md(另一份同内容文档在本地 Z:\dsh\dsha-pair\REMOTE-PLUGINS.md)。