Termux 一键安装器 ARSADM7/termux-deepseek-harness

termux-deepseek-harness

DeepSeek Harness (DSH) — Android / Termux 和 Alpine Linux 一键安装器由 ARSADM Development 提供并维护

关于 ARSADM • 安装 • 功能 • 支持 •

🏢 关于 ARSADM Development

ARSADM Development 是一家软件开发公司，专注于面向 Android 及新兴平台的移动解决方案、自动化和人工智能。

我们提供开源工具、优化安装器和生产就绪的基础设施，消除技术复杂性，将尖端技术直接带到用户设备上——无需 root，无繁琐操作，开箱即用。

使命： 以专业品质和持续支持，让 Android 和 Linux 设备上的 AI 与高级自动化触手可及。

我们提供的服务

| 领域 | 解决方案 |
| 🤖 AI 与自动化 | 面向 DeepSeek Harness、本地 LLM 及 Termux 和 Alpine 上自主代理的优化安装器 |
| 📱 移动与 Android | 原生工具、移动端适配（userscript、bookmarklet、响应式 CSS） |
| 📺 流媒体与 IPTV | 平台、面板及高性能 M3U 生成器 |
| ☁️ 云与基础设施 | 云解决方案、超级计算及 API |
| 🛠️ 开发工具 | ARM64 原生编译、node-gyp 补丁、性能优化 |
本仓库——termux-deepseek-harness——是 ARSADM Development 的旗舰项目之一：这些安装器彻底解决了 @deepseek-ai/dsh 在 Android/Termux 和 Alpine Linux 上的安装问题，而官方的 npm install -g 因缺少 ARM64 预编译包而失败。

官方仓库： ARSADM7/termux-deepseek-harness • 许可证： MIT • 支持： GitHub Issues

📦 关于项目

DeepSeek Harness（@deepseek-ai/dsh）的从零到可用安装：

| 平台 | 安装器 | 命令 |
| Android / Termux | install.sh | bash install.sh |
| Alpine Linux 3.18+ | install-alpine.sh | sh install-alpine.sh |

两者都适用于全新安装的环境：软件包更新、工具链、Node、原生编译、运行时补丁以及工作区配置全部自动化完成。

无需 root（有 root 也能运行）。已在 Android 11-16 / aarch64 / Termux (F-Droid) 和 Alpine 3.18+ / x86_64、aarch64、armv7 上测试。

由 ARSADM Development 分发，作为可投入生产的开源解决方案。

✨ 功能特性

- ✅ 一键安装——在干净环境中一条命令，开箱即用
- ✅ 幂等——中途失败了？再运行一次，从断点继续
- ✅ 智能网络——检测到 registry.npmjs.org 故障（8 秒）后自动切换到 npmmirror；使用优化超时进行重试
- ✅ 防 OOM——限制 koffi 的编译并行度，避免杀死低内存设备
- ✅ 默认工作区——Termux：sdcard（~/storage/shared）| Alpine：~/dsh-workspace
- ✅ 自动验证——最后检查 dsh / koffi / node-pty / sharp / 工作区，错误始终以红色显示（无静默失败）
- ✅ ARSADM 支持——由 ARSADM Development 团队维护并提供文档

🧩 为什么需要这些安装器

@deepseek-ai/dsh 依赖的原生模块没有 arm64 预编译包（Android 和 Alpine）：

| # | 模块 | 原始错误 | ARSADM Development 如何解决 |
| 1 | koffi | CMake does not seem to be available | 安装 cmake clang make python binutils pkg-config + 完整工具链 |
| 2 | koffi | statx 编译错误（bionic） | Termux： 使用 -target aarch64-linux-android30（API 30）编译 |
| 3 | node-pty | gyp: Undefined variable android_ndk_path | Termux： 修补 node-gyp 缓存中的 common.gypi |
| 4 | 全部 | install-scripts 被阻止（npm 11.19+） | npm config set allow-scripts=... 放开构建 |
| 5 | sharp | Could not load sharp android-arm64 | 回退到 WebAssembly @img/sharp-wasm32（两者） |
| 6 | cordis-plugin-hmr | --expose-internals is required | 启动包装器替换 dsh 符号链接（两者） |
| 7 | sessões/attachments | EACCES: permission denied, link() | 为阻止 link() 的 ROM/系统修补 link() → rename()（两者） |

📋 要求

