直接说结论：**把 DeepSeek Harness 搬进鸿蒙，坑不在 Electron，在鸿蒙的沙箱和网络模型。**

桌面 Linux 上理所当然的事——symlink、硬链接、访问 127.0.0.1、HOME 目录——到了鸿蒙上全被改了规矩。我数了数，能靠补丁 + 插件绕过去的有 8 个坑；但有少数几个是真·绕不过去的坎，比如「随包自带 Node、npm、pnpm、Python、pip、uv 等运行时和工具」。

这个坎我第一篇文章就埋过伏笔（当时叫它「第二层难点」），根因是**二进制证书个人开发者不可得**，后面 ACL 篇我会单独讲透。这篇先把 8 个能绕过去的坑一个个拆开。

---

## 一、先把背景对齐：为什么是这 8 个坑

我的目标是复用 desktop 那套架构（进程内 Host + webserver + 同源数据面），把 dsh 原样搬进鸿蒙。唯一本质差异是把「官方 Electron 运行时」换成「Electron-on-鸿蒙运行时」。

结果这「换一个运行时」引出一串连锁反应：沙箱禁了 symlink、回环地址被隔离、打包阶段被 5 万个小文件卡死、原生模块全是 win32 二进制……下面按「现象 → 原因 → 解决」逐个拆。

---

## 二、8 个坑逐个拆

### 坑 1：loopback 网络隔离

**现象**：渲染进程加载 `127.0.0.1:<端口>` 直接白屏，Web UI 加载失败。

**原因**：鸿蒙对渲染进程访问本机回环地址做了**进程间网络隔离**，桌面版「同源加载 localhost」的老路子走不通了。

**解决**：webserver 绑 `0.0.0.0`，渲染进程改走局域网 IP；出栈前再把 `Host` / `Origin` 改写回 `127.0.0.1:<端口>`，以通过 dsh 的 loopback-only 特权方法围栏。**安全语义不变——局域网其他设备依然 403。**

### 坑 2：沙箱禁 symlink

**现象**：`symlinkSync` 直接抛 `EACCES`，dsh 初始化阶段就失败。

**原因**：鸿蒙应用沙箱**禁止创建符号链接**（这也解释了后面坑 4 里 hardlink 相关的问题）。

**解决**：加 patch，symlink 失败时回退 `cpSync` 递归拷贝。牺牲一点磁盘空间，换来初始化不再崩。

### 坑 3：HAP 打包超限（5 万个小文件）

**现象**：dsh 构建产物有 **5 万多个小文件**，hvigor 打包阶段直接卡死、内存爆掉。

**原因**：鸿蒙的 HAP 打包流程对海量小文件不友好，node_modules 那种「文件多、单个体积小」的结构是它的天敌。

**解决**：先把整个 `dsh-dist` 压成单个 `dsh-dist.tar.gz`（约 143MB，`--format=ustar`），运行时再**流式解压**。把「5 万次小文件搬运」变成「一次大文件搬运 + 一次流式解压」。

### 坑 4：原生模块 ABI 不匹配（卡了我一整天）

**现象**：sharp / node-pty / koffi 这些原生模块，在 Windows 上收集产物时是 **win32-x64 二进制**，到了鸿蒙 aarch64 上根本加载不了，直接报错。

**原因**：dsh-dist 是在 Windows 上收集的，原生模块的二进制平台被锁死在 win32-x64。

**解决**（三条路，这个坑我最久才爬出来）：

- **sharp** → 换成**纯 JS stub**：不做事像素解码，只解析图片容器头，干净的 8-bit sRGB PNG/JPEG/WebP 直接按字节直通。
- **node-pty / koffi** → 直接**禁用**对应能力（终端、进程沙箱）。
- **better-sqlite3** → 换用 Electron 37 / Node ABI v138 的 aarch64 成品，**会话持久化保住了**。

这个坑最折磨人的地方在于：它不是「装错了东西」，而是「你装的东西从根上就是错的平台」，得一层层溯源到「产物是在哪台机器上收集的」。

### 坑 5：HOME 指向沙箱外

**现象**：一打开「选择工作区」就报 `cannot list /storage/Users/currentUser: EPERM`。

**原因**：鸿蒙沙箱里 `os.homedir()` 返回的是**沙箱外**的系统用户目录，应用无权访问，一点进去就 EPERM。

**解决**：dsh Host 启动前把 `HOME` 显式指向沙箱可写目录 `userData`，让「工作区选择」落在应用自己能读写的范围内。

### 坑 6：特权方法 403

**现象**：设置对话框多处报 `transport failure for /api/settings.describe: HTTP 403`。

**原因**：dsh 把 `settings.*`、`credentials.*` 等特权方法**锁定为 loopback-only**，而鸿蒙为了绕坑 1 的 loopback 隔离改走了局域网 IP，`Host` 头不是 loopback → 直接被 403。

**解决**：在内嵌渲染进程请求出栈前，把 `Host` / `Origin` 改写为 `127.0.0.1:<端口>`。**坑 1 和坑 6 其实是同一枚硬币的两面**：一个要「绕开 loopback」，一个要「装成 loopback」。

### 坑 7：agent preset 工具行无限等待

**现象**：加完工作区点不了，`session.create` 抛 `agent-preset-invalid`。

**原因**：standard preset 里 `tool-bash`、`tool-fs-search` 依赖被禁用的 shell/subprocess（node-pty，坑 4 已禁），于是**无限等待 → preset 挂载失败**。

