老柯修机铺

通讯行老师傅的手机软件笔记——每款 App 装过、用过,才敢写下来

DeepseekHarness 手机端能力全景盘点:一款让手机遥控本地 AI 的工具到底能做什么

项目内容
软件DeepseekHarness
版本0.2.0
平台Android APK
体积1.59M
分类系统工具
包名io.github.sayach.dshmobile
官网DeepseekHarness 官网
下载一DeepseekHarness 下载,DeepseekHarness 下载
下载二DeepseekHarness 下载,DeepseekHarness 下载
文档DeepseekHarness 文档
介绍从多入口移动访问到 PTC 程序化工具调用,从局域网自动发现到原生通知与安全机制,系统性梳理 DeepseekHarness 安卓版覆盖的六大能力域、已知短板与适用人群画像。

DeepseekHarness 手机端是什么

DeepseekHarness 是一款面向本地大模型运行场景的 AI 助手框架,电脑端装好之后,手机版的作用不是另起炉灶跑一份模型,而是把手机变成遥控器——随时随地调用电脑端的 AI 会话和能力。它的安卓 App 本质上是一个 Kotlin WebView 薄壳,打开的是和浏览器访问完全相同的页面,但额外提供了局域网自动发现、系统通知、Keystore 加密存储这些原生层能力。1.59M 的安装包体量,说明它没有内置第二套引擎,壳本身很轻。

为什么值得认真盘点?因为它解决的问题挺独特的——本地跑大模型的人,最痛的一件事就是"我人在外面,想让家里那台电脑上的 AI 帮我做点事"。远程桌面能用,但太重量级;写 webhook 也行,但得自己搭服务。DeepseekHarness 手机版把这个问题收进了一个专门的移动访问方案里,而且能力面铺得相当完整。下面按能力域逐一拆开。

多入口移动访问:选哪个都能连上

移动访问不是只有一个 App。官方给了三个入口,社区还有一个补充客户端:

安卓 App 是日常主力。 首次配对时分局域网访问和远程访问两个入口,局域网模式自动发现同网段的设备,远程模式走公开证书由系统验证。App 壳提供的原生能力是其他入口拿不到的——后台任务提醒、Keystore 加密凭证存储、锁屏通知脱敏。

手机浏览器是临时救急。 电脑端「移动访问」卡片会显示一个 HTTPS 地址,任何设备打开就能访问同一个页面。功能和 App 里看到的完全一致,差异只在壳层。换了手机、借了别人的手机临时用一下,浏览器入口最方便,缺点是局域网私有证书首次访问要手动确认,浏览器系统通知按来源分别授权,可能不响。

微信小程序客户端是社区尝鲜版。 正式版受微信域名备案限制,目前需开发者工具或真机调试才能跑通。如果你在微信生态里有场景需求可以看看,但生产使用还是推荐前两类。

三种入口的授权体系互相独立——同一台电脑可以被多个入口分别配对,互不干扰。

远程访问入口

局域网配对与网络适配:端口和防火墙那些事

配对这块容易踩坑,但设计上挺清楚的。电脑端有两个端口各司其职:3080 是 dsh Web 上游端口,只服务电脑本机访问;3443 是手机走的独立 HTTPS 入口,手机流量全部走它。改端口后重新生成二维码就行,配对二维码里包含实际端口号,手机端不用手动填。

网卡自动选择是个实用特性。setup 命令会记住当前局域网网卡。多网卡电脑(同时连有线和 Wi-Fi)自动选错时,手动指定 IP 即可。手机热点加电脑连热点的组合同样适用,和家用 Wi-Fi 思路完全一样。

防火墙这块,Windows 用户基本不用管——插件会自动创建放行规则,卸载时 purge 一并删除。Linux 用户得自己管理入站规则,连不上先查 3443 端口放行了没有。

无界面主机的场景有几条硬规则值得留意:管理 API 只接受本机回环连接,不会暴露到公网;反向代理必须只对可信内网开放,绝不能把移动访问管理路径公开转发到互联网。3443 的 HTTPS 入口始终是移动端界面,不会被反向代理变成桌面管理口。

局域网访问示意

原生能力增强:系统通知、触屏适配与后台存活

App 壳虽然薄,但补的几个原生能力挺关键。

任务完成通知和待输入提醒是独立功能,需要在 App 内 dsh 的设置里主动开启,锁屏状态下通知文本脱敏。它依赖 WebView 页面存活,不是通用后台推送——要可靠推送得自己配服务端 webhook 或机器人通道。通知不响时按顺序排查:App 内有没有开、WebView 有没有被系统杀掉、手机系统通知权限有没有授予。

