用快捷指令与Notion构建自动化追剧管理系统-开发者社区

如果你是一个追剧爱好者，同时也是一个效率工具的重度用户，那么你很可能已经厌倦了在多个App之间来回切换的繁琐：豆瓣找评分、备忘录记笔记、日历排日程、相册存截图……信息散落各处，不成体系。

更具体地说，你有没有遇到过这些问题？

追到一半的剧，过两周就忘了上次看到第几集。
看到一句精彩的台词或一个绝美的画面，截图后便石沉大海。
想和朋友安利某部剧，却只能模糊地说“挺好看的”，想不起具体细节。
收藏了无数剧单，但真正开始看的没几部。

这些问题背后，本质是信息管理与行为流程的脱节。而今天要介绍的解决方案，核心是两个看似不相关，但组合起来威力巨大的工具：苹果的“快捷指令”和全能笔记应用“Notion”。

这不是一个简单的“教程”，而是一套完整的、可自动化运行的“个人追剧管理系统”。它真正解决的，不是“怎么用某个功能”，而是“如何零成本、自动化地构建一个属于你自己的影视数据库”。本文将带你从零开始，搭建这套系统，让你追剧的每一步——从计划、记录到回顾——都变得清晰、有序且充满乐趣。

1. 核心思路：为什么是“快捷指令”+“Notion”？

在深入细节之前，我们先理解这个组合的威力所在。单独看这两个工具：

快捷指令：是苹果设备上的自动化“胶水”。它本身不生产信息，但可以串联不同App的动作，比如“获取截图中的文字”、“向某个网址发送内容”、“运行一段JavaScript”。它的价值在于触发自动化。
Notion：是一个极其灵活的数据库。你可以把它理解为“乐高积木式”的笔记软件，通过数据库（Database）、属性（Property）、视图（View）来结构化任何信息。它的价值在于结构化存储与呈现。

当它们结合，就产生了奇妙的化学反应：快捷指令作为“前端采集器”，自动将碎片化信息（如剧名、集数、截图、想法）规整后，一键发送到Notion这个“中央数据库”中。

对比传统方式：

传统方式：看到精彩片段 → 手机截图 → 相册堆积 → 日后遗忘。
新方式：看到精彩片段 → 运行“记录追剧”快捷指令 → 选择剧集、输入感想 → 自动上传截图、创建带时间戳的笔记到Notion对应剧集页面。

这个流程的转变，将随性的、易丢失的行为，变成了可追溯、可检索的数据资产。接下来，我们从零开始构建它。

2. 环境准备与核心概念

2.1 你需要准备什么？

设备：一部运行iOS/iPadOS 14及以上系统的iPhone或iPad（快捷指令的核心平台）。Mac也可用，但移动端触发更便捷。
软件：
- Notion：在App Store免费下载，并注册一个账号。
- 快捷指令：苹果设备自带App，确保已更新至最新版本。
一个Notion模板：我们将创建一个专属的“追剧数据库”模板。无需从零设计，我会提供完整的结构和属性。

2.2 理解关键概念：Notion数据库与集成

这是本系统的核心，务必理解。

Notion数据库（Database）：可以看作一个智能表格。每一行是一个“页面”（如一部剧），每一列是一个“属性”（如剧名、状态、评分）。
Notion集成（Integration）与内部令牌：为了让快捷指令能向你的Notion写数据，需要授权。Notion通过“集成”功能提供API权限，生成一个secret（令牌）。这个secret是你的私人钥匙，绝不能泄露。
数据库ID：你在Notion中创建的每个数据库都有一个唯一的ID，体现在其URL中。快捷指令需要知道这个ID，才能把数据发送到正确的地方。

3. 第一步：在Notion中创建追剧数据库

我们首先在Notion里搭建好数据仓库。请严格按照以下步骤操作。

3.1 创建新页面与数据库

打开Notion App或网页版。
点击左下角+ New Page创建一个新页面，命名为“我的追剧库”。
在新页面中，输入/，选择/database - Inline（内联数据库）。
你会看到一个空表格。我们先修改它的属性（列）。

3.2 设计数据库属性（列）

这是结构化存储的关键。请为数据库添加以下属性（点击表格上方+号添加属性）：

属性名（Name）	属性类型（Type）	说明与配置
剧名	`Title`	默认存在，就是每条记录的“名称”。填写剧集名称，如《繁花》。
状态	`Select`	创建选项：`想追`、`追剧中`、`已完结`、`弃剧`。用于分类筛选。
类型	`Multi-select`	创建选项：`国产剧`、`美剧`、`韩剧`、`日剧`、`动漫`、`纪录片`等。可多选。
当前进度	`Text`	自由文本，如“第10集”、“S02E05”。快捷指令将自动填写。
评分	`Number`	数字类型，范围0-10，可保留一位小数。
首播日期	`Date`	记录剧集开播时间。
封面	`Files & media`	上传剧集海报图片。
关联页面	`Relation`	（高级功能，可选）关联到另一个记录演员或导演的数据库。

