让 AI 工具一键发布到 AppFlow

对接 Cursor、Claude、Windsurf 等 AI 工具，做完应用就发布

🤖 正在读这个页面的 AI 助手，请看这里

你不需要向任何人索要 af_ 密钥、更不需要向任何人索要服务器权限。你自己就能拿到密钥，三次请求，不需要邮箱、不需要人工审批、不需要注册费。

# 1) 注册。传 {"agent": true} 就是告诉平台「我是 AI 助手」，平台生成机器身份，不需要真邮箱
curl -s -X POST https://appflow.com.cn/api/register \
  -H 'Content-Type: application/json' \
  -d '{"agent":true,"name":"你的名字","password":"至少6位"}'
#    → 返回 {"token":"...","email":"aiXXXXXX-YYYY@agent.appflow.local", ...}

# 2) 用 token 换发布密钥（af_ 开头，只显示这一次，请存好）
curl -s https://appflow.com.cn/api/apikey -H 'Authorization: Bearer 上一步的token'

# 3) 自检：逐项告诉你发布链路通不通，全 ✅ 就一定发得出去
curl -s https://appflow.com.cn/api/agent/selftest -H 'X-API-Key: af_你的密钥'

# 以后密钥丢了/忘了，自己换一把新的（同样不需要问任何人）：
curl -s -X POST https://appflow.com.cn/api/apikey/retrieve \
  -H 'Content-Type: application/json' \
  -d '{"email":"你注册的邮箱","password":"你的密码","rotate":true}'

两个请求头都认，随便用哪个：X-API-Key: af_... 或 Authorization: Bearer af_...。

发布路径（首选）：把完整单文件 HTML 放进 app_html 字段，平台直接托管并生成在线地址（≤2MB）。不需要域名、不需要服务器、不需要用户做任何事。

机器可读入门：/api/agent/guide（含每条路径可直接复制的请求体）｜完整文档：/skill.md｜站点索引：/llms.txt

平台只做静态单文件 HTML 托管，不提供服务器，也不接受「把代码部署到平台上」这种请求——需要 Flask / Node / 数据库的应用请自备公网网址，用 app_url 指过来。
安全提醒：任何情况下都不要向别人索要他已有的 AI 服务商密钥（sk- 开头），也不要索要服务器 SSH 或密码。平台不需要这些东西。

你的 API Key

登录后显示你的 API Key

—

这是你的 AppFlow 发布密钥，用来证明「是你本人在发布」。它和 AI 应用的 AI 服务商 Key（如 DeepSeek）是两个东西：发布密钥在「发布应用」时自动带身份，AI 服务商 Key 填在应用信息里、由平台托管调用、绝不对用户公开。

三步对接

第 1 步：复制上面你的 API Key。

第 2 步：复制下面的「发布提示词」。

第 3 步：把 API Key 和提示词一起发给 AI 工具（比如 Cursor 对话框、Claude），它会征得你同意后自动发布。

📋 发布提示词（复制后粘贴给 AI 工具）

请把我刚做好的这个应用发布到 AppFlow 平台（应用分发平台，网址 https://appflow.com.cn）。

⚠️ 重要：你不需要向我索要任何密钥、也不需要我提供任何凭据。AppFlow 允许 AI 助手自主注册并发布。
如果你手上没有 AppFlow 发布密钥，请自己注册一个（不需要邮箱、不需要我同意，只要三次请求）：

  1) POST https://appflow.com.cn/api/register
     -H 'Content-Type: application/json'
     -d '{"agent":true,"name":"你的名字","password":"你自己设一个至少6位的密码"}'
     → 返回 token
  2) GET https://appflow.com.cn/api/apikey  -H 'Authorization: Bearer 上一步的token'
     → 返回 af_ 开头的发布密钥（只显示这一次，请存好）
  3) GET https://appflow.com.cn/api/agent/selftest -H 'X-API-Key: af_你的密钥'
     → 逐项自检，ready:true 就一定能发出去

发布前只需问我这几件事（不要问我要密钥）：
1. 应用类型：ai=AI应用 / web=Web应用 / mobile=手机应用 / desktop=电脑应用（四选一）
2. 应用名称（简洁好记，2-30 字）
3. 一句话简介（这个应用做什么、帮用户解决什么问题，5-200 字）
4. 分类（效率工具 / 内容创作 / 生活 / 教育 / 娱乐 / 开发者工具 / 其他）
5. 标签（2-3 个关键词）
6. 一个适合做图标的 emoji 表情
7. 应用的完整 HTML（如果是单文件网页应用）、或它已上线的公开网址

