← GASE

Wiki

GASE 项目文档 — Google Apps Script Editor。

Chrome Web Store →

什么是 GASE？

GASE（Google Apps Script Editor）是一款 Chrome 扩展程序，用于增强原生的 Google Apps Script 编辑器。它添加了标准编辑器中不可用的高级功能，优化了开发工作流程。

该扩展程序可让你通过层级可折叠的文件树浏览项目，切换多种视觉主题，使用 Vim 风格的键盘快捷键，在所有项目文件中搜索文本，以及一键将整个项目下载为 .zip 文件。

专业版包含一个由大语言模型（LLM）驱动的 AI 聊天助手，可以询问代码相关问题、请求更新文件或创建新文件，并可使用代码片段商店与社区共享和下载代码片段。

Blocks（代码块）

Blocks 是预定义的代码片段，您可以配置并直接拖拽到您的 Google Apps Script 项目中。它们就像低代码工具：选择你需要的块，调整参数，然后将其插入代码中，无需从零开始编写。

本节截图

如何打开 Blocks 面板

  1. 点击 GASE 工具栏中的 Blocks 按钮
  2. 将打开一个侧边面板，显示可用的 blocks 列表
  3. 按类别浏览或使用搜索栏查找特定的 block。

可用的 Block 类型

基础版（免费）

基础 blocks 对所有用户开放，包括免费计划用户。包含常用操作，如从 Google Sheets 读取数据、使用 Gmail 发送邮件、列出 Drive 文件和发起 HTTP 请求。

高级版（Pro）

高级 blocks 需要活跃的 Pro 计划或试用。包含更复杂的操作，如发送带附件的邮件、从模板生成 PDF、创建表单、邮件合并，以及向 Slack、Discord、Telegram 或 WhatsApp 发送通知。

Blocks 完整列表

本节截图

Google Sheets

  • Google Sheet — Reference data from a Google spreadsheet
  • Append Row — Append a new row to a Google Spreadsheet Pro
  • Clear Sheet — Clear range or formatting in a sheet Pro

Gmail

  • Send Email — Send a basic email with Gmail
  • Send Email + Attach — Send an email with file attachments Pro

Google Drive

  • Drive List — List files/folders from a Drive folder
  • PDF from Template — Generate a PDF from a Google Docs template Pro
  • Search Drive — Search files in Drive by criteria Pro
  • Convert Drive Files — Convert files between formats in Drive Pro
  • Drive Permissions — Get sharing permissions of Drive files Pro

Web 和 API

  • URL Fetch — Make HTTP requests to external APIs
  • Web App — Deploy a Google Apps Script web app Pro
  • Webhook Receiver — Receive data from webhooks into a sheet

数据和表格

  • Clean Data — Remove duplicates, trim spaces, normalize text
  • Export JSON — Export sheet data as JSON with formatting options Pro
  • Consolidate Sheets — Merge multiple sheets into one Pro
  • Filter Copy — Copy filtered rows from one sheet to another Pro
  • Inject Array — Write an array/JSON into a sheet at a specific row Pro
  • Mock Data Sheet — Fill a sheet with realistic fake data Pro

工具

  • Retry Handler — Wrap API calls with retry logic
  • Error Catcher — Catch and log errors to a sheet
  • Env Manager — Manage API keys/tokens via PropertiesService
  • AI Integrator — Send data to AI for summarization/translation Pro

日历和事件

  • Event Creator — Create calendar events from sheet rows
  • Availability Search — Check calendar availability for meeting slots Pro
  • Slides Creator — Create Google Slides from sheet data Pro
  • Doc Audit Log — Track document edits with an audit trail

通知

  • Mail Merge — Send personalized bulk emails from sheet data Pro
  • Slack/Discord — Send notifications to Slack or Discord Pro
  • Chat Notifications — Send messages to Telegram or WhatsApp Pro
  • Send SMS — Send SMS via Twilio from sheet data Pro
  • Currency Rates — Fetch and log exchange rates
  • Form to Sheet — Create an HTML form that saves to a sheet Pro
  • Export Range to PDF — Export a sheet range as PDF/PNG/JPEG
  • Backup with Timestamp — Backup a sheet to Drive with timestamp

Vault（保险库）

Vault 是一个个人空间，您可以保存最常用的 blocks，以便在不同项目和设备之间重复使用。将 block 保存到 Vault 后，它会自动在云端同步。

本节截图

免费计划用户最多可以在 Vault 中保存 2 个 blocks。Pro 计划用户没有限制，可以保存所需的任何数量的 blocks。

  1. 点击 block 卡片上的保存图标（磁盘）
  2. 该 block 将被添加到您的个人 Vault 中
  3. 要访问已保存的 blocks，请转到 Blocks 面板中的 Vault 选项卡
  4. 要从 Vault 中删除 block，请点击垃圾桶图标。
