跳到主要内容
版本：2026 HER WAKA 活动

设置你的工具

在开始记录之前，先把所有工具安装好并连接起来。

你需要准备： 一台能联网的电脑。无需任何编程经验 —— 我们会一步一步带你完成每个步骤。

  1. 安装 Node.js

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

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

    1. 前往 nodejs.org
    2. 点击绿色大按钮 LTS 下载安装程序
    3. 打开下载的 .msi 文件
    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

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

    暂时输入 /quit 退出 Gemini CLI。等其他一切都设置完成后再重新启动。

  3. 安装 Obsidian 并启用 CLI

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

    1. 前往 obsidian.md/download，点击 Download for Windows
    2. 运行安装程序并按照提示操作
    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. 启用每日笔记

    每日笔记为你的每一天提供一张新页面 —— 就像一本自动生成的数字日记。

    1. 打开 Obsidian
    2. 点击左下角的设置图标（齿轮图标）
    3. 在左侧边栏，点击核心插件
    4. 在列表中找到每日笔记
    5. 将其开启

    什么是每日笔记？ 每天，Obsidian 都会以今天的日期为标题创建一篇新笔记。它成为你一天的记录日志 —— 你记录的所有内容都在这里。第二天，你会自动获得一篇新笔记。

    我在列表中找不到每日笔记

    请确保你查看的是核心插件，而不是社区插件。核心插件内置于 Obsidian 中，始终可用。滚动查看列表 —— 每日笔记应该在里面。

  5. 安装 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 打出一段长提示词，你可以直接说出来。如果你觉得打字慢或疲惫，这特别有用。

  6. 测试所有工具的协同

    让我们确认 Gemini CLI 可以控制 Obsidian。确保 Obsidian 已打开，然后在终端启动 Gemini CLI：

    复制此命令
    gemini

    现在用 Wispr Flow 说出或直接输入这条提示词：

    说出或复制此提示词
    Run the command obsidian daily to open today's note in Obsidian

    Gemini CLI 应该会为你运行 obsidian daily 命令，Obsidian 应该会打开今天的每日笔记。如果 Gemini 询问是否可以运行命令，输入 y 并按 Enter —— 这很正常。

    刚才发生了什么？ 你用普通语言要求 Gemini CLI 打开你的每日笔记。它理解了你的请求，运行了正确的命令，Obsidian 也做出了响应。这就是核心工作流 —— 你描述你想要什么，Gemini 负责处理剩下的事情。

    Gemini 说无法运行命令

    确保 Obsidian 正在运行且 CLI 已启用。在另一个终端窗口中直接运行 obsidian help 测试 CLI。如果那个命令可以运行，再次尝试 Gemini 提示词。

    我看到关于 vault 的错误

    确保 Obsidian 已打开并且你至少设置了一个 vault。Vault 就是 Obsidian 存储笔记的文件夹。如果你还没有创建，打开 Obsidian 并按照提示创建你的第一个 vault。

验证你的设置​

Node.js 已安装

在终端运行 node --version。你应该会看到一个版本号。

Gemini CLI 已安装并登录

在终端运行 gemini。它能正常启动并显示一个可输入的提示符。

Obsidian 已安装且 CLI 正常工作

应用已打开，你可以在终端运行 obsidian help 而不报错。

每日笔记已启用

每日笔记核心插件已在设置 → 核心插件中开启。

Gemini CLI 可以控制 Obsidian

请求 Gemini 打开每日笔记能正常工作 —— 它运行命令，Obsidian 做出响应。

一切就绪？前往记录、追踪与回顾，开始用自然语言使用每日笔记。