前言¶

在桌面端或网页端跑 DeepSeek Harness（DSH）时，一次任务往往要经历较长时间的推理、大量文件读写和工具调用。若把整套界面原样映射到手机，小屏会被中间过程占满，外出时你通常只想知道「这一轮是否结束」并下发下一条指令，而不是逐行审工具入参和 diff。

社区插件 dsh-mini-remote（维护者 xingzhen199186）面向上述场景：移动端用浏览器打开一个轻量页，按「单帧 / 聊天 / 完整」三档控制信息密度；同一插件还在 DSH 桌面端提供「远程窗口」，在另一台电脑的 DSH 里嵌入本机界面。下文按定位、能力、安装与用法说明，事实均来自 GitHub 仓库 README 与 npm 包 dsh-mini-remote（当前资料版本 0.2.3）。

这是什么¶

dsh-mini-remote 是 DSH 的客户端类插件：在本机起 HTTP 服务，手机扫码或复制带口令的 URL 即可遥控当前 DSH 进程；不依赖独立 App、不经过插件自建账号体系。README 将其概括为「将注意力支配权交还给用户」——默认可屏蔽执行噪声，需要时再展开完整轨迹。

在 SkillHub 插件目录 中归类为「客户端」；GitHub 上约 3 stars（以目录页统计为准）。协议为 MIT。

核心功能¶

三档呈现模式¶

同一会话可在移动端切换：

1. 单帧：整屏只保留最新结论，减少中间步骤干扰。
2. 聊天：常规气泡对话流，一屏可见多条历史。
3. 完整：按原有时序展开工具调用与文件差异，并支持关键词检索。

页面为原生 JavaScript，无前端构建；提供深色（深海墨蓝）与浅色（冰蓝宝蓝）主题。

连接通路¶

依据网络环境选型（各通道可并存，独立二维码与访问口令）：

访问地址形如（口令在 URL 中，需妥善保管）：

http://192.168.1.2:3090/mini?token=xxxxxxxxxxxx

移动端与会话治理¶

除底部发消息、执行中队列与刻度尺外，页面还支持：斜杠指令列表、Agent 多选答题、权限档位（read-only / workspace-write / danger-full-access）、会话重命名与置顶、归档、从指定轮次 Fork，以及待审批/待回答提示。运行中会展示轻量状态流（队列与计时），过滤底层原始推理块。

安全边界（README 强调）：接口使用定长口令校验；1 分钟内试错 5 次锁定 1 分钟；移动端不得跨目录读任意文件；危险命令审批仍须在电脑端 DSH 处理。

桌面端「远程窗口」¶

在 DSH 桌面端左侧栏进入「远程窗口」，可列出已配对机器并在主面板内嵌另一台电脑上的 DSH 桌面界面，避免整屏远程桌面或额外开浏览器 tab。配对使用一次性票据（README 截断处说明凭据不过手、短时有效）。

进阶：内嵌完整 DSH 电脑端界面¶

在手机遥控页设置中开启「进阶设置」（需二次确认）后，可在同一令牌下打开嵌入了完整 DSH 电脑端界面的页面；默认关闭，因权限面从手机页扩展到模型、凭据、插件与会话等全设置面。

环境依赖¶

安装前确认：

• Node.js：^22.19.0 || >=24.0.0
• DSH：>=0.1.5-rc.2 <0.3.0（README 写明在 0.1.5-rc.2、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2 上做过全量验证；高于 0.3.0 存在上游接口破坏风险，升级 DSH 前需确认插件已跟进）
• 操作系统：Windows、macOS 或 Linux

安装与启用¶

插件在本机以当前用户权限运行，安装前应确认来源可信并阅读源码与 MIT 许可证。

途径一：DSH 桌面端图形化安装（推荐）¶

1. 顶部「插件」→ 插件管理。
2. 「添加插件」。
3. 输入包名 dsh-mini-remote，或 github:xingzhen199186/dsh-mini-remote，或本地目录；安装源默认 npm 官方源。
4. 点击「安装」。

注意：暂不支持自动更新，升级需先卸载再装新版本。

途径二：npm 命令行¶

web 为 DSH 默认 Profile 名，自定义配置档请替换：

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

途径三：GitHub 直接安装¶

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

途径四：本地目录（调试）¶

dsh plugin --profile web add C:\path\to\dsh-mini-remote

启动确认¶

1. 重启 DSH 服务（关闭并重新运行 dsh web）。
2. 控制台应出现类似日志：

[dsh-mini-remote] 已启动：http://127.0.0.1:3090/mini?token=xxxxxxxxxxxx

3. 桌面端「设置 → 手机遥控」查看二维码与各通道 URL。

手机端仅为浏览器页面，可「添加到主屏幕」全屏使用；PC 浏览器打开同一地址也可操作。

典型用法¶

1. 安装并重启 DSH 后，在「设置 → 手机遥控」选合适通道（内网出差用 Tailscale 或飞书；完全无客户端时用公网隧道并注意 HTTPS 与口令泄露风险）。
2. 手机扫码进入 /mini?token=...，在设置里选「单帧 / 聊天 / 完整」与主题。
3. 底部输入指令；Agent 忙碌时消息自动排队。
4. 需改模型或装插件时，仅在信任环境下开启「进阶设置」中的内嵌电脑端界面。
5. 另一台电脑已跑 DSH 时，在本机桌面端「远程窗口」配对后于面板内操作对端实例。

package.json 中的 disclosure 补充：内网为 HTTP；Tailscale 默认可 HTTP 或另开 HTTPS；Cloudflare 隧道为 HTTPS；公网隧道勿在不可信网络使用带 token 的 URL；不收集遥测；启用公网隧道时流量经 Cloudflare 中转。

适用场景与注意¶

适合：经常离机但仍要盯 DSH 轮次、下发短指令的用户；需要在多台电脑间切换 DSH 界面而不开全屏远程桌面的场景；希望用飞书做纯文本遥控与审批的团队（需自行配置飞书应用）。

注意：

• 插件与 DSH 同进程权限，勿安装来源不明的包。
• URL 中的 token 等同遥控口令，勿截图外传；可在设置中更换密码。
• 「完全权限」档位风险高，移动端无法替代电脑端危险命令审批。
• DSH 版本需落在 >=0.1.5-rc.2 <0.3.0 声明范围内。

DSH 生态强调「一切皆插件」；SkillHub 为社区目录，与 DeepSeek / 幻方无官方从属关系。

结尾¶

dsh-mini-remote 把移动端收成「结论优先、过程按需展开」的遥控页，并用 LAN / Tailscale / Cloudflare / 飞书多条通路适配不同网络；桌面端「远程窗口」则把跨机 DSH 操作收进主面板。进一步细节与截图见仓库 README。

• 插件目录：https://www.skillhub.cn/plugins/xingzhen199186/dsh-mini-remote
• GitHub：https://github.com/xingzhen199186/dsh-mini-remote
• npm：https://www.npmjs.com/package/dsh-mini-remote