鴻蒙的 8 個(gè)坑)
直接說結(jié)論把 DeepSeek Harness 搬進(jìn)鴻蒙坑不在 Electron在鴻蒙的沙箱和網(wǎng)絡(luò)模型。桌面 Linux 上理所當(dāng)然的事——symlink、硬鏈接、訪問 127.0.0.1、HOME 目錄——到了鴻蒙上全被改了規(guī)矩。我數(shù)了數(shù)能靠補(bǔ)丁 插件繞過去的有 8 個(gè)坑但有少數(shù)幾個(gè)是真·繞不過去的坎比如「隨包自帶 Node、npm、pnpm、Python、pip、uv 等運(yùn)行時(shí)和工具」。這個(gè)坎我第一篇文章就埋過伏筆當(dāng)時(shí)叫它「第二層難點(diǎn)」根因是二進(jìn)制證書個(gè)人開發(fā)者不可得后面 ACL 篇我會單獨(dú)講透。這篇先把 8 個(gè)能繞過去的坑一個(gè)個(gè)拆開。一、先把背景對齊為什么是這 8 個(gè)坑我的目標(biāo)是復(fù)用 desktop 那套架構(gòu)進(jìn)程內(nèi) Host webserver 同源數(shù)據(jù)面把 dsh 原樣搬進(jìn)鴻蒙。唯一本質(zhì)差異是把「官方 Electron 運(yùn)行時(shí)」換成「Electron-on-鴻蒙運(yùn)行時(shí)」。結(jié)果這「換一個(gè)運(yùn)行時(shí)」引出一串連鎖反應(yīng)沙箱禁了 symlink、回環(huán)地址被隔離、打包階段被 5 萬個(gè)小文件卡死、原生模塊全是 win32 二進(jìn)制……下面按「現(xiàn)象 → 原因 → 解決」逐個(gè)拆。二、8 個(gè)坑逐個(gè)拆坑 1loopback 網(wǎng)絡(luò)隔離現(xiàn)象渲染進(jìn)程加載127.0.0.1:端口直接白屏Web UI 加載失敗。原因鴻蒙對渲染進(jìn)程訪問本機(jī)回環(huán)地址做了進(jìn)程間網(wǎng)絡(luò)隔離桌面版「同源加載 localhost」的老路子走不通了。解決webserver 綁0.0.0.0渲染進(jìn)程改走局域網(wǎng) IP出棧前再把Host/Origin改寫回127.0.0.1:端口以通過 dsh 的 loopback-only 特權(quán)方法圍欄。安全語義不變——局域網(wǎng)其他設(shè)備依然 403。坑 2沙箱禁 symlink現(xiàn)象symlinkSync直接拋EACCESdsh 初始化階段就失敗。原因鴻蒙應(yīng)用沙箱禁止創(chuàng)建符號鏈接這也解釋了后面坑 4 里 hardlink 相關(guān)的問題。解決加 patchsymlink 失敗時(shí)回退cpSync遞歸拷貝。犧牲一點(diǎn)磁盤空間換來初始化不再崩?？?3HAP 打包超限5 萬個(gè)小文件現(xiàn)象dsh 構(gòu)建產(chǎn)物有5 萬多個(gè)小文件hvigor 打包階段直接卡死、內(nèi)存爆掉。原因鴻蒙的 HAP 打包流程對海量小文件不友好node_modules 那種「文件多、單個(gè)體積小」的結(jié)構(gòu)是它的天敵。解決先把整個(gè)dsh-dist壓成單個(gè)dsh-dist.tar.gz約 143MB--formatustar運(yùn)行時(shí)再流式解壓。把「5 萬次小文件搬運(yùn)」變成「一次大文件搬運(yùn) 一次流式解壓」?？?4原生模塊 ABI 不匹配卡了我一整天現(xiàn)象sharp / node-pty / koffi 這些原生模塊在 Windows 上收集產(chǎn)物時(shí)是win32-x64 二進(jìn)制到了鴻蒙 aarch64 上根本加載不了直接報(bào)錯。原因dsh-dist 是在 Windows 上收集的原生模塊的二進(jìn)制平臺被鎖死在 win32-x64。解決三條路這個(gè)坑我最久才爬出來sharp→ 換成純 JS stub不做事像素解碼只解析圖片容器頭干凈的 8-bit sRGB PNG/JPEG/WebP 直接按字節(jié)直通。node-pty / koffi→ 直接禁用對應(yīng)能力終端、進(jìn)程沙箱。better-sqlite3→ 換用 Electron 37 / Node ABI v138 的 aarch64 成品會話持久化保住了。這個(gè)坑最折磨人的地方在于它不是「裝錯了東西」而是「你裝的東西從根上就是錯的平臺」得一層層溯源到「產(chǎn)物是在哪臺機(jī)器上收集的」?？?5HOME 指向沙箱外現(xiàn)象一打開「選擇工作區(qū)」就報(bào)cannot list /storage/Users/currentUser: EPERM。原因鴻蒙沙箱里os.homedir()返回的是沙箱外的系統(tǒng)用戶目錄應(yīng)用無權(quán)訪問一點(diǎn)進(jìn)去就 EPERM。解決dsh Host 啟動前把HOME顯式指向沙箱可寫目錄userData讓「工作區(qū)選擇」落在應(yīng)用自己能讀寫的范圍內(nèi)?？?6特權(quán)方法 403現(xiàn)象設(shè)置對話框多處報(bào)transport failure for /api/settings.describe: HTTP 403。原因dsh 把settings.*、credentials.*等特權(quán)方法鎖定為 loopback-only而鴻蒙為了繞坑 1 的 loopback 隔離改走了局域網(wǎng) IPHost頭不是 loopback → 直接被 403。解決在內(nèi)嵌渲染進(jìn)程請求出棧前把Host/Origin改寫為127.0.0.1:端口?？?1 和坑 6 其實(shí)是同一枚硬幣的兩面一個(gè)要「繞開 loopback」一個(gè)要「裝成 loopback」。坑 7agent preset 工具行無限等待現(xiàn)象加完工作區(qū)點(diǎn)不了session.create拋agent-preset-invalid。原因standard preset 里tool-bash、tool-fs-search依賴被禁用的 shell/subprocessnode-pty坑 4 已禁于是無限等待 → preset 掛載失敗。解決禁用依賴 shell / subprocess / pty 的工具行。禁用要「整行摘掉」別只摘工具名否則 preset 解析還會卡?？?8corepack pnpm 不可用現(xiàn)象desktop 構(gòu)建用的是corepack pnpm到了鴻蒙構(gòu)建環(huán)境 corepack 直接不可用。原因corepack 依賴下載/切換 pnpm 版本的機(jī)制在鴻蒙構(gòu)建環(huán)境里走不通。解決構(gòu)建腳本直接調(diào)pnpm跳過 corepack 這一層。別在鴻蒙環(huán)境里跟 corepack 死磕能省一天。三、8 個(gè)坑速查表坑現(xiàn)象根因解決1 loopback 隔離渲染進(jìn)程白屏回環(huán)地址進(jìn)程間隔離綁0.0.0.0 局域網(wǎng) IP2 禁 symlinksymlinkSync報(bào) EACCES沙箱禁符號鏈接回退cpSync拷貝3 打包超限5 萬小文件卡死HAP 對海量小文件不友好打 tar.gz 流式解壓4 ABI 不匹配原生模塊加載失敗產(chǎn)物是 win32-x64stub / 禁用 / 換 aarch645 HOME 越界選工作區(qū) EPERMhomedir 指向沙箱外HOME 指向 userData6 特權(quán) 403settings 報(bào) 403特權(quán)方法 loopback-only出棧改寫 Host/Origin7 preset 卡死agent-preset-invalid依賴被禁的 shell/subprocess禁用依賴 pty 的工具行8 corepack 不可用pnpm 拉不起來corepack 機(jī)制走不通直接調(diào) pnpm一句話記住鴻蒙化難的不是 Electron是沙箱和網(wǎng)絡(luò)模型逼著你換一套心智模型。四、還有幾個(gè)繞不過去的坎上面 8 個(gè)坑都能繞。但有 3 個(gè)坎繞過去得另辟蹊徑二進(jìn)制證書個(gè)人不可得——隨包分發(fā) ELFNode / pnpm / Python 運(yùn)行時(shí)需要二進(jìn)制證書個(gè)人開發(fā)者拿不到。這條是真·繞不過去「隨包自帶完整工具鏈」只能放棄下一篇 ACL 篇講透。應(yīng)用域 node 子進(jìn)程被 SIGSYS 殺——沙箱 seccomp 策略禁止 fork 出的子進(jìn)程分配 JIT 可執(zhí)行內(nèi)存node 一創(chuàng)建 V8 isolate 就被內(nèi)核打死所以「在應(yīng)用里 spawn 一個(gè) node/pnpm 子進(jìn)程」走不通。用戶數(shù)據(jù)分區(qū)禁 exec ELF——就算弄來 linux-arm64 原生 pnpm也塞不進(jìn)用戶目錄。這三個(gè)坎疊一起把「插件市場一鍵安裝」逼到了墻角。其中第 2、3 個(gè)我正在嘗試解決思路是把「spawn 子進(jìn)程」改成「在主進(jìn)程內(nèi)進(jìn)程式調(diào)用 pnpm」——這個(gè)坑夠單獨(dú)寫一篇專題這里先點(diǎn)到為止。五、寫在最后以上就是把 DeepSeek Harness 搬進(jìn)鴻蒙的 8 個(gè)坑外加幾個(gè)還沒完全啃完的坎。如果你也在做鴻蒙 / Electron-on-鴻蒙的適配這份清單照著查一遍能少踩不少。代碼已開源https://github.com/fellow99/dsh-desktop-hos歡迎star支持。下一篇我寫ACL 權(quán)限申請踩坑哪些權(quán)限才需要申請、我差點(diǎn)白交一批、以及最后 3 項(xiàng)一次通過的全過程。關(guān)注公眾號并設(shè)為星標(biāo)別錯過。相關(guān)開源工程DeepSeek Harness上游項(xiàng)目https://github.com/deepseek-ai/deepseek-harnessdsh-market插件市場https://github.com/dsh-market/dsh-marketharmonypc-electronElectron-on-鴻蒙運(yùn)行時(shí)https://atomgit.com/jianguoxu/harmonypc-electrondeepseek-harness-workspace工作區(qū)總覽https://github.com/fellow99/deepseek-harness-workspacedsh-desktop桌面端https://github.com/fellow99/dsh-desktopdsh-desktop-hos鴻蒙端https://github.com/fellow99/dsh-desktop-hos感謝各位關(guān)注歡迎訪問我的 GitHub 主頁https://fellow99.github.io/ 把 DeepSeek Harness 搬進(jìn)鴻蒙的 8 個(gè)坑
直接說結(jié)論把 DeepSeek Harness 搬進(jìn)鴻蒙坑不在 Electron在鴻蒙的沙箱和網(wǎng)絡(luò)模型。桌面 Linux 上理所當(dāng)然的事——symlink、硬鏈接、訪問 127.0.0.1、HOME 目錄——到了鴻蒙上全被改了規(guī)矩。我數(shù)了數(shù)能靠補(bǔ)丁 插件繞過去的有 8 個(gè)坑但有少數(shù)幾個(gè)是真·繞不過去的坎比如「隨包自帶 Node、npm、pnpm、Python、pip、uv 等運(yùn)行時(shí)和工具」。這個(gè)坎我第一篇文章就埋過伏筆當(dāng)時(shí)叫它「第二層難點(diǎn)」根因是二進(jìn)制證書個(gè)人開發(fā)者不可得后面 ACL 篇我會單獨(dú)講透。這篇先把 8 個(gè)能繞過去的坑一個(gè)個(gè)拆開。一、先把背景對齊為什么是這 8 個(gè)坑我的目標(biāo)是復(fù)用 desktop 那套架構(gòu)進(jìn)程內(nèi) Host webserver 同源數(shù)據(jù)面把 dsh 原樣搬進(jìn)鴻蒙。唯一本質(zhì)差異是把「官方 Electron 運(yùn)行時(shí)」換成「Electron-on-鴻蒙運(yùn)行時(shí)」。結(jié)果這「換一個(gè)運(yùn)行時(shí)」引出一串連鎖反應(yīng)沙箱禁了 symlink、回環(huán)地址被隔離、打包階段被 5 萬個(gè)小文件卡死、原生模塊全是 win32 二進(jìn)制……下面按「現(xiàn)象 → 原因 → 解決」逐個(gè)拆。二、8 個(gè)坑逐個(gè)拆坑 1loopback 網(wǎng)絡(luò)隔離現(xiàn)象渲染進(jìn)程加載127.0.0.1:端口直接白屏Web UI 加載失敗。原因鴻蒙對渲染進(jìn)程訪問本機(jī)回環(huán)地址做了進(jìn)程間網(wǎng)絡(luò)隔離桌面版「同源加載 localhost」的老路子走不通了。解決webserver 綁0.0.0.0渲染進(jìn)程改走局域網(wǎng) IP出棧前再把Host/Origin改寫回127.0.0.1:端口以通過 dsh 的 loopback-only 特權(quán)方法圍欄。安全語義不變——局域網(wǎng)其他設(shè)備依然 403。坑 2沙箱禁 symlink現(xiàn)象symlinkSync直接拋EACCESdsh 初始化階段就失敗。原因鴻蒙應(yīng)用沙箱禁止創(chuàng)建符號鏈接這也解釋了后面坑 4 里 hardlink 相關(guān)的問題。解決加 patchsymlink 失敗時(shí)回退cpSync遞歸拷貝。犧牲一點(diǎn)磁盤空間換來初始化不再崩?？?3HAP 打包超限5 萬個(gè)小文件現(xiàn)象dsh 構(gòu)建產(chǎn)物有5 萬多個(gè)小文件hvigor 打包階段直接卡死、內(nèi)存爆掉。原因鴻蒙的 HAP 打包流程對海量小文件不友好node_modules 那種「文件多、單個(gè)體積小」的結(jié)構(gòu)是它的天敵。解決先把整個(gè)dsh-dist壓成單個(gè)dsh-dist.tar.gz約 143MB--formatustar運(yùn)行時(shí)再流式解壓。把「5 萬次小文件搬運(yùn)」變成「一次大文件搬運(yùn) 一次流式解壓」?？?4原生模塊 ABI 不匹配卡了我一整天現(xiàn)象sharp / node-pty / koffi 這些原生模塊在 Windows 上收集產(chǎn)物時(shí)是win32-x64 二進(jìn)制到了鴻蒙 aarch64 上根本加載不了直接報(bào)錯。原因dsh-dist 是在 Windows 上收集的原生模塊的二進(jìn)制平臺被鎖死在 win32-x64。解決三條路這個(gè)坑我最久才爬出來sharp→ 換成純 JS stub不做事像素解碼只解析圖片容器頭干凈的 8-bit sRGB PNG/JPEG/WebP 直接按字節(jié)直通。node-pty / koffi→ 直接禁用對應(yīng)能力終端、進(jìn)程沙箱。better-sqlite3→ 換用 Electron 37 / Node ABI v138 的 aarch64 成品會話持久化保住了。這個(gè)坑最折磨人的地方在于它不是「裝錯了東西」而是「你裝的東西從根上就是錯的平臺」得一層層溯源到「產(chǎn)物是在哪臺機(jī)器上收集的」?？?5HOME 指向沙箱外現(xiàn)象一打開「選擇工作區(qū)」就報(bào)cannot list /storage/Users/currentUser: EPERM。原因鴻蒙沙箱里os.homedir()返回的是沙箱外的系統(tǒng)用戶目錄應(yīng)用無權(quán)訪問一點(diǎn)進(jìn)去就 EPERM。解決dsh Host 啟動前把HOME顯式指向沙箱可寫目錄userData讓「工作區(qū)選擇」落在應(yīng)用自己能讀寫的范圍內(nèi)?？?6特權(quán)方法 403現(xiàn)象設(shè)置對話框多處報(bào)transport failure for /api/settings.describe: HTTP 403。原因dsh 把settings.*、credentials.*等特權(quán)方法鎖定為 loopback-only而鴻蒙為了繞坑 1 的 loopback 隔離改走了局域網(wǎng) IPHost頭不是 loopback → 直接被 403。解決在內(nèi)嵌渲染進(jìn)程請求出棧前把Host/Origin改寫為127.0.0.1:端口?？?1 和坑 6 其實(shí)是同一枚硬幣的兩面一個(gè)要「繞開 loopback」一個(gè)要「裝成 loopback」。坑 7agent preset 工具行無限等待現(xiàn)象加完工作區(qū)點(diǎn)不了session.create拋agent-preset-invalid。原因standard preset 里tool-bash、tool-fs-search依賴被禁用的 shell/subprocessnode-pty坑 4 已禁于是無限等待 → preset 掛載失敗。解決禁用依賴 shell / subprocess / pty 的工具行。禁用要「整行摘掉」別只摘工具名否則 preset 解析還會卡?？?8corepack pnpm 不可用現(xiàn)象desktop 構(gòu)建用的是corepack pnpm到了鴻蒙構(gòu)建環(huán)境 corepack 直接不可用。原因corepack 依賴下載/切換 pnpm 版本的機(jī)制在鴻蒙構(gòu)建環(huán)境里走不通。解決構(gòu)建腳本直接調(diào)pnpm跳過 corepack 這一層。別在鴻蒙環(huán)境里跟 corepack 死磕能省一天。三、8 個(gè)坑速查表坑現(xiàn)象根因解決1 loopback 隔離渲染進(jìn)程白屏回環(huán)地址進(jìn)程間隔離綁0.0.0.0 局域網(wǎng) IP2 禁 symlinksymlinkSync報(bào) EACCES沙箱禁符號鏈接回退cpSync拷貝3 打包超限5 萬小文件卡死HAP 對海量小文件不友好打 tar.gz 流式解壓4 ABI 不匹配原生模塊加載失敗產(chǎn)物是 win32-x64stub / 禁用 / 換 aarch645 HOME 越界選工作區(qū) EPERMhomedir 指向沙箱外HOME 指向 userData6 特權(quán) 403settings 報(bào) 403特權(quán)方法 loopback-only出棧改寫 Host/Origin7 preset 卡死agent-preset-invalid依賴被禁的 shell/subprocess禁用依賴 pty 的工具行8 corepack 不可用pnpm 拉不起來corepack 機(jī)制走不通直接調(diào) pnpm一句話記住鴻蒙化難的不是 Electron是沙箱和網(wǎng)絡(luò)模型逼著你換一套心智模型。四、還有幾個(gè)繞不過去的坎上面 8 個(gè)坑都能繞。但有 3 個(gè)坎繞過去得另辟蹊徑二進(jìn)制證書個(gè)人不可得——隨包分發(fā) ELFNode / pnpm / Python 運(yùn)行時(shí)需要二進(jìn)制證書個(gè)人開發(fā)者拿不到。這條是真·繞不過去「隨包自帶完整工具鏈」只能放棄下一篇 ACL 篇講透。應(yīng)用域 node 子進(jìn)程被 SIGSYS 殺——沙箱 seccomp 策略禁止 fork 出的子進(jìn)程分配 JIT 可執(zhí)行內(nèi)存node 一創(chuàng)建 V8 isolate 就被內(nèi)核打死所以「在應(yīng)用里 spawn 一個(gè) node/pnpm 子進(jìn)程」走不通。用戶數(shù)據(jù)分區(qū)禁 exec ELF——就算弄來 linux-arm64 原生 pnpm也塞不進(jìn)用戶目錄。這三個(gè)坎疊一起把「插件市場一鍵安裝」逼到了墻角。其中第 2、3 個(gè)我正在嘗試解決思路是把「spawn 子進(jìn)程」改成「在主進(jìn)程內(nèi)進(jìn)程式調(diào)用 pnpm」——這個(gè)坑夠單獨(dú)寫一篇專題這里先點(diǎn)到為止。五、寫在最后以上就是把 DeepSeek Harness 搬進(jìn)鴻蒙的 8 個(gè)坑外加幾個(gè)還沒完全啃完的坎。如果你也在做鴻蒙 / Electron-on-鴻蒙的適配這份清單照著查一遍能少踩不少。代碼已開源https://github.com/fellow99/dsh-desktop-hos歡迎star支持。下一篇我寫ACL 權(quán)限申請踩坑哪些權(quán)限才需要申請、我差點(diǎn)白交一批、以及最后 3 項(xiàng)一次通過的全過程。關(guān)注公眾號并設(shè)為星標(biāo)別錯過。相關(guān)開源工程DeepSeek Harness上游項(xiàng)目https://github.com/deepseek-ai/deepseek-harnessdsh-market插件市場https://github.com/dsh-market/dsh-marketharmonypc-electronElectron-on-鴻蒙運(yùn)行時(shí)https://atomgit.com/jianguoxu/harmonypc-electrondeepseek-harness-workspace工作區(qū)總覽https://github.com/fellow99/deepseek-harness-workspacedsh-desktop桌面端https://github.com/fellow99/dsh-desktopdsh-desktop-hos鴻蒙端https://github.com/fellow99/dsh-desktop-hos感謝各位關(guān)注歡迎訪問我的 GitHub 主頁https://fellow99.github.io/