**解决**：禁用依赖 shell / subprocess / pty 的工具行。禁用要「整行摘掉」，别只摘工具名，否则 preset 解析还会卡。

### 坑 8：corepack pnpm 不可用

**现象**：desktop 构建用的是 `corepack pnpm`，到了鸿蒙构建环境 corepack 直接不可用。

**原因**：corepack 依赖下载/切换 pnpm 版本的机制，在鸿蒙构建环境里走不通。

**解决**：构建脚本直接调 `pnpm`，跳过 corepack 这一层。**别在鸿蒙环境里跟 corepack 死磕，能省一天。**

---

## 三、8 个坑速查表

| 坑 | 现象 | 根因 | 解决 |
|---|---|---|---|
| 1 loopback 隔离 | 渲染进程白屏 | 回环地址进程间隔离 | 绑 `0.0.0.0` + 局域网 IP |
| 2 禁 symlink | `symlinkSync` 报 EACCES | 沙箱禁符号链接 | 回退 `cpSync` 拷贝 |
| 3 打包超限 | 5 万小文件卡死 | HAP 对海量小文件不友好 | 打 tar.gz + 流式解压 |
| 4 ABI 不匹配 | 原生模块加载失败 | 产物是 win32-x64 | stub / 禁用 / 换 aarch64 |
| 5 HOME 越界 | 选工作区 EPERM | homedir 指向沙箱外 | HOME 指向 userData |
| 6 特权 403 | settings 报 403 | 特权方法 loopback-only | 出栈改写 Host/Origin |
| 7 preset 卡死 | `agent-preset-invalid` | 依赖被禁的 shell/subprocess | 禁用依赖 pty 的工具行 |
| 8 corepack 不可用 | pnpm 拉不起来 | corepack 机制走不通 | 直接调 pnpm |

一句话记住：**鸿蒙化难的不是 Electron，是沙箱和网络模型逼着你换一套心智模型。**

---

## 四、还有几个绕不过去的坎

上面 8 个坑都能绕。但有 3 个坎，绕过去得另辟蹊径：

1. **二进制证书个人不可得**——随包分发 ELF（Node / pnpm / Python 运行时）需要二进制证书，个人开发者拿不到。这条是真·绕不过去，「随包自带完整工具链」只能放弃（下一篇 ACL 篇讲透）。
2. **应用域 node 子进程被 SIGSYS 杀**——沙箱 seccomp 策略禁止 fork 出的子进程分配 JIT 可执行内存，node 一创建 V8 isolate 就被内核打死，所以「在应用里 spawn 一个 node/pnpm 子进程」走不通。
3. **用户数据分区禁 exec ELF**——就算弄来 linux-arm64 原生 pnpm，也塞不进用户目录。

这三个坎叠一起，把「插件市场一键安装」逼到了墙角。其中第 2、3 个我**正在尝试解决**（思路是把「spawn 子进程」改成「在主进程内进程式调用 pnpm」）——这个坑够单独写一篇专题，这里先点到为止。

---

## 五、写在最后

以上就是把 DeepSeek Harness 搬进鸿蒙的 8 个坑，外加几个还没完全啃完的坎。如果你也在做鸿蒙 / Electron-on-鸿蒙的适配，这份清单照着查一遍，能少踩不少。

**代码已开源**：[https://github.com/fellow99/dsh-desktop-hos](https://github.com/fellow99/dsh-desktop-hos)，欢迎 **star** 支持。

下一篇我写 **ACL 权限申请踩坑**：哪些权限才需要申请、我差点白交一批、以及最后 3 项一次通过的全过程。**关注公众号并设为星标**，别错过。

**相关开源工程：**

- DeepSeek Harness（上游项目）：https://github.com/deepseek-ai/deepseek-harness
- dsh-market（插件市场）：https://github.com/dsh-market/dsh-market
- harmonypc-electron（Electron-on-鸿蒙运行时）：https://atomgit.com/jianguoxu/harmonypc-electron
- deepseek-harness-workspace（工作区总览）：https://github.com/fellow99/deepseek-harness-workspace
- dsh-desktop（桌面端）：https://github.com/fellow99/dsh-desktop
- dsh-desktop-hos（鸿蒙端）：https://github.com/fellow99/dsh-desktop-hos

感谢各位关注，欢迎访问我的 GitHub 主页：https://fellow99.github.io/

直接说结论：把 DeepSeek Harness 搬进鸿蒙，坑不在 Electron，在鸿蒙的沙箱和网络模型。

把 DeepSeek Harness 搬进鸿蒙的 8 个坑

承接上篇真机调试：这篇回到「把 dsh 搬进鸿蒙」最难啃的部分——8 个系统级差异的坑，每个都贴报错原文和解法，文末再聊几个「绕不过去的坎」。

操作系统

开发工具

后端

DeepSeekHarness迁移鸿蒙的8个坑与解法：沙箱禁symlink、loopback隔离、HAP打包超限、原生模块ABI不匹配、HOME越界、特权403、preset卡死、corepack失效，均有补丁或替代方案。但随包分发二进制工具链因证书限制绕不过去。附完整速查表及开源项目地址。

数据分区

Windows

容器

Python

GitHub

Linux

pnpm

快速部署LLM、AI绘画等应用,助你玩转AIGC！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

把 DeepSeek Harness 搬进鸿蒙的 8 个坑-腾讯云开发者社区-腾讯云

把 DeepSeek Harness 搬进鸿蒙的 8 个坑

把 DeepSeek Harness 搬进鸿蒙的 8 个坑

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