随手记系统

1. 全图：一条随手记走过的路
2. 记录端：不造应用，用开源的客户端
3. 服务：本机一个服务是唯一写入端
4. 镜像：每条一个文件，每分钟同步一次
5. 日记：每晚只挂引用，不复制正文
6. 视图：在笔记软件里看卡片，也在那里记
7. Harness：六项工程，每项约束一层
8. 演化：两个晚上，九处改口
9. 现状：分三档说

全图：一条随手记走过的路

一条随手记从记下，到进日记、在卡片墙里能回看，经过四站，每站只做一件事。

让它不毁我的东西、不让我等的工程有六项，见 Harness 一节。

记录端：不造应用，用开源的客户端

想记的时候打开就能记：两个记录端各用一个现成的开源客户端，各自能离线。

• 手机：Moe Memos，Memos 的开源 iOS 客户端。登录只收服务器地址加访问令牌。
  • 新建先存手机本地，再排队上传。断网能记。
  • 上传时带原始记录时间。断网时记的一条，联网后补传，时间仍是记下时的时间。
  • 锁屏小组件直达新建。一条快捷指令不开应用就能存。
• 电脑：一个浏览器应用窗口，打开本机的服务地址。服务就跑在这台电脑上，不依赖外网。

「没网也能记」不靠管道，靠两个记录端各自的离线能力。

• 手机端离线由客户端自己做：本地先存，联网推送。
• 电脑端离线由服务位置决定：服务在本机，本机地址不需要网。
• 我在 2026-09-15 20:57 断网记了一条，联网后自动上传，进了文件夹。

服务版本锁在 0.30.0，锁的理由在手机端。

• 手机客户端只支持服务的 0.27 到 0.30 版。
• 升级服务之前先查客户端的兼容表。这一条写在项目说明里。

服务：本机一个服务是唯一写入端

记下的每一条只存一处、只由一处管：我电脑上的一个 Memos 服务。文件夹里的镜像因此永远和它对得上。

• 服务跑在本机的一个 Docker 容器里，只监听本机地址。
• Docker 开机自启。原来是关的，电脑重启后服务会不在线，我改成开。
• 本机原来有一个 2025-11 装的旧实例，没有记录。我另起了新实例，旧实例没删。

数据库放在文件夹外面，不放在被云盘同步的文件夹里。

• 我的文件夹由云盘同步。一个正在写入的数据库文件被同步盘搬动会损坏。
• 所以数据库、同步状态、日志都放在用户目录下一个独立位置。文件夹里只有镜像出来的纯文本。
• 同步脚本每分钟写一次日志。日志不进文件夹，理由相同：云盘每分钟搬日志。

手机连服务走私有网络，不上公网。

• 手机和电脑在同一张私有网络里（Tailscale），服务只对这张网可达。
• 电脑保持常醒，当服务器用。
• 不上公网的理由：零成本，不需要证书，不需要暴露端口。

唯一写入端这条约束落在三个位置。

• 同步脚本只从服务读，只往文件写，从不往服务写。
• 进日记脚本只读文件，不碰服务，不改文件。
• 视图里的输入框把内容发到服务，不直接写文件。见视图一节。

镜像：每条一个文件，每分钟同步一次

记下一分钟内，这一条就是我文件夹里的一个纯文本文件，AI 和知识库从这里接上它：同步脚本每 60 秒跑一次，把服务里的每条随手记写成一个文件，落在收件箱。

• 脚本只用编程语言的标准库，不装任何依赖。
• 文件名是记录日期、时间加一个短编号。文件头记服务里的编号、创建时间、标签、开头一句、来源。
• 附件下载到收件箱的一个子文件夹，图片、视频、音频在正文里嵌入显示。
• 归档的随手记也镜像，文件头加一个归档标记。

每条一个文件，不按天合并。

• 我推翻了「按天聚合成一个文件」的建议，选每条一个文件。
• 理由落在下游：日记能逐条引用；视图能每条一张卡片；一条随手记能单独被改名、被处理、被归进知识库，不牵连同一天的其他条。

