它要解决的问题很小

看视频时被一句话击中,想记下来。原来的做法是: 打开笔记软件 → 新建笔记 → 复制链接 → 粘贴 → 保存。 五步,每一步都在把你从那句话里拽出来。 做到第五步的时候,刚才那个感觉已经没了 —— 于是干脆不记了。

原来的五步

  1. 打开笔记软件
  2. 新建笔记
  3. 复制链接
  4. 粘贴链接
  5. 写一句话…算了

结果是:大多数时候根本没记。

现在的一步

  1. 左键点一下工具栏图标

数据已经在库里了。想补一句话,再点提示上的「+ 补一句」。

bilibili.com/video/BV1xx… · 正在播放 3:20
工具栏图标 · 左键点一下
✓ 已记录  ⏱ 3:20 · 此页第 3 条
+ 补一句    撤销

图 1 · 点完立刻浮现提示条,5 秒后自动淡出;鼠标移上去倒计时会暂停

提示条上只有三块信息:✓ 已记录 表示存好了; ⏱ 3:20 是你点下去那一瞬间的播放位置;· 此页第 3 条 说明这个页面你已经记过几次。最后一块只有第二次起才出现,第一次不会来打扰你。

两条不肯让步的设计规矩

一 · 捕获时只填一句话,甚至可以不填。
看到触动的内容时,人是沉浸状态。多一个字段要填,就会放弃。 分类、标签、文件夹,全部延后到你回头整理的时候再说。
二 · 同一个视频看三次,永远只算一个目标。
归一化之后的 URL 在库里全局唯一,每次点击只是在同一个目标下新增一条带独立时间戳的记录。 所以「看了三遍、每遍都有新收获」这件事,在数据里是一条时间轴,不是三个重复的收藏。

它是怎么拼起来的

没有用什么大框架,两层:浏览器里一个 MV3 扩展负责采集,家里一台 NAS 上跑一个小服务负责存。 数据是 SQLite 单文件,就在自己的硬盘上。

扩展
Manifest V3,零构建。改动后在 edge://extensions 点一下刷新就生效。
页面内 UI
Shadow DOM + adoptedStyleSheets,不受目标网站样式和 CSP 干扰。
服务
Node + Hono,只用两个依赖;数据库走内置的 node:sqlite。
分层
routes → services → models 严格单向,SQL 只允许出现在 models 层。
去重
归一化在 lib/canonical.js,播放进度、追踪参数、会话 token 全部剥掉。
部署
Docker Compose + Caddy,跑在局域网飞牛 NAS 上;改代码用 sync.bat 一键上线。

AI 参与的部分

这个工具大部分代码的第一版不是我写的。我的工作更像是:把「我想要什么」说到足够具体, 然后在 AI 给出的东西里挑出「看起来对、其实不对」的地方。

  1. 先把需求说死。 不是「帮我做个书签工具」,而是「左键点图标就要存好,不许弹窗,不许暂停视频」。 这一步只能我自己来 —— AI 猜不出我有多懒。
  2. 让 AI 出第一版。 它通常一次就能给到能跑的程度,但几乎总有一两处边界情况是错的: 播放进度参与了去重、提示条挡住了按钮、或者某个参数在 URL 里没被剥掉。
  3. 逐段问「这里为什么这样」。 问到自己能复述为止。讲不清的那一段,往往就是后面会出问题的那一段。
  4. 用真实数据跑。 拿自己这一周真实看过的东西去点,而不是拿测试链接。 这一步是唯一不能交给 AI 的:它不知道我的库里到底长什么样。
TODO(等你的真实情况)。 上面是通用流程。如果你想写得更具体,可以补这三件事: 哪些模块一开始就是 AI 写的、你改动最大的是哪一块、有没有哪次 AI 给的方案把你带进了坑。 补的时候直接改这一节,长度不限。

踩过的坑

下面四个都是真花过时间的,不是「常见问题」清单。

1 · 有些 B 站视频读不到播放进度

部分播放器在 iframe 里,主文档拿不到 currentTime。 我的第一反应是想办法钻进去拿 —— 后来放弃了: 时间戳是加分项,不是保存的前提。 拿不到就不带 ⏱,记录照样存下来。为了一个可选字段去对抗浏览器安全模型,不划算。

2 · manifest 里故意不设 default_popup

这个坑很隐蔽:只要设了 default_popup,左键点图标就只会弹窗, 永远不会触发 onClicked。 而「不弹窗、点一下就走」正是这个工具的全部意义。 所以设置页只能放在「右键图标 → 选项」里,不能挂在图标上。

3 · Edge 重启后会悄悄把扩展停用

开发人员模式加载的扩展,重启 Edge 后可能被提示「停用开发人员模式扩展」并自动禁用。 扩展数据不会丢,但要手动回到 edge://extensions 点一下「启用」。 第一次遇到时我以为是代码坏了,查了半小时。

4 · 备份不能直接复制数据库文件

开着服务直接 cp know.db,可能拿到一个不一致的快照(WAL 模式下还有 -wal 文件没落盘)。 改成 SQLite 官方的 VACUUM INTO:服务运行时也能生成一致副本,顺便整理碎片。 现在有一条每天 03:00 的定时任务,只保留 7 份。

现在跑在哪

服务已经从我的笔记本挪到了一台局域网的 NAS 上,扩展里填上地址和一个 64 位令牌就能用。 改完代码不用手动登服务器:仓库根目录双击 sync.bat, 它只传有变化的文件,然后重建镜像、重启容器、等 /health 通过。

它现在只在局域网里,没暴露到公网。什么时候想放到公网,我大概会先把令牌、限流、 CORS 这几件事再重新想一遍 —— 那是另一个量级的问题。


想从哪看起

如果你也想用:从「装好它」开始,三篇连着看大约 20 分钟。 如果你更想知道这些东西是怎么被做出来的:翻日志里的「踩坑」标签。