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-link

v1.4.0

Published

DSH sidebar button: open the desktop DSH Web GUI from DSHA on your phone, in one tap.

Readme

dsh-desktop-link

在 DeepSeek Harness(DSH) 的侧栏底部加两个按钮:一个点一下就在系统浏览器 / 新标签页里打开桌面版 DSH 的 Web GUI,另一个(齿轮)用来在界面里直接填地址。

专门为 DSHA(DeepSeek Harness 安卓启动器) 设计 —— 在手机上的 DSHA 里点这个按钮,会交给系统浏览器打开你电脑上的 DSH,而 DSHA 自己那套 agent 照常独立运行。

🖥 →  桌面版      ⚙

npm license

dsh plugin --profile web add dsh-desktop-link

它解决什么

DSHA 的内置浏览器只导航它自己的 http://127.0.0.1:<端口>,没有「填个网址去连别的机器」的入口。 但 DSHA 本来就有这条规则:顶层导航离开本机 DSH 服务时,交给系统浏览器(WebPreviewActivity.shouldOverrideUrlLoading → ACTION_VIEW)。

这个插件就是给这条已有规则加一个按钮入口 —— 不改 DSHA、不需要 root、不需要 am start。


行为

| 点击环境 | 结果 | |---|---| | 手机(DSHA 的 WebView 或手机浏览器) | 导航离开 DSH 服务 → DSHA 交给系统浏览器 → 打开桌面版 GUI | | 电脑浏览器 | target="_blank" 开新标签页,当前 GUI 不受影响 |

未配置地址时按钮变灰;此时点它会直接打开齿轮那个设置框,不会跳到一个死链。


安装

从 npm(推荐)

dsh plugin --profile web add dsh-desktop-link

从本仓库(开发循环)

git clone https://github.com/lzlrt/dsha-desktop-link
dsh plugin --profile web add link:$(pwd)/dsha-desktop-link

从打包好的 tgz

dsh plugin --profile web add /path/to/dsh-desktop-link-1.2.0.tgz

装到手机上的 DSHA

DSHA → 插件 → 添加 → 粘贴一个能下到这个包的 URL,例如:

https://registry.npmjs.org/dsh-desktop-link/-/dsh-desktop-link-1.3.0.tgz

或在 DSHA 插件页直接填包名 dsh-desktop-link(永远装最新版)。

或从本地导入(adb push 到 /sdcard/Download/ 后在插件页选文件)。

装完在插件管理页点「重启 Web」。


配置地址

在界面上填

点侧栏底部那个齿轮 → 填两个框 → 保存。写盘、立即生效,不用重启、不用碰命令行。

桌面浏览器和手机走的是两条不同的路:

| 在哪点 | 打开的是 | 说明 | |---|---|---| | 桌面浏览器 | 页面内的浮层对话框(React) | 就地改,保存后按钮立刻可用 | | 手机(DSHA 的 WebView) | GET /desktop-link/settings 的服务端渲染页面 | 纯 HTML 表单,零 JavaScript |

手机为什么单开一条路:在 DSHA 的 WebView 里点保存会让渲染进程直接退出 (onRenderProcessGone,App 跟着关掉)。同一个操作在桌面浏览器和 0.2.1-rc.2 的普通浏览器里都复现不出来,能确定的只有「手机 WebView + 一次表单提交 + 一次 React 重渲染」这个组合。所以手机上干脆不给脚本:齿轮是一个普通链接, 点开就是服务器渲染的一页 HTML,提交是一次最普通的表单 POST,回一张「已保存」。 那一页没有 React、没有覆盖层、没有软键盘适配问题,也就没有能崩的东西。