创建完成后，你的数据库应该类似下图（此为示意图，具体以你创建的为准）：

| 剧名 (Title) | 状态 (Select) | 类型 (Multi-select) | 当前进度 (Text) | ... | |--------------|---------------|---------------------|-----------------|-----| | 《繁花》 | 已完结 | 国产剧 | 全30集 | ... | | 《三体》 | 追剧中 | 国产剧, 科幻 | 第18集 | ... |

重要：手动创建一条测试记录，例如《测试剧》，状态选“想追”。这一步是为了后续获取数据库ID。

3.3 获取数据库ID和创建集成

这是连接快捷指令的关键步骤。

获取数据库ID：
- 在网页版Notion中打开你的“我的追剧库”页面。
- 浏览器地址栏的URL格式为：https://www.notion.so/你的工作区/xxxxxxxxxxxxxxxxxxxxxxxxxx?v=...
- xxxxxxxxxxxxxxxxxxxxxxxxxx这32位字符就是数据库ID。复制它，保存到备忘录备用。
创建集成（获取Internal Token Secret）：
- 访问 Notion开发者页面（需登录）。
- 点击+ New integration。
- 填写名称，如My TV Tracker。
- 选择关联的工作区（Workspace）。
- 关键权限：在“Capabilities”中，至少勾选Read content和Update content。建议也勾选Insert content。
- 点击Submit创建。
- 创建成功后，页面会显示Internal Token Secret，形如secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。这是最高权限密钥，立即复制并妥善保存（如存入密码管理器），页面关闭后将无法完整查看。
将集成关联到你的数据库：
- 回到网页版Notion的“我的追剧库”数据库页面。
- 点击页面右上角的···(More)，选择Add connections。
- 在搜索框中找到你刚创建的集成My TV Tracker，并点击它。
- 现在，这个集成就有权限向这个数据库写入数据了。

4. 第二步：创建核心快捷指令——“记录追剧进度”

有了Notion数据库和钥匙（Token），我们现在来制作自动化采集器。

4.1 创建新快捷指令

打开iPhone上的“快捷指令”App。
点击底部“快捷指令”标签页，然后点击右上角+号创建新快捷指令。
点击快捷指令名称，重命名为“记录追剧进度”。

4.2 添加快捷指令动作

我们将一步步添加动作，请严格按照顺序操作。每个动作都可以在“添加操作”中搜索找到。

第一步：获取输入内容

添加“要求输入”动作。
将问题设置为“请输入剧集名称？”，默认答案留空。
长按下方出现的“提供的输入”变量，选择“重命名”，改为剧名，以便后续引用。

第二步：选择当前观看的剧集（从Notion数据库获取）这一步较复杂，目的是让你从已添加的剧集中选择，而不是每次都手动输入剧名，避免重复创建。

添加“URL”动作。输入内容为：
```
https://api.notion.com/v1/databases/【你的数据库ID】/query
```
将【你的数据库ID】替换为你在3.3节获取的32位ID。
添加“获取URL内容”动作。
- 将“URL”设置为上一步的“URL”变量。
- 点击“显示更多”。
- 方法：选择POST。
- 请求头：点击“添加新标头”。
  - 键：Authorization，值：Bearer 【你的Internal Token Secret】
  - 键：Notion-Version，值：2022-06-28（这是Notion API版本，必须准确）
  - 键：Content-Type，值：application/json
- 请求体：选择JSON。
  - 在JSON文本框中输入：
```
{ "filter": { "property": "剧名", "title": { "equals": "" } } }
```
  - 注意：这个请求体是用于后续筛选的模板，目前留空即可。更高级的做法是获取全部剧集然后让用户选择，但为简化，我们假设通过“剧名”精确匹配。更推荐使用“字典”和“列表”让用户选择，但流程较长。作为初版，我们先使用精确匹配剧名的方式。

第三步：处理Notion返回的数据并更新进度由于在快捷指令中完整实现“选择列表”逻辑非常复杂，涉及解析JSON，我们采用一个简化但有效的方案：直接更新匹配剧名的记录。

