> ## 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 # 让代理完成安装 把一条现成的提示词粘贴给编码代理，让它在你的计算机上运行 Web 安装流程，并检查它为每个步骤写下的报告。 ## 枯燥的部分可以交出去 这个存储库是按“编码代理也能读懂”来编写的。它附带一份地图文件（`llms.txt`）、一份规则文件（`AGENTS.md`）、一份分步骤运行手册（`docs/agent-setup.md`）和一条现成的提示词（`prompts/agent-setup.md`）。你不必自己逐条学习安装命令——粘贴一条提示词，代理就会在你的计算机上照着运行手册执行。 把敲键盘的活交出去并不意味着跳过检查。代理在你的存储库副本中工作，并且必须拿出证据汇报它做了什么。下面几节展示一份合格的报告长什么样，让你始终掌控结果。 一个需要如实说明的限制：这条自动化路径安装的是 Web 应用及其后端——即处理账户和数据的服务器。该提示词和运行手册随 Web 存储库以及 All Platforms monorepo 一起提供。纯 Mobile 和纯 Desktop 检出则改为携带各自限定范围的 `llms.txt` 和平台安装指南。 [在本地安装 Mobile 应用](https://supastack.dev/zh/docs/mobile/local-setup.md) [运行 Desktop 应用](https://supastack.dev/zh/docs/desktop/run.md) ## 先准备好这些 先完成准备指南：安装 Node.js、Git 和编辑器，接受 GitHub 邀请，并把 supastack 文件夹下载到你的计算机。代理在该文件夹内工作，因此[开始之前](https://supastack.dev/zh/docs/web/before-you-start.md)中的所有内容依然适用。 你还需要一个能充当编码代理的工具——内置 AI 编码代理的编辑器（AI IDE），或在终端中运行的代理（代理 CLI）。任何具备代理能力的现行工具都可以；提示词已经写明它必须读什么、运行什么，你不必自己编写指令。 最后，运行应用的方式二选一：在计算机上安装 Node.js 22 或更新版本——即准备指南配置好的路径——或者使用 Docker、Podman 这类容器工具，把应用跑在容器里，无需安装 Node.js。在提示词中选择其一，代理会照此执行。 ## 复制提示词、填两个空、粘贴 在编辑器中打开 `prompts/agent-setup.md`——它位于 supastack 文件夹顶层的 `prompts` 文件夹中，与 `llms.txt` 并列。全选其文本并复制。 有两个占位符需要你做出选择。把 `` 替换为 docker、podman 或 host 之一——host 用你已安装的 Node.js 直接在本机运行应用；docker 或 podman 则把它运行在容器中。把 `` 替换为应用最终的去处——local-only 只在本机运行、不做任何部署，是首次体验的合适选择。 把改好的文本粘贴到代理的对话框中并发送。下方填好的第一行展示了 docker 加 local-only 的组合；该行下面的编号步骤保持文件原样即可。 ``` Stand up this supastack checkout end to end for **docker** and deploy it to **local-only**. ``` ## 代理拿到提示词后做什么 提示词把代理指向运行手册和安全规则，并要求它按顺序执行、逐阶段自证。通俗地说，代理会： - 动手之前先读仓库地图（`llms.txt`）、项目规则（`AGENTS.md`）和凭据处理规则（`docs/agent-security.md`）。 - 用 `node scripts/setup-env.mjs` 创建 `.env` 配置文件。该辅助脚本只从 `.env.example` 复制，因此代理绝不会编造设置名；它也会保留你已有的密钥，而不是覆盖它们。 - 启动 Postgres——存放应用账户与记录的数据库——以及应用本身：docker 或 podman 路径使用容器，host 路径则直接在你的计算机上运行命令。 - 在第一次真实登录之前运行数据库迁移——即创建应用数据表的命令——因为在数据表尚不存在时创建的账户是坏的。 - 在每个检查点验证对应阶段，最后交出一份报告，把每项检查标记为 PASS、FAIL、BLOCKED 或 NOT RUN，并附上支撑结论的输出。 ## 你要在代理报告里检查什么 合格的报告展示的是证据而不是结论。每个 PASS 背后要能看到真实的健康响应和命令输出——而不是一句“一切正常”。 提示词要求代理在同一步骤失败两次后停下并汇报——而不是绕过失败——并在执行清空数据库这类破坏性操作前先征得你同意。如果你的代理在反复失败后仍自行发挥，让它停下，把第一个错误带到[故障排查指南](https://supastack.dev/zh/docs/web/troubleshooting.md)。 有两件事绝不允许出现：为了消除报错而关掉某个安全功能，以及把密码或密钥之类的机密值打印到对话或报告里。看到任何一种，都把这次运行视为失败。 在头脑中把演示和真实登录分开。`/dashboard` 演示的本地参考流程不需要数据库，因此它可以独立通过；而在 `/auth` 创建账户只有迁移运行后才会成功。“演示跑通了”还不等于“账户能用”。 ## 如果你更想自己动手 上面的每一步也都有对应的逐步点击教程。先跑[五分钟 Web 指南](https://supastack.dev/zh/docs/web/ship-in-5-minutes.md)完成首次演示，再按 [Web 本地安装](https://supastack.dev/zh/docs/web/local-setup.md)搭建带真实数据库的完整本地环境。 即便安装不是代理做的，它在安装完成后依然有用——[代理工作流指南](https://supastack.dev/zh/docs/web/agents.md)涵盖新界面、改版式和审查等日常任务。 ## 下一篇 [5 分钟启动](https://supastack.dev/zh/docs/web/ship-in-5-minutes.md)