> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# VS Code 扩展的命令和设置

> 适用于 VS Code 的 Square Cloud 扩展的所有命令、设置，以及常见问题的解决方法。

## 命令

打开命令面板（`Ctrl+Shift+P` / `Cmd+Shift+P`），然后输入 **Square Cloud**。

| 命令 | 其他入口 |
| - | - |
| `Square Cloud: 连接账户` | 登录视图、未连接时的状态栏 |
| `Square Cloud: 入门` | 登录视图、侧边栏 `...` 菜单 |
| `Square Cloud: 刷新` | 侧边栏标题栏、状态栏 |
| `Square Cloud: 上传新应用` | 侧边栏标题栏、空的应用部分 |
| `Square Cloud: 查看服务状态` | 侧边栏底部（已连接账户时） |
| `Square Cloud: 创建数据库` | 侧边栏 `...` 菜单、空的数据库部分 |
| `Square Cloud: 创建工作区` | 侧边栏 `...` 菜单、空的工作区部分 |
| `Square Cloud: 复制我的邀请代码` | 侧边栏 `...` 菜单 |
| `Square Cloud: 断开账户连接` | 侧边栏 `...` 菜单 |

连接账户后，还可以在命令面板中运行应用和数据库操作。每个操作都会询问要使用哪个应用或数据库，并且只列出适用的对象：“启动”只列出未在运行的应用，“停止”和“重启”只列出未停止的应用，边缘工具只列出网站，指标只列出内存为 512 MB 或以上的应用。

| 分组 | 命令 |
| - | - |
| 生命周期 | 启动应用...、停止应用...、重启应用... |
| 日志和指标 | 查看应用日志...、切换应用实时流...、查看应用 24 小时指标... |
| 部署 | 向应用提交文件...、下载应用快照...、恢复应用快照... |
| 配置 | 编辑应用环境变量...、将应用关联到 GitHub 仓库...、取消应用与 GitHub 仓库的关联... |
| 边缘（网站） | 查看边缘日志...、查看边缘错误...、查看边缘性能...、清除边缘缓存... |
| 其他 | 在网页控制台中打开应用...、复制应用 ID...、删除应用... |
| 数据库 | 启动数据库...、停止数据库...、下载数据库 TLS 证书...、删除数据库... |

侧边栏中每张卡片的菜单里也有相同的操作：右键单击应用、数据库或 workspace，或点击其 ⋯ 按钮。

## 设置

| 设置 | 默认值 | 说明 |
| - | - | - |
| `squarecloud.favApps` | `[]` | 收藏应用的 ID，这些应用会显示在列表顶部。每张卡片上的星标会管理此设置，因此你很少需要手动编辑它。 |

## 激活与刷新

扩展只在需要时激活：当工作区中有 `squarecloud.app` 或 `squarecloud.config` 文件时，或者当你打开 Square Cloud 侧边栏、运行它的某个命令或打开配置文件时。在此之前，它不会有任何后台活动。

激活后，它每 **60 秒** 刷新一次你的账户。VS Code 窗口失去焦点时，轮询会暂停，你回来后会立即刷新，因此闲置的编辑器不会消耗你的 API 配额。触发速率限制时，后台轮询会暂停几分钟，侧边栏会保留当前已显示的内容。

## 故障排除

<AccordionGroup>
  <Accordion title="侧边栏中什么都没有显示">
    请检查是否已连接账户：未连接时，侧边栏会显示登录界面。如果无法访问 Square Cloud、Square Cloud 正在暂停请求或正在维护，侧边栏会说明具体是哪种情况，并提供 **重试** 和 **服务状态** 按钮。
  </Accordion>

  <Accordion title="你的授权已过期或已被撤销">
    授权有效期为 90 天，且无法在后台静默续期。请再次运行 `Square Cloud: 连接账户`。你可以随时在[控制台](https://squarecloud.app/zh/account/security)的 **我的账户 → 验证** 中撤销授权。
  </Accordion>

  <Accordion title="有人发给你一个代码或链接让你批准">
    不要输入它。批准别人的代码会把对方的编辑器连接到你的账户。如果页面拒绝了你粘贴的代码，请从 VS Code 重新开始。
  </Accordion>

  <Accordion title="上传失败，提示缺少配置文件">
    所选文件夹的根目录中需要有 `squarecloud.app` 或 `squarecloud.config` 文件。请参见[配置文件指南](/zh/getting-started/config-file)。
  </Accordion>

  <Accordion title="上传失败，因为 zip 文件过大">
    zip 文件最大为 100 MB。请将构建输出、缓存和依赖文件夹添加到 [`squarecloud.ignore`](/zh/getting-started/squarecloud-ignore) 中。`node_modules` 和 `.git` 已经默认排除，依赖会根据你的清单文件在平台上安装。
  </Accordion>

  <Accordion title="命令失败并显示速率限制消息">
    请稍候再试。后台轮询已经会自动退避，反复重试只会让限制持续生效。
  </Accordion>

  <Accordion title="诊断其他问题">
    打开 **查看 → 输出**，然后选择 **Square Cloud** 通道，即可查看每次 API 调用的日志；在 [GitHub](https://github.com/squarecloudofc/vscode-extension) 上报告 bug 时，请附上这些日志。
  </Accordion>

  <Accordion title="数据看起来已过时">
    点击状态栏项，或侧边栏标题栏中的刷新图标。请记住，窗口失去焦点时轮询会暂停。
  </Accordion>
</AccordionGroup>