deepseek-harness-desktop-HarmonyOS

HDSH

在 HarmonyOS 上自足运行 DeepSeek Harness 的应用

HDSH 把 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）的运行本体装进一个鸿蒙应用：HAP 内自带 Node 运行时与 dsh 核心树（当前 0.1.6-alpha.2），核心在本机 127.0.0.1 上起 Host，应用内的页面就是这个本地 Host 的客户端。

它不是 PC 上 dsh 的遥控器，也不需要在电脑上常驻任何服务：装上即用，数据只在本机应用沙箱内。支持 HarmonyOS 手机 / 折叠屏 / 平板 / 2in1。

---

能力

| 领域 | 说明 |

|---|---|

| 本地核心 | 内置 Node 运行时（自建、jitless）与 dsh 核心树 0.1.6-alpha.2（随包 zip 约 68.8 MB，resfile 仅此一个）；Host 仅监听 127.0.0.1，随应用生命周期起停 |

| 双形态界面 | 按窗口宽度路由（600vp 分界）：桌面态（平板 / 2in1 / 折叠展开）用 WebShell 直载官方 Web UI——与官方同一前端产物，全部官方界面能力开箱即得；手机态（手机 / 折叠闭合）用 RemoteShell 以 DSH Mobile 的移动范式原生复刻（ArkTS + MobileTheme 令牌 + Ds* 基元） |

| 对话与轨迹 | 对话视图（问答，思考过程折叠在回答上方）与轨迹视图（工具调用、子代理、目标/任务、交付物、错误）分开呈现 |

| 工作区 | 工作区为组、会话挂在组下；可在设备上选择文件夹作为工作区（系统文件夹选择器），并在其中浏览文件 |

| 模型与密钥 | 按提供方管理：API 密钥（只写）、baseURL 与模型目录；默认模型与推理强度可选 |

| 插件 | 查看随包插件清单与运行阶段；按行启用/禁用，并可恢复部署默认 |

| 核心版本 | 同时安装多个核心版本，一键切换 / 回滚（停旧起新，逐版本校验后激活） |

| 多语言 | 界面文案跟随系统语言，默认中文 |

| 上架友好 | 不申请 JIT 等特殊权限，全部按 jitless 运行；权限仅网络相关三项 |

架构

┌─ HDSH（一个 HAP）──────────────────────────────────────────────┐
│  客户端页面（pages/Index.ets 按形态 × 模式矩阵路由）              │
│    · DESKTOP_LIKE（≥600vp）→ WebShell：直载官方 Web UI          │
│    · PHONE（<600vp）       → RemoteShell：原生复刻 DSH Mobile   │
│        │  HTTP /api/*        WebSocket /api/remote.mux          │
│        ▼                                                        │
│  端侧 dsh Host（Node 运行时运行在**本应用进程内**，               │
│                以 --jitless --expose-internals 启动）            │
│        │  DSH_HOME = <应用沙箱>/dsh/home（跨版本共享的唯一数据）  │
│        ▼                                                        │
│  核心版本仓库（多个版本可并存，切换 = 停旧 + 起新 + 校验）        │
└─────────────────────────────────────────────────────────────────┘

同进程带来的是安全语义的简化：客户端与 Host 走回环，不需要把服务暴露到局域网，也不需要跨设备转发。

0.1.6-alpha.2 的端侧适配要点（v3 升级，2026-09-20/21）

| 事项 | 事实 |

|---|---|

| 新硬原生依赖 | 0.1.6 新增 node-addon-require-builtin（dsh-app-boot 的 profile resolution 必经路径）。打包期垫片把它替换为 createRequire 直通；宿主 argv 必带 --expose-internals（由 RuntimePort.buildHostArgv 加入），缺它 Host 起不来（fail-loud） |

| 端侧 preset | 0.1.6 的 standard preset 新增 PTC 工作流链（端侧必挂），ondevice preset 现禁用五行：tool-bash / tool-pwsh / tool-fs-search / workflow-ptc / tool-workflow（preset mount 仍是全有或全无） |

| boot 语义 | host 侧 boot 对 pending 行从 fail-loud 改为警告不失败。端侧实测 pending 四条：ptc-runtime / terminal-controller / ui-deliverables / workspace-changes，根都在 subprocess/sandbox 被禁（手机无进程创建能力，上游硬约束） |

| 协议面 | 端点 84 → 109（+25 全为增量：agentTeams×3 / officeToPdf×2 / permissionPresets×1 / pluginManager×8 / terminal×10 / workspace unarchiveSession×1），既有端点 wire 参数零漂移；转发事件白名单 19 → 23（新增 4 条仅登记不投影） |

| 工作区写入 | 0.1.6 的 dsh-fs-local writeFileAtomic 形态未变——本仓 link() 被沙箱拒后的降级垫片（installLinkFallback）继续覆盖"新建 = COPYFILE_EXCL、覆盖 = rename"两语义；工作区链路逐段核对零漂移 |

端侧运行时的硬约束：jitless ⇒ 没有 WASM

不申请 JIT 权限意味着 Host 全程以 --jitless 运行，而 V8 的 --jitless 与 --expose_wasm 互斥 ⇒ 端侧 typeof WebAssembly === 'undefined'（恒定，不是配置问题）。由此推出一条对上游代码的判据：

> 凡是上游直接 import('undici') 的功能，在端侧都会失败（undici 的 HTTP 解析器是 WASM）。

实测过的一个实例：dsh-web-fetch-http 不用全局 fetch 而自建 Agent，于是 web_fetch 打不开任何网页，而走纯 JS node:http 垫片的 web_search 照常工作 ⇒ 对付它需要两层，缺一层就会出现"Host 起来了、模型也能回话，但某个工具静默坏掉"：

| 层 | 做什么 | 不做的后果 |

|---|---|---|

| 全局 fetch 垫片（fetch-shim.js） | 用 node:http/https 重写 fetch/Request/Response/Headers/FormData | 调模型就走不通 |

| undici 模块名解析钩子（main.js 的 installUndiciNameHook()） | 让上游的 await import("undici") 拿到同一个垫片 | web_fetch 打不开任何网页 |

不改上游源码、不改核心树；由 tools/check-web-fetch-jitless.mjs 守着（自带对照实验：不注册钩子必须失败、注册后必须全过，且跨源跳转仍须被拒）。细节见 docs/parity-matrix.md §3.2。

构建

前置：DevEco Command Line Tools（含 hvigor / ohpm / codelinter / SDK）、JDK 17、Node.js

（仅用于仓库内的构建与检查脚本；门禁/工具链指定 D:\nodejs\node.exe（v24）——系统默认的旧版 Node 跑不动相关脚本）。

> SDK 版本口径：compatibleSdkVersion / targetSdkVersion 固定为 6.1.1(24)（决策，2026-09-14）。

> 代价是不能用 API 26 的「沉浸光感」材质（官方要求 targetAPIVersion ≥ 26）——

> 界面层次当前由系统阴影表达；升级路径与要改的几处列在 appstate/ui/HarmonyTheme.ets 的 HarmonyMaterial。

不入库的产物（新克隆必须先备齐，否则编不过）：

| 产物 | 路径 | 说明 |

|---|---|---|

| Node 头文件 | entry/src/main/cpp/node-headers/ | 编 libdshhost 只需要它（libnode 不参与链接） |