用户手册

GravesDiary v0.1.1 — 与应用程序内附带的手册相同

1. 关于本手册

本手册介绍 GravesDiary 0.1:如何在其中书写、找到你写过的内容、保持日记私密,以及让日记在你的多台电脑之间保持一致。手册中不描述任何无法使用的功能;已有计划但尚未实现的功能,在末尾如实列出。

2. GravesDiary 是什么

一本私密日记。每篇日记都属于某一天。一篇日记有正文,还可以有标题、评分、心情、标签、提到的人物、地点,以及照片或其他文件。日记始终加密保存在你的电脑上,并且可以通过你已有的文件夹让多台电脑保持一致,无需账户,也不经过我们的任何服务器。

GravesDiary 不向 GravesWare 发送任何内容。参见隐私声明。

3. 入门

GravesDiary 第一次打开时,会询问如何保护日记。

使用密码

密码就是日记的钥匙。每次打开 GravesDiary 时都要输入它。没有密码,谁也打不开日记——如果你忘了密码,也包括你自己。GravesWare 无法重置或找回密码;没有后门。请选一个你记得住的密码,或者把它存放在安全的地方。

不使用密码

GravesDiary 会直接打开你的日记。日记仍然是加密的,所用密钥保存在这台电脑上,只有你的用户账户可以读取。这能保护日记文件的副本(比如备份里的那份),但挡不住任何能以你的身份登录你电脑的人。

之后你可以在“设置”中添加、更改或移除密码。

从备份开始

如果你在另一台电脑上已有日记,请改选“从备份恢复”,这样日记就来自备份文件,而不是从空白开始。参见备份。

4. 书写

这里的日记是一系列独立的日记条目,每篇都标有自己的日期和时间——而不是每天一长页。一天之内想写多少篇都行:早餐时写一篇,打完电话再写一篇,晚上又写一篇。

GravesDiary 打开时显示今天:今天的日记,并打开最新的一篇;如果今天还没有日记,则是一页空白。

新日记点击“新日记”按钮,或按 Ctrl+N。日记会标上当前时间,归入日历上选中的那一天,或者今天。在日历上右键点击某一天,可选择“在这一天写新日记”。
日期和时间日记顶部的日期和时间是它所记述的时刻,而不是你写下它的时刻。今天早上补记昨晚的事?把它们设为昨天晚上即可。在每篇日记都有时间之前写下的日记,会显示一条短横线,直到你设置时间为止。
标题可选。
文本在大的区域中输入。上方的工具栏用于设置格式:粗体、斜体、下划线和删除线;项目符号列表和编号列表;左对齐、居中和右对齐。先选格式再输入,输入的文字就采用该格式;或者先选中文本,再选格式来应用。Ctrl+B、Ctrl+I 和 Ctrl+U 也可以使用。当光标所在位置应用了相应格式时,粗体、斜体、下划线、删除线和列表按钮会呈按下状态。

从别处粘贴的文本会变成纯文本,不带原来的字体和颜色。
表情符号工具栏末尾的笑脸可打开表情符号选择器:数百个表情符号,分为九组——笑脸、人物、爱心与天空、动物与自然、食物、运动、旅行、物品和庆祝。点击其中一个,或用方向键移动并按 Enter,它就会插入到光标所在位置。选择器不保留你用过哪些表情符号的记录。
右键点击在文本中右键点击,可使用“剪切”“复制”“粘贴”和“全选”;粗体、斜体和下划线;两种列表;“插入日期和时间”,即在光标所在位置写入当前日期和时间;以及“插入表情符号”。按菜单键或 Shift+F10 可在光标处打开同一菜单。
保存没有“保存”按钮。GravesDiary 会在你停止输入片刻之后、打开另一篇日记之前以及你关闭它时保存。上次保存的时间显示在日记下方,旁边是字数。

完全空白的日记不会保留。

5. 详细信息

在文本下方:

评分一到五星。点击当前已有的评分可将其清除。
心情五张脸,从“很糟”到“很棒”。点击其中一张即可选择。
标签用来给日记归类的词——“假期, 工作”。用逗号分隔。
人物日记中提到的人,与标签分开保存,用逗号分隔。
地点你当时在哪里,用你自己的话写。
收藏日记顶部的心形图标。

照片和文件

“添加照片或文件”可附加任何不超过 50 MB 的文件。照片显示为缩略图;点击照片可查看原始大小,点击文件可保存副本。右键点击附件,可保存其副本或将其从日记中移除。

附件保存在加密的日记内部,而不是放在它旁边。你查看的照片直接从内存显示;它绝不会被写入临时文件,以免被其他程序找到。“保存副本”会在你选择的位置写入一份未加密的副本,因为这正是你要求的。

6. 查找日记

日历

侧边栏中的月历会在每个有日记的日子下方加一个圆点。点击某一天可查看当天的日记;如果当天没有日记,则开始写一篇。箭头用于切换月份;点击月份名称可回到本月。右键点击某一天,可选择“在这一天写新日记”或“显示这一天”。

时间线

