跳转到内容
supastack
浏览文档
桌面端Tauri

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/desktop/agent-setup.md (or send Accept: text/markdown).

让代理完成安装

把一条现成的提示词粘贴到编码代理中，让它在您的计算机上执行 Desktop 安装，然后检查它为每个步骤写出的报告。

询问本指南
打开方式

枯燥的部分可以交出去

这个存储库是按“编码代理也能读懂”来编写的。它附带一份地图文件（llms.txt）、一份规则文件（AGENTS.md）、按文件的记忆笔记（.ai/）以及任务技能（.agents/skills/）。独立的 Desktop checkout 不包含 prompts/ 文件夹，因此现成的提示词直接印在本指南中——请从下方复制，而不是打开某个文件。

把敲键盘的活交出去并不意味着跳过检查。代理在你的存储库副本中工作，并且必须拿出证据汇报它做了什么。下面几节展示一份合格的报告长什么样，让你始终掌控结果。

这条路径会安装 Tauri 外壳及其与 Web 后端的连接——即处理账户和数据的服务器。桌面窗口只显示该后端；如果您的 checkout 也包含 apps/web，代理可以在本地运行它，仅含 Desktop 的 checkout 则需要使用提供给您的可访问后端地址。

先准备好这些

先完成准备指南：安装 Node.js、Git 和编辑器，接受 GitHub 邀请，并把 supastack 文件夹下载到你的计算机。代理在该文件夹内工作，因此开始之前中的所有内容依然适用。

你还需要一个能充当编码代理的工具——内置 AI 编码代理的编辑器（AI IDE），或在终端中运行的代理（代理 CLI）。任何具备代理能力的现行工具都可以；提示词已经写明它必须读什么、运行什么，你不必自己编写指令。

最后，确定提示词要求的两件事：窗口应加载的后端地址——本地后端用 http://localhost:3000，或使用提供给您的 HTTPS 地址——以及这台计算机上是否已安装 Rust 和原生构建工具。

复制提示词、填两个空、粘贴

提示词就是下面的代码块——请全选并复制整个代码块。

有两个占位符需要您来选择。把 <APP_URL> 替换为窗口应加载的后端地址——本地后端用 http://localhost:3000，或使用提供给您的 HTTPS 地址。当 rustc 和 cargo 已能打印版本号时，把 <TOOLCHAIN: present | install> 替换为 present；需要代理先安装 Rust 和操作系统构建工具时替换为 install。编号步骤保持原文不变。

Set up this supastack Desktop checkout end to end and open the Tauri window against the backend at **<APP_URL>**.
1. Read llms.txt, AGENTS.md and docs/agent-security.md before changing anything.
2. Run rustc --version and cargo --version. On **<TOOLCHAIN: present | install>** = install, install Rust and this OS's Tauri prerequisites first, then continue.
3. Run corepack pnpm install.
4. If apps/web exists in this checkout, start it in a second terminal; otherwise verify <APP_URL> answers from this computer and report its status.
5. Start the shell with corepack pnpm --filter @supastack/desktop dev and report whether the window opens, the tray icon appears and the summon shortcut works.
6. Stop after any step fails twice and report the failing command and first error. Ask before deleting anything.

代理拿到提示词后做什么

提示词会把地图、规则和安全检查清单指给代理，并让它按顺序执行安装且逐一证明每个阶段。通俗地说，代理会：

  • 动手之前先读仓库地图（llms.txt）、项目规则（AGENTS.md）和凭据处理规则（docs/agent-security.md）。
  • 检查 Rust 工具链和此操作系统的 Tauri 前置条件，并报告它安装的内容，而不是在编译中途失败。
  • 验证后端在您的地址上确有响应——只有当该 checkout 中存在 apps/web 文件夹时才会自行启动它——而不是假设一台并不存在的服务器。
  • 安装依赖、编译外壳并打开窗口，然后附上实际输出报告窗口、托盘和召唤快捷键的行为。
  • 同一步骤失败两次后停止并报告——它不会绕过失败，也不会在未询问的情况下删除任何东西。

你要在代理报告里检查什么

一份好的报告展示的是证据而不是结论。请寻找每个 PASS 背后的后端 URL 应答、依赖安装完成、一次完成的 Rust 编译和一个打开的窗口——而不是“一切正常”这样的一句话。

提示词要求代理在同一步骤失败两次后停止并报告——而不是绕过失败——并在执行任何破坏性操作前询问您。如果您的代理在反复失败后仍继续自行发挥，请停止它，并把第一个错误带到故障排除指南。

有两件事绝不允许出现：为了消除报错而关掉某个安全功能，以及把密码或密钥之类的机密值打印到对话或报告里。看到任何一种，都把这次运行视为失败。

请在头脑里把外壳和真实登录区分开。窗口显示后端首页只证明外壳可用——真实账户仍需要后端的数据库。“窗口能打开”还不等于“账户可用”。

如果你更想自己动手

代理执行的每一步都在下面的手动指南中完整写出——同样的命令、同样的检查，按您的节奏来。