Jamers0/deepseek-harness-android

DeepSeek Harness — Android / Termux 移植版

DeepSeek Harness 的实验性 Android/Termux 移植版，包含完整的原生 ARM64 编译和文档。

本仓库包含通过 Termux 在 Android 上原生运行 DeepSeek Harness（“dsh”）Web GUI 所需的更改，同时保留上游项目中已有的 Linux 兼容性。这是一个以 Android 设备作为构建和运行时主机的 fork/移植版——而非重新实现。

«Este port foi desenvolvido, compilado, documentado e commitado diretamente em um dispositivo
Android utilizando Termux e DeepSeek Harness, sem utilização de computador desktop.»

平台

| 项目                | 值                                                      |
|---------------------|------------------------------------------------------------|
| 平台            | Android                                                    |
| 环境         | Termux                                                     |
| 架构        | ARM64 (aarch64)                                          |
| Node.js             | v26.3.0                                                    |
| pnpm                | v11.7.0                                                    |
| Node-PTY 预构建   | prebuilds/android-arm64/pty.node → 提交为 prebuilds/pty.node |
| Koffi 补丁         | patches/koffi@3.1.1/lib/native/base/base.cc             |
| 官方分支     | android-bionic                                           |

目标

- 通过 Termux 在 Android 手机上运行 DeepSeek Harness Web GUI（dsh web）。
- 精确保留使上游项目在 Android/Bionic 上运行所需的修改。
- 尽可能保持 Linux 兼容性。

这不是一次全新的重建：现有修复被保留，而非回退。

特殊依赖

| 依赖     | Android 策略                                                              |
|----------------|--------------------------------------------------------------------------------|
| koffi@3.1.1  | 为 Bionic 修补了 lib/native/base/base.cc；为 android_arm64 编译。     |
| node-pty     | 为 Android arm64 编译；产物提交于 prebuilds/pty.node。         |
| sharp        | 用 @img/sharp-wasm32 替换原生构建（pnpm add -w @img/sharp-wasm32 --ignore-scripts）。 |

安装 / 设置

pkg install nodejs clang make cmake
npm install -g pnpm@11.7.0
pnpm install --ignore-scripts

在 Android 上需要 pnpm install --ignore-scripts。一些 Linux 原生
包（例如 native/landlock-run/packages/linux-arm64、linux-x64）会发出
警告——这些是在 Android 上运行的预期限制，而非错误。

构建（Android 原生产物）

原生产物已经提交；通常你不需要
重新编译。要重新构建：

cd patches/koffi@3.1.1 && cnoke.cjs build   # 用于 android_arm64 的 Koffi
node-pty：使用以下命令构建
ANDROID_NDK_HOME=$PREFIX npm_config_android_ndk_path=$PREFIX
并将结果放置在 prebuilds/pty.node

运行

Web 服务器目前通过以下方式启动：

node --expose-internals --import tsx/esm apps/cli/src/bin.ts web

或者，为了避免在设备上自动打开浏览器：

node --expose-internals --import tsx/esm apps/cli/src/bin.ts web --no-open

服务器：http://127.0.0.1:3080

在此 Node 构建版本上，--expose-internals 无法通过 NODE_OPTIONS 传递，因此
它直接在 CLI 上传递。参见 docs/android/TROUBLESHOOTING.md。

已知限制

- statx 和 posix_spawn 路径无法直接在 Android/Bionic 上使用；
该移植回退到 fstatat + fork/dup2/execve/_exit。
- 某些 Linux 原生包会发出警告并被跳过。
- 参见 docs/android/KNOWN-LIMITATIONS.md。

截图

在 Android（Termux）上运行 — dsh web 位于 http://127.0.0.1:3080：

Android 上的 DeepSeek Harness Web UI
Android 上的目录选择器 / 工作区

仓库布局（此移植）

README.md
COMMIT_FILES.md                     # 提交内容的精确范围
packages/client/ui-directory-picker-browse/   # Android 符号链接修复目标
packages/host/directory-picker-auto/
patches/koffi@3.1.1/                # 为 android_arm64 修补并编译的 Koffi
prebuilds/pty.node                  # 为 Android arm64 编译的 node-pty
docs/android/                       # 完整的移植文档

文档

参见 docs/android/：

- README.md — Android 文档索引
- ENVIRONMENT.md — 检测到的设备/运行时事实
- PORTING.md — 上游如何适配到 Bionic
- KOFFI.md — Koffi 补丁与构建细节
- NODE-PTY.md — node-pty 编译细节
- SHARP.md — WASM sharp 解析
- TROUBLESHOOTING.md — HMR、--expose-internals、目录选择器符号链接
- BUILD.md — 构建命令
- CHANGELOG.md — 移植的变更历史
- FILES-MODIFIED.md — 修改/添加文件的精确列表
- KNOWN-LIMITATIONS.md — 仍无法完全移植的内容
- PORTING-REPORT.md — 完整技术报告
- COMMIT_HISTORY.md — 提交 SHA / 作者 / 使用的工具

许可证

继承自上游 DeepSeek Harness（修改的包采用 MIT；参见
各自的 package.json / LICENSE.txt 文件）。