不写后端,也能做 AI 应用
写一个网页应用,通过 SDK 调用任意模型,打包成 zip 上传。用户用 RunApps 账号登录并为自己的 AI 用量付费——你不用管服务器,也不用管 API Key。
发布免费 · 用户为自己的用量付费
查看完整文档 →上传之前
应用一创建就有 slug,不需要先传 zip。在自己电脑上对着这个 slug 开发,发布后的应用用的是同一个身份。
- 1
先把应用建成草稿
控制台 → 创作者 → 发布:填名称和描述,包留空,保存;或者让你的 Agent 调 create_app。草稿只有你自己可见,不会进入审核。
- 2
把开发服务器指向它
把 slug 作为 SDK 的 project 选项传入。从 http://localhost 登录可用,调用走真实网关、从你自己的余额扣费,文件落在应用的真实命名空间。
- 3
做好了再上传
构建、打 zip、上传到同一个应用。slug、文件、提示词都已就位,本地跑通的代码就是上线的代码。
// The slug from your draft app — the same one the published
// app will have, so nothing changes at upload time.
const client = new RunApps({ project: "my-tool" });
const resp = await client.chat.create({
model: "Claude Sonnet 4.6",
messages: [{ role: "user", content: "Hello!" }],
// While developing, send a prompt inline; ship it as
// .private/prompts/outline.md and use { id: "outline" } later.
prompt: import.meta.env.DEV
? { template: "You write outlines in five acts." }
: { id: "outline" },
});让你的 AI Agent 来做
Claude Code、Codex、Cursor 或任何 MCP 客户端都能替你创建应用、上传包、发布。对 Agent 说一句话,你点一下即可。
- 1
把这句话发给 Agent
它会读接入页面,向 RunApps 申请密钥,然后给你一个链接。
- 2
在浏览器里批准
你会看到 Agent 的名字和它想做的事,不想给的权限取消勾选即可。永远不需要替它输入密码。
- 3
它来构建、上传、发布
通过 RunApps 的 MCP 服务:create_app、upload_bundle、update_app、get_review。它的密钥显示在 API 密钥页面,随时可撤销。
Read https://www.runapps.ai/agent/setup.md
and connect to RunApps.安装 skill 让 Agent 了解平台:npx skills add runapps/skills
三步发布
- 1
用 SDK 调用 AI
加一行 script 标签,或 npm i @runappsai/sdk。用户用 RunApps 账号登录,代码里不需要 API Key。
- 2
上传 zip
上传构建好的静态文件,应用自动上线到专属的 runapps.dev 链接。
- 3
上架
直接分享链接,或提交审核后上架到应用库。
npm i @runappsai/sdk<script src="https://www.runapps.ai/sdk/latest.js"></script>
<script>
const client = new RunApps();
const resp = await client.chat.create({
model: "Claude Sonnet 4.6",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);
</script>把提示词留在服务端
前端代码里的任何东西都能在浏览器里看到。把提示词作为文件放进 zip,在 bundle.json 里登记:RunApps 从不对外提供这个文件和它登记的任何文件,应用只按 id 调用,聊天、图片、视频、语音模型都一样。
- 1
写提示词文件
每个提示词一个 Markdown 文件,放在项目任意位置,比如 prompts/outline.md,再在 zip 根目录的 bundle.json 里把 id 指向它;很短的提示词也可以直接写在 bundle.json 里,形式是 { "text": "…" }。调用时才填的内容写成 {{genre}} 这样的占位符。
- 2
按名字调用
调用 chat.create 时,用 prompt 参数传入提示词的名字和变量值(见右侧代码)。服务端把提示词作为系统消息加进去,网络上只传名字。图片、视频、语音调用也接受同样的 { id, vars },放在原来的 prompt 文本(或要朗读的 input)的位置,填好变量的提示词就是发给模型的文本。
- 3
和构建产物一起打包
把 bundle.json 和提示词文件复制进构建产物一起打 zip。发布页会列出识别到的提示词。放在 .private/prompts/ 下、以 id 命名的文件(比如 .private/prompts/outline.md)不用登记;也可以在 bundle.json 里用 prompts_dir 指定别的目录,整个目录都不会对外提供。
本地开发时
在自己的开发服务器上还没有上传的包,所以把提示词原文作为 prompt.template 一起发。服务端只接受应用创作者这样做;import.meta.env.DEV 保证正式构建里不会带上原文。
平台会要求模型对提示词保密,回复里一旦原样复述提示词就会被拦截。但有心人仍可能让模型换个说法透露出来,所以不要把密钥、密码写进提示词。
{
"prompts": {
"outline": "prompts/outline.md",
"rewrite": "prompts/rewrite.md",
"greeting": { "text": "You are the concierge of {{app}}. Be brief." }
}
}You are the outline writer for this studio.
Every story has five acts, with a twist in act four.
Genre: {{genre}}async function privatePrompt(id, vars) {
const prompt = { id, vars };
// Your dev server only: send the text along. Vite drops
// this branch (and the file) from production builds.
if (import.meta.env.DEV) {
prompt.template = (await import(
`../prompts/${id}.md?raw`)).default;
}
return prompt;
}
const resp = await client.chat.create({
model: "Claude Sonnet 4.6",
prompt: await privatePrompt("outline", { genre: "mystery" }),
messages: [{ role: "user", content: idea }],
});npm run build
cp -r bundle.json prompts dist/
cd dist && zip -r ../app.zip .用户的数据,每台设备都有
应用照常把数据存在 IndexedDB 里,RunApps Sync 负责把它带到用户登录的每一台设备:写入提交几秒后上传,其他设备的改动在页面打开、切回前台或恢复联网时下载,徽章显示同步状态。默认开启,不用加代码。
- 1
照常使用 IndexedDB
直接用,或者通过 Dexie、idb、idb-keyval 都可以。在第一次 indexedDB.open 之前创建 client;新设备上第一次打开会等用户的数据到位,所以第一次读取就是完整数据。主键用自己生成的(crypto.randomUUID()),不要用 autoIncrement,两台设备才不会发出同一个 id。
- 2
响应其他设备的改动
其他设备的改动应用到本地时,db:change 事件会给出数据库、表和主键,重新读一遍那张表刷新界面即可。提交成功的 put、add、delete、clear 和游标修改都会同步,Date、Map、Set、二进制和 Blob 原样保留。
- 3
排除只该留在本地的
缓存、解码后的媒体,以及体积大或可以重建的数据:排除一张表('app/cache')或整个库('cache'),或者用 sync: false 整个关掉。同步的数据放在用户在你应用里的文件空间,算作用户的存储用量。
两台设备改同一条记录的不同字段,两边改动都保留;改同一个字段,后写的赢。换一个用户在同一浏览器登录,会从他自己的数据开始。只有登录用户才同步;登录前的写入会先排队,登录后再上传。
// Create the client before the first indexedDB.open.
const client = new RunApps();
const req = indexedDB.open("todo", 1);
req.onupgradeneeded = () =>
req.result.createObjectStore("items", { keyPath: "id" });
const db = await new Promise((ok) => (req.onsuccess = () => ok(req.result)));
// Write as usual; use your own keys, not autoIncrement.
db.transaction("items", "readwrite").objectStore("items")
.put({ id: crypto.randomUUID(), text: "buy milk", done: false });
// Another device changed something: re-read that store.
client.events.on("db:change", ({ store }) => render(store));new RunApps({ sync: false }); // off
new RunApps({ sync: { exclude: ["app/cache"] } }); // keep a store local
client.sync.status(); // idle | syncing | offline | error, pending
await client.sync.now();把数据共享给 app 的所有用户
模板、技能、目录,凡是想持续更新、又不想重新打包 zip 的内容,都可以放进 app 的公开文件夹:任何人都能读,只有你能写。
- 1
写到 _public/ 下
这个文件夹就在你这个 app 的文件里,发布就是普通的写文件。结构由你决定,通常是在文件旁边放一个 index.json。
- 2
任何人都能读,不用 token
client.shared 可以列出和读取文件夹,登录与否都行。覆盖后下次读取就是新内容。读取免费。
- 3
复制的内容归用户所有
client.shared.copy 把文件复制到当前登录用户自己的文件里,按一次写入向用户计费。之后你更新原文件,用户的副本不变。
// Anyone, signed in or not.
const { templates } = await client.shared.json("templates/index.json");
const cover = client.shared.url("templates/a/cover.jpg"); // <img src>, no token
// Copy into the signed-in user's own files.
await client.shared.copy("templates/a/cover.jpg", "my/cover.jpg");
// You, the app's creator.
if (await client.shared.canPublish()) {
await client.shared.put("templates/a/cover.jpg", blob);
await client.shared.put("templates/index.json", JSON.stringify(index));
}