Termux（Android）
- Android 11+（API 30+，statx 所需）
- Termux F-Droid — Play Store 版本已停止维护
- 约 4GB RAM，约 2GB 可用存储空间，网络稳定
- 架构：arm64（主要）/ armv7 / x86_64 / i686 — 自动检测

Alpine Linux
- Alpine Linux 3.18+（/etc/alpine-release）
- 约 2GB RAM，约 2GB 可用存储空间，网络稳定
- 架构：x86_64 / aarch64 / armv7 — 自动检测
- 建议使用非 root 用户

🚀 快速安装

Android / Termux

在 Termux 内执行（无需克隆）：

bash -c "$(curl -fsSL https://raw.githubusercontent.com/ARSADM7/termux-deepseek-harness/main/install.sh)"

或通过克隆：

pkg install -y git
git clone https://github.com/ARSADM7/termux-deepseek-harness.git
cd termux-deepseek-harness
bash install.sh

- 脚本会运行 pkg upgrade — 让它完成（Termux 不支持部分升级）。如需跳过：bash install.sh --skip-upgrade
- 网络缓慢/中国：bash install.sh --cn（使用 npmmirror 镜像 — 如果官方 registry 失败则自动检测）
- npm install 步骤耗时最长（数百个包 + 编译 koffi，约 5–15 分钟）。下载期间没有输出是正常的 — 请保持屏幕常亮

Alpine Linux

在 Alpine 的 shell 中执行：

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ARSADM7/termux-deepseek-harness/main/install-alpine.sh)"

或通过克隆：

apk add --no-cache git
git clone https://github.com/ARSADM7/termux-deepseek-harness.git
cd termux-deepseek-harness
sh install-alpine.sh

- 脚本会运行 apk upgrade — 让它完成。如需跳过：sh install-alpine.sh --skip-upgrade
- 网络缓慢/中国：sh install-alpine.sh --cn（使用 npmmirror 镜像 — 如果官方 registry 失败则自动检测）
- 需要 Node.js ≥ 22.12 — Alpine 3.19+ 的标准仓库中有；3.18 可能需要 edge/testing

✅ 安装后（两者）

dsh web

- Termux： 在手机上，打开 http://127.0.0.1:3080 或 termux-open-url http://127.0.0.1:3080
- Alpine： 在浏览器中，打开 http://127.0.0.1:3080
- 局域网（两者）： dsh web --host 0.0.0.0 → http://设备IP:3080
- 在 Web UI 的 设置 → 模型 中配置你的 API Key

📁 默认工作区

| 平台 | 默认工作区 | 配置 |
| Termux | ~/storage/shared（sdcard） | cordis.patch.yml 中 cwd: /data/data/com.termux/files/home/storage/shared |
| Alpine | ~/dsh-workspace | cordis.patch.yml 中 cwd: /home/user/dsh-workspace |

Web UI 会将工作区作为根目录使用，无论 dsh web 是从何处启动的。
- 安装时自定义：DSH_WORKSPACE=/meu/caminho bash install.sh（或 sh install-alpine.sh）
- 跳过：DSH_WORKSPACE="" bash install.sh
- 之后修改：编辑 ~/.dsh/profiles/web/cordis.patch.yml 中的 cwd，然后重启 dsh web

📱 移动端适配（可选——仅限 Termux）

Web UI 在窄屏上会收起侧边栏，但侧边面板在手机上仍会挤压聊天区域。ARSADM Development 在 mobile/ 中提供了：

| 方法 | 浏览器 | 备注 |
| mobile/dsh-mobile.user.js | Kiwi / Firefox + Tampermonkey | 自动注入 |
| mobile/bookmarklet.txt | 任意 | 将 javascript: 保存为书签，加载后点击 |
| mobile/mobile.css | 手动 | 通过控制台或 Stylus 注入 |

效果：单列布局，面板隐藏（聊天占满全部空间），模态框几乎全屏，触控目标更大。

🔧 脚本做了什么（完整流程）

Termux（install.sh）
1. 检查 Termux / 架构
2. pkg update && pkg upgrade
3. 工具链：git curl cmake clang make python binutils pkg-config libandroid-spawn
4. Node >= 22.12
5. npm：启用 allow-scripts、超时、镜像 --cn
6. 修补 common.gypi（android_ndk_path）
7. npm i -g @deepseek-ai/dsh（API 30 标志，限制 koffi 构建，使用镜像重试，检查 dsh）
8. 回退到 sharp WASM（@img/sharp-wasm32）
9. 为阻止 link() 的 ROM 修补 link() → rename()
10. 包装器 --expose-internals + pnpm
11. sdcard 权限 + 固定工作区
12. 最终验证 + 说明

