DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

snoworwind /

snoworwind/pocket-harness-ohos

Topic repository only

DeepSeek Harness 的 HarmonyOS 原生版:官方 Web GUI + IEC 原生执行核 + libvterm 终端

★ 1 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@f753f1f5

Pocket Harness · HarmonyOS 原生版

English | 简体中文

非官方项目:本项目由社区维护,与 DeepSeek 没有隶属、赞助或背书关系。"DeepSeek"、"DeepSeek Harness" 名称及鲸鱼标识归 DeepSeek 所有。许可与第三方组件声明见 THIRD_PARTY_NOTICES.md。

把官方 DeepSeek Harness 整个搬进鸿蒙应用:界面就是官方 Web GUI(dsh --profile web 的浏览器前端),Agent Loop、工具调用、审批、会话、工作区都由官方 @deepseek-ai/dsh 提供;Node、Bash、toybox、libarchive、ripgrep 针对 aarch64-linux-ohos 交叉编译成原生库随 HAP 安装,不依赖 adb、Termux 或远程服务器。终端由本项目用 libvterm 原生绘制,作为右侧栏里的一个 tab。

项目 值
应用名 Pocket Harness
包名 com.snoworwind.phoh
版本 0.1.0.1(versionCode 2)
最低 API HarmonyOS 5.1.0(API 18),target API 24
引擎 @deepseek-ai/dsh 0.2.2-rc.1(web profile,291 个插件)
运行时 Node 24.22.1(--jitless)、Bash 5.3、toybox 0.8.14、libarchive 3.7.7、ripgrep 14.1.1
发布产物 GitHub Release:未签名 HAP + arm64/x86_64 原生库(本项目暂不打算上架华为应用市场)

本项目暂不打算上架华为应用市场,只通过 GitHub Release 分发未签名的 HAP 与预编译原生库;使用者需要自行用调试证书签名后安装。下文的应用包(.app)构建步骤仅作为将来可能上架时的参考保留。

功能

  • 官方 Web GUI:Agent Loop、工具调用、审批、会话、工作区全部走官方引擎,界面不重写。
  • 原生终端:右侧栏可关闭 tab,PTY + 作业控制(Ctrl-Z/fg/bg)、libvterm 绘制、软键盘防遮挡、横竖屏自适应;终端默认进入当前 DSH 会话的工作目录,切换会话/工作区时自动跟随。
  • 返回手势:按浮层优先级逐层关闭——菜单 → 设置 → 右侧栏/终端 → 左侧抽屉 → 系统;终端收起时进程继续运行,只有 tab 的 × 才停止。
  • 选区引用:选中文本时「引用文本」浮层显示在选区下方,避开系统选区工具条。
  • 禁用双指缩放:界面按视口宽度布局,避免缩放把终端/侧栏几何算乱。
  • 无 JIT 的 fetch:Node 以 --jitless 运行,undici 的 WASM 不可用,运行时注入纯 JS 的 fetch 补丁。
  • TLS 信任:Mozilla 根证书 + 可选 extra-ca.pem(开发环境里的 HTTPS 中间人 CA),始终做完整校验。

组成

entry/src/main/ets
  ├─ pages/Index.ets             Web 组件、桥消息、返回手势、启动/错误状态
  ├─ pages/Terminal.ets          libvterm 终端视图与 PTY 会话
  └─ platform/NativeRuntime.ets  解包引擎、起 dsh web、CA bundle、命令启动器

plugins/
  ├─ dsh-harmony-terminal/       终端 tab:注册、stage 矩形、open/close/focus、工作目录跟随
  └─ harmony-compat/             鸿蒙适配:浮层状态上报(返回手势)、引用浮层位置

native/
  ├─ iec/                        端侧执行核(IEC,来自 Bettersh):exec/tty/fs shim、ELF 装载
  ├─ terminal/                   libvterm 与 terminal NAPI
  └─ toolchain/                  Node 24 / 原生插件的 OHOS 工具链脚本

scripts/
  ├─ build.mjs                   HAP 构建(Windows/macOS/Linux,自动找 DevEco)
  ├─ build-x86-runtime.sh        x86_64 模拟器运行时的分阶段构建
  ├─ pack-native.sh              原生库 + 引擎归档 → entry/
  └─ test-fetch-polyfill.cjs     fetch 补丁的 15 项回归测试

构建

1. 原生运行时(WSL / Linux)

arm64 真机:

bash native/toolchain/build-node24.sh        # Node 24.22.1(jitless),最慢
bash native/build-bash.sh                    # Bash 5.3(GPL-3.0)
bash native/iec/scripts/build_toybox.sh      # toybox
bash native/iec/scripts/build_libarchive.sh  # tar/cpio/unzip/zip
bash scripts/pack-native.sh                  # 产物 + 引擎归档 → entry/

x86_64 模拟器:见 docs/X86_64-BUILD.md,用 scripts/build-x86-runtime.sh 的 setup / node / tools / bash / addons / rg / pack 分阶段构建。

工具链、官方引擎与源码缓存默认放在构建机的 /var/tmp/deepseek-harmony-native(可用 NATIVE_BASE 覆盖); native/toolchain/README.md 记录了 LLVM 22 + libc++ 22 __n1 的配置原因。

2. HAP

# 只需要 Node 18+;DevEco 用完整安装即可(不必打开 IDE)
node scripts/build.mjs --deveco-home "<DevEco 安装目录>"
# 原生库有改动时先清理,避免增量构建跳过打包
node scripts/build.mjs --clean

