把网页以 Markdown 存进你的保险库。
一个浏览器扩展，把你正在读的页面——或者仅仅是你选中的那一段——剪进跑在你自己机器上的 Altretta 应用。剪藏抵达时是待审收件箱里的一份提议，而不是保险库里的一条笔记。
一次点击，一个 Markdown 文件，附着它的出处。
扩展读取你当前标签页里的页面，剥掉正文周围的导航和广告，把剩下的转成 Markdown。
剪藏整页
正文的提取方式与阅读模式一致，所以留下的是文字，丢掉的是那些摆设。遇到抗拒提取的页面，扩展会退回整个正文，并且明确告诉你它这么做了，而不是默不作声地存下一份比你预期单薄的东西。
只剪选中的部分
先选中文字，第二个按钮就会亮起。只有被选中的 HTML 会被转换，所以你想引用的那一段，不会裹着整个页面一起送来。
纯 Markdown，没有私有格式
结果和你保险库里其他每一条笔记一样，是个 Markdown 文件。没有剪藏专用格式，日后也没有什么要导出。
出处一路跟着它
每一份剪藏都带着 front matter，写明它出自哪个页面、什么时候剪的、处于待审状态，以及一个 web-clip 标签——页面若写明了作者、站名和发布日期，也一并带上。
一份剪藏是提议，不是笔记。
扩展把剪藏以待审状态暂存在你保险库的收件箱文件夹里。它不会被建索引，不会进入你的语义图谱，也不会被签名。在你打开应用并批准之前，它的任何部分都不会成为你知识库的一部分。
为什么恰恰是网页剪藏最需要一个收件箱
剪藏工具是把还没读过的材料塞满知识库的最快途径。让它直接写进你的笔记，就意味着你自己的保险库——你的 AI 据以作答的那个东西——会悄悄被一堆你只是打算读读的网页填满。所以剪藏去的是 AI 提议该去的地方：待审收件箱，在一个人的判断之后。
- 扩展从不签名，也从不写入图谱。它的职责到「已暂存」为止。
- 批准才是那个要担责的动作，而被记为一次带签名行为的，也正是批准这一步。
- 拒绝会把提议归档，而不是删除。
- 同一个未改动的页面剪第二次，会被认出来，而不是复制一份。
在应用里生成一个令牌，粘进扩展。
没有账户，没有登录，也没有一步要经过云端。扩展与你自己机器上的 Altretta 应用通信，而令牌就是它被允许这么做的凭据。
打开应用的连接设置
设置，然后是「AI 与连接」，然后是「外部助手」一节。那里有一个专门给网页剪藏的区块。
复制端点和令牌
端点地址会带一个复制按钮显示出来。按下「获取配对令牌」，应用就会签发一个标记为剪藏专用的令牌，你可以把它显示出来并复制。
把两样都粘进扩展
打开扩展的选项页——尚未配对时，弹窗里有通往它的链接——把端点和令牌粘在那里。
先测试连接，再保存
「测试连接」会与应用完成一次真实握手，并回报是哪个服务端应答的。如果应用没在运行，它会当场告诉你，而不是等到你第一次剪藏时才失败。
令牌保存在那台机器上浏览器自己的扩展存储里。它不会同步到任何地方，而在应用里吊销它，就足以终止这次配对。
目前是 Chromium 浏览器。
扩展按 Manifest V3 标准、针对 Chromium 扩展 API 构建，安装步骤也是照着 Chrome 和 Edge 的扩展页写的。
Chrome 与 Edge
两者读的是同一份 manifest，也都提供下面用到的开发者模式安装。其他提供同样页面的 Chromium 浏览器很可能也能用，但它们不是我们测过的对象，所以我们不作保证。
Firefox 与 Safari
不支持。扩展既没有 Firefox 附加组件身份，也没有 Safari 打包，所以那边暂时根本没有东西可装——这是一个待补的缺口，不是一个决定。
先下载，再以解压方式加载。
剪藏工具随应用的每一次发布一同发布，是一个 zip，放在安装包所在的同一个下载主机上。目前还没有商店上架，所以装好它是两步，而不是一个按钮。
获取扩展
一个压缩包，由构建应用的同一次发布一并构建和发布。文件名里的版本就是它随行的应用版本，也被写进了扩展本身——所以浏览器扩展页上显示的那个号码，就是你报告问题时该引用的号码。
下载扩展版本 0.9.4 · Altretta_0.9.4_web-clipper.zip
解压到一个你愿意让它长住的地方。浏览器每次启动都会从那个文件夹读取扩展，所以移动或删除文件夹就等于卸载了它。
把它加载进浏览器
zip 的安装方式是「加载已解压的扩展程序」，这是浏览器的一项功能，不是什么变通办法：
- 01下载上面的压缩包，解压到一个你打算保留的文件夹。
- 02打开浏览器的扩展程序页面。
- 03打开开发者模式。
- 04选择「加载已解压的扩展程序」，选中你解压出来的那个文件夹。
- 05用上面的令牌与应用配对。
以解压方式安装的扩展会一直装着，直到你自己移除它，而且重启浏览器后仍保留配对令牌。
有新版本发布时
以解压方式安装的扩展不会自我更新。你的浏览器会无限期地跑着那个文件夹里的副本，也没有任何东西会告诉你已经有更新的了——正因如此，这一段才写在这里，而不是被默认为常识。应用更新时，回到本页，下载新的压缩包，覆盖解压到同一个文件夹，然后在浏览器扩展页上按下该扩展的「重新加载」。这就是没有商店上架所要付的代价，每次发布付一次。
仍然没有商店上架
剪藏工具没有上架 Chrome 网上应用店，也没有上架 Edge 加载项目录。上架能让安装变成一次点击、更新变成自动；今天存在的是一个 zip，本页余下的部分也都是照着这个 zip 写的。
它够得到你的机器，此外什么都够不到。
只有一个目的地
扩展只被允许访问回环地址——也就是它所安装的那台电脑上的应用。它没有分析功能，不从 CDN 加载任何东西，也不发出其他任何网络请求。
你当前所在的标签页
你按下按钮时它才读取当前标签页，也只在那一刻读。它不会在后台跑在各个页面上，也不会盯着你浏览了什么。
你磁盘上，你自己的保险库
剪藏会作为一个你用任何编辑器都能打开的文件，写进你自己的保险库文件夹。没有任何东西被上传，与它相关的一切也都不会离开这台机器。