Appllama 使用技能
Appllama 是一个顶级移动应用的库——包含它们真实的界面、流程和 UI 模式，并附带收入与下载量背景信息。MCP 使其成为智能体的研究平台：它不仅是研究工具，更是构建者的工具。 你可以研究已经成功的模式，然后构建出更优秀的作品。
请将此技能与 appllama-design-skill 配合使用——本技能告诉你研究什么，那个技能则告诉你如何构建。
基本规则（请先阅读）
- 从
get_credits开始——免费。 它告诉你余额、限额和重置日期。Pro 版本每月包含 1,500 积分（每月 UTC 时间 1 号完全重置）；其他每个工具调用消耗 1 积分。 - 深入研究。 设计语言存在于整个旅程中，而非样本——请遍历与任务相关的每个应用的每个界面，包括图片。这正是这个库的用途。唯一违反条款的行为是大量抓取：即为了提取整个数据集而非回答真实任务而扫描整个目录。这不是研究，且会在服务端检测到。
- 媒体链接约 1 小时后过期。 请及时下载/查看你研究的材料。如果链接在任务中途失效，请重新请求该页面以获取新链接——界面 ID 是持久的，链接不是。
- 忽略水印。 每张 Appllama 图片和视频均在左上角带有小型 Appllama 水印。它是来源标记，而非界面的一部分——请勿让它影响你对左上角（状态栏、返回按钮、标题）的判断，也绝不要在你构建的任何内容中复制它。
- 分页是顺序的。 每个列表响应都带有
next_cursor；将其传回以继续。你不能直接跳转到第 N 页——且游标仅对生成它的同一查询有效。如果游标出错，请丢弃它并从第一页重新开始。 - 如果遇到速率限制，请耐心等待。 每分钟和每日的限制远高于真实研究需求；在极少数遇到限制的情况下，请等待指定的时间——不要反复重试。
- 错误即是指令。 工具错误信息本身就需要你采取行动（游标过期 → 重新开始；积分用完 → 告知用户积分在每月 1 号重置，并且他们可以在“设置 → 使用情况”中请求更多积分）。
工具映射
| 工具 | 功能 | 典型用途 |
|---|---|---|
get_credits | 余额、限额、重置日期。免费。 | 会话开始 |
search_apps | 每页 10 个应用：名称、收入、下载量、评分、上线日期、界面数量、流程列表及界面数量。支持自然语言 query + 筛选条件（收入/下载量/评分/上线日期/价格/引导步骤）+ sort + board_id | 查找某个类别或需求下的顶级应用 |
get_app | 单个应用的完整信息：评分细分、分类排名、内购定价、主要国家、流程 | 决定某个应用是否值得深入研究 |
list_app_screens | 每页 10 个界面，按旅程顺序排列（欢迎页 → 引导页 → 付费墙 → 产品页），每个界面包含媒体链接、流程、UI 元素、颜色。可按 flow 或 section 筛选 | 逐个浏览应用的界面 |
search_screens | 跨整个库搜索界面。mode="keyword" 按界面名称 + 筛选条件（流程、界面类型、元素、应用 ID）匹配；mode="semantic" 按含义/视觉语言搜索 | 收集某种界面类型的设计参考 |
get_screen | 单个界面的完整信息 + 最多 5 个来自其他应用的视觉相似界面。接受 screen_ref = app_id/screen_id（如 appllama.io 的“复制界面 ID”生成的格式） | 用户粘贴了界面引用；或深入研究某个参考 |
list_flows | 流程分类法，包含界面/应用数量 | 发现某个类别下有哪些流程存在 |
get_flow_apps | 包含某个流程的应用，按收入从高到低排列 | 找到某个流程的最佳示例 |
list_ui_elements | 约 38 个 UI 元素家族及其数量（一次调用） | 元素级研究的词汇表 |
get_element_screens | 包含某个元素家族的界面 | 研究赢家如何构建某个组件 |
list_my_boards | 用户自己的 appllama.io 面板（界面/应用/流程） | 优先查找他们的收藏内容 |
get_board | 面板的完整内容：带有媒体的界面、应用简介或（应用、流程）对 | 如果用户已经为任务整理了面板，请从这里开始 |
screen_ref 交互方式： 用户可以在 appllama.io 上点击任何界面的“复制界面 ID”，然后粘贴给你。它的格式类似 1393061654/spl_9i075——直接将其传给 get_screen(screen_ref=...)，你就能看到他们所指的精确界面及其在库中最相似的兄弟界面。
操作指南
| 场景 | 参考文档 |
|---|---|
| 从头构建一个应用（例如“帮我构建一个习惯追踪器”） | references/build-from-scratch.md |
| 改进现有界面 | references/improve-a-screen.md |
| 流程及元素研究；通用研究方法 | references/research-methods.md |
两个构建指南的结尾相同：使用 appllama-design-skill 的模拟器循环，重复直到你找不到任何缺陷。 没有这个循环的研究只是装饰。
本地参考面板
当你拉取界面进行研究时，请将它们保存到本地工作结构中——链接约一小时后过期，但你的笔记和下载不会：
research/
<category>/
apps.md # 短名单：指标、流程、结论
<app-name>/
screens.md # 每个界面的笔记：ID、名称、流程、元素、颜色
img/ # 下载的界面，按旅程顺序排列
patterns.md # 跨应用综合：该类别的设计语言
在研究的同時下载界面——综合时需将图片并排放置，而非仅凭元数据。笔记和界面 ID 是持久的；如果你需要再次查看像素，可通过 ID 重新获取新链接。