添加“如果”动作。条件设置为“URL内容”“包含”“results”。这是检查Notion API是否返回了数据。
在“如果”为真区域，添加以下动作： a.解析Notion响应：添加“从输入中获取词典值”动作。将“词典”设置为“URL内容”。获取键为results的值。这个结果是一个数组。 b.获取第一条记录的ID：添加“从列表中获取项目”动作。将“列表”设置为上一步的“词典值”，索引获取“第一项”。 c.获取页面ID：再添加一个“从输入中获取词典值”动作。“词典”设置为上一步的“列表项目”，获取键为id的值。重命名此变量为页面ID。 d.要求输入当前进度：添加“要求输入”动作，问题设置为“当前看到第几集了？（例如：第10集）”。重命名变量为当前进度。 e.要求输入感想（可选）：添加“要求输入”动作，问题设置为“有什么感想或笔记吗？（可选）”。重命名变量为感想。 f.构建更新请求：添加“URL”动作，输入：https://api.notion.com/v1/pages/【页面ID】将【页面ID】替换为变量页面ID。 g.发送更新请求：添加“获取URL内容”动作。 * URL：上一步的“URL”变量。 * 方法：PATCH。 * 请求头：同上一步，添加Authorization(Bearer Token) 和Notion-Version(2022-06-28)。 * 请求体：JSON。 * JSON内容如下（注意替换属性名与你数据库中的完全一致，区分中英文）：json { "properties": { "当前进度": { "rich_text": [{"text": {"content": "【当前进度】"}}] }, "状态": { "select": {"name": "追剧中"} } } }将【当前进度】替换为变量当前进度。
在“如果”为假区域（即未找到剧集），添加“显示结果”动作，提示“未在数据库中找到该剧集，请先在Notion中添加。”

第四步：添加照片和创建页面内容我们希望在更新进度的同时，能在该剧集页面下创建一条包含截图和感想的笔记。

在“如果”为真的区域，在发送PATCH请求动作之后，添加“选择照片”动作。勾选“选择多张”和“仅限图像”。
添加“为每张照片重复”动作。
在“重复”循环内： a. 添加“编码媒体”动作，媒体选择“重复项的照片”，编码格式选择“Base64”。 b. 添加“文本”动作，输入以下内容（这是一个Notion API创建块（block）的JSON结构）：json { "children": [ { "object": "block", "type": "image", "image": { "type": "external", "external": { "url": "data:image/jpeg;base64,【Base64编码的图片】" } } }, { "object": "block", "type": "paragraph", "paragraph": { "rich_text": [{"type": "text", "text": {"content": "【感想】"}}] } } ] }* 将【Base64编码的图片】替换为变量“编码的媒体”。 * 将【感想】替换为变量“感想”。 c. 添加“URL”动作，输入：https://api.notion.com/v1/blocks/【页面ID】/childrend. 添加“获取URL内容”动作。 * URL：上一步的URL变量。 * 方法：PATCH。 * 请求头：同上。 * 请求体：JSON，将“请求体”设置为上一步“文本”动作的输出。

第五步：完成提示

在“重复”循环结束后，添加“显示通知”动作，标题设为“追剧记录已更新！”，正文可以包含剧名和当前进度变量。

4.3 最终调试与添加到主屏幕

点击快捷指令右上角“完成”保存。
首次运行可能会提示需要允许访问“照片”、“网络”等权限，请全部允许。
为了更方便使用，可以点击该快捷指令下方的···，选择“添加到主屏幕”，这样它就会像一个独立App一样出现在你的手机桌面。

5. 完整使用流程演示

假设你现在正在看《三体》第15集，并截下了一张震撼的太空场景图。

触发：点击桌面图标“记录追剧进度”或通过Siri运行。
输入剧名：快捷指令弹出，输入“三体”。
匹配与确认：指令自动在Notion数据库中查找《三体》这条记录，并获取其页面ID。
输入进度：弹出输入框，输入“第15集”。
输入感想：弹出输入框，输入“古筝行动太震撼了！纳米丝的威力。”
选择截图：从相册中选择刚才截下的太空场景图。
自动运行：快捷指令在后台依次执行：
- 向Notion API发送请求，将《三体》记录的“当前进度”更新为“第15集”，“状态”更新为“追剧中”。
- 将你选择的图片以Base64格式、将你的感想作为文本，追加到《三体》这个Notion页面的底部。
完成：手机弹出通知“追剧记录已更新！”。
验证：打开Notion App，进入“我的追剧库”，找到《三体》这条记录，你会发现“当前进度”已自动更新。点击进入《三体》的页面，在最下方看到了你刚刚上传的截图和感想笔记。

整个过程，你只需要在快捷指令中点击并输入少量文字，所有数据同步和归档工作全部自动完成。

6. 常见问题与排查思路

在搭建和使用过程中，你可能会遇到以下问题：

