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

设置你的工具

在开始总结之前，先把你的 AI 工具连接到 Gmail。根据你的情况选择最适合的路径。

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

选择你的路径​

这条路径提供以语音为主的体验。你将安装 Gemini CLI，添加 Google Workspace 扩展，并可选安装 Wispr Flow 以便说出提示词。整个过程约 20 分钟，并且你会学到在后续每个教程中都会用到的 CLI 技能。

  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。安装 Gmail 扩展后我们再重新启动。

  3. 安装 Google Workspace 扩展

    打开终端并运行以下命令：

    复制此命令
    gemini extensions install https://github.com/gemini-cli-extensions/workspace

    这将下载并安装 Google Workspace 扩展，让 Gemini CLI 能够读取你的 Gmail、Google Calendar 和 Google Drive。

    什么是扩展？ 扩展是为 Gemini CLI 添加新功能的插件。Workspace 扩展增加了读取和管理 Gmail 等 Google 服务的工具 —— 类似于在手机上安装一款应用。

    命令失败或卡住了

    请确保你有网络连接，且 Node.js 已正确安装。先尝试运行 node --version。如果那个命令可以运行但扩展安装失败，尝试关闭并重新打开终端，然后再次运行命令。

  4. 授权 Gmail 访问

    1. 启动 Gemini CLI：
    gemini
    1. 首次加载带 Workspace 扩展的 Gemini CLI 时，它会要求你授权访问 Google 账户
    2. 浏览器会自动打开 —— 用你想要总结邮件的 Google 账户登录
    3. 查看权限并点击允许
    4. 返回终端 —— Gemini CLI 现在已连接到你的 Gmail

    仔细查看权限。 该扩展申请读取你的邮件、日历和云端硬盘的权限。点击允许前请确认你对此感到放心。你随时可以在 Google 账户安全设置中撤销访问权限。

    浏览器窗口没有自动打开

    复制终端中显示的 URL，手动粘贴到浏览器中。在那里完成登录，然后返回终端。

    我看到"此应用未经验证"的警告

    这对社区开发的工具来说很正常。点击高级 → **前往 [应用名称]（不安全）**继续。Google 对尚未通过官方审核流程的应用都会显示此警告。

  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 中，用 Wispr Flow 说出或直接输入这条提示词：

    说出或复制此提示词
    Check my Gmail and tell me how many unread emails I have.

    你应该会看到 Gemini CLI 访问你的 Gmail 并返回收件箱的信息。如果成功，一切正常。

    Gemini 请求权限确认？ 如果 Gemini CLI 请求批准工具调用，输入 y 并按 Enter。这很正常 —— 它在访问 Gmail 前请求你的确认。

    Gemini 说没有 Gmail 工具

    扩展可能没有正确安装。尝试再次运行安装命令：

    gemini extensions install https://github.com/gemini-cli-extensions/workspace

    然后退出（/quit）并重启 Gemini CLI。你可以用 /extensions list 查看已安装的扩展。

验证你的设置​

Node.js 已安装

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

Gemini CLI 已安装并登录

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

Workspace 扩展已安装

扩展安装时没有报错。你可以在 Gemini CLI 内用 /extensions list 确认。

Gmail 已授权

你完成了 Google 登录并授予了访问权限。

连接已测试

当你提问时，Gemini CLI 能告诉你关于未读邮件的信息。

一切就绪？前往总结你的 Gmail 获取你第一份 AI 生成的邮件摘要。