# Railway 替代方案：文件夹部署与 setup agent | Appaloft

> 开源的 Railway 替代方案。本机 Agent 门：先运行 `appaloft setup agent`，再运行 `appaloft deploy .`。不强制 git 的文件夹部署。每次部署前先问人类。成功后返回这个应用的线上网址。

本文件是 Agent 门的默认索引。人类选择「部署」或 Agent。编程 Agent 从这里开始。

## 权威链接

- 人类访客：https://www.appaloft.com/zh-CN
- Agent 索引：https://www.appaloft.com/zh-CN/llms.txt
- Agent setup briefing：https://www.appaloft.com/index.md
- 同一份 briefing：https://www.appaloft.com/start.md
- 部署：https://www.appaloft.com/zh-CN/deploy
- Agent：https://www.appaloft.com/zh-CN/agents
- 第一次部署：https://docs.appaloft.com/start/first-deployment
- Skill：https://docs.appaloft.com/agents/skill
- MCP：https://docs.appaloft.com/agents/mcp
- CLI：https://docs.appaloft.com/reference/cli
- 入口：https://docs.appaloft.com/start/entrypoints
- 部署 skill：https://docs.appaloft.com/agents/deploy-skill
- GitHub：https://github.com/appaloft/appaloft
- Console：https://app.appaloft.com

## 配置顺序

Grok Bot 用户：先 Add Appaloft 插件，再 Authenticate。本机默认门仍是 `appaloft setup agent`，给这台机器上的 Cursor / OpenCode。

1. 先询问用户再改本机，然后运行 `appaloft setup agent`。它把 skill 和 MCP 写入这台机器上已有的 Cursor 或 OpenCode。它不会部署。
2. Codex 仍需要 `appaloft auth mcp login` 和 `appaloft auth mcp codex install`。
3. OpenCode 可能需要 `--agent opencode`。
4. 每次部署前先问人类。
5. 然后 `appaloft deploy .`。返回这个应用的线上网址。失败必须非零退出。
6. 如果还没登录，会被要求登录。可用的 Server 是路径的一部分。
7. 禁止导出 token。永远不要让用户把 cookie、bearer 或私钥粘贴到对话里。
8. 如果用户拒绝，只使用公开文档，不要做任何账户操作。

## 不要编造

- 不存在 `appaloft agent`、`appaloft up`、`appaloft projects create` 或 `curl agents.appaloft.com | sh`。
- 不要打印 `--agent cursor`，也不要把 `agent-adapter install` 写成「让 Cursor 能部署」。
- 不要把 `appaloft mcp --help` 当成用法。
- `curl -fsSL https://appaloft.com/install.sh | sudo sh` 是自托管控制面安装器，不得写成开发者 CLI 或 Agent 安装。
- 开发者 CLI 安装（文档）：`npm i -g @appaloft/cli` 或 `brew install appaloft/tap/appaloft`。