For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/web/agent-setup.md (or send Accept: text/markdown).
让代理完成安装
把一条现成的提示词粘贴给编码代理，让它在你的计算机上运行 Web 安装流程，并检查它为每个步骤写下的报告。
枯燥的部分可以交出去
这个存储库是按“编码代理也能读懂”来编写的。它附带一份地图文件（llms.txt）、一份规则文件（AGENTS.md）、一份分步骤运行手册（docs/agent-setup.md）和一条现成的提示词（prompts/agent-setup.md）。你不必自己逐条学习安装命令——粘贴一条提示词，代理就会在你的计算机上照着运行手册执行。
把敲键盘的活交出去并不意味着跳过检查。代理在你的存储库副本中工作，并且必须拿出证据汇报它做了什么。下面几节展示一份合格的报告长什么样，让你始终掌控结果。
一个需要如实说明的限制：这条自动化路径安装的是 Web 应用及其后端——即处理账户和数据的服务器。该提示词和运行手册随 Web 存储库以及 All Platforms monorepo 一起提供。纯 Mobile 和纯 Desktop 检出则改为携带各自限定范围的 llms.txt 和平台安装指南。
先准备好这些
先完成准备指南：安装 Node.js、Git 和编辑器，接受 GitHub 邀请，并把 supastack 文件夹下载到你的计算机。代理在该文件夹内工作，因此开始之前中的所有内容依然适用。
你还需要一个能充当编码代理的工具——内置 AI 编码代理的编辑器（AI IDE），或在终端中运行的代理（代理 CLI）。任何具备代理能力的现行工具都可以；提示词已经写明它必须读什么、运行什么，你不必自己编写指令。
最后，运行应用的方式二选一：在计算机上安装 Node.js 22 或更新版本——即准备指南配置好的路径——或者使用 Docker、Podman 这类容器工具，把应用跑在容器里，无需安装 Node.js。在提示词中选择其一，代理会照此执行。
复制提示词、填两个空、粘贴
在编辑器中打开 prompts/agent-setup.md——它位于 supastack 文件夹顶层的 prompts 文件夹中，与 llms.txt 并列。全选其文本并复制。
有两个占位符需要你做出选择。把 <SETUP_PATH: docker | podman | host> 替换为 docker、podman 或 host 之一——host 用你已安装的 Node.js 直接在本机运行应用；docker 或 podman 则把它运行在容器中。把 <DEPLOY_TARGET: coolify | vps-docker | local-only> 替换为应用最终的去处——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 背后要能看到真实的健康响应和命令输出——而不是一句“一切正常”。
提示词要求代理在同一步骤失败两次后停下并汇报——而不是绕过失败——并在执行清空数据库这类破坏性操作前先征得你同意。如果你的代理在反复失败后仍自行发挥，让它停下，把第一个错误带到故障排查指南。
有两件事绝不允许出现：为了消除报错而关掉某个安全功能，以及把密码或密钥之类的机密值打印到对话或报告里。看到任何一种，都把这次运行视为失败。
在头脑中把演示和真实登录分开。/dashboard 演示的本地参考流程不需要数据库，因此它可以独立通过；而在 /auth 创建账户只有迁移运行后才会成功。“演示跑通了”还不等于“账户能用”。
如果你更想自己动手
上面的每一步也都有对应的逐步点击教程。先跑五分钟 Web 指南完成首次演示，再按 Web 本地安装搭建带真实数据库的完整本地环境。
即便安装不是代理做的，它在安装完成后依然有用——代理工作流指南涵盖新界面、改版式和审查等日常任务。