先进收件箱，不直接进日记。

• 随手记是未整理的收集，和抓取来的文章并列，都放收件箱。
• 日记只引用它，不保存它。整理和归档在收件箱里另外发生。

同步规则以「不毁我的东西」为先，五条。

删除一个文件要同时满足三件事。

• 服务里确实没有这条了。
• 文件自上次写入没被动过。
• 这次从服务拉到的不是空结果。
• 代价：把服务里最后几条全删光时，对应文件要等我再记一条新的才会被删。我接受这个代价。

改动检测用内容指纹，不用服务给的更新时间。指纹是把一条的内容算成一个短码，内容一变短码就变。

• 服务的更新时间只精确到秒。同一秒内的两次改动，靠时间判不出来。
• 指纹取正文、标签、置顶、状态、附件、更新时间一起算。
• 这一条是测试暴露的。当晚暴露的两个问题都不是逻辑写错，是对数据的假设错：时间戳的精度，空结果的含义。

脚本上线前在临时目录跑了九种情况，再在真实收件箱跑一遍确认走通。

• 九种情况：新建、更新、改名、本地改、移走、归档、删除、空结果、连不上。
• 拉取失败直接退出，不做任何写和删。
• 写文件先写临时文件再改名，不留半个文件。

日记：每晚只挂引用，不复制正文

白天想过什么，晚上自动出现在当天的日记里：进日记脚本每天 22:50 跑一次，在日记里加一段「随手记」，每条一行时间加一个引用。日记每天一份，是文件夹里的一个文件。

• 引用是笔记软件的嵌入语法，日记里显示正文，正文只存在收件箱那一份。
• 不复制正文的理由：正文要改去服务里改，镜像跟着变，日记跟着变。复制会产生第二份正文。
• 当天没有随手记就不建日记文件，不留空段。

备选的两个方案我都否了，选了第三个。

• 方案一：进日记后给源文件加「已处理」标记。
• 方案二：进日记后删源文件。
• 我选的：只放引用，源文件不动。比前两个都简单，源文件留在收件箱等整理。

「随手记」段放在「今日记录」段之前，位置由另一个程序决定。

• 每晚 23:00 有一个自动写日记的程序。它只要看到「今日记录」下面有字，就当今天已经写过，整篇跳过。
• 随手记如果写进「今日记录」，23:00 的程序会被挡掉。所以放在它前面，22:50 跑，赶在它之前。
• 23:00 的程序正在跑时（它留下的运行标记还在），本脚本跳过本次，不抢同一个文件。

每晚重算最近七天，不只写今天。

• 断网后晚传上来的，下一晚补进它记下那天。
• 服务里删掉的，下一晚从日记里移掉。
• 22:50 之后记的，第二晚补进前一天。
• 只改两个注释标记之间的内容，标记外一字不动。

视图：在笔记软件里看卡片，也在那里记

回看在这里：笔记软件里一面卡片墙，按天看、按标签筛、随机回顾。插件读收件箱里的随手记文件，不改名、不删任何文件。

• 按天分组的卡片：全文、图片、标签。置顶在前。
• 卡片上的任务复选框勾一下就是真勾上，写回文件里的那一行。这是插件唯一直接改文件的动作。之前点了只是翻个样子，一刷新就回去，2026-09-17 改成真写。
• 左栏：笔记数、标签数、天数；热力图，默认近十六周，点某一天筛选；标签树，带层级的标签按层级显示。
• 搜索。随机回顾，每次抽五条。正文里的标签点了就是筛选。
• 常驻左侧边栏，图标是灯泡。手动拖到哪就留在哪，插件启动时不拽回来。

界面见首屏截图；那张图按「反脆弱」标签筛出了一天的五条。

视图顶上有一个输入框，记的一条发回服务，不写文件。

