xingzhen199186/dsh-mini-remote 预览 preview

xingzhen199186/dsh-mini-remote

DSH 极简风远程移动端:只把「指令」和「回复」送到手机,隐藏执行步骤。

Project Overview项目介绍

dsh-mini-remote is a Cordis plugin built specifically for the DeepSeek Harness (DSH) agent framework, published on npm with MIT licensing and a DSH bundle-manifest. Once installed via dsh plugin --profile web add dsh-mini-remote (or from a GitHub source / local directory) and the DSH web profile is restarted, a new "手机遥控" entry appears in the sidebar and a pairing page prints a URL, QR code, and password per connection route. Three connection paths ship together and can run concurrently: same-Wi-Fi LAN, Tailscale mesh networking (with an optional TLS hostname like 你的电脑名.你的网络名.ts.net), and a Cloudflare trycloudflare.com public tunnel that needs no client app but downloads a one-time ~50 MB component and rotates its address on every DSH restart. A Feishu (Lark) long-connection bot route is also included as a fourth path that bypasses all three.

The phone experience is intentionally minimal: a single input box plus the latest reply, with tool calls, file diffs, sub-agent scheduling, and intermediate reasoning text stripped before transmission. Only a short model self-talk line is surfaced as the whale-girl "鲸鱼娘" character voice inside a dedicated bubble. Users can send commands, queue new ones while a run is in progress, swap appearance themes (dark / light / follow system), and switch the bound conversation, model, thinking strength, or workspace. On Feishu the plugin handles plain-text replies, mid-run multiple-choice prompts (1. / 2.), /会话 switching, and approvals via words like "同意" / "拒绝" / "取消"; only direct (single) chats are supported in this release.

The plugin targets DSH 0.1.5-rc.2 and was re-verified on 0.1.7-rc.2, so versions older than 0.1.5 are untested and newer ones are unsupported because the framework is still a developer preview. HarmonyOS clients lacking Tailscale MagicDNS (such as the third-party MeshArc app) cannot use the encrypted Tailscale hostname and must fall back to the raw tailnet IP. Pairing pages encode the password directly in the QR code, so screenshots leak access; all endpoints require the password (constant-time comparison, five-fail-per-minute rate limit), and pairing data is local-only. The mobile side may elevate Agent permissions to "完全权限", granting full file modification on the host — a documented risk the README explicitly calls out.

dsh-mini-remote 是一个面向 DeepSeek Harness(DSH)框架的 Cordis 插件,安装后会在 DSH 侧栏新增"手机遥控"入口。它通过内网直连、Tailscale 组网或 Cloudflare 公网隧道三种方式,把 DSH 会话以极简网页形式投射到手机,仅保留输入框和最新一条结论,工具调用、文件 diff、子 Agent 调度与模型自言自语一律不上手机,仅鲸鱼娘的旁白以气泡形式呈现;也可经飞书长连接直接私聊机器人控制会话。

典型场景是用户离开电脑后继续追踪长任务——外出、陪家人或在不同房间时掏出手机发送下一条指令或等待结论。设置页提供模式切换、端口、口令、权限档位与外观(深色/浅色/跟随系统)等选项,每条连接路径均配独立二维码、链接与密码,飞书侧还支持 /会话 切换与选择题答复。手机可在远程切换模型、思考强度、权限档位与登记工作区,但系统级审批弹窗仍须在电脑端处理。

安装命令为 dsh plugin --profile web add dsh-mini-remote,亦支持 GitHub 源码与本地目录安装,插件在 DSH 0.1.5-rc.2 上开发并在 0.1.7-rc.2 上逐项核对,低于 0.1.5 未测,更高版本不保证;首次启用公网隧道需下载约 50 MB 组件,注册失败会自动重试三次。项目以 MIT 发布,npm 上同步分发,且允许手机将 Agent 权限切至"完全权限"。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-mini-remote

把 xingzhen199186/dsh-mini-remote 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

极简遥控器 · dsh-mini-remote

npm DSH plugin License

English

极简遥控器:手机上只留你的指令和它的结论,中间过程留在电脑上

你发一句话,手机上只收到它的结论。

工具调用、文件读写、子 Agent 调度、思考过程的正文,全都不上手机。这个插件是给「出门在外,只想发指令、等结论」这件事做的——一部手机、一个输入框、最新的一条回答,就这些。

这是什么 ・ 什么时候会用到它 ・ 安装 ・ 连上手机 ・ 手机上能做什么 ・ 在飞书里遥控 ・ 常见问题 ・ 安全 ・ 为什么做这个插件


这是什么

一个 DeepSeek Harness(DSH,一个用插件扩展的 AI agent 框架)插件。装上之后:

  • 手机上打开一个网页,上面只有一个输入框和最新的一条回答;
  • 你在手机上发的指令,直接交给电脑上正在跑的那个会话;
  • AI 干活的中间过程(工具调用、读写文件、子 Agent、思考正文)一律不推给手机;
  • 唯一会「说话」的是鲸鱼娘:模型在步骤之间自言自语的那一句,由她念出来,只进她的气泡。

界面长这样——深色和浅色两套,设置里随手换:

深色:一段对话,手机上只留你的指令和它的结论 浅色:同一段对话,色调跟宣传图那张画统一

它不是:电脑端界面的备用屏。电脑上有的审批弹窗、文件 diff、工具调用链,手机上都没有——它刻意做得很少。

别的手机端会把电脑上的执行过程原样搬过来,它反过来:只把你要的那两句送过去。这是它和它们最不一样的地方。

什么时候会用到它

  • 出门在外,任务还在跑。 你人在外面,电脑在桌上跑着一轮任务;你只想掏出手机看一眼「跑完没有」,顺便把下一句交代过去。
  • 陪孩子、吃饭、散步的时候。 手不想碰电脑,但脑子里冒出一个念头,想让它先干着。
  • 电脑在书房,人在客厅。 不值得专门走回去,也不想把电脑端那一整屏过程搬到手机上看。

安装

dsh plugin --profile web add dsh-mini-remote

装完必须重启一次 DSH(把 dsh web 那个窗口关掉重开),左栏才会多出「手机遥控」;重启后的启动日志里会打印手机访问地址和密码。

命令里的 web 是 DSH 的配置档名(profile)——就是 ~/.dsh/profiles/ 下面那个文件夹的名字,多数人的默认档就叫 web。不叫这个的话,把它换成你自己的。

从 GitHub 源码装、从本地目录装,以及它适配哪些 DSH 版本

也可以直接从 GitHub 装,这样锁的是源码:

dsh plugin --profile web add github:xingzhen199186/dsh-mini-remote

手上有源码目录的话,把目录指给它也一样:

dsh plugin --profile web add <你放源码的目录>

它适配哪些 DSH 版本。 这个插件在 DSH 0.1.5-rc.2 上开发,在 0.1.7-rc.2 上重新逐项核对过(插件用到的那些接口,一个都没变),低于 0.1.5 的版本没试过。rc 是官方给预览版编的号,DSH 目前整体还是开发者预览版,跨小版本可能有破坏性改动,所以比 0.1.7 更新的版本同样不保证。真遇上不兼容,症状一般是某一块入口不见了(比如顶栏那行模型),其余部分照常——插件是按「少了哪个服务就关掉哪块功能」写的,不会整个起不来。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-node-appearance 下一个 Next dsh-session-delete →