logo
0
1
WeChat Login
更新 README:添加截图预览、下载链接、最新按键调整说明

termux-g

termux-g 是一个面向 Android 的单仓库工程,包含 Termux 定制版应用与 CLIProxy Android 管理应用,通过 CNB 自动化构建并发布 APK。

截图预览

下载

版本文件架构
v2026.4.24(最新)release/termux-app_2026.4.24_arm64-v8a.apkarm64-v8a
v0.119.0release/termux-app_v0.119.0_arm64-v8a.apkarm64-v8a

核心功能

顶部按钮栏(Top Buttons)

  • "固定第一页 + 动态第 2..N 页"分页结构。
  • 第 1 页:固定两行预设按钮。
  • 第 2..N 页:CLIProxy 预设按钮 + 自定义按钮 + + 新增按钮。
  • 动态页按 2x4(每页 8 个)自动分页,支持长按编辑/删除。

底部工具栏(Terminal Toolbar)

  • 第 1 页:extra keys(ESC / CTRL / ALT / KEYBOARD / SHIFT 等),原 - 键改为 Ctrl+C 中断键,原 END 键改为 DRAWER(快捷打开左侧抽屉)。
  • 第 2..N 页:复用动态按钮能力(自定义/+、分页、长按编辑,不含 CLIProxy)。
  • 顶部动态按钮增删改后,底部即时同步刷新。

仓库结构

模块路径主要语言说明
Termux 主应用termux-appJava/XML/Gradle终端会话、顶部按钮、底部工具栏、extra keys
CLIProxy AndroidcliproxyKotlin/Compose/Gradle内嵌 CLIProxy 服务端与移动端管理 UI
CLIProxy 后端参考reference/CLIProxyAPIGo管理 API、路由与服务端能力参考
管理前端参考reference/Cli-Proxy-API-Management-CenterTypeScript/React管理台前端交互参考

本地开发与构建

Termux App

cd termux-app ./gradlew assembleDebug

输出:termux-app/app/build/outputs/apk/debug/

CLIProxy App

cd cliproxy ./gradlew assembleDebug

输出:cliproxy/app/build/outputs/apk/debug/

验证清单(Termux 按钮系统)

  1. 底部第 1 页 extra keys 行为正常(Ctrl+C 中断、DRAWER 抽屉开关)。
  2. 底部第 2 页为动态按钮页,不含文本输入框和 CLIProxy。
  3. 连续新增自定义按钮后,底部可扩展为第 3/4 页。
  4. 顶部增删改按钮后,底部动态页即时同步。
  5. 长按交互(编辑命令/删除)在顶部与底部动态页保持一致。

CI/CD

  • 使用 CNB 触发流水线构建并聚合 APK 到 release/
  • 构建流程定义:.cnb.yml

协作约定

  • Termux 交互/按钮/终端:在 termux-app 内改动。
  • CLIProxy 管理端能力:在 cliproxy 内改动。
  • reference/* 为参考实现,不直接作为发布目标。
  • 提交前建议至少执行对应模块的 assembleDebug