这篇只做一件事:让你在十分钟内发出一生中第一条 KNOW 记录。 如果只想记住一句话,那就是 —— 左键点一下工具栏图标,完事。

先说清楚它把什么变简单了

我以前存东西的流程是:看到好内容 → 打开笔记软件 → 新建笔记 → 复制链接 → 粘贴 → 保存。 五步,每一步都在打断我正在看的东西。所以最后我根本不存。

KNOW 把这五步压成一步:点一下。 没有弹窗、不会暂停视频、不跳页,五秒后提示自己消失。

装之前,先确认两件事

  • 一个 Chromium 内核的浏览器(Edge 或 Chrome 都行)
  • 服务已经跑起来了,并且你知道它的地址(自己电脑上是 http://127.0.0.1:9787,我这里是局域网 NAS 上的地址)

装扩展

以 Edge 为例。它比 Chrome 多两个坑,所以我直接写 Edge 的走法。

  1. 地址栏输入 edge://extensions 回车。
  2. 左侧栏最下方打开「开发人员模式」开关。 打开之后,页面顶部才会出现「加载解压缩的扩展」按钮 —— 很多人卡在这一步,因为按钮一开始是看不见的。
  3. 点「加载解压缩的扩展」,选中项目里的 extension 文件夹。
  4. 把它显示到工具栏:点地址栏右侧的扩展图标(拼图形状)→ 找到 KNOW → 点右侧的「显示在工具栏中」。 不显示到工具栏的话,你每次都要多点两下,那就违背了这个工具的初衷。
  5. 地址栏右边出现一个蓝色圆角方块 + 白色书签的图标,就说明装好了。

填令牌

扩展没有弹窗,所以设置入口不在图标上: 右键工具栏的 KNOW 图标 → 「选项」。

  1. 「服务地址」填服务所在的位置。
  2. 「访问令牌」粘贴那一串 64 位字符(在服务端的 data/token.txt 里,控制台启动时也会打印)。
  3. 先点「测试连接」,看到通了再点「保存」。
如果换了服务地址,必须点一下「授权访问该地址」再保存 —— 否则浏览器不允许扩展访问新的域名,你会一直看到"连不上"。

发出第一条记录

随便打开一个视频或一篇文章,左键点一下工具栏图标。 页面右下角会浮出一条提示,像这样:

任意网页 · 视频播放到 3:20
左键点一下这个图标
✓ 已记录  ⏱ 3:20 · 此页第 3 条
+ 补一句    撤销

图 1 · 提示条长这样。它不会拦住页面,5 秒后自己淡出。

提示条上的三块信息

元素含义什么时候出现
✓ 已记录保存成功,数据已经在库里了总是
⏱ 3:20你点下去那一瞬间,视频播放到第几秒抓得到播放进度时
· 此页第 3 条这个页面你已经记过几次(含这次)第二次起才显示

想补一句话:+ 补一句

点「+ 补一句」,输入框会原地展开。写完点「保存」或直接回车,提示变成 ✓ 已补上。

不想写了?点「取消」或按 Esc 就收起来,已经存好的那条不受影响。 一条只有链接和时间点的记录,同样有价值 —— 这一点后面会反复提到。

提示默认 5 秒后消失。想慢慢打字,把鼠标移到提示条上,倒计时就会暂停。

「撤销」和「删除」不是一回事

提示上的「撤销」是直接删掉刚才那条,不进回收站、不可恢复。 而网页端 /debug 里的「🗑 删除」是软删除,会进回收站,随时能找回。

如果你正开着「补一句」输入框再点「撤销」,等于「放弃这句话 + 删掉这条记录」, 并且会顺手在新窗口打开调试页,方便你继续处理。

装不上时先看这两条

工具栏里找不到图标

Chrome / Edge 会把新装的扩展收进扩展菜单里。点地址栏右侧的拼图图标 → 在 KNOW 那一行点「显示在工具栏中」(Chrome 是图钉 📌)。

重启浏览器后扩展被自动停用

Edge 有时会提示「停用开发人员模式扩展」并把它禁用。数据不会丢, 回到 edge://extensions 点一下「启用」即可。 第一次遇到时我以为是代码坏了,查了半小时 —— 现在提前告诉你。