前言¶
DeepSeek Harness（DSH）通常跑在桌面環境裏。人離開電腦——在公司、在路上——想接着問一句、看日誌或批准一輪會話，常見做法是遠程桌面、VNC，或再裝一套客戶端。這些路徑要麼重、要麼要在手機上裝 App。
DSH My Phone 是社區插件，維護者爲 ssy-in，分類爲客戶端。它在本機 DSH 旁起一個配對與代理入口：手機用瀏覽器打開頁面，看到的是原生 DSH 界面，無需單獨安裝 App，也無需註冊賬號。同 Wi-Fi 可走局域網；不在同一網絡時可選 Cloudflare 快速隧道。下文按「是什麼 → 能做什麼 → 怎麼裝怎麼用 → 安全與限制」說明，事實均來自插件 README 與倉庫元數據。
這是什麼¶
一句話：把當前電腦上的 DSH「裝進口袋」——手機掃碼配對後，通過插件代理訪問宿主官方會話，而不是在插件裏另造一套 UI。
數據流可以概括爲：
手機瀏覽器 ──▶ DSH My Phone（配對憑據）──▶ 本機 DSH（官方會話）
插件已發佈到 npm，包名爲 dsh-my-phone，許可證 MIT；依賴 Node.js >= 20，並通過 Cordis 以 patch 形式掛入 DSH（peerDependencies 含 @deepseek-ai/cordis ^4.0.5）。
核心功能¶
手機端零安裝。 瀏覽器打開配對後的地址即可使用完整 DSH 界面；未持有效憑據時只會看到「用手機掃電腦上的碼」，沒有手輸配對碼的頁面。
局域網與外網兩種入口。 局域網默認可用（同 Wi-Fi，不經第三方）。外網默認通過 Cloudflare 快速隧道（trycloudflare.com 類地址）；第一次開啓時插件會在後臺下載 cloudflared（約 53MB，只需一次）。README 說明：快速隧道地址每次重啓會變，需要重新在電腦設置頁查看；固定域名需自備域名與 Cloudflare 命名隧道（文檔提到 v0.2 支持命名隧道）。
配對與設備管理。 電腦端點「生成二維碼」纔會出碼（不會自動生成；二維碼帶一次性票據，3 分鐘有效、用一次作廢，需手動點「換一個二維碼」刷新）。手機掃碼後出現「信任這臺電腦？」，須主動點信任才建立設備。每臺設備一枚 HMAC 令牌，可在「高級」裏備註、斷開或刪除；默認最多 8 臺，滿員後再掃會提示先在電腦上刪掉一臺。
界面入口。 DSH 任意界面右下角有懸浮入口（「連接 DSH」），與設置頁同一套「連接 / 高級 / 消息·日誌」面板；連上後提示行會消失，圖標可拖拽貼邊。宿主 Web UI 還提供 settings.plugin.item 設置卡片。管理頁僅綁定 127.0.0.1（默認管理地址 http://127.0.0.1:8080/__myphone/，端口被佔用時自動向後嘗試最多 12 個端口）。
安全設計要點（README 歸納）。 插件不解析 .credentials.yaml，而是調用宿主 ctx.connection.authenticatedUrl() 換取官方會話；管理面與公網訪問面分離；憑據可按設備吊銷。完整風險說明見倉庫 SECURITY.md——README 強調：打開入口相當於把本機 DSH 賬號能力暴露給拿到入口的人，局域網入口默認打開，用不到應關閉；外網隧道默認開啓但僅在需要時使用。
安裝與啓用¶
裝進當前 profile（npm 已發佈包）：
dsh plugin add dsh-my-phone --profile desktop
本地源碼目錄也可安裝（README 註釋示例）：
# dsh plugin add ./dsh-my-phone --profile desktop
安裝後重啓 DSH，在本機瀏覽器打開管理頁（僅本機可訪問）：
http://127.0.0.1:8080/__myphone/
狀態與設置寫在 ~/.dsh/.dsh-my-phone/state.json（含本機簽名密鑰，等同於密碼，勿外傳）。常用字段如下：
| 字段 | 默認 | 說明 |
|---|---|---|
lanEnabled |
true |
局域網入口 |
lanPort |
8080 |
管理頁端口（僅 127.0.0.1） |
publicPort |
8081 |
公網入口端口（開啓時監聽） |
tunnelEnabled |
true |
外網 Cloudflare 隧道 |
cloudflaredPath |
'' |
cloudflared 可執行文件路徑 |
maxDevices |
8 |
最多配對設備數 |
autoOffMinutes |
30 |
連續無訪問自動收回入口；0 表示不自動關 |
README 註明 v0.4.3 起 autoOffMinutes 默認改爲按通道分開計算且默認關 0 的行爲調整；以當前 state.json 實際寫入爲準。
典型用法¶
同 Wi-Fi 下第一次連接
- 重啓 DSH 後打開管理頁或點右下角懸浮入口。
- 點擊「生成二維碼」，用手機相機或瀏覽器掃碼。
- 在手機上點「信任這臺電腦，進入 DSH」。之後可直接用手機保存的入口地址訪問。
在公司訪問家裏電腦（外網）
- 在電腦「高級」中確保外網隧道已開啓，等待約 10–30 秒出現
https://xxx.trycloudflare.com類地址（或掃對應二維碼）。 - 手機打開該地址並完成一次「信任這臺電腦」。
- 隧道地址變化或 DSH 重啓後，需按界面提示重新掃碼；README 說明外網通道斷線後插件會按退避策略嘗試重連，連上新域名時需手機重掃。
連不上時排查（README v0.4 起）
- 懸浮窗 → 高級 → 排查日誌 → 展開，或使用「複製診斷」。
- 查看
~/.dsh/.dsh-my-phone/pair.log（配對嘗試）與error.log（500 堆棧）。
手機端「高級」爲只讀視圖，開關與換碼、撤銷其他設備必須在電腦管理面操作。
適用場景與注意¶
適合誰： 已在桌面 profile 長期使用 DSH，偶爾需要用手機繼續同一套會話與界面；希望避免遠程桌面或單獨移動客戶端；能接受自行管理局域網/隧道開關與設備列表。
務必知曉：
- 插件以當前 DSH 進程權限運行；安裝前應閱讀源碼與 MIT 許可證，並閱讀
SECURITY.md。 - 社區目錄頁（SkillHub）與 GitHub 倉庫由維護者發佈，與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，本文介紹的是社區插件之一。
- README「已知限制」一節（標註 v1.5.0）仍列出例如快速隧道地址不固定、隧道斷線行爲等歷史表述；較新版本 CHANGELOG 中對外網重連、UI 等有後續改進，以你安裝的版本 README / CHANGELOG 爲準。
- 目錄頁線索星標爲 0，不代表功能完整度；以倉庫文檔與自測爲準。
結尾¶
DSH My Phone 解決的是「人不在電腦旁，仍用手機瀏覽器接着用本機 DSH」——局域網優先、外網隧道可選、按設備配對與吊銷。安裝命令爲 dsh plugin add dsh-my-phone --profile desktop，裝好後在本機 http://127.0.0.1:8080/__myphone/ 生成二維碼即可開始。
