在 Farcaster 的信息流里，一条帖子可以内嵌一个带按钮的卡片，点一下就在客户端里打开一个小应用——这类”迷你应用”（Mini App，前身是 Frames）的运作规格在 Farcaster 官方文档里写得像一份嵌入式产品说明书，拆开看能明白这类”社交流里的网页”到底是什么技术形态。
核心机制是一条元标签。任何网页在 HTML 头部放上 fc:miniapp 标签，内容是一段序列化的嵌入 JSON，这个页面就有资格在一条 cast（帖子）里渲染成富媒体卡片；旧系统用的 fc:frame 标签为兼容继续支持。文档给了完整的字段表：版本号必填；预览图必填且必须是 3:2 比例、不超过 1024 字符的 URL；按钮对象必填，里面有最长 32 字符的应用名和最长 1024 字符的动作；动作本身可以是启动链接，附带闪屏图的图片地址与背景色。卡片显示规则也很克制：图片下面一个按钮，点了才加载应用——“预览零 JavaScript、点开才执行”是这类嵌入设计的安全底色。
点开之后是一台标准化的容器。规格要求宿主客户端在应用上方显示带名称与作者信息的头部、先进闪屏页再交还画面、以竖屏模态呈现，网页端的尺寸被定死在 424×695 像素。应用与宿主之间靠一个基于 postMessage 的 JavaScript SDK 通信——官方明确目前消息格式没有正式规范，统一靠开源包对齐版本。这套约定的意图是让同一个网页在 iOS、安卓、桌面端看起来行为一致。
“manifest 与 embed 的区别”是文档专门开了一章的点：manifest 是你把整个应用正式挂进 Farcaster 生态的注册表，声明域名、图标、开发者；embed 只声明”这一页可以变卡片”。一个只做单次活动页的应用可以没有 manifest；想进应用目录、被搜索发现，manifest 是门槛。开发接入时两条路径的域名验证要求不同，混用最容易在域名迁移场景翻车——官方文档的域名迁移指南专门处理旧链接如何续命。
对用户而言，规格翻译成三条使用判断。其一，卡片图片与按钮文案完全由发布者页面生成，眼见不等于真实域名，点开前看落地域名是唯一的防伪位；其二，Mini App 的登录、钱包交互都发生在宿主上下文里，官方教程覆盖与以太坊、Solana 钱包交互的路径，任何要求越过宿主直接导出私钥的”迷你应用”都直接不符合规范；其三，通知、分享扩展、跨设备深链都在规范里各有章节，一个应用承诺的能力可以在其 manifest 声明里对照。
这类”社交协议 + 嵌入式网页”的形态，本质是把分发权从应用商店换到了信息流。规格文档花了大量篇幅约束的不只是渲染，还有信任的边界：卡片可以出现在任何人的帖子里，而风险永远在点开之后。
按读者角色把这份规格收拢成三张清单。普通用户：把迷你应用看成信息流里的网页即可，但养成两个习惯——点击跳转前看一眼目标域名是不是官方域名，涉及钱包授权的动作在弹出的签名请求里逐字段核对网络与合约地址，迷你应用的身份来自服务器签名，信息流界面不会替你完成这些检查。开发者：元标签三要素（嵌入地址、预览图、就绪状态）是上线的最低配置，图片比例、按钮字段的长度限制按当期规格文档来，规格仍在迭代，把以当期文档为准写进开发流程而不是记在脑子里；用 manifest 区分完整网页与迷你应用，两种接入方式面向的场景不同，选错会让用户预期错位。平台方：客户端只需要信任签名过的元数据，意味着任何合规实现都能接入，但也意味着平台无法替你过滤内容——分发与内容审核的责任边界要在产品文档里写清楚。三个角色共同的底线是：这套规格解决的是网页如何嵌进社交流，它不解决安全与信任，那两件事仍然由发起方和使用者各自负责。
本文为机制说明，不构成任何投资建议。规范随版本演进，以 Farcaster 官方文档当期说明为准。
发表评论
还没有评论，来说两句吧。
评论区为展示样式，提交不会被处理。