Skip to content

Repository files navigation

Karin App

在 Android 手机上运行 Karin 。不用电脑、不用服务器,装好 App 就能把机器人跑起来。

App 能做什么

  • 一键启动 Karin:右下角电源键启动/停止,实时显示运行时长与内存占用
  • 内置插件市场:按分类浏览,直接安装、卸载,插件说明(README)在 App 内渲染
  • 切换 Karin 版本:在设置里查看已装版本并随时切换
  • 改配置文件:内置文件管理,直接浏览和编辑容器里的 /root/karin(配置、插件数据都能改)
  • 自动准备环境:容器解包、Node.js、依赖安装全部自动完成,首次启动后无需再操心
  • 后台保活:Karin 运行时可保持在后台,不被系统随手回收

开始使用

  1. 安装:从 Releases 下载 APK 安装(仅支持 arm64 手机)。
  2. 首次启动:等它自动准备容器和运行环境,需要联网,耗时取决于网速,界面会显示进度和日志。
  3. 启动 Karin:进入「控制台」,点右下角电源键。首次会申请通知权限——允许它,Karin 才能在后台稳定运行。
  4. 装插件:打开「插件」页,用分类和「全部 / 已安装 / 未安装」筛选,点安装即可。要接入平台,记得装对应的适配器插件。
  5. 改配置:需要改账号、协议端等配置时,用「控制台 → 文件管理」编辑 /root/karin 下的文件。

国内网络建议:进「设置」把 NPM 源 切到淘宝源;如果装插件时卡在 GitHub,可以填一个 GitHub 加速前缀(例如 https://gh-proxy.com/,留空表示直连)。

界面一览

  • 控制台:Karin 运行状态、内存占用、右上角容器状态(点开可优雅重启 / 强制重启)、右下角电源开关、文件管理入口
  • 插件:插件市场与已安装管理
  • 设置:Karin 版本切换、NPM 源、GitHub 加速,以及「重置 Karin 项目」「重置容器」两个危险操作

常见问题

  • 启动失败 / 一直转圈:首次启动需要联网下载运行环境,检查网络后点「重试」;失败时可以把完整日志保存到 Download 目录再看。
  • Karin 停止后就不动了:请允许通知权限,否则后台保活能力会下降。
  • 机器人没反应:先确认首页显示 Karin 正在运行,再检查适配器插件是否装好、配置是否填对。
  • 想从头再来:「重置 Karin 项目」只清空 /root/karin(插件和配置会丢);「重置容器」会重装整个 Debian 环境,耗时更长。
  • 终端入口:目前还是占位功能,暂不可用。

开发者

技术栈:React Native 0.87 + React 19 + TypeScript,原生侧用 proot 跑 Debian bookworm (arm64) 容器。

pnpm install        # 安装依赖
npm start           # 启动 Metro
npm run android     # 构建并安装到已连接的 arm64 真机
npx tsc --noEmit    # 类型检查
npm run lint -- --no-cache

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages