Notarium文档
文档版本: latest

安装为应用

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

离线可用的是外壳,不是数据

安装只覆盖应用外壳:可安装性、静态资源缓存,以及外壳自身的离线兜底。离线数据(在无网络时读写笔记、同步、冲突解决)不在其中。数据保存在服务器上,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,参见快速开始;关于为离线外壳缓存的字体与主题,参见阅读与外观