┌─────────────────────────────┐
│ 桌面版地址                    │
│ 填好点保存,回到 DSH 点「打开桌面版 DSH」即可。│
│ 已保存到 /data/.../desktop-url.txt          │
│                             │
│ 桌面版地址                    │
│ [https://xxxx.dsh-market.com] │
│ 长期地址,书签用;留空则回到自动探测的中继地址。│
│                             │
│ 点按钮时打开的地址              │
│ [https://…/open.html?k=…    ] │
│ 一般留空,会和上面一样。         │
│                   [     保存     ] │
│ ← 回 DSH                     │
└─────────────────────────────┘

保存会写进 $DSH_HOME/desktop-url.txt(先写临时文件再 rename,半个文件不会被读走; rename 被文件系统拒绝时退回直接覆写 —— Android 的 proot rootfs 会这样)。 两个框都清空 = 删掉该文件,退回自动探测。

设置页的提交带一个一次性 token(10 分钟有效,用完即废),所以那张页面被转发、 被回放都不会重复写盘。桌面的浮层对话框则按「绝不可能把页面搞挂」设计:不用 <form>, 按钮都是 type="button",外层包 error boundary —— 万一渲染抛错,只在这个位置显示 一行说明,侧栏和会话都不受影响。

界面坏掉时的兜底(一个网址就能改)

不想点界面、或者界面在某个 WebView 里表现不正常,就直接访问:

http://127.0.0.1:<DSH 端口>/api/desktop-link/set?desktopUrl=https://xxx.dsh-market.com
http://127.0.0.1:<DSH 端口>/api/desktop-link/set?desktopUrl=https://xxx.dsh-market.com&launchUrl=https://…/open.html?k=…

返回一张「已保存」的小网页,写的还是同一个 desktop-url.txt。 这条路只接受同源请求(Sec-Fetch-Site: cross-site 与外站 Origin 一律 403), 地址栏直接输入(没有 Origin)是放行的。

在 DSHA 终端里一行搞定

DSHA 有终端,插件的 Host 半区是每次请求重新读文件的,所以写文件就等于改配置、 不用重启:

echo 'https://4217332722d23859.dsh-market.com' > ~/.dsh/desktop-url.txt

第一行长长期地址,第二行(可选)是点按钮时打开的地址。

用配置文件

插件自身不带默认地址 —— 它从下面这些地方按顺序找,命中即停:

| 优先级 | 来源 | |---|---| | 1 | 本行 config.desktopUrl / config.launchUrl(profile 补丁里) | | 2 | 环境变量 DSH_DESKTOP_URL / DSH_DESKTOP_LAUNCH_URL | | 3 | $DSH_HOME/desktop-url.txt 第 1 行(桌面地址)/ 第 2 行(点击时打开的地址) | | 4 | $DSH_HOME/remote-web-ui-registry/web.json 的 id → https://<id>.dsh-market.com(仅当装了 dsh-remote-web-ui 并开了固定域名中继) |

desktop-url.txt 是最好改的一个 —— 改完刷新页面即生效,不用重启:

# 第一行:桌面版长期地址(书签、复制链接用)
https://your-desktop.example.com

# 第二行(可选):点按钮时真正打开的地址。
# 指向一个「每次铸新配对码」的端点,未配对的手机也能一次进。
https://your-desktop.example.com/pair-entry

只写一行 = 按钮直接开那一行。删掉文件 = 退回优先级 4。

两种地址的区别

| 字段 | 用途 | |---|---| | desktopUrl | 长期地址。锚点的 href 用它,中间键 / 复制链接 / 收藏都按这个走 | | launchUrl | 点击时实际打开的地址。可以是一个会临时铸码的端点,让从未配对过的设备也能一次进入 |

没配 launchUrl 时它等于 desktopUrl。


未配对的手机会看到 401

DSH 的远程访问是要配对的。未配对设备直接打开桌面地址会被 harness 的认证栅栏拒绝 —— 这是配对机制正常工作,不是这个插件的 bug。

三种处理方式:

  1. 先配对一次:配对 cookie 默认有效期一年,之后点按钮直接进。
  2. 配 launchUrl 指向铸码端点:每次点击拿新码,永远有效。
  3. 手机端自动铸码:若本机装了 dsh-remote-web-ui,手机点击时插件会先调同源 /api/pair/issue 铸一枚一次性码再跳转(该接口只应答回环,所以页面能直接调)。没装则自动退回直接打开 desktopUrl。

接口

| 方法 | 路径 | 说明 | |---|---|---| | GET | /api/desktop-link/info | {"ok":true,"launchUrl":"…","desktopUrl":"…","source":"…"} | | POST | /api/desktop-link/config | body {"desktopUrl":"…","launchUrl":"…"} → 写入 desktop-url.txt,返回写入后的解析结果与 path |

| GET | /api/desktop-link/set?desktopUrl=…&launchUrl=… | 同上,但用查询参数、回一张 HTML 小页面 | | GET | /desktop-link/settings | 手机用的设置页(纯 HTML,无 JavaScript,带一次性 token) | | POST | /desktop-link/settings/save | 表单提交(application/x-www-form-urlencoded + 一次性 token)→ 200「已保存」 |

POST 只接受 http(s) URL:传了非空值但格式不对会返回 400 并说明原因,不会静默清空。 请求体上限 8 KiB,非 POST 返回 405,Content-Type 不是 application/json 返回 415。


准入:所有路由都过 DSH 自己的围栏

webServer.register({ kind: 'exact' }) 挂的路由不在 Connection 围栏之内 —— 真正过围栏的 只有 /api 网关和 ctx.connection.fetch.register 注册的精确路由。所以每条 handler 入口都先调 ctx.connection.requestRejection(req):

| 情况 | 结果 | |---|---| | Host / Origin 不是本实例 | 403(挡 DNS rebinding、挡外站页面) | | 没有已配对的会话 | 401(/set 回一张「需要已配对的浏览器」的页面) | | 通过 | 照常处理 |

没有 Connection 服务的 profile 会退回到自己的检查:Sec-Fetch-Site: cross-site 直接拒, 带 Origin 时要求 host 相同,没有 Origin(地址栏直接敲)时要求 Host 是本机回环地址 (127.0.0.1 / localhost / [::1])。弱在没有配对状态,但照样钉死 Host 与 Origin。

POST /config 还有第二道锁:只收 application/json。跨站页面能免预检发出去的 「简单请求」只能是 text/plain / 表单编码,这条路把它们挡在 415, 而且不会再把非 JSON 的 body 当表单解析。

GET /info 也要过围栏,因为 launchUrl 里可能带一次性配对密钥(?k=…)。

/desktop-link/settings 两条路由同样先过围栏,并且 POST 只收自己表单发出的 application/x-www-form-urlencoded(别的 Content-Type 一律 415),外加一次性 token。

每次请求重新解析地址,所以改配置文件不需要重启。 另外 Host 半区会在 webserver/index-inject 里注入 globalThis.__DSHA_DESKTOP_LINK__,让按钮首帧就能拿到地址;全局缺失时 Client 半区回退到上面那个接口。


结构

package.json          清单:dsh.bundle.patch + dsh.client(platform: web)
cordis.patch.yml      插入一行 dsha-desktop-link
index.js              Host 半区:地址解析 + /info + /config + /set + /desktop-link/settings + index 全局
client.js             Client 半区:注册 sidebar.footer.action ×2 + 桌面浮层设置框(手机改走设置页链接)
icon.svg              显示器 + 外跳箭头
locale/{zh,en}.json   meta.title / meta.description

实现要点

  • 注册 sidebar.footer.action 两次(replaceRisk: none):启动按钮 order: 10,齿轮 order: 11,都排在官方「远程访问」之后。
  • 设置框跟齿轮挂在同一棵组件树里(position: fixed 覆盖层),不额外 createRoot —— 这样不依赖 react-dom/client 是否在页面可 require 的白名单里。
  • 两个按钮之间的状态用一个模块级 store 同步,保存完另一个立刻拿到新地址,不用刷新。
  • Config 导出是可选的:@deepseek-ai/schemastery 只存在于 DSH 安装内部,运行时按包名 → process.argv[1] 上溯 → Node 全局路径依次找;找不到就整个不导出 Config,插件照常工作,只是没有 DSH 自带的设置表单。
  • 手机与电脑的分支靠 navigator.userAgent 判定;桌面侧完全走原生锚点行为,不拦点击。

已知限制

  1. Host 半区(index.js)改动需要重装插件或重启 dsh web;Client 半区(client.js)刷新页面即生效(有 pnpm run dev:web 监听时可免刷新)。
  2. 侧栏折叠成 56px 轨道时只显示图标,展开后才显示「桌面版」文字。
  3. 手机端「点击时铸码」依赖本机装了 dsh-remote-web-ui(本插件不声明这个依赖,装不装都能用,只是没有自动铸码)。
  4. 需要 DSH >= 0.2.1-rc.2(webserver/index-inject 事件与 sidebar.footer.action 槽位)。
  5. DSHA 把 DSH 锁在 0.2.1-rc.2,那一版没有 @deepseek-ai/schemastery,所以手机上不会出现 DSH 自带的插件设置表单 —— 这正是本插件自带齿轮与 /set 路由的原因。
  6. 手机上的齿轮是普通链接,会离开 DSH 的会话界面去 /desktop-link/settings;保存后点「← 回 DSH」或直接后退即可回来,会话不丢。
  7. DSHA 的 profile 启动失败时会退到极简 recovery profile(只剩基础界面);如果界面突然"变回出厂样子",先看启动日志里 [DSHA_STARTUP] 那几行。

License

MIT

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

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

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