是否有过这样的经历：划了很多重点、收藏了很多金句，当下很有共鸣，过几天却完全忘了、更谈不上真正行动？

Read & Act 就是为这种情况设计的——它帮你把书籍、文章，甚至自己随手记下的想法，转化成一个个小而具体、可以马上去做的行动。数据默认保存在你的浏览器本地，你可以用一个很简单的节奏来使用它：记录 → 转化 → 行动 → 回顾。

这篇教程会一步步带你上手。

1. 初次打开：界面总览

打开应用（https://read-and-act.orangely.xyz）后，你会看到：

  • 桌面端左侧是一个带导航和每日小贴士的 侧边栏。
  • 移动端底部有一个 导航栏。
  • 顶部右侧（或移动端顶部）有一个 语言切换 开关（EN / 中）。

主导航包含五个页面：

  1. 灵感首页（Inspiration） – 今日推荐行动 + 最近笔记。
  2. 我的笔记（My Notes） – 你的完整笔记库和 AI 生成的行动。
  3. 知识图谱（Knowledge Map） – 来源与标签的交互式网络图。
  4. 成长数据（Growth） – 每周行动趋势和主题分布。
  5. 隐私说明（Privacy） – 数据如何存储，以及导出功能。

在桌面端右上角 / 移动端右下角，你还能看到一个醒目的 「添加笔记」 按钮。

2. 记录你的第一条笔记

点击 「添加笔记」 打开笔记弹窗，你会看到四个输入框：

  • 来源（可选）
    例：原子习惯、关于深度工作的一篇博客，或留空，直接写下面的摘录 / 想法。
  • 作者（可选）
    例：詹姆斯·克利尔。
  • 摘录 / 想法（必填）
    你想「转化为行动」的那段话，可以是书中原文，也可以是自己的反思。
  • 标签（用逗号分隔）
    例：习惯, 专注, 健康。

关于「来源」字段的处理方式

来源不是必填的。如果你留空，应用会自动帮你：

  • 读取你填写的 摘录，
  • 截取一小段有代表性的内容，
  • 把它当作这条笔记的「来源名称」展示
    （例如：“未经省察的生活不值得过” → 未经省察的生活…）。

这样即便你只是快速记了一段话，笔记列表里依然会有一个简洁、好认的来源标签。

保存笔记

填写完成后：

  1. 确认 摘录 / 想法 已填写。
  2. 点击 「保存笔记」。

这条笔记会保存在你的浏览器本地（IndexedDB），并出现在：

  • 灵感首页 → 最近输入（Recent inputs） 区域；
  • 我的笔记（My Notes） 列表；
  • 如果有标签，稍后也会出现在 知识图谱（Knowledge Map） 中。

3. 把笔记转化为「可执行小行动」

Read & Act 的核心价值，就是帮你把文字转化成「小而具体、马上能做」的行动。

打开 「我的笔记」 页面，你会在每一条笔记上看到：

  • 来源 和 作者；
  • 用引用形式展示的 摘录；
  • 这条笔记的 标签；
  • 一个状态标记：等待转化 或 已生成行动。

对于还没有生成行动的笔记：

  1. 点击 「生成行动」 按钮。
  2. 按钮会变成 AI 思考中...，此时 Cloudflare Worker + AI 模型会根据你的摘录生成建议。
  3. 生成完成后，你会看到：
    • 一枚 「已生成行动」 的小徽章；
    • 笔记下方出现 1–3 条微行动建议。

每条行动包含：

  • 标题 – 一般以动词开头，便于立刻执行。
  • 说明 – 用一两句话告诉你具体要做什么。
  • 时间 – 例如 5分钟、10分钟。
  • 类型 – 反思（Reflection）、互动（Interaction） 或 观察（Observation）。

你可以：

  • 点击每条行动左侧的小 圆形按钮 来 标记完成 / 取消完成；
  • 在行动条目下方看到 时间和类型。

如果生成过程中出现问题，页面顶部会出现友好的错误提示，你可以稍后重试。

4. 用好「灵感首页」作为每日起点

灵感首页界面截图

灵感首页（Inspiration） 可以理解为你的「今日行动面板」，适合每天快速打开一次。

