---
title: "安装为应用"
description: "将 Notarium 安装为 PWA：离线的应用外壳（但不含离线数据）与更新。"
---

# 安装为应用

Notarium 是一款 PWA（渐进式 Web 应用）：你可以把它**安装为应用**，在主屏幕或启动器中放置图标，并在独立窗口中运行，没有浏览器标签页和地址栏。得益于预缓存的静态资源，它能够即时启动。

> [!important] 离线可用的是外壳，不是数据
> 安装只覆盖**应用外壳**：可安装性、静态资源缓存，以及外壳自身的离线兜底。离线**数据**（在无网络时读写笔记、同步、冲突解决）**不在其中**。数据保存在服务器上，Service Worker 不会缓存它们。

## 如何安装

安装入口位于 **Settings → About**。你看到什么取决于你的浏览器和平台：

- **一个 “Install app” 按钮** —— 当浏览器已提供安装选项、而应用尚未安装时。
- **“Installed” 状态** —— 当 Notarium 已在独立窗口中运行时。
- **Add to Home Screen 说明** —— 在 iOS 上，系统没有安装提示，需在 Safari 中手动添加应用。
- **一条提示** —— 面向不支持安装的浏览器。

## 哪些内容可离线使用

对任何导航请求，外壳自身都可离线提供 —— 静态资源（代码、样式、图标、字体）在构建时已预缓存。但对数据（`/api`）和 MCP 网关（`/mcp`）的请求**始终走网络**：没有连接时它们会返回网络错误，应用会显示自己的错误状态，而不会用陈旧的缓存笔记来顶替。

## 更新

更新绝不会在你毫无察觉时自行重新加载页面。当新版本构建完成后，应用会显示一条常驻提示 **“A new version is available”**，并附带 **“Reload”** 操作 —— 只有点击它才会切换到新版本。同样的操作在 Settings → About 中也由一个 **“Reload to update”** 按钮镜像提供。

关于从零启动 Notarium，参见[快速开始](/docs/getting-started/)；关于为离线外壳缓存的字体与主题，参见[阅读与外观](/docs/guides/reading/)。