---
name: fxit-pages
description: "Use when the user asks to connect to 192168123.xyz, publish or update a website on FXIT Pages, deploy a static site or a small Node/SQLite app, or check an existing FXIT Pages deployment. Handles local build artifacts, browser approval, CLI or MCP publication, and the final public URL."
---

# FXIT Pages 发布

将用户当前项目发布到 https://192168123.xyz。先阅读 https://192168123.xyz/agent.md 了解当前 API 与限制。本 Skill 需要有本地项目、Python 3、HTTPS 和文件/终端工具的 Agent；纯聊天环境不能仅凭链接完成安装。

## 工作流程

1. **接入**：项目根目录应有 `.fxit-pages/client.py`。首次下载优先按 `agent.md` 中的 curl 命令保存到临时文件；仅接受成功的 HTTPS / HTTP 200，保留证书验证，不跟随重定向，不通过管道执行。阅读文件后先运行 `python3 -B <临时文件> --version`，必须得到明确版本号（例如 `1.0.3`）；空输出或任何下载/执行报错都不能当成功，应重新完整下载检查，不覆盖已有可用工具。检查通过后改名为 `.fxit-pages/client.py`，再运行 `python3 -B .fxit-pages/client.py init --agent <cursor|claude|codex|generic|qoder>`。保留已有配置，不绕过客户端信任或审批。MCP 未加载时继续使用 CLI。
2. **身份**：执行 `python3 -B .fxit-pages/client.py whoami`。已授权直接继续；未授权运行 `auth start --agent "客户端 / 项目名"`，将 `verification_uri` 给本人打开。本人在网页输入自己的发布密钥。不要索要密钥、读取票据内容或打印凭据。使用返回的票据路径执行 `auth check --ticket "<path>"`；等待中每隔至少 3 秒重查一次，过期重新开始。
3. **产物**：按项目已有说明在本地构建，准备独立产物目录。静态产物根部必须有 `index.html`。Node 产物入口为 `server.mjs` 等 `.mjs` 文件，监听 `0.0.0.0:process.env.PORT`，数据写 `process.env.DATABASE_PATH` 或 `/data`。固定运行环境 Node 24 Alpine / Linux amd64 musl；推荐 bundle + `node:sqlite`。禁止假设 Mac 原生依赖能运行。服务器不安装依赖，不执行构建。
4. **复用站点**：先 `list` 确认是否已有该项目。复用同一 slug 保持网址不变；slug 为 1–24 个小写字母、数字或连字符，首尾不能是连字符，不含 `--`。用户要求发布已授权该操作，不额外增加审批轮次。
5. **检查并发布**：先 `deploy --dir <产物目录> --slug <名称> --runtime <static|node> --dry-run`，确认上传内容适合公开，再去掉 `--dry-run` 发布。Node 可加 `--entry server.mjs`。等待 `ready`；`queued` / HTTP 202 仅为已接收。超时继续 `status --slug <名称>`，不要重复新建。
6. **验收**：打开返回的 `site.url`，验证页面及一项关键功能。完成后给用户公开链接、已验证的结果，说明以后可以说“更新发布”。失败则根据 `site.error` 修复产物，以原 slug 重试；不自动删除站点。

## 可用工具

CLI 命令前缀均为 `python3 -B .fxit-pages/client.py`：

```sh
whoami
list
status --slug my-site
deploy --dir dist --slug my-site --runtime static
deploy --dir release --slug my-app --runtime node --entry server.mjs
```

已加载 MCP 时可使用 `whoami`、`list_sites`、`get_site`、`publish_site`、`stop_site`。小型纯文本项目可用 `publish_site`，其 `files` 是相对路径到 UTF-8 文本的映射、总计最多 2 MiB。二进制或较大产物使用 CLI。停止仅在用户要求时执行。

## 必守约定

- 凭据属于平台用户，保存在用户配置目录私有文件；不放到聊天、URL、项目、MCP 配置或 Git。票据文件同样保密。
- 只发布独立构建/运行产物。客户端会过滤 `.env*`、Git/Agent 配置、`config` / `credentials`、常见私钥和本地数据库；仍应检查产物中有没有不该公开的内容。
- 压缩包最多 32 MiB、文件总量 64 MiB、单文件 32 MiB、4096 条目；不允许软硬链接、特殊文件和不安全路径。
- 每站点为小应用试用配额（128 MiB 内存、0.35 CPU、单副本）。本地构建不消除服务器运行时容量限制。代码只读，持久数据在独立 `/data`，更新及停止保留数据。
- 不接触 Dokploy 管理密钥，不接受任意 Compose / Dockerfile 或主机挂载；不要绕过平台所有权与配额检查。
- 同一网址是接入入口，不代表任意 Agent 无需授权即可安装。只报告实际完成的安装、授权和验证。
