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-mobile-next

v0.2.3

Published

DSH 移动端接入插件:局域网 HTTPS + iroh 加密远程通道 + 独立设备配对

Readme

dsh-mobile-next

DSH 移动端接入插件(自研)。提供两条互相独立的通道:

  • 局域网:手机通过局域网 HTTPS 访问电脑上的 DSH,带设备配对认证。
  • 远程通道(iroh,实验性):加密直连优先、中继兜底,不需要域名或公网端口;需要本机原生组件与支持 iroh 的 App。见 iroh 接入说明。

版本更新记录见 更新日志。

手机浏览器访问(无需安装 App)

手机与电脑网络互通后,在 Safari / Chrome 打开 https://电脑IP:3444/:

  • 首次访问或会话失效:显示网页登录页,粘贴电脑「移动访问」面板生成的局域网配对链接,点击「配对并进入 DSH」。也可直接在目标浏览器中打开配对链接,自动配对并进入。
  • 已有有效登录状态:直接进入真实 DSH 网页。
  • 登录失败:页面提示令牌过期、尝试次数过多或网络超时,可重新生成链接后重试。

HTTPS 的私有 CA 需要在手机上安装并信任。登录 Cookie 仅属于完成配对的浏览器,App / 扫码软件内置浏览器的配对不会自动登录 Safari / Chrome。浏览器暂不持久化长期设备令牌或自动续期,会话过期后需重新配对。

公开登录页不代表匿名开放 DSH:API、WebSocket 和其他受保护路径仍要求有效会话,电脑管理接口仍不允许经网关调用。独立 iroh 远程入口保持原有认证协议。

状态

| 项 | 状态 | | --- | --- | | 类型检查 | ✅ tsc --noEmit 无错 | | 测试 | ✅ 162 passed, 2 skipped(13 个文件) | | 构建 | ✅ host + client 构建通过 | | 装进 DSH | ✅ 已加载(host + client 双面) | | 界面 | ✅ 侧栏一键开全屏面板,真实页面验证过 | | 端到端 | ✅ 配对 → 访问 DSH → 安全边界全通过 |

界面:侧栏一键直达的全屏面板

浅色主题

┌──────────────────────────────────────────────────────────┐
│ 移动访问  ● 已开启              [诊断] [设备 3] [✕]       │
├──────────────┬───────────────────────────────────────────┤
│ 局域网 已开启 │ 浏览器访问 https://192.168.1.5:3444 [⧉] │
│ 同一 Wi-Fi…  │                                           │
│              │              ┌──────────┐                 │
│ 远程通道     │              │  二维码   │                 │
│ iroh 已关闭  │              └──────────┘                 │
│              │  ● 用手机扫码配对 · 剩余 4:32              │
│              │  [复制配对链接] [重新生成] [关闭访问]       │
│              │  ▸ 高级:网卡 · 端口 · CA 指纹             │
└──────────────┴───────────────────────────────────────────┘

三个为「快速操作」做的设计决定:

  1. 侧栏图标直达(sidebar.panellist)—— 不再翻设置页找折叠行。
  2. 开箱即出码 —— 面板打开时若网关已开启,自动生成二维码, 少点一次。每个面板实例只自动生成一次,避免过期后无限重开。
  3. 主操作随状态变 —— 没码时是「生成」,有码时是「复制链接」, 用户永远只有一个"下一步点哪个"的答案。

面板状态矩阵(穷举,见 src/client.tsx 文件头):

| 网关 | 徽标 | 主操作 | | --- | --- | --- | | stopped | 已关闭 | 开启局域网访问 | | starting | 启动中 | disabled(骨架) | | running 无码 | 已开启 | 生成配对二维码 | | running 有码 | 已开启 | 复制配对链接(+ 倒计时) | | running 码过期 | 已开启 | 重新生成配对二维码 | | error | 出错 | 重试 / 诊断 | | 无候选网卡 | 未就绪 | 重新扫描 |

