思源 QuickAdd

动作原理很简单，就是调用了一下思源的 API，之前看到思源群里有老铁希望加一个类似速记的功能，所以产生了做一个动作实现的想法。不过大佬们应该都在忙着硬刚挂件，我就先做一个，希望能够抛砖引玉 😂

动作链接：QuickAdd - 动作信息 - Quicker (getquicker.net)

22 版动作：QuickAdd.zip

主要功能：

添加速记内容到思源当天日记最前或最后
支持发送到常用文档
支持截图、截图 OCR
生成 B 站视频时间戳、PotPlayer 时间戳
支持模糊搜索思源中的文档和标题

视频时间戳：

支持本地视频、B 站视频、YouTube 视频三种使用场景。作为暂时性方案，更推荐直接使用。

B 站时间戳：

本地视频（PotPlayer）：

　　有三种生成方式可以自由选择：

在 assets 文件夹下生成.bat 脚本文件，发送文件链接到思源
生成 quicker 外部调用的链接
生成字段供划选使用

右键设置菜单

自定义按键

对应“屏幕截图”、“截图 OCR”、“发送为列表块”、“发送为超级块”五个功能的辅助按键。

在使用动作前按下辅助按键就可以启用对应功能。可以通过右侧的小键盘选择对应按键。

增删格式

右键动作，“新增格式”。输入自己需要的格式，即可新增格式。支持的格式：“年”、“月“、”日”、“星期“作为关键词，可以自由组合

右键动作，“删除格式”。选择需要删除的格式，即可删除指定格式。

增删文档：

和发送文档配合使用。设置常用文档，可以选择发送的不同文档。可用于专题笔记（比如书籍对应的思源文档或者考试突击……）

选择新增，在输入框输入文档名或文档 ID。如果对应文档是唯一的，直接添加到文档列表里；如果对应文档不唯一，可以选择需要的文档

右键动态菜单

OCR 常驻：

选择后每次启用动作默认采用 OCR 模式

OCR 接口：

有两个接口，Win10 接口和百度接口（需要配置 OCR 的 API）

插入位置选项：

选择插入前置子块，插入到文档最前方；选择插入后置子块，插入到文档最后

发送格式：

选择默认的发送格式。支持列表格式和超级块格式。两种格式的差别参考：发送逻辑。

引文作为笔记：

选择将选中文本作为引用内容还是作为笔记内容。如果禁用此功能，会给选中的文本添加引用符号，发送到思源后为引用块样式；如果启用此功能，会将选中内容作为正常输入的笔记。

动作配置

初次使用动作或者右键动作选择“填写表单”会出现如下配置界面。虽然看着有很多不过很多都是非必填的内容。下面简单介绍一下哪些是必填的，非必填的适用于什么场景。

APIToken：

思源 API 的 token，本地使用不用填写。

PPPath：

PotPlayer 的程序路径。可以把鼠标移到输入框右侧，选择“已安装的软件”，选择 PotPlayer 即可。也可以输入 PotPlayer 的 exe 文件路径。

如果不使用 PotPlayer 的本地时间戳功能，这里不用填。

SMPath：

Supermemo 收藏的路径。比如这个就是：L:\Supermemo\sm18\systems\Read

如果不使用 Supermemo，这里不用填。

bxnPath：

BookxNote 的 Note 文件夹的路径。在 BookxNote 选项中找。

如果不使用 BookxNote，这里不用填。

assetsPath：

思源 assets 文件夹路径。比如说这个就是：G:\Siyuan\data\assets

Path：

日记路径开头必须有 “/”，只支持 “年” 和 “月” 的搭配，搭配的具体格式看自己的是怎么设置的。

下面举几个例子：

日记为默认路径：/daily note/年/月；

日记为如下路径：/年/年-月；

mouldPath：

日记模板的路径，精确到.md 文件

如果日记不使用模板不用填。

docSeat：

设置新建文档的存放位置。如果有在日记下设置类似“Inbox”的文档的老铁可以在这里输入“Inbox”文档的文档 ID。用于定位没有搜索到信息时选择新建文档的位置，思源划词搜索新建文档位置同理。

对应文档树或者笔记本设置中“块引新建文档存放位置”

clipperID：

用户保存剪藏网页的本地链接，防止被作为未引用资源删除。

不建议使用，不建议填写。

From：

日记格式，默认选项为“年-月-日”和“年-月-日星期”。一般来说是够用了，如果有自定义格式可以通过“增加格式”自行添加，支持“年”、“月“、”日”、“星期“作为关键词，可以自由组合。

boxName：

