appllama-usage

Appllama 使用技能

Appllama 是营收最高的移动应用设计库，包含它们的真实屏幕、流程和 UI 模式，以及营收和下载量背景信息。MCP 将该设计库交到 Agent 手中：**它不只是研究工具，更是构建工具。**研究已经成功的设计，然后打造更好的产品。

每个设计／实现步骤都要搭配 appllama-app-design-skill 使用：本技能告诉你要研究什么；另一个技能告诉你如何构建。

基本原则（请先阅读）

1. **先调用 get_credits——它是免费的。**它会显示余额、限制和重置日期。Pro 每月包含 1,500 点数（每月 1 日按 UTC 时间全额重置）；其他每次调用都会消耗 1 点数。
2. **深入研究。**设计语言体现在完整的用户旅程中，而不是某个样本里——仔细查看与任务相关的应用的每个屏幕，包括图片。这正是该设计库的用途。唯一违反条款的行为是抓取数据：扫遍整个目录，目的是提取数据集本身，而非解决实际任务。这不属于研究，而且会在服务端被检测到。
3. **媒体 URL 大约 1 小时后过期。**请及时下载／查看研究内容。如果链接在任务中途失效，请重新请求该页面以获取新链接——屏幕 ID 长期有效，链接则不然。
4. **忽略水印。**每张 Appllama 图片和视频的左上角都有一个小小的 Appllama 水印。它用于标明来源，并非屏幕的一部分——不要让它影响你对该角落（状态栏、返回按钮、标题）的判断，也不要在你构建的任何内容中复现水印。
5. **分页必须按顺序进行。**每个列表响应都包含 next_cursor；传回该值即可继续。你不能跳到第 N 页，而且游标只适用于生成它的同一个查询。如果游标报错，请丢弃它并从第一页重新开始。
6. **遇到速率限制时，请耐心等待。**每分钟和每日限制远高于实际研究所需；如果极少数情况下触发限制，请等待提示的时间，不要反复重试。
7. **错误信息会告诉你该怎么做。**工具错误的说明可以直接照着处理（游标过期 → 重新开始；点数不足 → 告知用户点数会在每月 1 日重置，并且可以在 Settings → Usage 中申请更多点数）。

工具概览

工具	提供的信息	典型用途
get_credits	余额、限制、重置日期。免费。	会话开始时
search_apps	每页 10 个应用：名称、收入、下载量、评分、发布日期、屏幕数量、包含屏幕数量的流程列表。自然语言 query + 筛选条件（收入/下载量/评分/发布日期/价格/引导步骤）+ sort + board_id	查找某个类别或需求的热门应用
get_app	单个应用的完整信息：评分明细、类别排名、应用内购买定价、热门国家、流程	判断某个应用是否值得深入研究
list_app_screens	按用户旅程顺序排列的每页 10 个屏幕（欢迎 → 引导 → 付费墙 → 产品），每个屏幕都包含媒体 URL、流程、UI 元素、颜色。可按 flow 或 section 筛选	逐屏浏览某个应用
search_screens	搜索整个资料库中的屏幕。mode="keyword" 可匹配屏幕名称并应用筛选条件（流程、screen_type、元素、app_id）；mode="semantic" 按含义/视觉风格搜索	为某种屏幕类型搜集设计参考
get_screen	单个屏幕的完整信息，以及来自其他应用的最多 5 个视觉相似屏幕。接受 screen_ref = app_id/screen_id（appllama.io 的“Copy Screen 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 的任意屏幕上点击“Copy Screen ID”，然后粘贴给你。它看起来像 1393061654/spl_9i075 — 直接传给 get_screen(screen_ref=...)，即可查看他们所指的确切屏幕，以及资料库中最相似的屏幕。

操作指南

场景	参考文档
从零开始构建应用（例如“帮我构建一个习惯追踪应用”）	references/build-from-scratch.md
改进现有屏幕	references/improve-a-screen.md
流程与元素研究；通用研究方法	references/research-methods.md

两份构建指南都以相同方式收尾：**反复运行 appllama-app-design-skill 中的模拟器循环，直到找不到任何缺陷。**不经过这个循环的研究只是装饰。

本地参考看板

提取屏幕进行研究时，请将它们保存到本地工作目录结构中 — 链接约一小时后会失效，但笔记和下载内容不会：

research/
  <category>/
    apps.md            # the shortlist: metrics, flows, verdicts
    <app-name>/
      screens.md       # per-screen notes: id, name, flow, elements, colors
      img/             # downloaded screens, in journey order
    patterns.md        # cross-app synthesis: the category's design language

研究时下载屏幕 — 综合分析需要将图片并排比较，而不是只看元数据。笔记和屏幕 ID 都可以长期保存；如果之后还需要查看图片，可以通过 ID 重新获取有效链接。