DeepseekHarness 手機版踩坑紀實——看著簡單其實有五個容易翻車的地方
DeepseekHarness 是什麼
DeepseekHarness 是一套把 AI 大模型能力接到日常工作流裡的工具，電腦端跑著主程序，手機版 App 就是它的遠端遙控面板。你在外面排隊等號的時候掏出手機，就能讓電腦那頭的 AI 幫你查資料、改代碼、跑腳本——不用蹲在桌前也能指揮它幹活。
說白了就是「手機當遙控器、電腦當後台大腦」的架構。適合需要隨時插手 AI 任務、或者想把 DeepseekHarness 的能力延伸到移動場景的使用者——更多背景可以看 DeepseekHarness官網 提供的完整指南。手機版本身不跑模型，它只負責連線與操作介面，所以安裝包才 1.59M，裝起來超快。
安裝
DeepseekHarness 手機版是 Android APK，版本 0.2.0，安裝包 1.59M——體積很小，裝起來基本沒什麼負擔。不過有兩件事要注意：
首先，手機版只是個面板，它必須配合同步版本的電腦端 DeepseekHarness 主程序與移動訪問插件才能工作。光裝手機 App 沒用，打開會卡在連線畫面。電腦端要先在移動訪問面板裡開啟局域網或遠程通道，生成配對密鑰，手機掃碼或手動輸入密鑰才能完成配對。
其次，安裝過程本身很標準：從 DeepseekHarness下載 拿 APK 後，系統可能會提示「未知來源」，允許一下就能裝。裝完第一次打開時，如果電腦端還沒開好訪問通道，App 會停在等待配對的畫面——這不是卡死，是在等你把電腦端那邊的配對密鑰準備好再掃。
我第一次裝的時候以為跟普通 App 一樣裝完就能用，結果打開發現什麼功能都點不了，以為裝壞了又卸載重裝——浪費了半天才意識到是電腦端那頭還沒配置。這軟體不是單機 App，是客戶端，這個定位要先搞清楚。
坑一：版本號看起來對，其實互相不綁定
症狀：我第一次升級電腦端 DeepseekHarness 之後，手機就連不上了。App 打開顯示連線超時，電腦端那邊的移動訪問面板也沒報錯。我以為是網路問題，重啟了路由器又重掃配對碼，折騰了快一個小時才發現——原來是版本組合的問題。
原因：DeepseekHarness 從 0.6.2 版本開始，App 版本、插件版本、主程序版本三者獨立編號，互不綁定。也就是說，你電腦上裝的主程序是 0.2.0，插件可能是 0.6.2，手機 App 可能是 0.3.15——三個版本號各查各的，沒有一個「都升到最新就對了」的簡單規則。更坑的是，不在官方驗證矩陣裡的版本組合，不代表不能用，但也不保證能用。我那次升級主程序到一個預發布版，插件還停在舊版，結果接口變動導致連線直接斷掉。
解法：升級後出問題，第一反應不是重配對也不是卸載重裝，而是先更新插件到最新版——多數「升級後不好使」靠這一步就能解。然後對照項目的兼容性矩陣看自己的組合有沒有被驗證過。舊版 App（0.1.3 及更早）升級後還得卸載重裝再重新配對，從 0.3.3 起才支援無縫升級不用重配。
坑二：通知死活不響，以為 App 壞了
症狀：我在電腦上讓 DeepseekHarness 跑了一個長任務，以為手機能收到完成通知，結果等了半天什麼都沒有。打開 App 發現任務其實早就跑完了，只是沒通知過來。
原因：DeepseekHarness 手機版的通知不是通用後台推送，它依賴 App 內 WebView 頁面存活。也就是說，App 被系統殺掉、或者 WebView 頁面被掛起，通知就直接斷了。另外還有兩個容易漏的地方：一是 App 內部的「通用設置」裡有個開關，預設是關的，得自己去打開；二是手機系統層面的通知權限，有些 ROM 會自動關閉後台通知。
解法：按這個順序排查——先去 App 裡的「設置 → 通用設置」確認通知開關有沒有打開；然後確認 App 沒被系統殺進後台，把它鎖在最近任務裡或者設置電池優化白名單；最後檢查手機系統的通知權限。三處都正常還不響，就只能去項目倉庫反饋了——這種是真的 bug。
坑三：舊手機打開直接白屏，報 Iterator is not defined
症狀：我用一台老 Android 手機測試，打開 App 直接白屏，控制台報錯 Iterator is not defined。以為是 APK 下壞了，重下了好幾次都一樣。
原因：這個錯誤不是 App 本身的問題，是手機的 WebView 內核太舊，缺少新版 JavaScript API（迭代器輔助方法、Promise.withResolvers、AbortSignal.any 這些）。DeepseekHarness 的移動訪問插件雖然隨包提供了一層兼容腳本，會同步加載經網關鑒權的同源腳本來補齊缺失的 API，但兼容層只覆蓋已識別的缺失，太老的內核還是兜不住。
解法：優先更新 Android System WebView 或 Chrome——這兩個是 WebView 的底層提供者，更新之後多半直接解決。如果手機系統組件不可更新（有些廠商把 WebView 綁死在系統裡），那就只能把完整的錯誤信息和內核版本帶去項目倉庫反饋了。臨時繞路方案：在頁面地址後面追加 ?frontend=stock 可以回到舊版桌面頁面適配模式，雖然功能殘缺但至少能看。
坑四：遠程通道開了兩套，結果互相搶連線
症狀：我之前電腦上裝了一個第三方遠程插件，後來又開了 DeepseekHarness 自帶的遠程通道。結果手機時而連得上、時而連不上，有時顯示連線成功但發指令沒反應。
原因：兩套遠程訪問方案用的是完全不同的授權體系，互不相認。同時開著的時候，手機端不知道該走哪條路，兩邊可能同時佔用同一個端口或者互相干擾握手過程，表現出來就是連線時斷時續。
解法：只保留一套接管遠程訪問，另一套關掉。建議用 DeepseekHarness 自帶的移動訪問插件，它和主程序的兼容性最好，出問題也有統一的排查口。如果要用第三方插件，那就把自帶的關乾淨。兩套並開只會讓你調到懷疑人生。
坑五：手機首次加載流量大到嚇人
症狀：第一次在手機上打開 DeepseekHarness 專用頁面時，網路請求一堆，流量跑了好幾兆。我當時在外面用移動數據，差點以為 App 在偷偷下什麼。
原因：移動訪問插件首次啟動會加載一整套客戶端模組——文件編輯器、終端、搜索、技能面板、工作流這些全部在首次請求時下載，所以流量會偏大。之後這些模組會被緩存，就不會再重下了。
解法：首次加載盡量在 Wi-Fi 環境下完成。高級用戶可以去 profile 的移動訪問插件配置裡設置 excludedClientModules，把啟動清單裡不需要的模組包名填進去排除掉——只影響手機端頁面，電腦端不受影響。不過配置要填精確的包名，填錯了會返回 409 並顯示衝突詳情，刪掉配置就能恢復。
防坑清單
整理了五個最容易踩的坑，做成速查清單給你：
- 版本升級後連不上 → 先更插件，再對照兼容性矩陣
- 通知不響 → App 內開關 → WebView 是否存活 → 系統通知權限，按順序查
- 白屏報 Iterator 錯誤 → 更 WebView/Chrome，臨時加
?frontend=stock繞過 - 遠程連線時斷時續 → 只留一套遠程方案，另一套關乾淨
- 首次加載流量大 → Wi-Fi 環境下首次打開，高級用戶可排除不需要的模組
知道這些坑之後，DeepseekHarness 手機版其實相當省心——裝上之後只要配對一次，日常用起來就是個稱手的 AI 遙控器，在外也能隨時插手電腦那頭的任務。
本文為個人基於網路公開資料整理編寫，非官方內容，僅供學習交流參考；軟體版權歸原作者所有，請支持正版；使用過程中遇到問題請查閱官方管道，本文不承擔任何責任。
