> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 你会遇到的词

用大白话解释安装指南、错误信息和产品本身会用到的术语。

## 文件与文件夹

这些词描述的是你下载的代码。每当安装指南让你打开或编辑文件时，都会用到这些名字。

- 存储库（Repository）——项目文件夹加上它的全部变更历史，托管在 GitHub 上并复制到你的计算机。
- 克隆（Clone）——存储库在你计算机上的副本；由 git clone 命令创建。
- Monorepo——一个存储库中放多个应用和共享包；All Platforms 套装就是一个 monorepo。
- package.json——每个应用或包里都有的文件，列出它的名字、命令和所需的库。
- pnpm-workspace.yaml——monorepo 根部的文件，列出哪些文件夹属于该工作区。
- 锁定文件（Lockfile）——记录每个已安装库确切版本的文件，保证每次安装结果一致。


## 计算机上的工具

首次运行前安装一次的程序。指南会在 node --version 这类命令中提到它们。

- 终端（Terminal）——输入命令的窗口，比如 Windows 上的 PowerShell 或 macOS 上的 Terminal。
- Node.js——在浏览器之外运行 JavaScript 的程序；套件的服务器和脚本都跑在它上面。
- npm——随 Node.js 捆绑的库安装器；在本套件中你主要用它来启用 Corepack。
- Corepack——启用项目所指定的确切包管理器版本的工具。
- pnpm——下载库并运行项目脚本的包管理器；通过 corepack pnpm 调用。
- Git——下载你的存储库并记录你对它所做每一次改动的工具。
- 编辑器或 IDE——用来打开文件夹、编辑文件的应用；指南使用 Visual Studio Code。


## 配置用词

设置保存在文件里，而不是终端里。这些词说明它们的位置和叫法。

- 环境变量——形如 EMAIL_PROVIDER=local 的具名设置，改变应用的行为。
- .env——存储库根部的文件，存放数据库迁移等命令使用的设置。
- .env.local——单个应用的设置文件，比如 Web 服务器使用 apps/web/.env.local。
- 机密（Secret）——必须保持私密的值，比如密码或签名密钥；绝不提交它，也别粘进对话。
- API key——外部服务给你的机密字符串，让它认出你的应用是合法调用方。
- 提供商（Provider）——套件可用于 AI、邮件、计费、存储等工作的外部服务。


## 产品里用到的词

运行中的应用及其设置界面使用这些术语。Workspace 带有两个不同含义——注意看上下文。

- 工作区（Workspace）——在产品中，指一个团队各自独立的用户、数据和设置；在 pnpm 命令中，指 monorepo 内的一个包文件夹，用 --filter 选择。
- 授权（Entitlement）——服务器上记录某个工作区被允许使用付费功能的凭证。
- 迁移（Migration）——创建或更新数据表的带版本数据库变更；用命令应用迁移。
- 会话（Session）——告诉服务器“谁在请求”的登录状态，直到过期或你退出登录。
- Webhook——外部服务在某事发生（比如账单已支付）时发送到你应用 URL 的消息。
- 账户与组织（Account vs organization）——账户是一个人的登录身份；组织是成员加入的团队共享空间，也叫工作区。


## Web 开发用词

当你在浏览器中打开应用时，运行、构建和部署指南会用到这些词。

Ctrl + C 指按住 Ctrl、点按 C 再松开——它会停止终端中正在运行的命令。

[动手学习命令、文件和配置](https://supastack.dev/zh/docs/web/terminal-basics.md)

[如何使用这些文档](https://supastack.dev/zh/docs/web/using-the-docs.md)

- localhost——浏览器地址中“这台计算机”的名字；开发期间你的应用就跑在那里。
- 端口（Port）——localhost 后面那道带编号的门，比如 :3000；每个运行中的应用各用一扇。
- 开发服务器（Dev server）——你工作时持续重建并伺服应用的命令；用 Ctrl + C 停止。
- 构建（Build）——把源代码变成服务器可部署的优化文件的那一步。
- 服务器渲染（SSR）——服务器先组装好页面再发送，让第一屏内容完整到达。


## 下一篇

[套件改进时更新你的副本](https://supastack.dev/zh/docs/web/updating-the-kit.md)