中间一栏列出日记,最新的在前,每一天有一个标题,标明当天有多少篇日记。每篇日记显示其时间、标题(如果有)以及正文的开头。这一栏显示全部日记、某一天的日记,或你在侧边栏中选择的任何内容。

右键点击一篇日记,可以打开它、将它加入收藏或取消收藏、复制其文本(日期和时间在前)、导出或删除它。

搜索

时间线上方的搜索框可搜索标题、正文、标签和人物。你输入的每个词会匹配单词的开头(忽略重音符号),或文本中任意位置的该词:“lake walk”能找到提到 lakeside 和 walking 的日记,位于中文或日文文本中间的词也能找到。

历史上的今天

往年在今天这个日期写下的日记。

收藏、标签和人物

你用过的每个标签和人物都列在侧边栏中,并标明有多少篇日记带有它。点击其中一个即可查看这些日记。“全部日记”可回到全部内容。

删除

日记顶部的垃圾桶图标,或其右键菜单中的“删除”,会在询问确认后删除该日记。删除操作会同步:这篇日记会从共用你同步文件夹的每台电脑上移除,其文字不会保留在任何地方。此操作无法撤销。

7. 导出

侧边栏底部的导出按钮可将日记从日记中写出到你选择的文件:

导出内容这篇日记、时间线中显示的内容(某一天、一次搜索、一个标签),或整本日记。
格式网页 (.html),便于阅读和打印,其中包含照片;纯文本 (.txt);Markdown (.md),适用于笔记应用;或 JSON (.json),包含每篇日记的全部细节及其附件,便于存档或迁移到其他程序。

日记按从旧到新的顺序写出,每篇都列在其日期和时间之下。导出的文件并未加密:任何能打开它的人都能阅读,所以请把它存放在私密的地方。GravesDiary 不会把它发送到任何地方;它只写入你选择的位置。

8. 同步

GravesDiary 可以让你的日记在多台电脑上保持一致。它通过每台电脑都能看到的一个文件夹来实现:

- OneDrive、Dropbox 或 Google Drive 中的文件夹,且每台电脑上都装有该服务的应用;— 由 Syncthing 保持同步的文件夹;— 共享的网络文件夹。

没有 GravesDiary 账户,也没有 GravesWare 服务器。GravesDiary 把更改写入该文件夹,由你已在使用的服务把它们带到你的其他电脑上。

设置方法

  1. “设置”>“同步”。输入同步口令。
  2. 点击“选择文件夹”,然后选定文件夹。

在你的其他每台电脑上,用同一个文件夹和同一个口令重复上述操作。GravesDiary 会在你选择的文件夹里创建一个名为 GravesDiary 的文件夹。

同步口令与日记密码是分开的,每台电脑必须使用同一个同步口令。GravesDiary 写入该文件夹的一切都用它加密,所以存放该文件夹的服务无法读取你的日记。每台电脑只会询问一次。

如果不设口令,GravesDiary 会要求你确认,因为这样一来,文件夹中保存的日记就是可读的明文。

何时同步

打开时,你停止编辑约 20 秒后,每隔五分钟,你点击侧边栏角落的同步按钮时,以及关闭时再同步一次。侧边栏会显示上次同步的时间,或是什么妨碍了同步。

在两台电脑上同时进行的编辑

如果一篇日记在两台电脑上都被修改,而双方都还没看到对方的更改——一台在家里,一台在火车上——两个版本都会保留。较新的版本成为每台电脑上的这篇日记,另一个版本保留在它旁边。这篇日记会显示一条提示;点击“查看”可阅读另一个版本,如果你更喜欢它,再点击“使用此版本”。任何内容都不会被悄悄丢弃。

需要你做的事

让服务把文件复制完。在一台电脑上所做的更改,要等文件夹复制到其他电脑之后才会到达那里;GravesDiary 会等待尚未到达的文件,并如实告知。

不要把日记本身放进同步文件夹。GravesDiary 在每台电脑上把日记保存在它自己的位置,只把更改放进该文件夹,因为数据库在使用过程中被复制可能会损坏。

同步文件夹不是备份。在一台电脑上删除,就是在所有电脑上删除。参见备份。

9. 备份

一份备份就是一个包含整本日记的文件:每篇日记、每张照片和每个附加文件、你的标签和人物,以及你的设置。它是加密的,在任何装有 GravesDiary 并且有备份口令的电脑上都能打开。

“设置”>“备份与恢复”。

设置方法

选择一个文件夹。从这台电脑能看到的任何位置都可以:这台电脑上的文件夹、U 盘、外置硬盘,或由 OneDrive、Dropbox 或其他服务为你复制的文件夹。只存放在日记所在磁盘上的备份会随那块磁盘一起丢失,所以放在别处更好。

设置备份口令并输入两次。它与日记密码和同步口令都是分开的。每份备份都用它加密;在备份文件和捡到 U 盘的人之间,只隔着这一道口令,所以它必须足够强:

  • 至少 12 个字符
  • 一个大写字母和一个小写字母
  • 至少 2 个数字
  • 至少 2 个特殊字符,例如 — ! ? # 或 @

