设置你的工具

在开始整理之前，确保所有工具都已安装并正常运行。

你需要准备： 一台电脑和已安装并启用了 CLI 插件的 Obsidian。无需任何编程经验 —— 我们会一步一步带你完成每个步骤。

已经设置好了？ 如果你已完成用语音控制你的笔记教程，你已经设置好了！跳到第 5 步检查你的笔记库。

1. 安装 Node.js

   已有 Node.js？ 如果你在之前的教程中已经安装过，跳过此步骤。在终端运行 node --version 检查 —— 你应该会看到类似 v22.x.x 的版本号。

   Node.js 是一个免费工具，让你可以在电脑上运行 Gemini CLI。

   Windows

   1. 前往 nodejs.org
   2. 点击绿色大按钮 LTS 下载安装程序
   3. 打开下载的 .msi 文件
   4. 点击下一步完成所有屏幕 —— 默认设置即可
   5. 点击安装，然后点击完成

   macOS

   1. 前往 nodejs.org
   2. 点击绿色大按钮 LTS 下载安装程序
   3. 打开下载的 .pkg 文件
   4. 点击继续完成所有屏幕 —— 默认设置即可
   5. 点击安装，然后点击关闭

   如何知道安装成功了？

   打开终端并输入：

   node --version

   你应该看到类似 v22.x.x 的版本号。如果看到错误，尝试关闭并重新打开终端，然后再次运行该命令。

2. 安装 Gemini CLI

   已有 Gemini CLI？ 如果你在之前的教程中已经安装过，跳过此步骤。只需在终端运行 gemini 确认它还能正常运行。

   Gemini CLI 是 Google 的免费 AI 助手。它在你的终端中运行，根据你的描述帮助你完成任务。

   打开终端并输入：

   npm install -g @google/gemini-cli

   等待安装完成。然后输入以下命令启动它：

   gemini

   第一次运行时，Gemini CLI 会要求你登录：

   • 选择 "Sign in with Google"
   • 浏览器窗口会打开 —— 用你的 Google 账号登录
   • 当提示已连接时，返回终端

   免费套餐： 每分钟 60 次请求，每天 1,000 次请求 —— 对于本教程和日常使用已绰绰有余。

   'npm' 未被识别

   这意味着 Node.js 没有正确安装。返回重新安装 Node.js。重新安装后，完全关闭终端并打开一个新的终端，然后再试一次。

   权限被拒绝错误

   Windows： 关闭 PowerShell，右键单击重新打开并选择**"以管理员身份运行"**，然后再次尝试安装命令。

   macOS： 在命令前加 sudo：

   sudo npm install -g @google/gemini-cli

   在提示时输入你的电脑密码（输入时不会显示字符 —— 这是正常的）。

3. 安装 Obsidian 并启用 CLI

   已经完成了？ 如果你在之前的教程中安装了 Obsidian CLI 插件，跳过此步骤。在终端运行 obsidian version 检查 —— 你应该会看到一个版本号。

   Obsidian 是一款免费的笔记应用，将你的笔记以纯文本文件的形式存储在你的电脑上。CLI 让你可以从终端控制它。

   Windows

   1. 前往 obsidian.md/download，点击 Download for Windows
   2. 运行安装程序并按照提示操作
   3. 打开 Obsidian —— 如果是第一次使用，点击 Create new vault，给它起个名字（例如"My Notes"），然后选择保存位置

   macOS

   1. 前往 obsidian.md/download，点击 Download for macOS
   2. 将 Obsidian 拖到你的应用程序文件夹
   3. 打开 Obsidian —— 如果是第一次使用，点击 Create new vault，给它起个名字（例如"My Notes"），然后选择保存位置

   已有 Obsidian？ 确保你运行的是 1.12.4 或更高版本。前往设置 → 通用 → 查看顶部的版本号。如果需要更新，从 obsidian.md/download 下载最新安装程序。

   现在启用 CLI：

   1. 在 Obsidian 中，打开设置（左下角的齿轮图标）
   2. 前往通用
   3. 找到命令行界面并切换为开启
   4. 按照提示注册 CLI
   5. 关闭并重新打开终端使更改生效

   通过打开终端并输入以下命令来测试：

   obsidian help

   你应该看到可用命令列表。如果可以，CLI 已准备就绪。

   'obsidian' 命令未找到

   启用 CLI 后重启终端 —— PATH 更改只在新终端窗口中生效。

   macOS： 检查你的 ~/.zprofile 文件是否包含以下行：

   export PATH="$PATH:/Applications/Obsidian.app/Contents/MacOS"

   如果缺少，手动添加，然后重启终端。

   Windows： 确保你使用的是 Obsidian 1.12.4+ 安装程序。安装程序会添加一个允许 CLI 工作的终端重定向器。如果命令仍然找不到，尝试重启电脑。

   Obsidian 必须处于运行状态

   CLI 连接到正在运行的 Obsidian 应用。在运行 CLI 命令之前确保 Obsidian 是打开的。如果 Obsidian 没有运行，第一个 CLI 命令应该会自动启动它 —— 但这可能需要几秒钟。

   我有多个知识库

   默认情况下，CLI 使用当前终端目录中的知识库，或最近活跃的知识库。要指定特定知识库，在命令前加 vault=<名称>：

   obsidian vault="My Notes" help

