Hyna-hla/dsh-remote
DSH Remote 手机遥控端：把电脑上的 DeepSeek Harness 装进口袋。手机连上就能给 AI 派活、看实时回复、批审批；支持局域网/内网穿透、扫码连接、审批通知、会话管理、多主题换装，还能解锁加密保险库。第三方社区作品，开源免费。
安装Install
dsh plugin --profile web add github:Hyna-hla/dsh-remote把 Hyna-hla/dsh-remote 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
dsh-remote — 第三方 DeepSeek Harness 手机遥控端
⚠️ 非官方项目：本仓库是个人开发的社区第三方客户端，基于 DeepSeek Harness 构建，并非 DeepSeek 官方产品，未使用其商标、未经授权背书。项目遵循 MIT License 且完全开源免费；如有人向您以任何形式出售本软件，请拒绝交易。
✍️ 开发人员：残星会·虚质空间分部 达妮娅同学（B站：最喜欢达妮娅了），Yauntyours。
把 DeepSeek Harness 装进口袋：手机 App 连接你电脑上正在运行的 DSH 服务， 随时随地给智能体派任务、看进展、批审批。UI 对齐桌面端 DSH 风格，交互参考 Trae 移动端。
💬 社区问答：使用问题、玩法交流、想法建议请到 GitHub Discussions；Bug/安全仍走 Issues 与 安全通告。
功能
- 远程操控：连接 PC 上的 DSH（局域网直连 或 自备内网穿透，任何网络可用）；连接页右上角扫码连接（扫描任意 URL 二维码自动填入服务器地址，含相机权限申请）
- 通知提醒（前台服务常驻）：需要审批 / 问答确认时高优先级横幅通知（去重、点击直达对应会话）；任务完成自动提醒（运行→空闲 8 秒防抖确认）；Android 13+ 首次启动自动申请通知权限，设置页可补授权与开关
- 实时聊天流：用户/助手消息、流式输出（思考过程不上屏，仅显示"已思考 x 秒"）、Markdown 渲染、工具调用卡片（含参数与结果）
- 审批与问答：审批横幅（允许一次/拒绝）、问答题卡片（单选/多选）
- 自适应模型：设置里可开「自适应模型」（默认开）——短问答自动走 Flash，复杂任务（长文本或命中"分析/重构/审查"等关键词）自动切 Pro，发送前完成切换
- 模型与权限：会话内切换模型 / 思考程度（reasoningEffort）、审查严格度（只读 / 工作区可写 / 完全访问）
- 可拓展主题：内置 5 套有真实观感差异的主题——深蓝（鲸鱼娘装扮，默认） / 纯黑（AMOLED）/ 暖白 / Codex CLI 终端风（全局等宽 + 方角 +
❯提示符）/ 夜之城 2077（NC 黄霓虹青 + 切角 + 稀有度会话色）；支持导入自定义主题包（zip，含 theme.json + 可选预览图），同名导入即热替换更新；单文件 theme.json 也可直接导入；另支持界面字体/代码字体切换（对齐 dsh-font 概念） - 背景图与面板：设置 → 外观可选本地背景图 + 四档一键预设（通透玻璃/电影质感/纯净原图/柔和梦境）；图像不透明度/模糊/饱和度/蒙层浓度独立可调，面板通透玻璃化（对齐桌面 dsh-beautify 模板）；屏幕亮度 = 夜间模式
- 图片消息：📎 选择图片（PNG/JPEG/WebP/GIF ≤4MB）随消息发送，新对话与历史会话均支持
- 技能选择：📚 技能列表（skill.list），点选自动插入"请使用 X 技能"到输入框
- 应用内更新：启动自动检查 GitHub Releases（每天最多一次，不打扰）；有新版弹窗询问，下载走多镜像加速（ghfast.top / gh-proxy.com / ghproxy.net / 直连兜底，失败自动切换、全程透明展示进度与速度），优先下载 debug 主包（功能最全；无主包时回退 -min 精简包），下载完一键安装
- 保险库解锁（dsh-encrypt 联动）：设置页「保险库」卡片查看锁定状态、手机端输入密码解锁 PC 端凭证保险库——与 web 端走同一路由（/api/credentials.unlock），密码本地 SHA3-256 后仅上传摘要，解锁后 PC 端同步生效；支持记住密码（AndroidKeyStore 加密存储摘要）、防爆破冷却展示
- 会话管理：最近会话列表、历史分页加载、长按归档 / 已归档区恢复、状态指示、停止运行、⚡ 插话发送（打断思考，steer 模式）、新对话工作区选择
更新日志
完整更新历史见 CHANGELOG.md。
- 插件 v2.4.1 / App v1.8.1（最新）：配对码安全修复 + 四项健壮性改进 + 节点小宝教程，详见 CHANGELOG.md 顶部条目。
安装（APK）
- 推荐：应用内更新——App 启动自动检查 GitHub Releases（每天最多一次），有新版弹窗询问后直接下载安装（多镜像加速、断源自动切换），优先下载 debug 主包（约 68MB，功能最全），无主包时回退 -min 精简包
- 手动安装：从 Releases 下载
DSH-Remote-vX.Y.Z.apk（debug 主包）；仓库release/目录另存各版本 R8 精简版-min.apk（约 4.6MB，已签名） - 传到手机 → 允许「未知来源」安装 → 填服务器地址 → 连接
- ⚠️ v1.2.0 起更换签名证书，旧版（upload.jks 签名）需卸载重装；debug 包与 release 签名包互不兼容，升级请走同一通道
- 自定义主题包格式与示例：docs/theme-package-format.md、docs/aurora.dshTheme.zip
PC 端使用
局域网模式（手机与电脑同一 Wi-Fi）：DSH 启动后，把电脑局域网地址填进 App，形如
http://192.168.1.100:8787
公网模式：任选内网穿透工具（cpolar / cloudflared / ZeroTier / 自建隧道等），
把 DSH 服务端口映射成公网域名后填进 App。首次连接需在 PC 端 DSH「设置 → 远程控制」
确认配对，之后所有请求自动携带通道令牌，任意网络可用。
无公网 IP 想走国产内网穿透的：用【节点小宝】把 8787 映射成公网地址，配好公网域名
白名单 + 配对码即可，逐步教程见 docs/节点小宝内网穿透教程.md
PC 端插件：远程互信认证（dsh-remote-access）
除手机 App 外，仓库还附 PC 端 DSH 插件 dsh-remote-access/：只做远程互信——
推荐在 DSH 设置页「远程控制」点「生成配对码」，手机 App 连接后输入 6 位码即完成配对（也可沿用旧式
PC 弹窗确认）；配对后远程通道 token 下发到 App，此后所有 /api 与实时通道请求都要求该 token，拿到地址
的陌生人无法遥控你的 DSH；同时提供主机设备信息、只读目录/文件浏览、MCP 枚举等辅助路由。
手机经公网隧道连接时，还需把隧道公网域名加进「远程控制 → 公网域名白名单」（写入 DSH 核心
client-connection.trustedHosts，重启 DSH 生效）——否则核心 Host 围栏会拒绝 403。
详见 dsh-remote-access/README.md。
v2.0.0 起不再内置微信遥控与 cpolar 隧道（仓库内的隧道辅助脚本已一并移除）。公网访问用 任意自备内网穿透工具即可，通道鉴权对任何隧道同样生效。
协议（逆向自 dsh-client-connection，仅个人学习用途）
- 上行：POST /api/，body = {"type":"client-request","rpcId","method","payload"}
- 下行：{"type":"server-response","rpcId","result":{ok, value|error}}
- 事件流：WebSocket ws://host/api/events.mux（另 events.host），每条消息 = server-request 信封， payload 为 mux 帧（session/event、approval/requested、question/requested、session/jobs…）； 部分服务器（dsh web CLI）用 SSE 承载，App 自动回退
- 应答：POST /api/respond，body = client-response（审批 outcome / 问答 answers）
从源码构建
环境：JDK 17 + Android SDK（platform 36）+ Gradle 8.14.3（wrapper 已指向腾讯镜像）。
$env:JAVA_HOME = "<你的 JDK 17 路径>"
Set-Location <本仓库路径>
.\gradlew.bat assembleDebug debug 主包（应用内更新分发的就是这个）
.\gradlew.bat assembleRelease min 精简签名包
local.properties 写 SDK 路径时用正斜杠（sdk.dir=D:/android-sdk）——反斜杠会被
properties 转义吞掉导致 "文件名、目录名或卷标语法不正确" 启动失败。
发布签名：local.properties 指向发布密钥库 dsh-remote-daniya.jks
（alias daniya；证书 DN = CN=残星会虚质空间分部达妮娅同学, OU=残星会, O=虚质空间分部），
构建产物自动签名。旧版 upload.jks 仅保留用于历史版本校验与 Play 上架迁移参考。
或用 Android Studio 打开本目录直接构建。
目录结构
app/src/main/java/com/dsh/mobile/
├── data/ 协议层：DshProtocol（四象限信封/帧）、DshConnection（RPC+WS/SSE）、SettingsStore
├── ui/
│ ├── components/ MarkdownText 轻量 Markdown 渲染
│ ├── navigation/ 路由：connect → home → session / settings（含通知深链跳转）
│ ├── screens/ Connect / Home / Session / Settings
│ └── theme/ 多主题注册表（深蓝/纯黑/暖白/Codex CLI/夜之城 2077 + 导入主题包）+ 面板通透玻璃化
├── service/ 前台服务：审批/问答/完成通知 + 断线重连
├── MainActivity.kt
└── DshApplication.kt
dsh-remote-access/ PC 端 DSH 插件（远程互信认证：配对/设备/fs/mcp 路由 + 通道 token 鉴权；v2.0.0 已移除微信桥与 cpolar）
已知限制与路线图
- 会话首屏取最近 3 条 + 「加载更早」15 条/页 + 「加载全部历史」（循环翻页到底）；超大会话全量加载耗时取决于网络
- 图片消息仅支持 DSH 协议核心接受的图片内容块（PNG/JPEG/WebP/GIF），长图不缩放仅采样显示
- 权限审批只支持「允许一次 / 拒绝」两个决策（与 web 端一致）；若服务端审批策略为 never 则不会出现审批请求
- 后续：推送通知云端化（App 被杀也能收到，需接三方推送）
皮肤素材署名与许可
鲸鱼娘皮肤素材来自 dsh-deep-whale（深海女仆工坊 maid-atelier）：
- 鲸鱼娘角色原作：上善（Pixiv · Bilibili）
- 女仆鲸鱼娘二次设计：ZipZipPipe（Pixiv · Bilibili）
- 完整署名链见 docs/maid-atelier-NOTICE.md
- 素材以 CC BY-NC-SA 4.0 发布（署名-非商业性使用-相同方式共享），本 App 仅个人自用，不用于商业用途
- 蓝鲸配色参考 dsh-blue-whale；夜之城主题对齐 dsh-theme-cyberpunk2077；字体方案对齐 dsh-font（App 仅引用系统字体族名，不打包字体文件）
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…