分发:打包验证通过

本地开发用软链接(node_modules/dsh-mobile-next → 源码目录), 但软链接不能分发给别人。真实分发走 tarball:

pnpm pack --pack-destination ./dist # → dist/dsh-mobile-next-0.2.3.tgz
node scripts/verify-package.mjs    # 验证可独立安装并加载

验证内容:

包内文件       ✅ 10 个(lib/*.js + index.d.ts + locale + icon + patch + README)
入口解析       ✅ main / types / exports["."] / exports["./client"] / locale / icon
独立安装       ✅ 在干净项目里 pnpm add 成功
两面加载       ✅ host: inject=[webServer, connection]
                  client: loader id 正确,导出 apply + inject

依赖分类已修正:@types/node-forge 曾误放在 dependencies, 已移到 devDependencies(类型包不该进生产依赖)。

安装 / 升级(可独立发布)

三种方式,按场景选:

# ① tarball(离线分发、内网)
pnpm pack --pack-destination ./dist
dsh plugin --profile desktop add ./dist/dsh-mobile-next-0.2.3.tgz

# ② registry(团队共享)
pnpm publish --access public
dsh plugin --profile desktop add [email protected]

# ③ 插件页(GUI)
# 设置 → 插件 → 安装 → 填包名或本地路径

实测过的完整链路(干净 profile,DSH_HOME=/tmp/dsh-home-test):

① 首次安装    dsh plugin --profile web add <tarball>
              → dependencies 记录 file: 路径
              → pnpm-lock.yaml 出现该包(6 处)
              → node_modules 是**实体目录**,不是软链
              → --dump-config 里出现 mobile-access-next 行

② 升级 0.2.0→0.2.1
              → "dsh-mobile-next 0.2.0 → 0.2.1"
              → 实体目录版本已更新

③ 降级 0.2.1→0.2.0(重跑 install-local)
              → 回到 0.2.0

④ 从零复现    rm -rf node_modules && pnpm install
              → 197 包装回,插件仍是 0.2.0(lock 可复现)

升级:dsh plugin add dsh-mobile-next@<新版本> 覆盖安装, 或插件页点「更新」。升级不动 devices.json,手机无需重新配对。

兼容性闸门:package.json 的 engines.dsh 是 >=0.2.2-rc.1 <0.3.0-0。DSH 版本不匹配时安装会被拒 (incompatible-version),而不是装完运行时报错。

开发期的软链 → 真实安装

开发时 profile 里通常是软链(node_modules/dsh-mobile-next → 源码目录)。 它有两个后果:dependencies 与 pnpm-lock.yaml 里都没有它(不可复现), 插件页的「更新」按钮永远灰(DSH 要求"从 registry 以包名安装")。

node scripts/install-local.mjs            # 软链 → 真实安装(tarball)
node scripts/install-local.mjs --revert   # 改回软链,继续开发

实测对比(同一个包):

| 字段 | 软链 | 真实安装 | | --- | --- | --- | | listBundles().installed | false | true | | dependencies 记录 | 无 | file:…/dist/dsh-mobile-next-0.2.0.tgz | | pnpm-lock.yaml | 0 处 | 6 处 | | node_modules | 软链 | 实体目录 |

⚠ tarball 必须落在稳定目录(仓库 dist/),不能放临时目录 —— pnpm add 会把路径原样写进 dependencies,temp 目录被清理后 下次 pnpm install 会直接失败。

开发期热重载(不用重启 DSH)

pnpm build
node scripts/reload-plugin.mjs    # 禁用 → 启用,触发客户端模块重扫
node scripts/check-loaded.mjs     # 确认已进入 boot manifest

实测:applied (changed=true) 两次,面板立即生效。

客户端模块重载:不用重启 DSH

客户端模块清单(dsh.client)是 DSH 启动时扫描 Loader entries 构建的。 改了 package.json 后刷新页面没用。

但不必重启整个应用 —— DSH 的 pluginManager/setPluginEnabled 描述里写着 "apply it on live profiles",禁用再启用即可触发重载:

node scripts/reload-plugin.mjs   # 触发重载
node scripts/check-loaded.mjs    # 确认已加载

实测结果:

禁用…  applied (changed=true)
启用…  applied (changed=true)

boot manifest 模块数: 82(之前 81)
✅ 客户端模块已加载
   bundle URL: plugins/??dsh-mobile-next/client.js&rev=198ebeaa427c

bundle 实测可拉取:HTTP 200,10467 字节,含正确的 __ModuleLoader__ 包装。

注意:服务端清单已更新,但已打开的浏览器页面需要刷新一次 才会重新读 window.__DSH_BOOT__。

诊断脚本

scripts/check-loaded.mjs 能区分三种状态:

| 输出 | 含义 | | --- | --- | | ✅ 已加载 | 正常 | | ❌ 未安装到 profile | 装错位置 | | ❌ 清单在启动后修改 | 需要 reload-plugin.mjs |

客户端界面(已重写)

主入口是侧栏图标(sidebar.panellist),点一下中栏整块切成全屏面板; 插件页里还留了一行兜底入口(plugins.item),面板万一打不开时仍可达。

| 区域 | 内容 | | --- | --- | | 头部 | 标题 + 状态徽标;右侧「诊断」「设备 N」「关闭」 | | 左栏 | 连接方式列表(局域网 / iroh 实验性远程通道,各自独立启停和配对) | | 主区 | 地址 + 二维码 + 倒计时 + 主操作,按状态穷举切换 | | 抽屉 | 设备列表(逐个撤销 / 二次确认全部撤销)、诊断(逐项自检) | | 高级 | 网卡选择、监听端口、CA 指纹(可复制) |

实现要点:

  • src/client.tsx 用 __ModuleLoader__.load 包装(构建时 banner 注入)
  • React 与 react/jsx-runtime 都由 DSH loader 提供,不打包 —— tsdown.config.ts 的 external 必须同时列这两个,漏了 jsx-runtime 会把 React 运行时内联一份进来(1.6 KB → 32 KB)
  • 三个槽:sidebar.panellist(图标)、main(keyed 全屏面板,key 必填)、 plugins.item(兜底行)
  • 打开/关闭用 ctx.get('layout').selectPanel(id | null); selectPanel 对未注册 id 会 throw,所以调用点包了 try/catch, 面板没注册上时不会炸掉侧栏
  • 样式只用 --dsw-alias-* / --dsw-radius-* / --dsw-shadow-* token,自动跟随主题

为什么不 require @deepseek-ai/dsh-client-ui-primitives: DSH 的插件作者指南明确要求第三方插件不要依赖 Harness 的 Client 包 —— 它们会无预告变更,且组件一旦抛错整个 slot 条目会被摘除 (控制台 slot entry crashed in '<slot>',界面直接空白)。 这里自写控件 + 只引用 token,宿主升级最坏是配色微调,不会白屏。

dsh.client.inject 保持为空 —— 它装的是包名(模块图边,只影响预取顺序), 不是服务名。服务注入走模块导出的 inject(export const inject = ['slots'])。 两条轴,别混。

label 是必需的 —— 缺了不渲染。

参考实现里的槽名也已过时(dsh-client-ui-settings-general/lib/client.js):

// 官方自己的用法,与我们的实现完全一致
ctx.slots.inject("settings.general.item", () => ctx.slots.register({
  name: "settings.general.item",
  id: "developer-tools",
  order: 15,
}, DeveloperToolsRow));

组件对 props 是宽容的:不依赖 DSH 传入的 t/hooks, 用不同 props 组合测试均能渲染(见 scripts/verify-client.mjs)。

验证(scripts/verify-client.mjs):

manifest 校验   ✅ platform/inject/external 全合规
bundle 路径     ✅ 9985 字节,loader banner 正确
执行 client.js  ✅ 导出 apply + inject
调用 apply      ✅ effect → inject:settings.general.item → register

界面在真实 DSH 里验证过

用 headless Chrome + CDP 打开真实 DSH(注入浏览器会话 Cookie), 点侧栏图标,DOM 探针 + 截图确认:

侧栏行           ["Plugins","Plugin Market","Automation tasks","移动访问","More"]
点「移动访问」    → 中栏切成面板,data-global-panel 生效
二维码           自动生成,200×200 SVG
主操作           「复制配对链接」(有码时)
控制台错误        无

交互路径逐条跑过:

| 场景 | 结果 | | --- | --- | | 复制配对链接 | toast「配对链接已复制」+ 剪贴板内容与 host 返回一致 | | 打开设备抽屉(空态) | 「还没有配对设备。生成二维码后用手机扫描即可。」 | | 设备列表(3 台) | label + 最近连接时间 + 逐行撤销 | | 全部撤销(二次确认) | 第一次点击变「确认撤销全部 3 台?」,第二次才执行 | | 诊断抽屉 | 7 项,role="dialog" aria-modal="true" | | Esc 关闭抽屉 | 关闭 | | 焦点陷阱 | 首焦点在抽屉内,Tab 到末项回到首项,Shift+Tab 反向循环 | | 关闭面板 | 回到会话(data-global-panel 变 null) | | 再点侧栏图标 | 重新打开,二维码重新生成 |

暗色主题自动跟随(面板全部用 --dsw-alias-* token):

暗色主题

诊断抽屉(拿不到的项显示「未检查」,不假装通过):

诊断抽屉

可访问性(实算,不是估的)

用 DOM 探针逐元素算对比度(浅色 + 深色各跑一遍):

浅色 4.84:1 ~ 20.94:1   深色 6.7:1 ~ 17.45:1   全部 ≥ WCAG AA 4.5:1
命中区 <44px:无(8 个可点元素,最小 44×44)
200% 字体缩放:无横向溢出(scrollWidth === clientWidth)
窄容器 760px:左栏自动收起,无横向溢出

两个必须知道的取舍:

  • 宿主的 --dsw-alias-label-caption 当正文用只有 2.13:1(浅色), 所以次级文字改用 color-mix(caption 60%, label-primary) → 4.84:1。
  • 状态色直接当文字色也不够(green-500 on green-100 = 2.09:1), 同样压向 label-primary → 6.78:1,与宿主 contextGreen 的写法同源。

真机配对验证(Android 模拟器)

用 flutter/tool/device_pair_probe.dart 在真实 Android 环境跑完整链路 (走设备真实网络栈与证书处理,不是宿主机 Dart VM):

设备: android sdk_gphone64_arm64-userdebug 16

--- 1. 不固定 CA(应失败)---
  ✅ 证书被拒(符合预期)
  HandshakeException: Handshake error in client

--- 2. 固定私有 CA ---
  health: HTTP 200

--- 3. 真实配对 ---
  CA 从 asset 读取: 1212 字符
  ✅ 配对成功
  deviceId: e42f343970aff98f4a6982d88e5aa269
  deviceToken 长度: 43
  sessionToken 长度: 43

--- 4. 用会话访问 DSH ---
  status: 200
  大小: 43065 字节
  含 DSH 标题: true
  含 __DSH_BOOT__: true

第 1 步是负对照:不固定 CA 时必须失败,否则说明 TLS 根本没在校验。

服务端确认设备已注册:

{"devices":[{"label":"Android 真机","deviceId":"e42f3439…"}]}

真机验证结果

插件加载        ✅ ~/.dsh/mobile-access-next/ 已创建
管理 API        ✅ GET /mobile-access-next/status → 200
网卡发现        ✅ en0 / 192.168.1.5
网关启动        ✅ https://192.168.1.5:3444
未认证访问      ✅ 401(含中文提示)
配对            ✅ 201 + HttpOnly Secure Cookie
上游凭据交换    ✅ 拿到 dsh-auth-* Cookie(226 字节)
访问 DSH        ✅ 200,42876 字节,标题 "DeepSeek Harness"
安全边界        ✅ 伪造 Cookie 401 / 令牌复用 401 / 静态资源放行
Flutter 客户端  ✅ 固定私有 CA 后真实配对成功
二维码          ✅ 2883 字符 SVG,扫码 → GET 页 → 自动 POST 配对

客户端验证(真实 Flutter 代码)

// 固定插件的私有 CA(手机端必须做的事)
final caPem = File('.../tls/ca.pem').readAsStringSync();
final transport = IoHttpTransport(trustedCaPem: caPem);

final client = PairingClient(
  transport: transport,
  pairPath: '/mobile-access-next/pair',   // 本插件的端点
);
final result = await client.pair(descriptor, label: 'Flutter 客户端');

结果:

✅ 配对成功
   deviceId: 14c525f75939615b07bc76ec9b8390fc
   deviceToken 长度: 43

测试构成

| 文件 | 数量 | 验证内容 | | --- | --- | --- | | network.test.ts | 28 | 私有地址判定、CIDR、网卡发现、配置解析 | | access.test.ts | 22 | 配对、限流、会话、持久化(只存摘要) | | gateway.test.ts | 7 | 真实 HTTPS 握手 + 配对 + 代理 + Host 改写 | | plugin.test.ts | 7 | 插件生命周期、管理路由、启停、dispose | | contract.test.ts | 5 | 路由形态对齐真实 webserver 契约 | | e2e-router.test.ts | 7 | 真实 HTTP 服务器上的路由响应 |

架构

手机 --HTTPS--> dsh-mobile-next 网关(:3444) --HTTP--> DSH(127.0.0.1:<port>)
                      ↓
              私有 CA 签发证书 + 设备会话认证

四层:

| 层 | 文件 | 职责 | | --- | --- | --- | | 配置 | config.ts | 解析 setup/control 文件,非法值退默认不抛错 | | TLS | tls.ts | 私有 CA(10 年)+ 服务器证书(397 天,含 IP SAN) | | 鉴权 | access.ts | 一次性配对令牌、设备令牌(只存摘要)、会话、限流 | | 网关 | gateway.ts | HTTPS 反代 + Host/Origin 改写 + WebSocket 升级 | | 管理 | admin.ts | 回环管理路由(只在电脑本机能访问) | | 网络 | network.ts | 网卡发现、私有地址判定、CIDR 匹配 |

安全设计

| 机制 | 说明 | | --- | --- | | 只存摘要 | devices.json 只有 tokenDigest,明文令牌绝不落盘 | | 一次性配对 | 配对令牌 5 分钟有效,消费即失效 | | 限流 | 按来源 IP,默认 10 次/分钟 | | 会话 Cookie | HttpOnly + Secure + SameSite=Strict | | 静态资源放行 | /assets/* 等无需认证(否则登录页打不开) | | 管理路由隔离 | 只在回环注册,手机访问不到 | | 默认关闭 | initiallyEnabled: false,装完不自动对外监听 |

隐私:数据去了哪里

插件本体不向任何第三方发送数据。 没有统计、遥测、崩溃上报、广告或 远程配置。源码里只有两处 fetch(),都是本地相对路径(面板请求自身、 配对页提交自身)。配对页完全自包含,不加载任何外部字体、脚本或图片。

落盘的数据只有 devices.json,每条设备记录仅 6 个字段:

deviceId, tokenDigest(SHA-256), label, createdAt, expiresAt, lastSeenAt

设备令牌只存摘要,磁盘泄露不等于凭据泄露。会话记录只在内存,不落盘。 网关是纯反代,不记录、不缓存、不解析任何会话内容 (响应统一带 cache-control: no-store)。

⚠️ 例外:iroh 远程通道会经过第三方中继

这是本插件唯一的第三方数据面,使用前必须知道。

局域网通道不涉及任何第三方 —— 数据只在你自己的 Wi-Fi 内从手机到电脑。

但 iroh 远程通道默认使用 n0 官方公共基础设施(presets::N0, 见 native/iroh-host/src/main.rs):

| 项目 | 是否暴露给第三方 | | --- | --- | | 会话内容、消息正文 | 否(QUIC 端到端加密,TLS 在电脑侧终止) | | 你的公网 IP | 是(中继与对端建连所必需) | | 端点身份 EndpointId | 是(发布到 n0 DNS 发现服务) | | 流量大小、连接时长、时间 | 是(中继可见元数据) |

直连打洞成功时数据不过中继;打洞失败才回落到中继转发(仍是加密的)。

如果你不能接受这一点,有两个选择:

  1. 只用局域网通道,不开启远程通道 —— 完全不涉及第三方;
  2. 启动时加 --local-only,它会禁用中继与 DNS 发现并只绑回环 (此时手机无法跨网连接,仅供本机验证)。

远程通道默认关闭,且每次进程启动都需显式 start(),磁盘不保存启用状态。

管理 API

全部在 http://127.0.0.1:<dsh-port>/mobile-access-next/ 下(回环专用):

| 方法 | 路径 | 作用 | | --- | --- | --- | | GET | /status | 网关状态 + 候选网卡 + 配对窗口(不含令牌) | | GET | /diagnostics | 逐项自检(面板「诊断」抽屉) | | POST | /network | 选定网卡 {interfaceName} | | POST | /enable | 启停 {enabled} | | POST | /pairing | 生成一次性配对令牌,返回 URL + 内联 SVG 二维码 | | GET | /devices | 已配对设备 | | POST | /devices/revoke | 撤销 {deviceId} | | POST | /devices/revoke-all | 一次撤销全部(服务端单事务) |

⚠ 路径前缀不是 /api/。DSH 对 /api/* 有自己的浏览器认证层, 未认证会在到达 handler 前返回 401。

⚠ 网关不会透传这些路径。/mobile-access-next/* 下除 /pair 与 /health 之外一律 404(gateway.ts)。否则一台已配对的手机就能 POST /pairing 给自己续期、POST /devices/revoke 踢掉其他设备。 这条有专门的回归测试(tests/gateway.test.ts → 「管理路径不得经网关透传」)。

配对流程

  1. 电脑本机 POST /api/mobile-access-next/pairing → 拿到 url
  2. 手机打开该 URL(或扫码)
  3. 手机 POST /pair {token} → 拿到 deviceToken + 会话 Cookie
  4. 之后手机带 Cookie 访问,网关代理到 DSH

从源码开发

cd dsh-mobile-next
pnpm install
pnpm run build        # rm -rf lib && tsdown(host + client 双面)
pnpm run typecheck
pnpm test             # 149 项(含 iroh controller / 集成 / 真实 native 冒烟)
# 真实 native 冒烟需要已构建的组件(否则该 2 项显式 skip):
# DSH_IROH_HOST=$REPO/native/target/release/dsh-mobile-iroh-host pnpm test
node scripts/verify-client.mjs    # 槽注册契约冒烟
node scripts/verify-package.mjs   # tarball 独立安装 + 双面加载
node scripts/verify-patch.mjs     # cordis patch 形态

已知限制

| 限制 | 说明 | | --- | --- | | iroh 为实验性原生通道 | 远程通道已接入 iroh;需要配置本机原生组件并使用支持 iroh 的 App,不支持普通手机浏览器。详见 iroh 接入说明。不使用 Cloudflare。 | | 无 /mobile 命令 | 参考实现的对话内定制没做 | | 手机端 App 未接新端点 | flutter/ 侧的 UI 重设计是另一个交付面,本轮只改了电脑端插件 | | 配对令牌在内存里 | DSH 重启后未用完的配对码失效,需要重新生成(设备凭据不受影响) |