Alpine（install-alpine.sh）
1. 检查 Alpine / 架构
2. apk update && apk upgrade
3. 工具链：git curl cmake clang make python3 binutils pkgconfig linux-headers build-base
4. Node >= 22.12
5. npm：启用 allow-scripts、超时、镜像 --cn
6. npm i -g @deepseek-ai/dsh（原生构建 koffi/node-pty，使用镜像重试，检查 dsh）
7. 回退到 sharp WASM（@img/sharp-wasm32）
8. 为阻止 link() 的系统修补 link() → rename()
9. 包装器 --expose-internals + pnpm
10. 默认工作区 ~/dsh-workspace
11. 最终验证 + 说明

两者都是幂等的：可以随时重新运行。

⚙️ 参数

| 标志 / 变量 | 描述 | Termux | Alpine |
| --skip-upgrade | 跳过 pkg/apk update && upgrade | ✅ | ✅ |
| --cn | 强制使用 npmmirror 镜像 | ✅ | ✅ |
| DSH_WORKSPACE=/caminho | 安装时自定义工作区 | ✅ | ✅ |
| DSH_WORKSPACE="" | 跳过工作区配置 | ✅ | ✅ |
| CMAKE_BUILD_PARALLEL_LEVEL=N | koffi 并行度（默认 2，内存低时用 1） | ✅ | ✅ |

🆘 故障排除

| 症状 | 平台 | 解决方案 |
| Node 中的 OpenSSL / shared libraries | Termux | 先执行 pkg update && pkg upgrade -y |
| allow-scripts is not valid | 两者 | 无害——旧版 npm 默认已运行脚本 |
| CMake not available | 两者 | 重新运行脚本 |
| android_ndk_path | Termux | 重新运行脚本 |
| No command dsh found | 两者 | npm 失败 — 查看红色错误，尝试 --cn |
| >15 分钟 npm 无输出 | 两者 | 网络不稳定 — Ctrl+C 然后 --cn |
| Web UI 无 sdcard | Termux | termux-setup-storage + “文件和媒体”权限 |
| EACCES link ... | 两者 | ROM/系统阻止 link() — 重新运行以应用 rename() 补丁 |
| [timed out] bash | Termux | 在慢速设备上使用 run_in_background: true |
| Node 版本 =30 → -target ...android30
- Termux Node 报告 platform === 'android' → android_ndk_path 未定义 → 补丁 common.gypi
- npm 11.19+ 阻止 install-scripts → allow-scripts
- sharp 无 arm64 预构建 → WASM 回退
- HMR 需要 --expose-internals → 自定义包装器
- link() 在自定义 ROM / 某些内核上失败 → 同一目录中的原子 rename()

💬 支持 — ARSADM Development

由 ARSADM Development 用 ❤️ 维护

- GitHub： @ARSADM7
- 仓库： ARSADM7/termux-deepseek-harness
- Issues： 提交 issue — 我们会在 24 小时内回复
- 公司： 移动 AI、Android、Linux 和自动化领域的专业解决方案

需要为您的企业定制版本，包含品牌、工作区或预配置模型？请通过 GitHub 联系 ARSADM Development。

🌐 English

关于 — 由 ARSADM Development 提供

适用于 Android / Termux 和 Alpine Linux 的 DeepSeek Harness（@deepseek-ai/dsh）一键安装程序，由 ARSADM Development 提供并维护。从全新环境到可用的 Web UI，只需一条命令。修复了官方 npm i -g 在 arm64 上失败的原生构建链问题。无需 root。

快速开始（Termux）： bash -c "$(curl -fsSL https://raw.githubusercontent.com/ARSADM7/termux-deepseek-harness/main/install.sh)"

快速开始（Alpine）： sh -c "$(curl -fsSL https://raw.githubusercontent.com/ARSADM7/termux-deepseek-harness/main/install-alpine.sh)"

以上完整文档（葡萄牙语）适用 — 英文故障排除和标志完全相同。如需支持，请在 ARSADM7/termux-deepseek-harness 提交 issue。

📄 许可证

MIT — © 2026 ARSADM Development 及贡献者。基于原始项目 cokelaoshi1/android-termux-dsh（MIT）。

由 ARSADM Development 提供 • 在 Android 和 Linux 上构建未来 • github.com/ARSADM7