触屏输入有一套自己的行为:软键盘已打开且未连接实体键盘时,触屏回车保留换行;长问题和选项在卡片内共同滚动,收起时标题最多两行。这套提问卡片增强可以独立启停,不喜欢就关掉。

旧 WebView 内核兼容是个良心设计。某些旧手机打开会报 Iterator is not defined,插件随包提供兼容层,补齐缺失的迭代器辅助方法,较新版本还补了 Promise.withResolvers 和 AbortSignal.any。兼容层只覆盖已识别的缺失 API,能更新 Android System WebView 或 Chrome 就优先更新。

PTC 程序化工具调用:让 AI 写 TypeScript 跑批量

这是 DeepseekHarness 比较有辨识度的一项能力。普通模式下,让 AI 遍历 50 个文件各提取一段统计再汇总,意味着 50 多次独立工具调用往返,每次都消耗上下文和时间。PTC(Programmatic Tool Calling,官方叫 Code 模式)换了个思路:让模型写一段 TypeScript 程序,把多轮工具调用编排进去,一次运行完成。

程序里调用的是 Code Mode SDK 暴露的工具接口,执行引擎跑完整段代码后把最终结果交回会话。省掉的是中间几十轮"结果进上下文、再决定下一步"的开销,换来的是确定性的控制流——循环、条件、异常处理都是代码写死的,不是模型每轮即兴发挥。

适合的场景很明确:批量多文件多目录处理、构建测试报告这类有固定链路的任务、长任务里模型容易"忘事"的时候,把流程固化成程序更稳。小提醒:程序是模型生成的,复杂程序第一次跑可能有 bug,建议先跑小规模再放量。

第三方插件与移动访问的边界

桌面端用的插件在手机上能不能用?答案是工作区、任务管理、终端和文件面板入口都保留了,第三方插件仍由 dsh 正常加载。但小屏是否易用取决于插件自己的布局,移动层不保证把所有自定义布局自动改成手机版。依赖桌面原生窗口的插件替代不了。

首次加载流量太大时,高级用户可以在 profile 的移动访问插件配置里设置 excludedClientModules,填启动清单中的准确包名排除不需要的客户端模块,只影响专用移动页面,电脑端不变。配置不匹配会返回 409 并给出冲突详情,移除即恢复。设置优先级是"本设备选择 → 电脑默认 → 插件配置"。

短板也要说

能力面铺得广的同时,几个局限得提前知道。

后台推送不是真推送。 任务提醒依赖 WebView 页面存活,系统杀掉页面就收不到通知了。要可靠推送必须配服务端 webhook 或自建机器人通道,这对普通用户来说有门槛。

iOS 用户无原生入口。 官方只给了安卓 App,iPhone 用户只能走浏览器入口,体验差一截——没有自动发现、没有 Keystore 加密、没有锁屏通知脱敏。

插件小屏适配靠第三方自觉。 移动层不做自动适配改造,桌面插件直接搬过来可能布局错乱,尤其是那些依赖多栏、侧边栏的插件。

PTC 程序质量取决于模型本身。 让 AI 写 TypeScript 虽然省了多轮往返,但复杂程序的正确性和普通代码一样需要调试,第一次跑大概率有 bug。

适用人群画像

综合能力面和短板,DeepseekHarness 手机版主要服务三类人群:

第一类:本地大模型重度用户。 家里或工作室有一台常开的电脑跑模型,需要出门时也能远程调用会话、看任务进度、处理一些轻量指令。局域网自动发现和独立 HTTPS 入口让配对这一次性工作做完就不用再管了。

第二类:远程协作中的 AI 调用场景。 团队里有人在电脑端跑着复杂任务,外出的人需要通过手机随时介入、下达补充指令、或者让 AI 帮着做一些文件处理类的批量工作。PTC 模式在这里的价值最能体现——把固定链路的任务固化成程序,一次跑完。

第三类:技术研究者和极客玩家。 喜欢折腾本地 AI、对网络配置有概念、愿意花时间配对和调端口的人。第三方插件加载、自定义端口、反向代理接入这些功能都是为他们准备的,普通用户可能一辈子用不上。

如果你不属于上面三类,只是想找一个手机上直接跑大模型的 App,那 DeepseekHarness 手机版可能不是最合适的选择——它的定位始终是"遥控器"而不是"独立终端"。但对于家里有模型在跑、出门又想遥控它的人来说,这套方案是目前市面上能力覆盖最完整的一类。

本文为个人基于网络公开资料整理编写,非官方内容,仅供学习交流参考;软件版权归原作者所有,请支持正版;使用过程中遇到问题请查阅官方渠道,本文不承担任何责任。

同类文章