你会看到：

  • 顶部的 日期徽章（会根据当前语言本地化格式）。
  • 一句问候，例如「你好，思考者。」。
  • 一张主卡片，内容包括：

「今日推荐」行动

如果当前有尚未完成的行动，应用会：

  • 从中挑出一条，作为 「今日推荐」；
  • 展示它的标题、说明和预计耗时；
  • 提供一个明显的 「标记完成」 按钮。

当你点击 「标记完成」：

  • 这条行动会被标记为已完成；
  • 会计入你的 成长数据统计；
  • 从「待办池」中移除，方便明天抽取新的推荐。

当没有待办行动时

如果你当前没有任何未完成的行动，主卡片会：

  • 在你已经用过生成功能时，展示类似 「全部搞定！」 的鼓励语；
  • 在你还没生成过行动时，则引导你 添加第一条笔记。

卡片下方，还有：

  • 「添加笔记」 按钮 – 快速打开记录弹窗；
  • 「前往笔记 / 查看全部」 – 一键跳转到完整笔记库。

在主卡片下面，你还能看到 最近输入（Recent inputs）：用卡片形式展示最近几条笔记（来源、日期、摘录、标签），方便你回顾最近在思考什么。

5. 管理与筛选：打造你的「知识库」

我的笔记页面界面截图

在 「我的笔记」 页面，你有一套完整的管理工具，帮助你快速找到需要的内容。

搜索

顶部的搜索框支持在以下字段内模糊搜索：

  • 来源
  • 作者
  • 摘录内容
  • 标签

输入任何关键词，列表会即时过滤匹配的笔记。

筛选与标签

点击 「筛选」 打开筛选面板：

  • 标签筛选
    • 所有你使用过的标签会以小圆角按钮展示。
    • 点击某个标签即可切换选中 / 取消。
    • 至少选中一个标签时，只会显示包含这些标签的笔记。
  • 仅查看星标 开关
    • 打开后，只会显示你标记为「星标」的笔记。

你可以随时通过面板中的 「清除」 按钮，或者搜索框右侧的清除按钮，重置所有筛选条件。

星标、编辑与删除

在每条笔记右上角，你可以：

  • 点击 星形图标 将笔记标记为星标 / 取消星标；
  • 点击 铅笔图标 进入编辑模式：
    • 可以修改来源、作者、摘录、标签；
    • 保存时，来源字段会像创建时一样自动规范化。
  • 点击 垃圾桶图标 删除笔记（会弹出确认对话框）。

注意：删除笔记会一并删除其下方已生成的行动（仅在本地）。

6. 使用「知识图谱」看见概念之间的连接

知识图谱界面截图

知识图谱（Knowledge Map） 会把你的来源和标签以点线图的形式可视化，帮助你看到「不同想法之间是如何关联的」。

图中有两类节点：

  • 来源节点 – 代表书名、文章名或自动提取的来源，一般用蓝绿 / 青色显示，体积较大；
  • 标签节点 – 代表概念或主题，颜色多样且略小。

节点间的连线表示：某条笔记的来源与某个标签存在关联。

图谱为空时

若你尚未为笔记添加任何标签，图谱区域会显示一个友好的空状态：

  • 提醒你需要笔记 + 标签才能生成图谱；
  • 提供一个 「添加笔记」 按钮方便你立刻开始。

图谱有数据时

  • 你可以 拖拽节点 来重新布局，观察不同簇的结构；
  • 可以用它来查看：
    • 哪些标签处于「中心位置」，连接了多个来源；
    • 哪些书 / 来源聚集在相似的标签周围；
  • 在手机端，你同样可以滑动和拖动，布局会自动适配屏幕。

建议为常见主题使用统一标签，例如：

  • 习惯、专注、关系、健康、职业 等。

这样图谱会非常直观。

7. 在「成长数据」中看到自己的进步

成长数据界面截图

成长数据（Growth） 页面用图表的方式，展示你最近一段时间的行动情况。

顶部四个统计卡片

