用途:该技能指导为 prompts.chat 的提示词信息流创建 widget 插件,用于展示推广内容、赞助卡片或自定义交互组件。
主要能力:widget 支持两种渲染模式——标准 prompt widget(沿用默认 PromptCard 样式)与自定义 render widget(完整自定义 React 组件)。配置项包括:唯一 ID(kebab-case)、名称、slug、标题、描述;标准模式下的 content、type(TEXT 或 STRUCTURED,后者可指定 json 或 yaml)、tags、category;可选动作按钮 actionUrl 与 actionLabel;可选赞助信息(name、logo、logoDark、url);定位策略 positioning(position 为 0 起始,默认 2;mode 为 once 或 repeat;repeatEvery;maxCount);以及 shouldInject 注入逻辑函数,可依据 filters 的 q/category/categorySlug/tag/sort 与 itemCount 决定是否展示,例如仅在无筛选、特定分类、搜索关键词匹配或条目数达标时展示。
使用方式:先向用户收集上述配置,再创建文件 src/lib/plugins/widgets/{widget-id}.ts(标准,TypeScript)或 .tsx(自定义,React);自定义模式使用 render 返回 ReactNode。随后在 src/lib/plugins/widgets/index.ts 中 import 并加入 widgetPlugins 数组完成注册;如有赞助,将 logo 放入 public/sponsors/{sponsor}.svg,深色 logo 可选。最后运行 npx tsc --noEmit 做类型检查,npm run dev 启动开发服务器,访问 /discover 或 /feed 验证 widget 是否出现在配置位置。
适用场景:为提示词信息流插入推广、赞助卡片或自定义交互组件,并可按分类、搜索词、条目数等条件定向展示。
限制:资料中未说明收费、价格、平台兼容性或性能影响;资料仅涉及 prompts.chat 内部插件体系。资料未提供依赖版本要求与部署方式。