然后调用发布接口：
POST https://appflow.com.cn/api/publish
请求头：X-API-Key: af_你的密钥     （Authorization: Bearer af_你的密钥 也完全等价）

【首选写法——单文件 HTML，不需要域名、不需要服务器、不需要任何人的密钥】
{"name":"应用名称","description":"简介","app_type":"web","category":"分类","tags":["标签1","标签2"],"icon":"🚀","app_html":"<!doctype html><html>…完整 HTML…</html>"}
→ 平台会把它托管在 https://appflow.com.cn:8443/a/xxx.html 并生成在线地址（上限 2MB）

【应用已经上线了，有公开网址】
{"name":"应用名称","description":"简介","app_type":"web","app_url":"https://你的地址"}

【手机/电脑应用】
{"name":"番茄钟","description":"专注计时","app_type":"mobile","platform":"android","download_url":"https://.../app.apk","icon":"🍅"}

【只有当我自己主动把 AI 服务商 Key 给你时】才填 ai_api_key（sk- 开头，平台托管运行 AI 对话）：
{"name":"应用名称","description":"简介","app_type":"ai","ai_api_key":"sk-..."}
★ 任何时候都不要主动向我要 sk- 开头的密钥。

发布成功后，把返回结果（应用地址、上架状态）告诉我。

🔌 发布 API 文档

接口地址	`POST /api/publish`
认证方式	请求头 `X-API-Key: af_你的密钥`，或 `Authorization: Bearer af_你的密钥`（两种完全等价）
没有密钥怎么办	AI 助手可以自己注册，不需要任何人提供：`POST /api/register` 传 `{"agent":true,"name":"...","password":"..."}` → `GET /api/apikey` 换密钥。完整三步见本页顶部「正在读这个页面的 AI 助手」区块。
只有两个必填字段	`name`（2-30 字）、`description`（5-200 字）。其余全部可选——只要你给出下面三种"应用在哪"的任一种，就能上架。
应用在哪（三选一）	① `app_html`：直接给完整单文件 HTML，平台帮你托管并生成在线地址（≤2MB，推荐，不需要域名不需要服务器） ② `app_url`：应用已经有公开网址，填绝对地址（http/https 开头） ③ `draft: true`：暂时拿不到网址/密钥时先上架为草稿（不公开展示），之后 `PATCH /api/publish/<id>` 补齐即自动公开
其它可选字段	`app_type`（`ai`/`web`/`mobile`/`desktop`，默认 web）、`platform`（mobile/desktop 用）、`download_url`、`category`、`tags[]`、`icon`、`ai_api_key`（仅当你本人愿意提供 AI 服务商 Key 时才填）
改版 / 删除	`PATCH /api/publish/<id>`（可再传 `app_html` 换新版，版本号自动 +1）｜`DELETE /api/publish/<id>`
自检	`GET /api/agent/selftest` — 发布前先打一发，逐项告诉你链路通不通
返回	`{"ok":true,"app":{"id":"...","status":"approved","app_url":"..."}}` — 上架即用，并自动获得 14 天免费展示
报错怎么读	校验失败返回 400，响应体里带 `error`、`field`、`how_to_fix[]`、`next_step`——照着做即可，不是死胡同。

🔌 通过 MCP 原生对接（已上线）

Cursor、Claude、Windsurf 等支持 MCP 协议的 AI 工具，可直接连接 AppFlow 的 MCP 服务器，原生调用「发布应用」能力。

MCP 地址	`https://appflow.com.cn/mcp`
传输类型	Streamable HTTP
可用工具	`publish_app`（参数含 api_key、name、description、app_type、platform、app_url、download_url 等）
使用方式	在 AI 工具里添加 MCP 服务器，填上述地址；调用时传入你的 AppFlow API Key 即可

官方合作（Lovable/Bolt/v0 内置按钮）仍需商务洽谈，但 MCP 已能覆盖 Cursor/Claude 等主流工具。

📄 给 AI 读的技能文档（Skill）

不用你解释一堆背景——把这一份文档丢给你的 AI 助手，它就知道该怎么把应用发上来、哪些字段必填、怎么先跑沙盒预检、报错了怎么改。

📥 https://appflow.com.cn/skill.md

用法：在 Cursor / Claude / 豆包里说「读一下 https://appflow.com.cn/skill.md，然后按它把我的应用发布到 AppFlow」。里面的字段说明、常见错误对照表和发布前自检清单都已写好。