你会看到四个数字卡片：

  1. 总笔记数 – 你目前保存了多少条笔记。
  2. 已完成 – 你标记完成的行动总数。
  3. 完成率 – 已完成行动 / 总行动 的百分比。
  4. 专注领域 – 出现次数最多的标签（若暂时没有数据，会展示一个占位文案）。

它们可以帮助你快速判断：你是否持续把阅读转化为行动，最近都在关注哪些方面。

每周行动趋势（柱状图）

左侧的图是一个 7 天柱状图：

  • 显示最近 7 天 的完成情况，周一在最前；
  • 每天的柱子表示当天完成了多少条行动；
  • 当天对应的柱子会用特殊颜色高亮，一眼就能看到「今天的行动量」。

通过它，你可以观察：

  • 自己一周中哪几天最常执行行动；
  • 是否存在「只在周末动一下」或「周一很猛，后面全躺平」的模式。

知识主题分布（饼图）

右侧是一个展示前 5 个高频标签的饼图：

  • 每一块代表一个标签；
  • 边上还有一个小图例，列出最常出现的几个主题及颜色。

它可以帮你回答一些问题，例如：

  • 「我最近是不是读太多效率书了？」
  • 「健康 / 关系 / 职业这几个维度，有没有严重失衡？」
  • 「过去一段时间，我的注意力主要被什么吸走了？」

如果当前数据还不多，这一块会显示一个简单的空状态，鼓励你多生成一些行动。

8. 隐私与数据：存在哪、如何导出

隐私说明（Privacy） 页面用中英文简要说明了应用如何处理你的数据。

核心要点：

  • 笔记和行动 默认 存储在你的浏览器 IndexedDB 本地。
  • 语言偏好 会保存在 localStorage，方便下次直接用上次的语言打开。
  • Service Worker 只用于缓存静态资源、加快加载速度，不做任何埋点跟踪。
  • AI 调用会发送到你配置的 Cloudflare Worker 端点，前端并不直接持有你的大模型 API Key。

导出数据备份

你可以随时导出自己的数据为 JSON 文件：

  1. 打开 「隐私说明」 页面。
  2. 找到 「导出数据」 卡片。
  3. 点击 「导出 JSON」 按钮。

应用会：

  • 生成一个 JSON 文件，内容包含：
    • 应用版本号（如果有）
    • 导出时间
    • 所有笔记及其下的行动
  • 启动浏览器下载，文件名类似：
    • read-and-act-notes-YYYY-MM-DD.json

你可以将其：

  • 作为个人长期备份；
  • 导入到其他分析工具或二次处理；
  • 也可以未来配合自己的脚本做进一步整理。

9. 中英双语使用方式

Read & Act 同时支持 英文 和 简体中文。

  • 使用界面中的 语言切换开关（EN / 中）即可一键切换；
  • 整个界面文案、按钮、说明、隐私文本都会随之切换；
  • AI 在生成行动时也会被提示使用对应语言：
    • 中文时：使用简洁、口语化但不失清晰的中文；
    • 英文时：使用简洁、实用的英语表达。

你的语言选择会保存在当前浏览器中，所以不需要每次打开都重新切换。

10. 推荐的使用节奏与实践

最后，给出几个简单的使用模式，方便你把 Read & Act 融入日常。

  • 日常阅读循环

    • 每天记录 1–3 条摘录或灵感；
    • 给每条笔记打 2–3 个标签；
    • 至少为其中 1 条笔记生成行动；
    • 在 灵感首页 执行至少 1 个行动并标记完成。

  • 每周回顾

    • 打开 成长数据：
      • 看看本周完成率如何；
      • 哪些标签出现最频繁；
      • 每周哪几天行动最积极。
    • 用这些信息决定下周重点：是继续深挖一个主题，还是调整阅读 / 行动方向。

  • 构建专题知识图谱

    • 为一个具体主题（例如「演讲」「写作」「亲密关系」）设立统一标签；
    • 所有相关摘录都加上这个标签；
    • 打开 知识图谱 观察：
      • 这个主题与哪些其他标签互相关联；
      • 哪些来源在这个主题上贡献最多。

通过「简单记录 → 自动生成微行动 → 可视化反馈」这条轻量级路径，Read & Act 帮你把「看过」变成「做到」，让阅读真正渗透到生活和行为里。