Docs › Palmtop › 中文
Palmtop 快速上手
十分钟，从零到一个你用一句话描述出来的手机应用——并且交到别人手里。 需要一点说明的只有两处：告诉 Palmtop 由谁构建，以及构建 → 运行 → 修改这个循环。其余都是点一下的事。
1 · 把 Palmtop 装到手机上
三种方式，都是同一个 Palmtop。网页版现在就能用；两个商店版本处于发布前的最后阶段。
网页版 — 现在就能用，任何手机
在手机浏览器里打开 priorstates.com/palmtop/webapp，然后添加到主屏幕——那个副本才是真正的 Palmtop：存储是永久的、可以离线使用、圈子和分享都会落到那里。
- iPhone（Safari）：点分享 ⎙ → 添加到主屏幕。
- 安卓（Chrome）：菜单 ⋮ → 添加到主屏幕（或安装应用）。
- 在微信里打开的：先点右上角 ⋯ → 在浏览器中打开，再按上面的步骤做。微信内置浏览器不能添加到主屏幕，也不能下载安装包。
从此以后都从主屏幕打开 Palmtop。普通的浏览器标签页有自己单独的存储——这就是为什么在标签页里打开的邀请会提示你把它发到主屏幕上的 Palmtop。
安卓 — 直接下载，不需要 Google Play
在手机上从 Palmtop 页面下载安装包并打开；安卓会询问一次是否允许从浏览器安装。它和 Google Play 上的是同一个应用、同一个签名，国内不用 Google 服务也能装。
iPhone — TestFlight，现在就能装
通过苹果的 TestFlight 安装：在手机上加入测试——它会先让你装 TestFlight，再装 Palmtop。和上面的网页版是同一个版本，多了一个功能：Palmtop 出现在手机的分享面板里。App Store 版本还在苹果审核中；上架后测试版会自动变成商店版。
商店版比网页版多了一样网页做不到的事：Palmtop 出现在手机的分享面板里，别人发来的应用或邀请会直接在它里面打开，而不是在浏览器标签页里。
每个 Palmtop 副本都有自己的存储——主屏幕上的网页版和商店版是同一部手机上的两个独立的 Palmtop，互相看不到对方的应用。要搬过去，在旧的那个里点 设置→备份全部，在新的那个里点 恢复…。 备份文件里故意不包含你的 AI 密钥和与电脑的配对，因为这个文件是要传来传去的——在新副本里重新设置一下（一分钟，第 2 步）。
2 · 设置 AI——由谁构建
Palmtop 自己不带 AI，由你来提供。打开 设置→由谁构建，二选一。以后可以切换；两种方式都把你的应用留在手机上。
A · 这台手机上的 AI — 最快的方式
- 在手机上到 aistudio.google.com/apikey 免费获取一个密钥（只需要一个 Google 账号；国内用不了的话见下面）。
- 回到 Palmtop：设置→这台手机上的 AI，粘贴密钥，点保存，再点测试。
- 模型保持 Flash-Lite（推荐）：免费额度下它每分钟允许的请求数比完整的 Flash 模型多得多，而一次构建是连续 5–10 个请求。
密钥只保存在这台手机上；请求从手机直接发给 Google。
在中国大陆（访问不了 Google）：在服务里选 智谱 GLM（到 open.bigmodel.cn 免费获取密钥，GLM-4-Flash 不收费）或 阿里云百炼 Qwen（bailian.console.aliyun.com，新账号有免费额度），然后粘贴那个密钥即可。请求从手机直接发给该服务。
B · 我电脑上的编程助手 — 构建更强，应用保存在 git 里
- 在装有并登录了 Claude Code（或 Codex）的电脑上安装 PriorStates Hub——macOS、Windows 或 Linux——然后打开它。
- 按 Start，再按 Pair a phone：它会显示一个二维码。用手机相机扫（会在 Palmtop 里打开），或者把链接复制到 设置→我电脑上的编程助手。
- 点检查连接。不在家时，手机通过一个读不懂内容的加密中继连到 hub。hub 运行时会让那台电脑保持唤醒；用完按 Stop。
你的应用会提交到电脑上的 git 仓库；设置里的推送到 git / 从 git 拉取在设备之间搬运它们。
构建标签页在对话下方有一行字告诉你当前用的是哪个“大脑”（“由这台手机上的 Gemini 构建”或“由你电脑上的编程助手构建”）。如果它说还没有配置 AI，回到这里。
3 · 做第一个应用
- 打开构建标签页。顶部的一排标签是对话：通用、+ 新建，以及你已有的每个应用一个。
- 点+ 新建，用一两句话描述应用——说它是做什么的、要显示什么。用中文写，做出来的应用就是中文的：
- “这周蔬菜的订货单：西红柿、黄瓜、鸡蛋，带价格；每行填数量，有合计，客户姓名，一个发送按钮。”
- “周末出行的打包清单，按衣物、洗漱用品、证件分组；可以勾选。”
- “周五聚餐的投票，四个选项；每人投一次，看得到票数。”
- 发送 ↑，看着对话：AI 规划、写文件，然后说 done（附带用了几轮）。一次构建从不到一分钟到几分钟不等。
- 到应用标签页——新的图标就在那里。点它。
怎么说效果最好：一次一个应用，具体的名词（项目、字段、按钮），以及用途（“给农场每周订货用”）。不需要说怎么做——不用提技术，不用讲布局。
4 · 运行、修改
点图标全屏打开应用。顶部一栏有 ‹ 返回、↻ 重新加载、 ⤴ 分享，以及 🐞——打开构建器，它会跳到构建标签页里这个应用的对话，并帮你起好头“有个地方不对：”。这就是那个循环：
- 用这个应用。注意缺了什么、哪里不对。
- 🐞（或者 构建 → 这个应用的标签）然后说出来：“在备注下面加一个送货日期选择”、“合计要包含 5% 的费用”、“按钮做大一点”。
- done → 再次打开应用。它的数据（你填过的列表）还在。
长按图标打开它的菜单：打开、用 AI 修改、分享、收件箱（收集回复的应用才有）、删除。 应用标签页上的整理可以拖动图标、建分组（我的、家人……）。
5 · 从模板开始
应用→模板库里有五个现成的应用：订货单、报名表、投票、清单和分账。 点安装，打开它，再用同样的方式改成你的——构建 → 它的标签 → “把项目改成……”。从模板开始往往比从头描述更快。模板本身是英文的，让 AI 改成中文只是一句话的事。
6 · 分享——微信也可以
给一个人
在应用的菜单或顶栏里，分享 → 分享链接。应用在你的手机上加密；密钥只在链接里。用什么发都行——微信、WhatsApp、iMessage、邮件。 对方在 Palmtop 里打开并确认安装。你可以决定数据要不要一起带上（对一份填好的清单来说，这正是重点）。导出文件做同样的事，只是变成一个文件。
要发到公开的地方——群聊、论坛、朋友圈？保持预览卡片勾选并加一张截图：链接会展开成应用的图片、名字和简介，它的页面还会告诉没有 Palmtop 的人去哪里获取。卡片是公开的；应用本身仍然加密。
在微信里收到链接的人：点开就能看到卡片和“在 Palmtop 中打开”。如果要装 Palmtop，页面会提示点右上角 ⋯ → 在浏览器中打开——应用商店和下载在微信内置浏览器里不能用。
给一群人——圈子
圈子→新圈子，然后邀请：把链接发给家人、班级或团队（发到微信群就行）。用 ＋ 在圈子里发布一个应用；每个人都会看到安装，你发布更新时他们会看到更新。
回复。你分享出去的表单（订货单、报名表、投票）会把答案发回给你：长按它的图标 → 收件箱，在那里可以导出成表格。完整的来回过程，两边都讲——会回话的表单（英文）。
遇到问题
- 构建标签页说“还没有配置 AI”——第 2 步。用 Gemini 的，在设置里点测试；用电脑的，点检查连接。
- Gemini 构建卡住或者说在等待——免费额度的每分钟限制；Palmtop 会自己重试。保持 Flash-Lite，或者等一分钟。
- 修改后应用看起来不对——先 ↻ 重新加载；然后 🐞，把你看到的准确地告诉构建器。
- 邀请或分享链接在浏览器标签页里打开了——复制它，在主屏幕上的 Palmtop 里用加入（圈子）或粘贴分享链接（设置 → 分享）。
- 界面是英文的——设置→语言选中文。默认跟随手机的语言。
- 其他问题——service@priorstates.com。我们不收集任何关于你的信息；告诉我们发生了什么、在哪种手机上。