跳转到内容

快速开始

本文带你完成 Snow Cues 的第一次使用。从准备运行环境,到新建存储数据、进入空间、创建并保存第一条密码。

推荐打开 Snow Cues 的官方 HTTPS 正式地址,或使用由该地址安装的 PWA。Snow Cues 也支持自部署,但自部署环境需要提供可信 HTTPS。

正式使用建议选择 Chrome、Edge 等 Chromium 系浏览器。Snow Cues 依赖浏览器原生 WebCrypto 能力;其他浏览器可能因为 WebCrypto、File System Access API 或安全上下文差异,出现无法加密、无法保存或敏感操作被阻断的问题。

桌面本地开发可使用 localhost127.0.0.1

首次使用时,新建 storageData。已有数据时,打开原来的 storageData 文件夹或导入 current.json

storageData 是 Snow Cues 的业务数据文件夹,也是唯一业务数据源。它通常包含:

  • current.json:当前正式数据。
  • revisions/:历史快照。
  • drafts/:用户导出的草稿。
  • conflicts/:保存冲突时生成的候选文件。

输入空间 ID 进入空间。空间 ID 会被规范化处理(去除首尾空白并转为小写)。空白新空间会先作为临时空间存在。

空间主密码用于建立当前浏览器内存会话。它不会写入 storageData,也不会作为可找回材料保存。

新建密码前,需要确认空间规则链。默认规则链适合普通使用,它的顺序是「稳定 HMAC → 增强 PBKDF2」。

规则链是空间级配置,不是单条密码字段。自定义 Rule 只能使用声明式 JSON 映射到允许的内置算法模板,不能导入或执行 JavaScript 代码。第一次使用如果没有特殊需求,建议先使用默认规则链。

默认规则链通常是 ["v1-hmac", "v2-pbkdf2"],对应「稳定 HMAC → 增强 PBKDF2」。如果要导入自己的 Rule,需要进入「规则管理」,粘贴声明式 JSON,导入成功后再勾选要加入规则链的规则并确认初始化。

更多说明见:核心概念:规则链

填写平台、关键密钥和可选记忆提示。创建成功后,条目相关材料会进入内存草稿。

关键密钥是每条密码单独需要的输入,创建密码和解密密码都必须输入。它不会被保存。

点击「保存存储数据」,检查摘要 diff 后确认保存。

不要把未保存的草稿当作已经落盘的数据。Snow Cues 不会在每次操作后自动写入业务文件,保存必须由你显式触发。

进入空间后,如果空间已有密码,需要通过一条已知关键密钥的密码完成本次空间校验。解密单条密码时仍需要输入该条目的关键密钥。

  • 空间主密码不会保存,也无法找回。
  • 每条密码的关键密钥不会保存,也无法找回。
  • 记忆提示会加密保存,但它不能自动恢复关键密钥。
  • 清理浏览器数据或换设备前,应先导出备份。