← GASE

Wiki

GASE 项目文档 — Google Apps Script Editor。

什么是 GASE？

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

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

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

入门指南

安装扩展后打开 Google Apps Script 项目时，您会注意到编辑器中的几个即时变化：

  • 全新视觉主题：编辑器默认采用现代深色外观，配色针对长时间开发进行了优化。
  • 增强的文件浏览器：左侧面板以树形视图显示，每个文件（.gs、.html）都有自定义图标。
  • 额外按钮：界面中出现新按钮，用于访问代码片段、AI 助手和扩展设置。

要打开扩展的主面板，请点击 Chrome 扩展栏中的 GASE 图标。

本节截图

功能特性

📁

文件树

通过层级可折叠的文件树浏览项目。直接在扩展程序中直观地组织、重命名和管理文件。

🎨

视觉主题

使用多种主题自定义编辑器外观。在浅色、深色和高对比度主题之间切换，减少长时间开发中的视觉疲劳。

⌨️

Vim 快捷键

在编辑器中启用 Vim 模式，使用熟悉的键盘快捷键进行导航、编辑和文本操作，无需鼠标。适合偏好 Vim 效率的开发者。

📦

代码片段商店

在免费版中，你可以创建和管理本地代码片段。使用专业版，可访问代码片段商店上传你的代码片段，并下载社区共享的片段。

🤖

AI 助手（专业版）

与直接集成在编辑器中的大语言模型对话。询问代码相关问题，请求更新现有文件或创建新文件。加速开发的必备工具。

📥

.zip 下载

一键将整个项目下载为 .zip 文件。非常适合本地备份、共享项目或在 Google 账号之间迁移。

🗂️

紧凑浏览器

通过一键或键盘快捷键隐藏或显示文件浏览器。在需要专注于代码时最大化编辑空间。

🔍

全局搜索

同时在项目的所有文件中搜索文本。即时查找变量、函数或任何代码片段，无需手动打开每个文件。

主题与自定义

GASE 包含数十种 Monaco 编辑器视觉主题。您可以随时更改主题并立即看到变化。

  1. 打开 Google Apps Script 编辑器
  2. 在顶部栏中查找主题选择器（显示当前主题名称）
  3. 选择任何可用主题。更改即刻生效。
本节截图

AI 面板位置

您可以为 AI 助手选择两种显示模式：

  • Float: 浮动：聊天窗口以浮动形式叠加在编辑器上方。推荐大屏幕使用。
  • Inline: 内联：聊天窗口作为固定侧边栏集成在编辑器右侧。适合小显示器或保持聊天始终可见。
  1. 打开 AI 助手
  2. 进入 Settings 选项卡
  3. 找到 Position 选择器，选择 Float 或 Inline。
本节截图

Vim 模式

如果您习惯 Vim 快捷键，可以在编辑器中启用 Vim 模式。该模式通过扩展弹出窗口（Chrome 栏中的图标）或键盘快捷键切换。启用后，编辑器将响应标准 Vim 命令：h、j、k、l 导航，i 插入，Esc 返回普通模式，以及您已熟悉的所有命令。

本节截图

文件浏览器

编辑器的左侧面板以分层树形结构显示所有项目文件。点击任何文件即可直接在编辑器中打开。

  • 文件夹：以文件夹图标显示。点击可展开或折叠。
  • .gs 文件：以 JavaScript 图标标识。
  • .html 文件：以 HTML 图标标识。
本节截图

代码片段管理器

代码片段管理器让您创建、编辑和组织可重用的代码片段。就像拥有一个个人代码库，可以快速插入到任何项目中。

要打开管理器，请点击 GASE 工具栏中的 Snippets 按钮，或使用扩展弹出窗口中的快捷方式。

创建新片段

  1. 在管理器面板中点击 + New Snippet
  2. 填写字段：Name（描述性名称）、Prefix（快速插入的简短快捷方式，如 logt）、Description（可选）和 Scope（JavaScript 用于 .gs、HTML 用于 .html，或 All 用于两者）
  3. 点击 Save。
本节截图

将片段插入编辑器

在编辑器中输入片段的前缀并按 Tab 键。片段将自动展开为您定义的代码。

本节截图 本节截图

编辑或删除片段

  1. 在左侧面板的列表中选择片段
  2. 修改字段并点击 Save
  3. 要删除，点击垃圾桶按钮。

代码片段商店

社区商店让您发现其他开发者创建的片段，将其导入到您的项目中，并分享您自己的片段（需要 Pro 计划或活跃试用）。

浏览商店

  1. 打开代码片段管理器
  2. 在右侧面板中，您将看到代码片段商店
  3. 使用搜索栏按名称查找片段
  4. 按最新、最受欢迎或趋势排序。
本节截图

从商店导入片段

  1. 找到您喜欢的片段
  2. 点击 Import
  3. 该片段将添加到您的个人列表中。您可以像编辑其他片段一样编辑它。

上传片段到商店（Pro/试用）

  1. 在个人列表中创建或选择片段
  2. 点击云朵按钮（Upload）
  3. 使用 Pro 计划或活跃试用，片段将发布到商店
  4. 没有 Pro，系统会要求您激活试用或购买订阅。
本节截图

为片段投票 — 如果您已通过身份验证，可以用星级（1-5）评分片段，帮助社区找到最有用的代码。

举报不当内容 — 如果您发现违反规则的片段，可以点击旗帜图标进行举报。管理员将进行审核。

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 下载、紧凑浏览器和全局搜索。

专业版计划

2 美元 / 月

20 美元 / 年（节省 17%）

包含 15 天免费试用。

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

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

计划详情：Free、Pro 和 Trial

Free 计划（免费）

  • 所有视觉主题
  • Vim 模式
  • 增强的文件浏览器
  • 本地代码片段管理器

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

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

Trial（15 天免费试用）

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

本节截图

激活免费试用

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

购买 Pro 计划

  1. 从代码片段管理器或任何升级页面打开 Account 窗口
  2. 选择计划：Monthly（$2/月）或 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 助手。

语言

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