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

设置你的工具

在开始构建之前，先准备好你的工具。本页面将逐步引导你完成每个步骤。

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

逐步设置​

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

  2. 安装 Node.js

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

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

    打开终端并输入：

    node --version

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

  3. 学会打开终端

    终端是一个你输入命令的程序。它看起来像一个带有文字的深色窗口 —— 这完全正常，不要被吓到！

    1. 按键盘上的 Windows 键
    2. 输入 PowerShell
    3. 在搜索结果中点击 Windows PowerShell

    你会看到一个带有闪烁光标的深蓝色窗口。那就是你的终端！

    终端是你输入命令来安装工具和与 AI 对话的地方。本教程中你会经常用到它 —— 保持它开着！

    如何在特定文件夹中打开终端

    在本教程的后续部分，你需要在项目文件夹内打开终端。方法如下：

    Windows： 在文件资源管理器中打开文件夹。点击顶部的地址栏，输入 powershell，然后按 Enter。终端会直接在那个文件夹中打开。

    macOS： 在 Finder 中导航到文件夹。右键单击文件夹并选择**"在文件夹中打开终端"**。如果看不到此选项，可以正常打开终端并输入 cd （带空格），然后将文件夹拖入终端窗口并按 Enter。

  4. 安装并测试 Gemini CLI

    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

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

  5. 安装 Typst CLI

    Typst 是一个免费开源的排版系统，将简单的文本文件转化为精美的 PDF。

    打开 PowerShell 并运行：

    winget install --id Typst.Typst

    等待安装完成。之后你可能需要关闭并重新打开终端。

    手动下载备选方案

    如果上面的命令不起作用，你可以直接下载 Typst：

    1. 前往 Typst 发布页面
    2. 下载适合你系统的文件：
      • Windows： typst-x86_64-pc-windows-msvc.zip
      • macOS（Apple Silicon）： typst-aarch64-apple-darwin.tar.xz
      • macOS（Intel）： typst-x86_64-apple-darwin.tar.xz
    3. 解压下载的文件
    4. 将 typst 可执行文件移动到系统 PATH 中的某个文件夹，或直接从解压目录运行
    验证安装

    打开一个新的终端窗口并输入：

    typst --version

    你应该会看到类似 typst 0.13.x 的版本号。如果看到错误，先尝试关闭并重新打开终端。

验证你的设置​

继续之前，检查所有工具是否就绪：

Node.js 已安装

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

终端可以正常使用

你可以打开终端窗口并输入命令。

Gemini CLI 已安装

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

已登录 Google

Gemini CLI 已连接到你的 Google 账号。

Typst CLI 已安装

在终端运行 typst --version，应显示一个版本号。

Wispr Flow（可选）

如果你已安装，可以在任何应用中 —— 包括终端 —— 通过语音输入文字。

一切就绪？前往构建你的第一个 PDF，创建你的第一份专业文档。