日记笔记本的名称。前几版动作经常有老铁反馈输入笔记本名会报错，就在最新版增加了选择项。可以自行选择日记日记笔记本。

ApiKey、SecretKey：

有两个，一个是百度 OCR 的 ApiKey、SecretKey。另一个是百度语义分析的 ApiKey、SecretKey。

百度 OCR 申请教程参考：截图 OCR 申请 API KEY 教程

百度语义分析教程参考：获取超链接

百度 OCR 使用场景：截图 OCR，默认的 Win10 借口精度比较低，如果对精度有需求可以申请

百度语义分析使用场景：网页摘录溯源。效果同：获取超链接

ocrSave：

选择 OCR 后是否保留 OCR 图片。选中为保存，不选为不保存

PotPlayer 配置：

设置以下快捷键

BookxNote 配置：

速记功能

支持多段文本输入，换行、Tab 缩进逻辑同思源，即在记录的时候换行则生成两个无序列表，在记录时缩进则发送后显示缩进格式

发送逻辑：

列表模式：

单行：
- 选中文本：
- 没有选中文本：
多行：
- 选中文本：
- 没有选中文本：

超级块模式：

单行：
- 选中文本：
- 没有选中文本：
多行：
- 选中文本：
- 没有选中文本：

截图 OCR

**注意：**图片直接保存到 assets 文件夹下，如果无法显示图片，检查 assets/ScreenShot 文件夹下有没有对应图片，并检查工作空间有无设置错误

OCR 并保存图片：

OCR 不保存图片：

截图：

笔记中想链接思源中内容或实现“关联型双链”？

可以同时使用：思源划词搜索 - 动作信息 - Quicker，将链接格式设置为“内部链接”，即可在输入时同时搜索思源内容
因为将链接内容独立出来做到了 title 里，所以如果想实现类似“关联型双链”的格式需要使用划词搜索，搜索内容后粘贴到第一行内容后

搜索功能

模糊搜索

在“link”输入框输入内容即可根据关键词搜索思源中的文档和标题，支持别名、命名、备注，支持乱序。模糊搜索设置最大数量为 9，即最多显示 8 个选项（算上新建文档）。模糊搜索的选项可以用上下方向键移动，用 Enter 选择。发送格式和输入框可以按 Tab 键切换，按方向键选择。

乱序的模糊搜索示例：目标：“思源笔记小技巧”，搜索：“技巧思源”也可找到对应内容

自动创建文档

发送信息时自动搜索是否存在当天日记，若不存在：自动创建当天日记。搜索时可选择创建新文档，创建文档位置在“docSeat”对应文档下

模糊搜索时未找到对应文档，可以选择创建新文档，文档位置在“新文档模式”对应文档下。建立新文档时会自动删除关键词间所有空格

联动功能

BookxNote

在最新版 QuickAdd 中，BookxNote 联动功能改为和“思源书斋”系列动作联动，在“书斋”功能完善之前暂时不可用。

Supermemo

在 SM 中：

无选中内容：直接速记

选中内容：生成引用链接（可能会被 SM 拒绝访问，再试一次就行）

在思源点击链接：

SM 关闭：打开 SM，结束动作

SM 打开：将 SM 设为前台窗口并跳转至对应卡片

轻度剪藏

文字摘录

选中网页文本后，运行动作，会自动复制选中内容，并作为引文，保存网页链接在引文最后。

如果配置过语义分析的 API，会生成选中文本的高亮链接；如果没有配置过语义分析的 API，则保留原网页链接

截图与 OCR

截图、截图 OCR 可以通过自定义快捷键按键触发，也可以通过轮盘菜单触发。轮盘菜单触发配置如下：

如何实现快速记录？

可以设置动作快捷键，快速启用
输入完成后，Ctrl + Enter 可以直接发送内容到思源，不用点“确定”
选择链接的时候除了可以使用方向键，还可以直接输入选项前的序号，不用反复点击上下按钮浪费时间
切换输入框可以用：Ctrl + Tab 快速切换，其中单行文本框按一次，多行文本框按两次即可切换到下一个输入框

版本回退

由于我低估了移除 BookxNote 笔记功能可能造成的影响，在“书斋”系列动作完善之前就推出了修改后的 QuickAdd，给一些老铁带来了不便。在此向各位支持 QuickAdd 的老铁致歉。

版本回退操作如下：

通过 Quicker 动作定义回退：

先下载 22 版动作：QuickAdd.zip
右键编辑动作，选择右上角的“导入动作定义”
选择下载好的动作数据（需解压）

通过导入动作数据回退：

先下载 22 版动作：QuickAdd.zip
右键空白动作页，选择“导入动作”
选择下载好的动作（需解压）

17 回帖