Memories

Memories / 文档

本页目录

桌面托盘与 WebUI

Windows 托盘和 macOS 菜单栏应用提供本地 Memories 守护进程的快速概览。它们共用一个内嵌状态仪表板和受限的普通卡片编辑器，不使用外部字体、脚本或分析服务。仪表板支持英语、中文、日语、德语和法语，并适应窄窗口。

状态投影保持只读。解锁后，卡片编辑器接受保险库 ID，并提供类型选择器、类型化字段、重命名/移除、拖动排序，以及可复用模板创建功能。经过身份验证和来源检查的 POST /api/cards 只通过同目录的 CLI 转发明确允许的卡片/类型操作。它不能解锁、提权、运行程序或显示敏感值。敏感操作必须通过原生移动端/CLI 验证；浏览器不提供生物识别/PIN 注册。参见卡片类型。

启动

  • Windows：解压发布 ZIP，双击 memories-tray.exe。将它与 memories.exe 放在同一目录。启动器不会打开控制台窗口。
  • macOS：打开 macOS 软件包中的 Memories.app。它显示在菜单栏中，没有 Dock 窗口。应用包包含配套 CLI。
  • 终端：memories tray 打开原生托盘和仪表板；memories webui 仅打开浏览器仪表板并在前台运行。Linux 可使用 webui；原生托盘支持仅限 Windows 和 macOS。
memories --home /path/to/development-home tray
memories --home /path/to/development-home webui --no-open --port 0
memories-tray --home /path/to/development-home --no-open

--home / MEMORIES_HOME 使用与 CLI 相同的存储。没有覆盖设置时，启动器使用所选配置中的 storage_dir 或通常的每用户 Memories 主目录。--config PATH / MEMORIES_CONFIG 选择 TOML 文件；参见配置。--port 0（默认值）选择空闲的回环端口；指定端口也必须空闲。前台 webui 命令输出本地能力 URL，其中包含片段令牌。--no-open 禁止自动打开浏览器。托盘的打开状态仪表板菜单项可在之后打开它，即使配置中设置了 desktop.open_browser = false；--open 会明确覆盖该设置。--lang 选择托盘语言；浏览器最初跟随自身区域设置，并提供语言选择器。

状态与服务生命周期

托盘菜单显示离线、需要设置、已锁定或已解锁。启动守护进程在配套 CLI 守护进程不可用时启动它。此操作不初始化存储、不解锁，也不请求提权。照常在终端中使用 memories init、memories unlock 和 memories sudo。

页面每两秒刷新一次。解锁时显示库、活动代理和远程会话数量；已配置的云提供商类型；待上传和下载数量；已应用/已拒绝的传输；以及等待同步的库。状态投影不显示记忆文本、库名称、凭据、账户身份、文件路径或令牌。守护进程锁定或不可用时会清除库/同步详情。状态轮询不会让保险库保持解锁。

最近变更是当前浏览器页面打开期间观察到的内容，并非持久安全审计日志。离线状态可能表示守护进程已停止、忙碌时间超过探测期限，或版本不兼容。请同时升级 CLI 和守护进程，升级后重新启动守护进程。

退出托盘移除图标并停止该仪表板监听器。守护进程仍继续运行，包括从菜单启动的守护进程。对于前台 WebUI，Ctrl+C 关闭其监听器。程序不会自动注册登录启动项。每次单独启动使用独立端口和令牌。重启后要重新打开仪表板，请使用托盘菜单，而非旧书签 URL。

浏览器访问边界

仪表板仅绑定 127.0.0.1，供同一台计算机使用。每次启动使用新的随机访问令牌。浏览器从地址栏移除令牌，并仅为当前标签页会话保存它。状态请求需要该令牌，并通过 Host/Origin 检查。普通卡片编辑器使用相同检查和封闭的操作允许列表；没有 HTTP 解锁、提权、凭据交付、命令执行或通用 IPC 端点。启动 JSON 报告 read_only: false、status_read_only: true 和 card_editor: true，以区分卡片写入与只读状态投影。参见安全。

构建与打包

cargo build --workspace --release --locked 与 CLI、中继和 FFI 一起构建 memories-tray。Windows 软件包从干净且已提交的检出创建：

pwsh -File scripts/package-windows.ps1

在安装了 Rust、Xcode Command Line Tools 和 Python 3 的 macOS 主机上：

bash scripts/package-macos.sh

macOS 脚本构建主机架构（Apple Silicon 或 Intel），打包 Memories.app、CLI/中继/FFI 文件、所有受 Git 跟踪的 docs/、字体许可证、逐文件构建清单和归档校验和。它不会为分发签名或公证应用。Windows 构建不验证 macOS 运行时行为。请查阅验证，了解每次发布实际执行了哪些验证。

在 Linux GNU 主机上，bash scripts/build-linux.sh 构建发布工作区；bash scripts/package-linux.sh 从干净且已提交的检出创建 CLI/中继/FFI .tar.gz。参见 Linux 前提条件。使用 memories webui 打开仪表板；Linux 软件包不包含不受支持的原生托盘启动器。