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

v0.1.7

Published

掌上 dsh —— DSH 的手机端完整聊天界面:6 位码配对、设备信任、工作区/会话/聊天、SSE 实时流,可经局域网或公网反代访问。

Readme

掌上 dsh · dsh-mobile

把 DeepSeek Harness 的会话装进手机浏览器。 配对即用:流式对话、工具过程、审批与提问、文件上传、模型切换,全部随身。

npm dsh node license

快速开始 · 特色 · 截图 · 配置 · 架构


特色

🎛 和桌面同一份上下文 手机上看到的就是桌面那个会话:同一串消息、同一份工具输出、同一个模型。接着聊,不用复制粘贴。

🧠 过程是可见的 思考折叠卡、工具调用卡、子任务卡、轮次尾卡都会出现在消息流里,可展开看细节;跑完显示「已完成 · 用时 N 秒」。

📎 附件真的能用 发图、发文件(.docx/.xlsx/.pptx/.zip/.txt 都行);已上传文件以胶囊显示在待发送区,发送时把工作区路径交给模型,直接就能读。

✅ 审批与提问 宿主弹出的审批、ask_user_question 都能在手机上应答;错过也没关系,重进会话会自动补发卡片。

📱 PWA 常驻 添加到主屏幕,像 App 一样打开;带离线条、更新检查与浏览器通知。

🔌 零改造接入 不改 dsh 本体、不改桌面 UI。宿主半是一个普通插件,手机 UI 是打包好的静态资源。

快速开始

1. 装插件(二选一)

# 按名字从 npm 装
dsh plugin add dsh-mobile-web

# 或者本地开发装:把仓库根目录作为 bundle
dsh plugin add /path/to/dsh-mobile

2. 桌面 dsh:设置 → 掌上 dsh,出二维码

3. 手机浏览器打开

http://<主机IP>:19387/m/     # 局域网直连
https://your-host.example.com:45632/m/   # 公网(HTTPS 反代)

手机扫桌面那张二维码即可自动配对(面板里同时给了「复制链接」,不方便扫码时把链接发到手机粘贴也行)。 配对后设备 cookie 长期有效,桌面端可随时撤销设备。

公网访问请务必套 HTTPS 反代,不要把 19387 明文端口直接暴露到公网。详见 SECURITY.md。

能力一览

  • 扫码配对:桌面设置面板出二维码,手机扫一下就完成配对;扫不了码时可复制面板里的配对链接粘贴。服务端下发 HttpOnly 设备 cookie,可在桌面端随时撤销设备。
  • 完整手机聊天界面:会话列表、流式回复(SSE /m/api/events.mux)、推理块、工具卡、Markdown/代码块、消息队列、引用、重新生成、搜索。
  • 工作区与会话:浏览 / 新建 / 重命名 / 归档;运行中徽标;「最近访问 / 固定 / 运行中」快捷入口;会话清理(归档 / 本地隐藏 / 彻底删除 / 回收站)。
  • 审批与提问:mobile.pending / mobile.respond;进入会话自动补发待处理卡片,工作区与会话行有橙条提示。
  • 附件:相册/拍照、文件上传(24 MB 上限,落到会话工作区 .dsh-uploads/);文件卡片可预览文本、下载原文。
  • 模型与权限:查看模型目录、切换会话模型与思考强度;权限预设从工具栏盾牌切换。
  • 命令面板:/ 面板合并宿主命令、本机动作与技能目录,中文标题与说明;选中即插入输入框,由宿主命令通道执行。
  • 通知:浏览器通知 + 推送渠道(WxPusher / Server酱 / Bark / Telegram / PushPlus)+ 可选 Web Push。
  • 语音转写:可配置 OpenAI 兼容的转写服务(按序回退)。
  • 设置:外观 / 对话等本机项 + 主机配置只读/可写项,逐项标注「本机 / 同步桌面 / 桌面端」。
  • PWA:可添加到主屏幕,离线壳与更新检查。

前置条件

  • dsh ≥ 0.2.0-rc.1(见 package.json 的 dsh.engines.dsh)
  • Node.js ≥ 20(插件宿主与 mobile-src 构建)
  • 手机端浏览器:Chrome / 夸克等 Chromium 内核;HTTPS 环境下 Web Push、剪贴板等能力才可用

配置

在 profile 的 cordis.patch.yml 里加一条:

- insert:
    - id: dsh-mobile
      name: 'dsh-mobile-web'
      config:
        enabled: true
        mobilePort: 19387
        mobileHost: '0.0.0.0'
        pairCode: ''                                          # 留空 = 随机 6 位码(5 分钟过期)
        publicBaseUrl: 'https://your-host.example.com:45632'   # 仅用于展示,可留空

| 字段 | 默认 | 说明 | |---|---|---| | enabled | true | 关闭后不挂载任何路由 | | mobilePort | 19387 | 手机监听端口(独立于 GUI 的动态端口) | | mobileHost | 0.0.0.0 | 监听地址;只在本机用可改 127.0.0.1 | | pairCode | ''(随机 6 位、5 分钟过期) | 留空 = 随机码;填固定值则该码永不过期(代码内回退值 123456 仅供开发,公开部署不要用固定码) | | publicBaseUrl | 空 | 设置面板展示的公网地址,仅展示用途,留空也不影响运行 | | devicesFile | ~/.dsh/dsh-mobile-devices.json | 已配对设备与 token 的存储位置 | | pushConfigFile | ~/.dsh/dsh-mobile-push.json | 推送渠道配置 | | hiddenModels | [] | 手机端模型选择器里隐藏的模型 id |

架构

