使用指南 · Hermit

01. 添加你的第一个应用

先下载并安装 HermitApp。打开后进入收藏页，选择适合手头内容的入口。

输入完整的 HTTPS 或 HTTP 页面网址，或扫描包含网址的二维码。检查名称后确认添加。普通网页会直接实时运行且不能创建开发副本；ZIP 直链、直接的 hermit-install.json，或网页同源根目录提供的安装清单会下载安装为本地版本，之后可以进入开发模式。

通过 Android 文件选择器选择页面目录。目录应包含 index.html，可以同时放入 app.js、style.css 与图片。没有 hermit.json 时可检查并补充基础配置。

导入按 Hermit 包合同组织的 ZIP，根目录包含 hermit.json 与页面入口。ZIP 是文件归档，不需要前端构建工具。带有相同 happId 的包会由宿主提示如何安装。

从收藏页添加会同时收藏；从“全部”页添加后，可以再点亮应用卡片的爱心。

点击应用卡片打开页面。搜索支持名称、地址或来源，筛选可以区分本地与线上来源。点击“管理”可以修改名称、地址、运行方式，或添加到手机桌面。

设置页可选择跟随系统、浅色或深色主题。收藏页与全部页分别保留搜索、筛选和滚动位置；重新进入时仍会读取最新应用数据。

你看到的选项	实际含义
本地 / 线上来源	记录从哪里添加。下载到手机后，线上来源仍然是线上来源。
本地运行	需要已安装的代码版本。有实时地址时，在该地址空间内优先加载包内资源，动态请求仍可能访问网络。
线上实时运行	需要实时地址，直接加载网站当前内容，页面可以随服务器变化。

在“管理 → 地址与更新”配置实时地址与更新地址。更新地址用来获取后续代码，当前版本下载地址用于原地址重装。修改后先保存，再检查更新。

改变实时地址可能改变页面所属的网站身份与站点数据空间，请确认地址属于你预期的网站。

页面使用相机、录音、位置、剪贴板或通知等能力时，Hermit 会按应用申请授权；Android 系统权限是另一层决定。可以在应用管理里查看并重置页面授权。

在“管理 → 数据与卸载 → 导出应用备份”保存当前代码、Hermit 记录和附件。备份不加密，不包含 WebView 网站登录状态、Cookie 或页面持久授权。

“设置 → 恢复应用备份”创建独立的新应用；应用管理中的“从备份恢复”会替换当前应用的 Hermit 数据并重置授权。卸载可以保留数据，或在再次确认后彻底清除。

最小页面目录可以只有下面三份文件，直接导入文件夹即可使用：

my-app/
  index.html
  style.css
  app.js

在 index.html 中引用相对路径的 CSS 和 JavaScript。优先使用浏览器标准能力；需要手机能力时，按 Hermit 公开 Bridge 合同申请并调用。普通应用无法调用 HermitUI 的宿主管理 API。

“开发”页可以开启智能体开发模式。可信电脑通过当前局域网地址与六位密码连接，管理全部应用。HTTP 不加密，只在可信局域网使用；进入后台或空闲后服务自动停止。

如只需更新某一个本地应用，可以在应用管理的“开发与更新”中使用 USB 或局域网单应用连接。内置图标库可搜索并复制图标代码，不依赖外部 CDN。

应用无法打开

线上运行先检查网络与实时地址，本地运行确认已有代码版本。可从管理页更新、重装或切换已有代码版本；更换代码前先备份数据。

手机能力不可用

检查应用授权、Android 系统权限和设备能力。Android 版本不等于 WebView 能力；设备没有提供的功能不能通过页面设置补上。

新版界面没有出现

在设置中点击“更新本地版本”。线上实时界面随官网发布变化；无法加载时会回退本地界面。当前运行方式与本地版本可在设置中查看。

需要反馈问题

在“设置 → 运行诊断”复制报告，补充操作步骤、预期与实际结果后前往项目反馈。不要提交开发密码、令牌、登录凭据或私人页面数据。