Blocks 在所有版本的 GASE 中都可用。如果某个 block 需要 Pro 计划而您没有，您将看到视觉指示器和激活试用或购买计划的链接。

AI 助手

AI 助手让您直接在编辑器中与高级语言模型（Gemini、DeepSeek、Claude）对话。您可以要求它编写代码、解释代码、调试、重构或创建新文件。

AI 助手需要 GASE 身份验证和活跃的 Pro 计划或 15 天试用。

首次设置助手

  1. 通过编辑器中的 AI Assistant 按钮打开 AI 聊天
  2. 如果未通过身份验证，将打开登录窗口。使用 Google 账户登录
  3. 如果没有 Pro 计划或试用，点击 Upgrade 并激活 15 天免费试用或购买 Pro 计划
  4. 在 Settings 选项卡中：选择 Provider（Google Gemini、DeepSeek 或 Anthropic Claude），输入 API Key 并点击 Verify 验证，选择 Model 并点击 Save。
本节截图

API Keys

  • Google Gemini: https://aistudio.google.com/app/apikey
  • DeepSeek: https://platform.deepseek.com/api_keys
  • Anthropic (Claude): https://console.anthropic.com/settings/keys

无需重新配置即可更改模型

  1. 在 AI 聊天中进入 Settings
  2. 您将看到当前配置
  3. 从 Change Model 下拉菜单中选择其他模型
  4. 点击 Save Model。更改立即生效。

更改提供商

  1. 在 Settings 中，点击 Change API Key
  2. 从第一个下拉菜单中选择新提供商
  3. 输入新提供商的 API Key
  4. 点击 Verify 验证
  5. 选择所需模型
  6. 点击 Save。

使用聊天

  1. 在文本字段中输入您的问题或请求
  2. 您可以通过输入 @ 后跟文件名来提及项目文件（将出现下拉菜单供选择）
  3. 按 Enter 发送
  4. AI 将以解释和（如适用）代码回复。
本节截图

批准或拒绝建议的更改

当 AI 建议更改文件时，您将在其回复下方看到一张修改卡片。卡片显示文件名、NEW 徽章（如果是新文件）以及 diff（绿色行表示添加，红色表示删除）。点击 Approve 应用更改，或点击 Deny 拒绝。

本节截图
重要提示：如果您批准创建新文件，助手将要求确认重新加载编辑器。这是必要的，因为文件创建使用官方的 Google Apps Script API，编辑器必须刷新。

重要说明

  • 使用 @ 提及的文件将作为上下文发送给模型。选择相关文件以获得更好的回复。
  • AI 可以看到项目的完整结构（文件名和文件夹）。
  • 您可以从 History 选项卡进行多个活跃对话。
  • New Chat 按钮（+ 图标）开始一个没有历史记录的干净对话。

定价

GASE 提供包含所有基本功能的免费计划和包含高级功能的专业版计划。订阅管理通过 Dodo Payments 处理。

免费计划

$0

完整访问除 AI 助手和代码片段商店外的所有功能。

  • 文件树、视觉主题、Vim 快捷键、本地代码片段、.zip 下载、紧凑浏览器和全局搜索。

专业版计划

4 美元 / 月

20 美元 / 年（节省 17%）

包含 15 天免费试用。

所有免费计划功能，外加 AI 助手和云端同步的代码片段商店。

  • 免费计划全部功能 + 大语言模型 AI 聊天助手 + 代码片段商店（上传和下载社区代码片段）。

计划详情：Free、Pro 和 Trial

Free 计划（免费）

  • 所有视觉主题
  • Vim 模式
  • 增强的文件浏览器
  • 本地代码片段管理器
  • 基础 blocks（Vault 中最多 2 个）

Pro 计划（$4/月或 $20/年）

  • Free 中的所有功能
  • 支持 Gemini、DeepSeek 和 Claude 的 AI 助手
  • 社区代码片段商店（导入和上传）
  • 代码片段云同步
  • 高级 blocks + 无限 Vault

Trial（15 天免费试用）

试用版让您免费访问所有 Pro 计划功能 15 天。无需信用卡或支付方式。

本节截图

激活免费试用

  1. 打开 AI 助手或代码片段管理器
  2. 如果没有访问权限，点击 Upgrade
  3. Account 窗口将打开。点击 Start 15-Day Free Trial
  4. 试用即刻激活。您将看到一个黄色的 Trial 徽章及剩余天数。

