OpenCode Termux 运行指南

解决的问题

OpenCode 是 Bun 编译的单文件 CLI 工具，原生依赖 glibc 环境。在 Termux（Android 系统）上直接运行会失败，因为 Android 使用 bionic libc 而非标准 glibc。本技能提供完整的兼容层方案，让开发者能在 Android 设备上运行 OpenCode 并接入 AI 编程能力。

工作原理

核心架构

通过 glibc-runner（grun）兼容层实现 Linux ARM64 二进制在 Termux 中的执行。OpenCode 主程序为 64 位 ARM ELF（约 175MB），内嵌 Node.js 运行时，通过 $PREFIX/bin/opencode 的 bash 包装脚本调用 grun 启动实际二进制文件 opencode.real。

关键组件

• 双文件结构：opencode 作为启动器调用 opencode.real 真实二进制
• npm meta 包：opencode-ai（7.9KB）通过 optionalDependencies 按平台拉取 opencode-linux-arm64 子包（约 188MB 解压）
• 配置文件：位于 ~/.config/opencode/，包含 opencode.jsonc（用户配置）、package.json（依赖声明）和插件代码
• 持久化存储：~/.local/share/opencode/ 存储 SQLite 数据库（session 状态）和 JSON 行格式日志

运行时行为

• 使用 glibc bash（$PREFIX/glibc/bin/bash）而非 Termux 原生 bash
• 默认配置 opencode-go provider 和 deepseek-v4-pro 模型
• 通过 inotify 实现 Linux 原生文件监控，LSP 和格式化工具默认禁用
• Session 自动创建，格式为 ses_ 前缀的字符串

适用边界与注意点

• 手动安装：需通过 npm 手动安装 meta 包并配置 glibc 环境，无自动化安装脚本
• 文件选择器限制：fff 在 home 目录下有限制，建议在项目目录内运行
• 网络依赖：models.dev 超时仅影响模型列表更新，不影响已配置模型
• 权限修复：Termux 的 /tmp 需修复写入权限（默认 shell:shell 属主）
• 版本锁定：依赖 ~/.config/opencode/package.json 锁定插件版本，需手动管理依赖更新