build-profile.json5 已被 .gitignore 排除(含证书路径与口令),仓库只保留 build-profile.example.json5;首次构建由模板生成。签名在本地 signingConfigs 中配置。

3. 应用包(可选,仅将来上架时)

本项目暂不打算上架应用市场,这一步通常不需要。若将来要打包上架,可在 project 模式下再跑 assembleApp:

# 指向 DevEco 的 SDK 与 JBR;也可以直接在 DevEco 里 Build → Build App
DEVECO_SDK_HOME="<DevEco>/sdk" JAVA_HOME="<DevEco>/jbr" \
  node "<DevEco>/tools/node/node.exe" "<DevEco>/tools/hvigor/bin/hvigorw.js" \
  --mode project -p product=default -p buildMode=release assembleApp --no-daemon

产物在 build/outputs/default/*.app;单 HAP 在 entry/build/default/outputs/default/entry-default-signed.hap。

签名与分发

  • 真机调试需要 com.snoworwind.phoh 的 debug Profile(含设备 UDID),在 DevEco Project Structure → Signing Configs 里自动生成;
  • GitHub Release 只提供未签名的 HAP 与预编译原生库,使用者需自行签名;
  • 本项目不计划上架华为应用市场;如果自行上架,才需要发布证书 + release Profile 签名的 .app,并自行承担商店审核、备案、商标与 AI 服务合规等责任;
  • release 签名的 HAP 不能 hdc install(会报 9568322 not trusted app source), 也不要用来做本地调试。

测试与校验

node scripts/test.cjs                  # 宿主侧 28 项(会话协议、SSE、路径沙箱、JSON-RPC)
node scripts/test-fetch-polyfill.cjs   # fetch 补丁 15 项(JSON/SSE/重定向/FormData/abort…)
bash scripts/audit-sources.sh          # 解包 HAP,核对二进制集合与 npm.tar.gz
bash scripts/check-engine-web.sh       # web profile 291 个插件,stderr 为空

真机验证范围与已知缺口见 docs/VALIDATION.md。

运行时布局

首次启动把 rawfile/tools/official-engine.tar.gz 解包到应用私有目录:

filesDir/
  runtime-<version>/           bin/ 命令启动器(#IECSOv2)
                               engine/ 官方引擎 + harmony/ 宿主脚本
                               certs/ cacert.pem + bundle.pem
                               home/ tmp/
  harness-home/                DSH_HOME(profile、会话、设置、凭据)
  • 运行时目录名由 pack-native.sh 按内容摘要生成;引擎、npm 或任一原生库变化都会换目录、 重新解包,成功后删除旧的 runtime-* 目录(约 450 MB/个);
  • harness-home 永不被应用删除:覆盖安装保留会话与设置,卸载才清空;
  • 目录被改坏时:三项存在性探测失败会整棵重解;引擎启动报缺文件症状会自动重解一次; 仍失败则界面提供「重新解包运行时」。

运行时补丁

鸿蒙上 Node 只能以 --jitless 运行,V8 不暴露 WebAssembly,而 Node 内置的 fetch (undici)用 WASM 解析 HTTP。运行时因此注入纯 JS 的 harmony/fetch-polyfill.cjs:

  • 经 NODE_OPTIONS=--require 预加载到宿主与终端里的 node;
  • 请求体支持 string / Buffer / TypedArray / ArrayBuffer / URLSearchParams / Blob / FormData (multipart)/ ReadableStream / Node Readable;
  • 响应支持流式 body(SSE 不整块缓冲)、gzip/br/deflate;
  • 重定向 follow/error/manual 与方法改写;AbortSignal 以 AbortError 拒绝; HEAD/204/304 的 body 为 null;带 url/type/redirected。

V8 DrumBrake(Wasm 解释器)在 Node 24.22.1 的源码里落后于同版本 V8 API(约 50 处编译错误), 且解释器仍会申请可执行内存,与鸿蒙无 JIT 的限制冲突,因此不采用; scripts/patch-v8-drumbrake.sh 仅作为实验记录保留。

TLS 信任由运行时 CA bundle 决定:启动时把 Mozilla 根证书与可选的 rawfile/harmony/extra-ca.pem 合并成 certs/bundle.pem,不做运行时放宽。extra-ca.pem 用于开发环境里会拦截 HTTPS 的 杀毒/代理,不随仓库分发;需要时自行放入,公开/商店构建请保持缺省(只信 Mozilla 根证书), 或替换成自己的企业根证书。

已知边界

  • 首次启动要解包 43.8 MB 的引擎归档(约 2.5 万个文件),真机上一到两分钟;
  • 后台保活用「定位」连续任务:需要授权模糊定位,拒绝时只影响后台存活;
  • dsh web 只绑 127.0.0.1,界面只在本机 Web 组件里可达,不要改成对外监听;
  • 引擎自带的进程级沙箱(bwrap / Landlock)在鸿蒙上大概率不可用,能力边界靠 permission preset 与工具开关;
  • fork 未被拦截,由设备决定;终端 PTY 依赖 forkpty 的兼容实现;
  • 未包含:Python、MCP、语音、插件市场、后台常驻执行。

许可证与合规

  • 本项目原创代码:MIT,见 LICENSE;
  • 上游 DeepSeek Harness:MIT,随包保留版权与许可声明;
  • 第三方组件清单、许可证原文与 GNU Bash 对应源码获取方式:THIRD_PARTY_NOTICES.md;
  • 许可证全文在 LICENSES/,同一份随 HAP 分发到应用内 files/notices/;
  • 组件来源与构建方式:docs/SOURCES.md。
—/ 5

No ratings yet

Manifest verification required

Commit f753f1f5865d

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout