SuperAPI AI 工具集

front-plugin

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

用途:指导使用 Front 官方 Plugin SDK(@frontapp/plugin-sdk)开发可投入生产的 Front 插件,用于在 Front 界面中扩展自定义功能。

主要能力:支持两类插件——侧边栏插件(显示在 Front 侧边栏,展示所选会话的上下文信息)与撰写器插件(显示在消息撰写工具栏,作用于正在编写的草稿)。可订阅 Front.contextUpdates 获取上下文变化;可调用的 SDK 方法包括列消息(context.listMessages())、创建草稿(context.createDraft())、更新草稿(context.updateDraft())、打标签(context.tag())、分配同事(context.assign())、以弹窗打开 URL(context.openUrlInPopup())。上下文类型包含 noConversation、singleConversation、multiConversations、messageComposer。可访问的数据有当前用户 teammate、会话 conversation/conversations、草稿 draft。

使用方式:通过 React 上下文(FrontContextProvider / useFrontContext)订阅并分发 Front 上下文,按 context.type 分支渲染不同界面。快速开始示例包含 src/providers/frontContext.tsx 与 src/App.tsx,依赖 @frontapp/plugin-sdk。详细参考见 rules/ 目录,涵盖上下文类型与接口、全部 SDK 方法签名、草稿创建/更新模式、附件处理与错误处理;资源包括 Plugin SDK Overview、SDK Methods Reference、Getting Started Example 与 npm package。

UI 规范:支持深色/浅色模式,侧边栏较窄不可横向滚动,图标使用 lucide-react,需有加载状态、避免空白屏,并对缺失数据提供回退。

限制:本技能面向 Plugin SDK(客户端,运行于 Front 内嵌 iframe);REST API(服务端、webhooks 与 API 调用,见 packages/core/src/front/client.ts)不在其范围,相关操作应参考 front-webhook 技能。资料未提供具体收费、价格或平台版本信息。