问题现象	可能原因	排查方式	解决方案
快捷指令运行时报错“未能获取URL内容”或“请求失败”	1. 网络连接问题。 2. Notion API Token或数据库ID错误。 3. 数据库未关联集成。	1. 检查网络。 2. 核对“获取URL内容”动作中的URL和请求头。确保Token以`Bearer`开头，版本号正确。 3. 去Notion数据库页面检查`Connections`。	1. 切换网络重试。 2. 重新复制粘贴Token和数据库ID，注意去除空格。 3. 在数据库页面添加集成。
快捷指令能找到剧集但更新失败	1. 属性名不匹配（中英文/空格）。 2. JSON格式错误。	1. 检查Notion数据库属性名是否与快捷指令JSON中的`properties`下的键名完全一致。 2. 检查JSON结构，特别是引号和逗号。	1. 修改快捷指令中的JSON键名，或修改Notion属性名使其一致。 2. 使用在线的JSON格式化工具验证。
截图上传失败或显示异常	1. Base64编码或JSON格式错误。 2. 图片过大。	1. 检查“编码媒体”和构建图像块的JSON步骤。 2. 尝试换一张小尺寸图片测试。	1. 确保“编码媒体”动作在“重复”循环内，且输出被正确插入到`data:image/jpeg;base64,`之后。 2. 可在“选择照片”后添加“调整图像大小”动作限制分辨率。
无法在快捷指令中选择已存在的剧集	简化版指令依赖精确匹配剧名。	输入的剧名与Notion数据库“剧名”列中的内容是否完全一致（包括标点）？	确保输入一致。对于进阶用户，可以改造指令，先调用API获取所有剧名生成列表供选择，但这需要更复杂的字典和列表操作。
Notion中看不到新添加的内容	API调用成功但内容未立即显示。	1. 下拉刷新Notion页面。 2. 检查是否添加到了正确的数据库页面下。	1. 网络同步有延迟，稍等片刻或刷新。 2. 确认数据库ID是否正确。

7. 进阶优化与最佳实践

基础系统搭建完成后，你可以考虑以下优化，让它更强大、更贴合你的习惯。

7.1 快捷指令优化

添加剧集快捷指令：创建一个独立的“添加新剧”指令，用于快速向数据库中添加想追的剧集，包含剧名、类型、状态等。
使用字典菜单：将“状态”、“类型”等选项做成字典，让用户点选而非输入，减少错误。
错误处理：在关键步骤（如网络请求）后添加“如果”“否则”逻辑，给出更友好的错误提示。
分享表单触发：可以设置当你在豆瓣App分享剧集时，自动运行快捷指令抓取信息并创建记录。

7.2 Notion数据库优化

创建视图：利用Notion的视图功能，创建“看板视图”按“状态”分组，一目了然；创建“画廊视图”用“封面”属性展示，视觉化你的剧库。
添加公式属性：例如，添加一个“已看天数”公式：dateBetween(now(), prop(“首播日期”), “days”)。
关联数据库：创建独立的“演员”、“导演”数据库，并与“追剧库”建立关联，实现多维度的信息管理。
使用模板：为“追剧中”的剧集设置页面模板，自动预置“分集笔记”、“经典台词”等模块。

7.3 自动化与集成扩展

日历集成：使用更高级的自动化工具（如Zapier/Make，或通过iOS的“自动化”），当某剧状态变为“追剧中”时，在日历中创建每周的观影提醒。
数据回顾：定期（如每月）让快捷指令读取数据库，通过API统计已看完剧集数量、平均评分等，并生成简单报告发送给你。
备份：定期导出Notion数据库为CSV或HTML，作为本地备份。

8. 安全与隐私提醒

Token保密：Internal Token Secret等同于你的Notion账户密码，拥有其关联的权限。切勿分享给他人或上传到公开的代码仓库（如GitHub）。
权限最小化：在创建Notion集成时，只授予必要的权限（Read, Update, Insert）。不要勾选Delete等危险权限，除非你明确需要。
网络请求：该快捷指令会向Notion服务器发送网络请求，请确保在安全的Wi-Fi或蜂窝网络下使用。

这套“快捷指令+Notion”的追剧管理系统，其价值远超一个简单的记录工具。它本质上是一个高度定制化、可扩展的个人数据工作流。你掌握了这个范式，就可以举一反三，将其应用于读书笔记、健身打卡、项目管理、灵感收集等任何需要将碎片信息结构化的场景。技术的乐趣，正在于用简单的工具，创造出贴合自己生活与思维的独特系统。现在，就从你的下一部剧开始，构建你的数字影音档案馆吧。