# opencode-termux-installer

**Repository Path**: kingsunrain/opencode-termux-installer

## Basic Information

- **Project Name**: opencode-termux-installer
- **Description**: OpenCode Termux 一键安装脚本 - 自动安装 OpenCode 并配置 DeepSeek 为默认模型
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-21
- **Last Updated**: 2026-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OpenCode Termux 一键安装脚本

自动在 Termux 中安装 OpenCode，支持 Android 11+。

## ⚠️ 重要说明

**本脚本使用 [Hope2333/opencode-termux](https://github.com/Hope2333/opencode-termux) 构建系统，在设备上本地编译安装。**

### 为什么需要本地编译？

旧版 `guysoft/opencode-termux` 二进制在 **Android 11+ 上完全无法运行**：

```
Pointer tag for 0x... was truncated
Aborted
```

原因：使用 bionic libc + Bun，与 Android 11+ 的 MTE（内存标记扩展）冲突。

本脚本使用 glibc 构建系统，完美支持 Android 11+。

---

## 快速开始

### 前提条件

- Android 7.0+ 设备（推荐 Android 11+）
- Termux（**必须从 [F-Droid](https://f-droid.org/packages/com.termux/) 下载**，Play Store 版本已过时）
- 存储空间 1GB+、内存 2GB+

### 安装步骤

```bash
# 1. 下载脚本（-L 参数跟随重定向，避免下载空文件）
curl -L -o install-opencode.sh https://gitee.com/kingsunrain/opencode-termux-installer/raw/main/install-opencode-termux.sh

# 2. 添加执行权限
chmod +x install-opencode.sh

# 3. 运行安装（构建约需 5-10 分钟）
bash install-opencode.sh
```

### 安装后使用

```bash
opencode           # 启动 OpenCode
opencode --version # 查看版本
```

在 OpenCode 中：
- 输入 `/models` 查看可用模型
- 输入 `/connect` 配置认证

---

## 安装流程

```
配置镜像源 → 安装依赖 → 安装 glibc → 克隆构建系统 
→ 本地构建(5-10分钟) → 安装 .deb 包 → 完成
```

---

## 踩坑记录（重要！）

### 1. 核心难点：Android 11+ Tagged Pointers

**问题**：`Pointer tag for 0x... was truncated, Aborted`

**原因**：bionic libc + Bun 与 Android 11+ MTE 冲突

**解决**：使用 glibc 构建系统

### 2. GitHub 无法访问

**解决**：使用 Gitee 镜像
- opencode-termux: `https://gitee.com/kingsunrain/opencode-termux`
- bun-termux-loader: `https://gitee.com/kingsunrain/bun-termux-loader`

### 3. 依赖缺失

**完整依赖**：
```bash
pkg install git curl wget unzip ripgrep make nodejs file python3 tar clang
```

### 4. glibc 路径问题

**解决**：创建符号链接
```bash
ln -sf $PREFIX/glibc /data/data/com.termux/files/usr/glibc
```

### 5. dpkg 安装跳过

**解决**：强制重装
```bash
dpkg -i --force-reinstall opencode_*.deb
```

---

## 详细文档

完整的安装问题与解决方案请参阅：**[INSTALL-GUIDE.md](INSTALL-GUIDE.md)**

---

## 版本历史

| 版本 | 说明 |
|------|------|
| v3.1.1 | 修复安装命令（curl 加 -L，bash 执行） |
| v3.1.0 | 新增 oc 短链接、默认模型、自动启动 |
| v3.0.1 | 修复构建问题，移除 DeepSeek 默认模型 |
| v3.0 | 切换到 Hope2333/opencode-termux 构建系统 |
| v2.x | 尝试修复 tagged pointers（未成功） |
| v1.0 | 初始版本 |

---

## 许可证

MIT License

## 相关链接

- [OpenCode 官网](https://opencode.ai)
- [Hope2333/opencode-termux](https://github.com/Hope2333/opencode-termux)
- [Termux (F-Droid)](https://f-droid.org/packages/com.termux/)