遇到问题,来这里找答案
有疑问?慢慢看。
刚开始用,或想再多玩一点,都可以从一个问题开始。
安装与上手
Hermit 和里面的应用是什么关系?
Hermit 是手机上用来安装和打开应用的地方。里面的应用叫 happ,可以是 AI 聊天工具、清单、记事本,或为自己做的小工具。先安装 Hermit,再添加 happ,就能开始用。
下载后怎么安装?手机提示“未知来源”怎么办?
点击下载完成的 APK 文件,按手机提示安装。如果系统要求,允许这次用于下载的浏览器或文件管理器安装应用。安装完成后可以关闭这项权限。Hermit 适用于 Android 10 及以上设备。
支持 iPhone 吗?需要 Google Play 吗?
目前提供 Android 版,iPhone 暂不支持。Hermit 的安装和核心使用不需要 Google Play 服务,具体应用所需的网络服务由该应用决定。
安装后怎么是空的?
这是正常的,你还需要添加一个 happ。在 Hermit 中点“扫码添加”或“从网址”,就可以安装应用。先试试 chataxi。
网页和 Hermit 都在同一台手机上,怎么扫码?
不用扫码。在入门页点“复制地址”,回到 Hermit 点“从网址”,粘贴并确认。无法复制时,也可以长按地址手动复制。
chataxi 装好了,为什么还不能聊天?
chataxi 用来连接你选择的 AI 模型,本身不附送模型服务或额度。打开后按应用中的连接引导添加服务,填入服务商提供的 API 密钥并选择模型,再创建角色开始聊天。网络和费用以你选择的服务为准。
密钥只填写在 chataxi 的服务配置中,不要放进问题反馈或分享给其他人。
日常使用
Hermit 和应用怎么更新?
Hermit 的管理界面已包含在安装包内。需要更新界面时,在 Hermit“设置”中点“更新本地版本”即可,无需单独下载界面包。
你安装的 happ 有更新地址时,可以在应用管理中检查更新。需要升级 HermitApp 本身时,从下载页获取新版 APK 并覆盖安装。
可以把常用应用放到桌面吗?
可以。在 Hermit 中找到应用,使用添加到桌面的入口,按系统提示确认。也可以点亮爱心,放进 Hermit 的收藏。
没有网络还能用吗?
取决于应用。安装到本机的应用可以从本地打开;离线清单、笔记等可以由作者做成无需联网。AI 聊天、在线内容和其他服务器功能仍需要网络。
怎么备份?换手机会丢失内容吗?
在应用管理里导出应用备份,再在新设备的 Hermit 设置中恢复。备份可以保存代码、Hermit 数据和附件,但不包括网页的 Cookie 和登录状态。备份默认不加密,请妥善保存。
为什么会请求相机、麦克风或通知权限?
扫描、录音、提醒等功能需要对应能力。Android 系统权限与每个 happ 的授权分别生效,你可以按实际需要允许,并在应用管理中查看或重置。了解数据与权限。
AI 与定制
怎么把 Codex 或 WorkBuddy 连到手机?
让手机与电脑连接同一个可信 Wi-Fi,在 Hermit 的“开发”页开启开发模式。把当前显示的地址和密码交给你信任的电脑智能体,请它打开地址并按连接说明接入。
不同智能体的接入方式可能不同,需要添加工具或完成客户端设置时,让它按说明继续操作。连接完成后,就可以描述你想修改或新建的应用。
智能体连不上,该检查什么?
确认开发模式仍然开启,使用的是手机当前显示的地址和密码,且电脑与手机在同一网络。先让智能体访问连接地址;如果访问不到,检查访客 Wi-Fi 隔离、电脑代理和防火墙。服务停止或地址变化后,重新连接。
把密码交给智能体安全吗?
开发连接允许修改应用,只应交给你信任的智能体,在可信网络中临时使用。不要把地址和密码放到公开网页、代码仓库或群聊。完成后关闭开发模式;如怀疑泄露,可以更换密码。
不懂编程,也能做自己的应用吗?
可以从描述需求开始,让智能体完成具体实现。先挑一个小场景,比如“每天三件事的清单”,做出来用一遍,再告诉它哪里不顺手。涉及复杂功能时,可能需要多轮调整。
所有应用都能随便改吗?
Hermit 中具有本地代码的 happ 可以在开发模式下创建开发副本并修改。只有网址的在线网页不一定有可修改的本地代码;商业 Android APK 也不能直接放进 Hermit 改造。分享他人的代码时,应遵守原作者的许可。
想深入了解
本地来源、线上来源,和运行方式有什么区别?
来源记录应用从哪里添加;运行方式决定这一次怎样打开。网址下载的应用仍是线上来源,但安装了代码后可以本地运行。有实时地址时,也可以线上实时运行。
本地运行并不总等于离线:带有实时地址的应用会优先使用包内资源,动态请求仍可能访问网络。
给智能体的技术资料在哪里?
开启开发模式后,先让智能体访问手机显示的连接地址,读取与当前 HermitApp 匹配的工具和开发说明。发现入口为 /.well-known/hermit-agent,标准 MCP 接口为 /mcp。
happ 用什么技术做?需要构建工具吗?
最简单的 happ 就是 HTML、CSS 和 JavaScript 页面,可直接运行,不要求 React、Vue 或构建步骤。规范发布包在根目录提供 hermit.json,声明稳定的 happId、版本和入口。ZIP 只是传输文件的方式。
相机、文件、通知等功能如何接入?
通过 Hermit 的公开 Bridge 接口,并为当前 happ 申请相应授权。先让智能体读取手机提供的当前合同;普通 happ 无法使用官方管理界面的宿主管理权限。
Hermit 支持规定类型的通知计划与服务端通知轮询,但不会替 happ 持续在后台执行任意 JavaScript。
不同应用的数据是完全隔离的吗?
Hermit 自有数据、文件和授权按应用实例隔离。WebView 的 Cookie 与站点存储遵循浏览器同源规则:同一协议、主机和有效端口的页面可能共享网站数据,不同路径不构成隔离。
怎么发布更新,又不影响用户已有数据?
保持同一 happId,递增版本号,发布新的版本化 ZIP,再更新安装清单。Hermit 用新的只读代码版本替换旧代码;用户设置与业务数据应单独保存,不应写入代码目录。业务数据格式变化仍需应用作者正确处理。
如何核对 Android 安装包?
当前正式版本为 1.10.19,应用标识为 io.github.zhyuzh3d.hermit,文件大小 3,156,977 字节。SHA-256:
db1312fffa199f209aba694b04f7fe2340262eccc9809f60446dcd7a3ce2f594