你输入时,窗口会逐项打勾。用符号和一个数字把几个互不相关的词连起来,既足够强,又比一串短而杂乱的替换字符更容易记住。

忘记的备份口令绝对无法找回。没有它,任何人都无法打开备份,包括 GravesWare。请把它写下来,并存放在备份盘以外的地方。

制作备份

“立即备份”会马上制作一份备份。此时不会询问口令:口令只在设置时需要一次。

勾选“每天自动备份一次”后,如果上一份备份已超过一天,GravesDiary 会在打开时制作一份备份。如果文件夹不在——比如驱动器已拔出——它会跳过这一天,不打扰你,下次打开时再试。窗口会显示上一份备份的制作时间;要确认备份确实在进行,就看这里。

每份备份都是一个新文件,以制作时刻命名,例如 GravesDiary-20261002-193000.gdbackup。保留最新的十份,更早的会被移除。文件夹中的其他文件绝不会被改动。

还原

在这台电脑上:“设置”>“备份与恢复”>“从备份恢复”。在新电脑上:在 GravesDiary 显示的第一个窗口中选择“从备份恢复”。

选择备份文件,并输入制作它时所用的口令。你可以为恢复后的日记设置密码,也可以留空以便不使用密码打开;备份不带有旧日记的密码。

在改动这台电脑上的任何内容之前,备份会先从头到尾检查一遍。口令错误,或者文件已损坏或不完整,都会被拒绝,你的日记会保持原样。

备份中的日记会取代这台电脑上的日记。从“设置”中恢复时,GravesDiary 会关闭,你再次打开它时恢复即告完成。被取代的日记会作为安全副本,以 diary.db.before-restore 为名保留在日记文件夹中,直到下一次恢复。

恢复后的日记保留其备份设置,所以下一份备份使用同一个口令。如果你使用同步,它会继续使用同一个文件夹,备份制作之后写下并已同步的内容都会从中恢复回来。在同步文件夹位于别处的新电脑上,请在“设置”中重新选择它。

更改口令

在同一个窗口中设置新口令。此后制作的备份使用新口令。此前制作的备份仍使用制作时的口令,因为每个备份文件都带着自己的锁。

备份会透露什么

内容用 AES-256 加密。文件的名称、大小和日期则没有加密,所以任何看到该文件夹的人都能看出其中有一份 GravesDiary 备份、它是何时制作的,以及日记大致有多大。

10. 保护日记安全

Windows%LOCALAPPDATA%\GravesDiary\
Linux~/.local/share/GravesDiary/

Microsoft Store 版本的 GravesDiary 把该文件夹放在 Windows 存放所有 Store 应用数据的位置,卸载 GravesDiary 时 Windows 会将其删除。如果你要卸载从 Store 获取的 GravesDiary,请先备份到你自己选择的文件夹,这样才能把日记找回来。同步文件夹里也有你的日记,但备份是把整本日记放在一个文件里。参见备份。

11. 语言

GravesDiary 支持 55 种语言。“设置”>“语言”中以各语言自己的文字列出每种语言;所选语言在 GravesDiary 下次启动时生效。阿拉伯语、波斯语、乌尔都语、信德语和维吾尔语会让整个窗口从右到左布局。在正文中,每个段落按其自身文字的方向排列,所以一篇日记可以混用多种语言。

本手册、许可协议和隐私声明均为英文。

12. 无障碍功能

屏幕阅读器

每个可操作的控件都带有屏幕阅读器能够读出的名称,包括星级、心情和格式按钮。每次构建都会自动检查这一点:只要有控件无法被读出,构建就会失败。

键盘

Ctrl+N 新建一篇日记,F1 打开“关于”。在文本中,Ctrl+B、Ctrl+I 和 Ctrl+U 用于设置格式,菜单键或 Shift+F10 打开右键菜单。菜单和表情符号选择器用方向键移动,按 Enter 选择,按 Escape 关闭。对话框按 Escape 关闭,其默认按钮响应 Enter。

颜色与对比度

GravesDiary 采用 GravesWare 的配色,并跟随系统的浅色或深色设置。当系统设为高对比度时,GravesDiary 会放下自己的配色,改用朴素的系统主题。

尺寸

按钮和文本框的高度至少为 44 像素,这是指针、手指或不太稳的手都能舒适操作的最小尺寸。GravesDiary 在 Windows 上声明自己支持显示缩放,所以在 150% 或 200% 下依然清晰。

13. 本版本尚未提供的功能

已在计划中,但在能用之前不作宣称:导出为 PDF 和 Word(导出的网页可以打印,浏览器也能将其另存为 PDF);从其他日记应用导入;模板;追踪记录;统计;提醒;当前位置和天气;地图和照片库;正文中的标题、引用和颜色。

14. 支持

GravesWare, LLC
support@gravesware.com

该地址也在“关于”页面上(侧边栏中的 i 按钮),那里还有一个“发送电子邮件给支持团队”按钮,可打开你自己的邮件程序,并已填好地址和你的版本号。在你发送之前,不会发出任何内容。

请说明你运行的是哪个版本(“关于”页面上有显示)以及哪个操作系统。绝不要发送你的日记、密码或同步口令。