• 输入框发到服务，随即触发一次同步，几秒后卡片出现在列表。
• 不直接写文件的理由：服务是唯一写入端。插件如果直接写文件，同步脚本会把那个文件当成「本地改过」，从此不再更新它。
• 访问令牌从文件夹外面的位置读，不存进插件设置。
• 记下后立即显示一张「同步中」卡片，同步回来按编号换成正式卡片。发送失败内容留在输入框。
• 快捷键通过软件自己的快捷键设置注册。直接监听按键收不到：软件默认把这个组合键分给了另一个动作。

性能红线：打开和记下都在三秒内。红线落在四条写法上。

• 起因：记下一条后「记录中」卡了一分钟。根因是我写的插件按整个文件夹遍历，这个文件夹在软件里可见的文件数见下面的数字。
• 四条写法：
  • 读随手记直接读收件箱那一个文件夹，不等软件给整个文件夹建完索引。
  • 文件列表里的标题只查随手记文件的条目，不遍历全部条目。
  • 文件事件等布局就绪后再监听。启动时每个文件都会发一次事件。
  • 发送请求十五秒超时。
• 同步任务的最小启动间隔从系统默认的十秒改为一秒。连记两条时，第二条原来要等近十秒。
• 不在插件能力内的：软件冷启动要扫整个文件夹，插件要等它扫完才加载。要快只能给文件夹瘦身，这是我的项目结构，插件不动它。

文件列表里显示开头一句，文件名不动。

• 同步脚本在文件头写一个「开头一句」字段。
• 插件只改文件列表里的显示文字，不改文件名。改名时自动换回真实文件名，防止把开头一句误当成新文件名。
• 这一处依赖软件的非公开结构。软件升级后若失效，现象是列表又显示编号文件名。插件设置里可关。

Harness：六项工程，每项约束一层

harness 不产出内容，只让产出稳定：谁能写、往哪个方向写、什么情况不许删、打开要多快，每一条都落在管道上一个具体位置。

演化：两个晚上，九处改口

从起念到全链路打通用了一个晚上，之后的改动全部来自我用了一次之后的纠正。

没变的是管道的三条约束，变的是界面上的每一处。

• 没变：服务是唯一写入端，文件是单向镜像，每条一个文件。三条从第一个晚上定下后没动过。
• 变的：进日记的方式，视图的位置、图标、输入框、性能写法。每一处都是我用了一次之后改的。
• 两个晚上里改动最大的一次纠正是三秒红线。它把插件的写法从「用软件的索引」改成「直接读收件箱那一个文件夹」。

现状：分三档说

写这一页的日期是 2026-09-17。系统建成两天，三档分开说，不混。

在跑，有真实使用记录

• 同步任务每 60 秒跑一次，从 09-15 20:34 起在跑，最近一次写入 09-17 10:39，错误日志零行。
• 进日记任务 09-16 22:50 第一次按点自动跑，把两天的随手记引用挂进了两天的日记。
• 手机客户端已登录，三天里每天都有随手记落成文件。断网记录在真机上测过一次。
• 视图装在我的笔记软件里，输入框、搜索、随机回顾、热力图筛选、文件列表标题在真机上验证过。

建了，不常跑或没走通

• 附件下载：代码在，三天里零个附件，没有真实走过。
• 同步规则里的本地改过不覆盖、移走不复活、空结果不删：在临时目录测过，真实收件箱里还没发生过这些情况。
• 归档状态的镜像：代码在，没有真实归档过一条。
• 电脑上的网页窗口建了，没有使用记录可查：服务不记录一条随手记从哪个入口进来。

设计中或未测得

• 文件多起来之后视图的性能没测过。现在只有十五条。
• 文件列表标题依赖软件的非公开结构，软件升级后是否仍有效未测。
• 给文件夹瘦身以缩短软件冷启动，只是建议，没做。

数字只报能证明系统真实存在的。

随手记落进的收件箱和日记，是作品一里记忆层的一部分。这个视图的做法之后被信息获取系统的收件箱视图沿用。它背后的想法怎么来的，见思考。