Skip to Content
卡片 SDK在手机上

在手机上

使用远程访问时,手机上能看到整块画布。“一切照常工作”只有一个例外,那就是自定义卡片:手机永远不运行卡片代码。 社区代码只获得一个沙箱,在电脑上,而不是在手机浏览器里再开一个更弱的沙箱。

手机上的自定义卡片会显示:

  • 标题栏——图标、标题、状态标签和徽章,与你的卡片设置的完全一致;
  • 你用 card.setOverview() 设置的概览内容——在任何缩放级别都显示,而不只是缩小时;
  • 一行 “Open on the computer to use this card”。

有人在手机上查看时,所有在电脑上运行的东西都照常工作。智能体调用的工具、投递数据的端口、提示词和命令,都在桌面端卡片的页面中运行—— 只要卡片所在的工作区在电脑上是打开的(暂停的卡片会像平常一样按需唤醒)。

手机无法安装、更新、授予权限、链接文件夹,也无法应答卡片的对话框:这些在远程访问中都被屏蔽,需要在电脑上完成。

为手机而设计

  • 让概览讲清楚情况。 primary 是最重要的那一条信息(3 failing、Deploy ready、Waiting for review),secondary 是细节, progress 是进度条,tone 是颜色,icon 取自宿主图标。只要这条信息变了就更新它。
  • 使用状态标签和徽章展示需要一眼看到的内容。
  • 用户必须行动时,使用 card.attention('needs-input', …)——卡片会闪烁,并被列入收件箱(Inbox)。
  • 不要依赖卡片页面传达任何紧急信息:在手机上的用户看不到、也点不到它。

第 1 版无法在手机上运行你的卡片页面。