开发

不写后端,也能做 AI 应用

写一个网页应用,通过 SDK 调用任意模型,打包成 zip 上传。用户用 RunApps 账号登录并为自己的 AI 用量付费——你不用管服务器,也不用管 API Key。

发布免费 · 用户为自己的用量付费

查看完整文档 →

上传之前

应用一创建就有 slug,不需要先传 zip。在自己电脑上对着这个 slug 开发,发布后的应用用的是同一个身份。

  1. 1

    先把应用建成草稿

    控制台 → 创作者 → 发布:填名称和描述,包留空,保存;或者让你的 Agent 调 create_app。草稿只有你自己可见,不会进入审核。

  2. 2

    把开发服务器指向它

    把 slug 作为 SDK 的 project 选项传入。从 http://localhost 登录可用,调用走真实网关、从你自己的余额扣费,文件落在应用的真实命名空间。

  3. 3

    做好了再上传

    构建、打 zip、上传到同一个应用。slug、文件、提示词都已就位,本地跑通的代码就是上线的代码。

main.jshttp://localhost:5173
// 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. 1

    把这句话发给 Agent

    它会读接入页面,向 RunApps 申请密钥,然后给你一个链接。

  2. 2

    在浏览器里批准

    你会看到 Agent 的名字和它想做的事,不想给的权限取消勾选即可。永远不需要替它输入密码。

  3. 3

    它来构建、上传、发布

    通过 RunApps 的 MCP 服务:create_app、upload_bundle、update_app、get_review。它的密钥显示在 API 密钥页面,随时可撤销。

这一句Claude Code · Codex · Cursor · …
Read https://www.runapps.ai/agent/setup.md
and connect to RunApps.

安装 skill 让 Agent 了解平台:npx skills add runapps/skills

三步发布

  1. 1

    用 SDK 调用 AI

    加一行 script 标签,或 npm i @runappsai/sdk。用户用 RunApps 账号登录,代码里不需要 API Key。

  2. 2

    上传 zip

    上传构建好的静态文件,应用自动上线到专属的 runapps.dev 链接。

  3. 3

    上架

    直接分享链接,或提交审核后上架到应用库。

安装npm
npm i @runappsai/sdk
index.html@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. 1

    写提示词文件

    每个提示词一个 Markdown 文件,放在项目任意位置,比如 prompts/outline.md,再在 zip 根目录的 bundle.json 里把 id 指向它;很短的提示词也可以直接写在 bundle.json 里,形式是 { "text": "…" }。调用时才填的内容写成 {{genre}} 这样的占位符。

  2. 2

    按名字调用

    调用 chat.create 时,用 prompt 参数传入提示词的名字和变量值(见右侧代码)。服务端把提示词作为系统消息加进去,网络上只传名字。图片、视频、语音调用也接受同样的 { id, vars },放在原来的 prompt 文本(或要朗读的 input)的位置,填好变量的提示词就是发给模型的文本。

  3. 3

    和构建产物一起打包

    把 bundle.json 和提示词文件复制进构建产物一起打 zip。发布页会列出识别到的提示词。放在 .private/prompts/ 下、以 id 命名的文件(比如 .private/prompts/outline.md)不用登记;也可以在 bundle.json 里用 prompts_dir 指定别的目录,整个目录都不会对外提供。

本地开发时

在自己的开发服务器上还没有上传的包,所以把提示词原文作为 prompt.template 一起发。服务端只接受应用创作者这样做;import.meta.env.DEV 保证正式构建里不会带上原文。

平台会要求模型对提示词保密,回复里一旦原样复述提示词就会被拦截。但有心人仍可能让模型换个说法透露出来,所以不要把密钥、密码写进提示词。

bundle.json不会发给浏览器
{
  "prompts": {
    "outline": "prompts/outline.md",
    "rewrite": "prompts/rewrite.md",
    "greeting": { "text": "You are the concierge of {{app}}. Be brief." }
  }
}
prompts/outline.md不会发给浏览器
You are the outline writer for this studio.
Every story has five acts, with a twist in act four.
Genre: {{genre}}
src/ai.js@runappsai/sdk
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 }],
});
打包shell
npm run build
cp -r bundle.json prompts dist/
cd dist && zip -r ../app.zip .

用户的数据,每台设备都有

应用照常把数据存在 IndexedDB 里,RunApps Sync 负责把它带到用户登录的每一台设备:写入提交几秒后上传,其他设备的改动在页面打开、切回前台或恢复联网时下载,徽章显示同步状态。默认开启,不用加代码。

  1. 1

    照常使用 IndexedDB

    直接用,或者通过 Dexie、idb、idb-keyval 都可以。在第一次 indexedDB.open 之前创建 client;新设备上第一次打开会等用户的数据到位,所以第一次读取就是完整数据。主键用自己生成的(crypto.randomUUID()),不要用 autoIncrement,两台设备才不会发出同一个 id。

  2. 2

    响应其他设备的改动

    其他设备的改动应用到本地时,db:change 事件会给出数据库、表和主键,重新读一遍那张表刷新界面即可。提交成功的 put、add、delete、clear 和游标修改都会同步,Date、Map、Set、二进制和 Blob 原样保留。

  3. 3

    排除只该留在本地的

    缓存、解码后的媒体,以及体积大或可以重建的数据:排除一张表('app/cache')或整个库('cache'),或者用 sync: false 整个关掉。同步的数据放在用户在你应用里的文件空间,算作用户的存储用量。

两台设备改同一条记录的不同字段,两边改动都保留;改同一个字段,后写的赢。换一个用户在同一浏览器登录,会从他自己的数据开始。只有登录用户才同步;登录前的写入会先排队,登录后再上传。

src/db.js数据代码里没有任何 RunApps 专有的东西
// 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));
选项与状态@runappsai/sdk
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. 1

    写到 _public/ 下

    这个文件夹就在你这个 app 的文件里,发布就是普通的写文件。结构由你决定,通常是在文件旁边放一个 index.json。

  2. 2

    任何人都能读,不用 token

    client.shared 可以列出和读取文件夹,登录与否都行。覆盖后下次读取就是新内容。读取免费。

  3. 3

    复制的内容归用户所有

    client.shared.copy 把文件复制到当前登录用户自己的文件里,按一次写入向用户计费。之后你更新原文件,用户的副本不变。

文档里的公开文件夹章节 →
client.shared@runappsai/sdk 0.18
// 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));
}

准备好了吗?

发布你的第一个应用,或者创建 API Key 开始调用模型。

发布应用

发布免费 · 用户为自己的用量付费