kaijibot 2026.6.25 → 2026.6.26
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -0
- package/docs/android-install.html +64 -0
- package/docs/platforms/index.md +1 -0
- package/docs/platforms/termux.md +233 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -142,6 +142,16 @@ kaijibot gateway --port 18789 --verbose
|
|
|
142
142
|
<details>
|
|
143
143
|
<summary><b>📦 其他安装方式</b></summary>
|
|
144
144
|
|
|
145
|
+
#### Android / Termux（手机运行）
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
# 1. 从 F-Droid 安装 Termux（不要用 Google Play 版）
|
|
149
|
+
# 2. 在 Termux 中运行：
|
|
150
|
+
curl -fsSL https://gitee.com/kaiji1126/kaijibot/raw/main/scripts/install-termux.sh | bash
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
详见 [Termux 部署指南](./docs/platforms/termux.md)。
|
|
154
|
+
|
|
145
155
|
#### npm 全局安装（已有 Node.js 22+ 环境）
|
|
146
156
|
|
|
147
157
|
```bash
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="zh-CN">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
|
|
6
|
+
<title>KaijiBot 安装</title>
|
|
7
|
+
<style>
|
|
8
|
+
*{margin:0;padding:0;box-sizing:border-box}
|
|
9
|
+
body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;background:#0d1117;color:#c9d1d9;padding:20px;max-width:500px;margin:0 auto}
|
|
10
|
+
h1{color:#58a6ff;font-size:1.6rem;margin:1.5em 0 .5em;text-align:center}
|
|
11
|
+
.subtitle{text-align:center;color:#8b949e;margin-bottom:2em}
|
|
12
|
+
.step{background:#161b22;border:1px solid #30363d;border-radius:12px;padding:20px;margin-bottom:16px}
|
|
13
|
+
.step-num{display:inline-block;width:28px;height:28px;background:#238636;color:#fff;border-radius:50%;text-align:center;line-height:28px;font-weight:bold;font-size:14px;margin-right:8px}
|
|
14
|
+
.step-title{font-size:1.1rem;color:#58a6ff;display:flex;align-items:center;margin-bottom:12px}
|
|
15
|
+
.btn{display:block;width:100%;padding:16px;text-align:center;font-size:1.1rem;border:none;border-radius:8px;text-decoration:none;cursor:pointer;margin:12px 0}
|
|
16
|
+
.btn-download{background:#238636;color:#fff}
|
|
17
|
+
.btn-download:active{background:#1a7f37}
|
|
18
|
+
.cmd-box{background:#0d1117;border:1px solid #30363d;border-radius:8px;padding:14px;font-family:monospace;font-size:.85rem;color:#7ee787;word-break:break-all;position:relative;margin:12px 0}
|
|
19
|
+
.copy-btn{position:absolute;top:8px;right:8px;background:#21262d;color:#58a6ff;border:1px solid #30363d;border-radius:6px;padding:6px 14px;font-size:.8rem;cursor:pointer}
|
|
20
|
+
.copy-btn:active{background:#30363d}
|
|
21
|
+
.hint{color:#8b949e;font-size:.85rem;margin-top:8px;line-height:1.5}
|
|
22
|
+
.qr{text-align:center;margin:16px 0}
|
|
23
|
+
.qr img{border-radius:8px}
|
|
24
|
+
.notice{background:#1c2128;border-left:3px solid #f0883e;padding:12px 16px;border-radius:0 8px 8px 0;margin:16px 0;font-size:.85rem;color:#d29922}
|
|
25
|
+
.footer{text-align:center;color:#484f58;font-size:.8rem;margin-top:2em;padding-bottom:2em}
|
|
26
|
+
</style>
|
|
27
|
+
</head>
|
|
28
|
+
<body>
|
|
29
|
+
|
|
30
|
+
<h1>👾 KaijiBot</h1>
|
|
31
|
+
<p class="subtitle">两步装好你的 AI 助手</p>
|
|
32
|
+
|
|
33
|
+
<div class="step">
|
|
34
|
+
<div class="step-title"><span class="step-num">1</span>下载安装 Termux</div>
|
|
35
|
+
<a class="btn btn-download" href="https://github.com/Kaiji-Z/kaijibot/releases/download/v2026.6.25-1/termux-arm64.apk">下载 Termux APK (34MB)</a>
|
|
36
|
+
<p class="hint">下载后点击安装。如果提示"未知来源"，允许即可。</p>
|
|
37
|
+
</div>
|
|
38
|
+
|
|
39
|
+
<div class="step">
|
|
40
|
+
<div class="step-title"><span class="step-num">2</span>打开 Termux，粘贴运行</div>
|
|
41
|
+
<div class="cmd-box">
|
|
42
|
+
<button class="copy-btn" onclick="copyCmd()">复制</button>
|
|
43
|
+
curl -fsSL https://gitee.com/kaiji1126/kaijibot/raw/main/scripts/install-termux.sh | bash
|
|
44
|
+
</div>
|
|
45
|
+
<div class="qr">
|
|
46
|
+
<img src="https://api.qrserver.com/v1/create-qr-code/?size=200x200&margin=8&data=curl%20-fsSL%20https%3A%2F%2Fgitee.com%2Fkaiji1126%2Fkaijibot%2Fraw%2Fmain%2Fscripts%2Finstall-termux.sh%20%7C%20bash" alt="扫码获取命令" width="200" height="200">
|
|
47
|
+
<p class="hint">或扫描二维码获取命令</p>
|
|
48
|
+
</div>
|
|
49
|
+
<p class="hint">安装完成后会自动进入配置向导，按提示配置 API Key 和飞书机器人即可。</p>
|
|
50
|
+
</div>
|
|
51
|
+
|
|
52
|
+
<div class="notice">
|
|
53
|
+
⚠️ 安装完成后，请务必在手机设置中关闭 Termux 的电池优化：<br>
|
|
54
|
+
设置 → 应用 → Termux → 电池 → 不限制后台<br>
|
|
55
|
+
否则 Gateway 会被系统杀死。
|
|
56
|
+
</div>
|
|
57
|
+
|
|
58
|
+
<p class="footer">问题反馈 · <a href="https://github.com/Kaiji-Z/kaijibot/issues" style="color:#58a6ff">GitHub Issues</a></p>
|
|
59
|
+
|
|
60
|
+
<script>
|
|
61
|
+
function copyCmd(){var t="curl -fsSL https://gitee.com/kaiji1126/kaijibot/raw/main/scripts/install-termux.sh | bash";navigator.clipboard?navigator.clipboard.writeText(t):document.execCommand("copy")}
|
|
62
|
+
</script>
|
|
63
|
+
</body>
|
|
64
|
+
</html>
|
package/docs/platforms/index.md
CHANGED
|
@@ -20,6 +20,7 @@ Native companion apps for Windows are also planned; the Gateway is recommended v
|
|
|
20
20
|
- macOS: [macOS](/platforms/macos)
|
|
21
21
|
- iOS: [iOS](/platforms/ios)
|
|
22
22
|
- Android: [Android](/platforms/android)
|
|
23
|
+
- Android (Termux): [Termux](/platforms/termux)
|
|
23
24
|
- Windows: [Windows](/platforms/windows)
|
|
24
25
|
- Linux: [Linux](/platforms/linux)
|
|
25
26
|
|
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
---
|
|
2
|
+
summary: "在 Android 手机的 Termux 终端中部署 KaijiBot，实现 24/7 在线"
|
|
3
|
+
read_when:
|
|
4
|
+
- 想在 Android 手机上运行 KaijiBot
|
|
5
|
+
- Termux 环境配置或保活问题
|
|
6
|
+
- Android 开机自启设置
|
|
7
|
+
title: "Termux 部署"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Termux 部署
|
|
11
|
+
|
|
12
|
+
## 概述
|
|
13
|
+
|
|
14
|
+
KaijiBot 可以在 Android 手机的 Termux 终端模拟器中运行。把一台闲置手机变成 24/7 在线的 AI 助手，不需要额外的服务器。只要手机有网络，KaijiBot 就能通过飞书收发消息、主动推送洞察。
|
|
15
|
+
|
|
16
|
+
> **注意**：本文档介绍的是 Termux 方案。`docs/platforms/android.md` 描述的是 KaijiBot 原生 Android 伴侣 App（尚未发布），两者是完全不同的使用方式。
|
|
17
|
+
|
|
18
|
+
## 准备工作
|
|
19
|
+
|
|
20
|
+
**Termux 安装**：从 F-Droid 安装，不要用 Google Play 版本（Play 版已废弃，版本滞后且不接收更新）。
|
|
21
|
+
|
|
22
|
+
下载地址：https://f-droid.org/packages/com.termux/
|
|
23
|
+
|
|
24
|
+
**设备要求**：
|
|
25
|
+
|
|
26
|
+
| 要求 | 最低配置 |
|
|
27
|
+
|------|----------|
|
|
28
|
+
| Android 版本 | 7.0+ |
|
|
29
|
+
| RAM | 4GB |
|
|
30
|
+
| 存储 | 2GB 可用空间 |
|
|
31
|
+
| 网络 | 需要稳定网络连接 |
|
|
32
|
+
|
|
33
|
+
## 一键安装
|
|
34
|
+
|
|
35
|
+
推荐用一键脚本，自动完成所有配置：
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
curl -fsSL https://gitee.com/kaiji1126/kaijibot/raw/main/scripts/install-termux.sh | bash
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
如果手动安装后需要配置开机自启和保活，运行：
|
|
42
|
+
|
|
43
|
+
```bash
|
|
44
|
+
kaijibot android-install
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
## 手动安装步骤
|
|
48
|
+
|
|
49
|
+
如果不想用一键脚本，可以按以下步骤手动操作：
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# 1. 更新包管理器并安装依赖
|
|
53
|
+
pkg update && pkg install nodejs-lts imagemagick ffmpeg
|
|
54
|
+
|
|
55
|
+
# 2. 安装 KaijiBot
|
|
56
|
+
npm install -g kaijibot --force
|
|
57
|
+
|
|
58
|
+
# 3. 安装图片处理库（WASM 版，适用于 Termux 的 arm32 环境）
|
|
59
|
+
npm install -g @img/sharp-wasm32 --force
|
|
60
|
+
|
|
61
|
+
# 4. 运行配置向导，配置飞书机器人和 LLM 提供商
|
|
62
|
+
kaijibot onboard
|
|
63
|
+
|
|
64
|
+
# 5. 配置开机自启和后台保活
|
|
65
|
+
kaijibot android-install
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## 开机自启
|
|
69
|
+
|
|
70
|
+
开机自启依赖 Termux:Boot 插件，配置步骤如下：
|
|
71
|
+
|
|
72
|
+
1. **安装 Termux:Boot**：在 F-Droid 搜索 `com.termux.boot` 并安装
|
|
73
|
+
2. **必须打开一次**：安装后先手动打开 Termux:Boot 应用。Android 要求应用至少启动过一次才会注册开机广播接收器，这一步不做的话开机后什么都不会执行
|
|
74
|
+
3. **生成启动脚本**：`kaijibot android-install` 会自动写入 `~/.termux/boot/start-kaijibot.sh`
|
|
75
|
+
4. 重启手机，KaijiBot 自动启动
|
|
76
|
+
|
|
77
|
+
启动脚本的内容大致如下：
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
#!/data/data/com.termux/files/usr/bin/sh
|
|
81
|
+
termux-wake-lock
|
|
82
|
+
kaijibot gateway
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
## 后台保活
|
|
86
|
+
|
|
87
|
+
Termux 被 Android 系统杀掉是最常见的可靠性问题。以下是多层防护措施：
|
|
88
|
+
|
|
89
|
+
### 唤醒锁
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
termux-wake-lock
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
获取 CPU 唤醒锁，防止手机休眠时 Termux 进程被暂停。`kaijibot android-install` 生成的启动脚本已自动包含此命令。
|
|
96
|
+
|
|
97
|
+
### 电池优化白名单
|
|
98
|
+
|
|
99
|
+
**设置路径**：设置 → 应用 → Termux → 电池 → 不限制
|
|
100
|
+
|
|
101
|
+
这步必须做。不做的话 Android 会在几分钟内杀掉 Termux 进程，开机自启形同虚设。
|
|
102
|
+
|
|
103
|
+
### 前台服务
|
|
104
|
+
|
|
105
|
+
Termux 的通知栏必须保持常驻。如果通知栏看不到 Termux 的通知，说明进程已经被杀了。下拉通知栏检查，如果没有就手动重启一次 `kaijibot gateway`。
|
|
106
|
+
|
|
107
|
+
## OEM 电池优化设置（按品牌）
|
|
108
|
+
|
|
109
|
+
这是最关键的一步。不同品牌的 Android 系统对后台进程的管控策略差异很大，只做通用的电池优化白名单远远不够。必须按你的手机品牌完成以下设置：
|
|
110
|
+
|
|
111
|
+
### 小米 / MIUI / 澎湃OS
|
|
112
|
+
|
|
113
|
+
- **设置** → 应用设置 → 应用管理 → Termux → 省电策略 → **无限制**
|
|
114
|
+
- **设置** → 应用设置 → 应用管理 → Termux → 自启动 → **开启**
|
|
115
|
+
- **安全中心** → 应用管理 → Termux → 后台弹出权限 → **开启**
|
|
116
|
+
|
|
117
|
+
### 三星 / One UI
|
|
118
|
+
|
|
119
|
+
- **设置** → 电池和设备维护 → 电池 → 后台使用限制 → 从不睡眠应用 → **添加 Termux**
|
|
120
|
+
|
|
121
|
+
### 华为 / EMUI / 鸿蒙
|
|
122
|
+
|
|
123
|
+
- **设置** → 电池 → 更多设置 → 受保护的应用 → **Termux 开启**
|
|
124
|
+
- **设置** → 应用 → 应用启动管理 → Termux → 手动管理 → **全部开启**
|
|
125
|
+
|
|
126
|
+
### vivo / OriginOS
|
|
127
|
+
|
|
128
|
+
- **设置** → 电池 → 后台高耗电 → Termux → **允许后台运行**
|
|
129
|
+
- **i管家** → 应用管理 → 自启动 → Termux → **开启**
|
|
130
|
+
- **设置** → 快捷与辅助 → 安全管理 → 后台管理 → Termux → **允许**
|
|
131
|
+
|
|
132
|
+
### OPPO / ColorOS
|
|
133
|
+
|
|
134
|
+
- **设置** → 电池 → 应用耗电管理 → Termux → **允许后台运行** + **允许自启**
|
|
135
|
+
|
|
136
|
+
### Pixel / 原生 Android
|
|
137
|
+
|
|
138
|
+
- **设置** → 应用 → Termux → 电池 → **不受限**
|
|
139
|
+
- **设置** → 应用 → Termux:Boot → 电池 → **不受限**
|
|
140
|
+
|
|
141
|
+
> **提示**：设置完成后，重启一次手机验证所有设置是否生效。如果重启后 KaijiBot 没有自动启动，回到本章逐项排查。
|
|
142
|
+
|
|
143
|
+
## 日常使用
|
|
144
|
+
|
|
145
|
+
```bash
|
|
146
|
+
# 前台启动 gateway（可以在终端看到实时日志）
|
|
147
|
+
kaijibot gateway
|
|
148
|
+
|
|
149
|
+
# 重启 gateway
|
|
150
|
+
kaijibot gateway restart
|
|
151
|
+
|
|
152
|
+
# 停止 gateway
|
|
153
|
+
kaijibot gateway stop
|
|
154
|
+
|
|
155
|
+
# 更新 KaijiBot 到最新版本
|
|
156
|
+
kaijibot update
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
日志文件位于 `~/.kaijibot/gateway.log`，排查问题时先看这里。
|
|
160
|
+
|
|
161
|
+
## 浏览器自动化（可选）
|
|
162
|
+
|
|
163
|
+
需要网页抓取或截图功能时，可以在 Termux 中安装 Chromium：
|
|
164
|
+
|
|
165
|
+
```bash
|
|
166
|
+
pkg install x11-repo && pkg install chromium
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
KaijiBot 会自动检测 `$PREFIX/bin/chromium-browser`。Termux 环境下需要额外配置：
|
|
170
|
+
|
|
171
|
+
```bash
|
|
172
|
+
kaijibot config set browser.noSandbox true
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
不装 Chromium 也不影响核心功能，飞书消息收发和认知系统都能正常工作。
|
|
176
|
+
|
|
177
|
+
## 功能限制
|
|
178
|
+
|
|
179
|
+
Android/Termux 环境下，部分功能会降级：
|
|
180
|
+
|
|
181
|
+
| 功能 | 降级原因 | 替代方案 |
|
|
182
|
+
|------|----------|----------|
|
|
183
|
+
| 向量语义搜索 | sqlite-vec 没有 android-arm64 预编译包 | 降级为 FTS 全文搜索 |
|
|
184
|
+
| LanceDB 记忆插件 | 无 arm64 支持 | 使用 memory-core 插件代替 |
|
|
185
|
+
| 图片处理 | 无原生 sharp 二进制包 | 使用 WASM 版 sharp（速度慢 2-5 倍，功能完整） |
|
|
186
|
+
| PTY 终端模拟 | Termux 限制 | 降级为 child_process（TUI 体验略差） |
|
|
187
|
+
|
|
188
|
+
这些降级不影响日常使用。飞书消息、认知洞察、技能系统、记忆管理等核心功能全部正常。
|
|
189
|
+
|
|
190
|
+
## 故障排除
|
|
191
|
+
|
|
192
|
+
### Gateway 被系统杀掉
|
|
193
|
+
|
|
194
|
+
1. 检查 `termux-wake-lock` 是否生效：`termux-wake-lock` 命令执行后通知栏应出现锁图标
|
|
195
|
+
2. 检查电池优化白名单是否已将 Termux 设为不限制
|
|
196
|
+
3. 检查 OEM 电池优化设置（见上方按品牌说明）
|
|
197
|
+
|
|
198
|
+
### 开机不自启
|
|
199
|
+
|
|
200
|
+
1. 确认已安装 Termux:Boot（F-Droid 搜索 `com.termux.boot`）
|
|
201
|
+
2. 确认已至少打开过一次 Termux:Boot 应用
|
|
202
|
+
3. 确认 `~/.termux/boot/start-kaijibot.sh` 文件存在且可执行
|
|
203
|
+
4. 手动运行该脚本验证内容是否正确：`bash ~/.termux/boot/start-kaijibot.sh`
|
|
204
|
+
|
|
205
|
+
### TLS / SSL 错误
|
|
206
|
+
|
|
207
|
+
Termux 的 CA 证书可能与 Node.js 不匹配。设置环境变量：
|
|
208
|
+
|
|
209
|
+
```bash
|
|
210
|
+
export NODE_EXTRA_CA_CERTS=$PREFIX/etc/tls/ca-bundle.crt
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
建议写入 `~/.bashrc` 或 `~/.profile` 使其永久生效：
|
|
214
|
+
|
|
215
|
+
```bash
|
|
216
|
+
echo 'export NODE_EXTRA_CA_CERTS=$PREFIX/etc/tls/ca-bundle.crt' >> ~/.bashrc
|
|
217
|
+
```
|
|
218
|
+
|
|
219
|
+
### npm install 失败
|
|
220
|
+
|
|
221
|
+
某些包（如 `@lancedb/lancedb`）没有 arm64 预编译包，安装会报平台检查错误。加 `--force` 跳过：
|
|
222
|
+
|
|
223
|
+
```bash
|
|
224
|
+
npm install -g kaijibot --force
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
### 内存不足
|
|
228
|
+
|
|
229
|
+
4GB RAM 的手机在运行 KaijiBot 的同时使用其他应用可能会卡顿。建议：
|
|
230
|
+
|
|
231
|
+
- 关闭不必要的后台应用
|
|
232
|
+
- 在 Termux 中限制 Node.js 内存：`export NODE_OPTIONS="--max-old-space-size=512"`
|
|
233
|
+
- 使用轻量模型（如 `zai/glm-5-turbo`）减少推理时的内存占用
|