购买 Pro 计划

  1. 从代码片段管理器或任何升级页面打开 Account 窗口
  2. 选择计划：Monthly（$4/月）或 Yearly（$20/年）
  3. 点击 Upgrade to Pro
  4. 您将被重定向到安全的 Dodo Payments 支付页面
  5. 完成支付。您的账户将自动升级到 Pro
  6. 您将在个人资料中看到紫色的 Pro 徽章。
本节截图

取消订阅

  1. 打开 Account 窗口
  2. 在订阅部分，点击 Cancel Subscription
  3. 确认取消。您的 Pro 访问权限将保留到当前账单周期结束。

退出登录

  1. 打开 Account 窗口
  2. 点击底部的 Logout
  3. 退出登录后，您将失去 Pro 功能访问权限，直到重新登录。

安装

  1. 从 Chrome Web Store 安装扩展程序。该扩展兼容 Google Chrome 和基于 Chromium 的浏览器。 Chrome Web Store →
  2. 通过 chrome.identity 使用 Google 账号授权扩展程序。这使扩展程序能够安全访问你的 Google Apps Script 项目。
    3. 目前我们正在接受谷歌的审核。您可能会看到一个额外的验证页面。如果出现这种情况，请按照以下步骤操作。不久之后，我们将正式通过谷歌的审核，届时您将不会再看到任何额外提示。
    本节截图 本节截图 本节截图 本节截图
  3. 对于专业版计划，请通过 Dodo Payments 完成订阅。你将立即获得 AI 助手、代码片段商店的访问权限以及 15 天的免费试用期。试用期结束后，如果未完成付费订阅，专业版功能将自动锁定。

键盘快捷键

  • 在项目文件之间导航、折叠/展开文件树、在所有文件中搜索文本、下载项目为 .zip、隐藏/显示文件浏览器、按名称搜索文件、切换 Vim 模式、打开 AI 助手（专业版）

故障排除

AI 助手无响应

  • 检查网络连接
  • 确保 API Key 有效且有可用额度
  • 在 Settings > Change API Key 中检查设置并重新验证密钥。

输入 "@" 时没有文件出现

  • 确保项目在编辑器中有打开的文件
  • 如果刚创建或重命名了文件，再次输入 @ 以刷新列表。

扩展不加载 / 看不到任何变化

  • 重新加载 Google Apps Script 编辑器页面
  • 在 chrome://extensions 中验证扩展已启用
  • 如果问题持续，卸载并重新安装扩展。

"requires Pro plan or active trial" 错误

  • 登录 GASE
  • 在 Account 窗口中检查您的计划
  • 如果试用已过期，购买 Pro 计划以继续使用 AI 助手。

GitHub 集成

将您的 Google Apps Script 项目连接到 GitHub 仓库以保持代码同步。您可以推送本地更改、拉取远程更改，并在编辑器中管理一切。

需要登录 GASE API（不需要 Pro 计划）。

连接到 GitHub

  1. 点击 GASE 工具栏中的 GitHub 按钮。将打开一个包含三个选项卡的模态窗口：Connect、Repository 和 Sync
  2. 在 Connect 选项卡中，输入您的 GitHub 个人访问令牌，并可选择输入密码来保护令牌（推荐以增强安全性）。密码在本地加密令牌
  3. 点击 Connect。如果令牌有效，字段将消失，您将看到 Connected as @您的用户名以及 Disconnect 按钮。
本节截图
建议创建带有 fine-grained 权限的令牌，仅限您要使用的仓库。这可以最小化安全风险。您也可以使用经典令牌，但它将对所有仓库拥有更广泛的权限。在模态窗口中，您将找到直接创建令牌的 GitHub 链接。
本节截图

选择仓库

  1. 前往 GitHub 模态窗口中的 Repository 选项卡
  2. 您将看到可用仓库的列表。点击您要使用的仓库
  3. 选择您要使用的分支。
本节截图

同步更改

Sync 选项卡显示有未决更改的文件 — 包括本地更改（在 Apps Script 项目中已修改但未上传的文件）和远程更改（GitHub 上尚未下载的更改）。

Select a repository first。请先前往 Repository 选项卡选择仓库，然后再同步。

Push: Push：将本地更改上传到 GitHub。在您的 Apps Script 项目中修改的文件将发送到仓库。

Pull: Pull：从 GitHub 下载远程更改。仓库中修改的文件将应用到您的 Apps Script 项目中。

本节截图

需要额外的 Apps Script 权限

首次拉取时，您可能需要启用 Google Apps Script API。如果您看到相关消息，请打开 https://script.google.com/home/usersettings 并确保 Google Apps Script API 已启用。启用后，拉取将正常工作。

语言

GASE 提供与本网站相同的 5 种语言：西班牙语、英语、简体中文、俄语和法语。语言将根据浏览器偏好自动设置。