4. 安装 Wispr Flow（可选）

   此步骤是可选的。 Wispr Flow 让你可以说话代替打字 —— 如果你更喜欢说话而不是打字，会很方便。如果你更喜欢打字输入提示词，可以跳过此步骤。

   使用此邀请链接注册，获得一个月免费 Pro 版： https://wisprflow.ai/r?CHAN115

   你和教程作者都能受益 —— 你获得一个月免费 Pro，当你口述 2,000 个单词时，作者也会获得一个月免费！

   1. 在 wisprflow.ai/r?CHAN115 注册
   2. 下载并安装适合你操作系统的应用
   3. 配置设置 —— 启用以下选项以获得最佳体验：
      • 实验性功能 > Command Mode —— 启用高级语音命令
      • Press Enter Command —— 当你说"press enter"时自动按回车
      • Bulk Import —— 导入片段和字典项目

   什么是 Wispr Flow？

   Wispr Flow 是一款语音转文字工具，让你可以口述代替打字。它在任何应用中都能使用，包括终端。与其向 Gemini CLI 打出一段长提示词，你可以直接说出来。如果你觉得打字慢或疲惫，这特别有用。

5. 检查你的笔记库

   让我们确保 Gemini CLI 可以与你的 Obsidian 笔记库对话。启动 Gemini CLI：

   复制此命令

   gemini

   然后说出或输入这条提示词：

   说出或复制此提示词

   How many files and folders are in my Obsidian vault?

   Gemini CLI 应该会返回关于你笔记库的信息 —— 文件数量、文件夹数量，可能还有笔记库名称和路径。如果成功，一切都已连接。

   有多个笔记库？ 如果你有不止一个笔记库，Obsidian CLI 使用你的默认笔记库。你可以在 Obsidian 应用设置中切换笔记库。

6. 如果你的笔记库是空的，创建示例笔记

   如果你的笔记库是全新的、没有笔记，请逐一给 Gemini CLI 以下提示词。这会创建示例笔记，让教程有内容可以操作。

   说出或复制此提示词

   Create a note in Obsidian called 'Meeting Notes - March 15' with a heading Team Meeting, some discussion points about the project timeline, two checkbox tasks about reviewing the budget and sending an update to Sarah, and tag it with meeting and work

   说出或复制此提示词

   Create a note called 'Recipe - Banana Bread' with ingredients list and tag it recipe and baking

   说出或复制此提示词

   Create a note called 'Book Notes' with a reading list of Atomic Habits and The Lean Startup, tagged books and reading

   说出或复制此提示词

   Create a note called 'Project Ideas' with three career-related ideas, tagged ideas and career

   说出或复制此提示词

   Create a note called 'Untitled' with some random unstructured text and no tags

   已经有笔记了？ 跳过此步骤。这些示例笔记仅供从空笔记库开始的人使用，让教程有内容可以操作。

验证你的设置

Node.js 已安装

在终端运行 node --version 显示一个版本号。

Gemini CLI 已安装并登录

在终端运行 gemini 启动 AI 助手并显示一个可输入的提示符。

Obsidian CLI 正常工作

在终端运行 obsidian version 显示一个版本号。

笔记库信息可见

向 Gemini CLI 提问关于笔记库的问题，返回文件和文件夹数量。

Wispr Flow 已安装（可选）

你可以说话并看到文字出现在终端中。

一切就绪？前往搜索、审查和整理，开始探索你的笔记库。