手机浏览器 / PWA
  │  GET /m/  (HTML + 注入脚本 + theme.css)
  │  POST /m/api/<method>  (63 个 RPC:session/workspace/pair/mobile/…)
  │  GET  /m/api/events.mux (SSE)
  ▼
index.js(宿主半)
  ├─ 双 HTTP 面:GUI webServer(回环,设置面板)+ 0.0.0.0:<port>(手机/局域网/公网)
  ├─ 配对与设备 cookie、审批/提问应答、通知、用量、插件/自动化页数据、命令与技能目录
  └─ 注入脚本:在不改 bundle 的前提下补齐工具栏、命令面板、设置范围标签、图片预览等
  ▼
assets/mobile.bundle.js  ← 由 mobile-src/ 构建(dsh-palm v1.6.0 fork,见 mobile-src/UPSTREAM.md)
assets/theme.css         ← 本仓库自己的样式(实时读盘,改完刷新生效)

手机 UI 复用 dsh-palm v1.6.0 的 React bundle(源码已 vendor 到 mobile-src/,Apache-2.0);宿主侧 RPC 由本插件按 dsh 原生服务重新实现,而不是沿用 dsh-palm 的 host。

开发

# 1) 构建手机 bundle(源码在 mobile-src/,产物写到 assets/)
cd mobile-src
npm ci
npm run build        # 实测 npm ci ~1.2s、构建 65–80ms,产物 sha256 可复现

# 2) 检查宿主半语法
node --check index.js

# 3) 本地加载验证(插件已装好并监听 19387 时)
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:19387/m/
  • assets/theme.css 每次请求实时读盘:改完刷新手机页面即生效,无需重启 dsh。
  • index.js / src/host/** 由 dsh 进程加载,保存后不会自动重载;开发时可临时在 profile 的 cordis.patch.yml 末尾加一行注释触发 reconcile(随后还原),或重启 dsh。

改动归属(避免误归因)

  • mobile-src/ 相对 dsh-palm v1.6.0 只改了两处,已回源到源码并记录在 mobile-src/UPSTREAM.md:
    1. 设置 → 外观新增「发送模式」行(读写宿主 window.__dmSendMode);
    2. 用量卡片的「账户余额」文案改为「充值余额」。
  • 「关于 / 反馈」文案、网页搜索 artwork 等属于 src/host/** 的 DOM 补丁(注入脚本),不是 bundle 源码改动。
  • 其它手机端增强(命令面板、图片预览、设置范围标签、插件/自动化页等)全部在 src/host/** / assets/theme.css 中实现。

已知限制

  • 实时通道:聊天流式走 SSE /m/api/events.mux;通知类端点 /m/api/events.notify 未实现(保持 404),手机端通知走轮询 / Web Push / 推送渠道。
  • Web Push:iOS 与大陆网络对 FCM 支持有限(需代理);不想折腾可用推送渠道(WxPusher 等)。
  • Web Push 需要 HTTPS:http:// 访问时浏览器通知与 Service Worker 推送不可用。
  • 设备 cookie 即登录态:撤销设备后该 cookie 立即失效;不要在多台设备间共享 cookie。
  • 截图路由:/m/shot/<file> 匿名只读(手机 <img> 不带 cookie),只应放非敏感截图;详见 SECURITY.md。
  • mobile-src/ 是 fork:不跟随 dsh-palm 上游;需要上游修复时按 UPSTREAM.md 手工 cherry-pick 并重建 bundle。
  • 实测环境:桌面 Chromium 与 Android 夸克浏览器;其它 WebView 未系统验证。

License(分层)

本仓库是混合来源,按目录分层授权:

| 范围 | 许可证 | 版权 | |---|---|---| | 根目录代码(index.js、client.js、assets/theme.css、注入脚本、docs/ 等) | MIT(见 LICENSE) | dsh-mobile contributors | | mobile-src/(手机 UI 源码,fork 自 dsh-palm v1.6.0) | Apache-2.0(mobile-src/ 适用同一份 Apache 全文:根目录 LICENSE-APACHE 与 mobile-src/LICENSE-APACHE 内容一致) | © Eternalloveone / dsh-palm 及上游归因方 | | 依赖的 dsh 平台包(@deepseek-ai/dsh-*) | Apache-2.0 | DeepSeek |

归因链保留在 NOTICE:dsh-palm → dsh-remote-web-ui(@linxin666/dsh-remote-web-ui,Apache-2.0)。mobile-src/ 的 baseline、构建方式与本地改动见 mobile-src/UPSTREAM.md。

致谢

这个项目站在别人肩膀上:

  • dsh-palm(© Eternalloveone,Apache-2.0)—— 手机端 UI 直接来自它的 v1.6.0;我们 vendor 到 mobile-src/ 后做了本地修改(清单见 mobile-src/UPSTREAM.md)。
  • dsh-remote-web-ui(@linxin666/dsh-remote-web-ui,© zhu1090093659,Apache-2.0)—— dsh-palm 的移动端同样源自它,归因链见 NOTICE。
  • DeepSeek Harness(Apache-2.0)—— 宿主平台与 @deepseek-ai/dsh-* 服务。

如果你是从本仓库再分叉:请保留 NOTICE、LICENSE-APACHE 与 mobile-src/UPSTREAM.md,这是 Apache-2.0 对派生作品的要求(保留版权声明、附带许可证副本、标注修改过的文件)。

安全

公开部署前请阅读 SECURITY.md:必须 HTTPS 反代、设备 cookie 等同登录态、/m/shot/ 匿名可读、固定配对码(如果你的配置里设了)务必改掉。