SuperAPI AI 工具集

widget-forms

通用与其它

查看项目

更新于 10-15 17:33

技能介绍

用途:在 ChatCut 的 Codex 或 Claude Code 插件宿主中,把调用方与宿主无关的表单契约,转换为当前宿主支持的结构化输入界面,收集用户回答后交回调用方工作流。它只负责宿主适配,不决定工作流需要哪些字段。

主要能力:映射语义字段类型。short_text 为一个文本输入;explicit_consent 为一个初始未选中的确认控件,必须使用调用方完整的本地化文案,附件或其他已提交字段不算同意;audio_reference 不录制、不上传媒体,先渲染其他字段,再请用户把音频附加到对话,随后加载 asset-import,并返回导入后的 ChatCut 音频 assetId;playable_single_choice 为带稳定选项值、本地化标签及可选可播放媒体的选择界面;playable_preview 为只展示、不提交的音频界面,必须使用调用方提供的运行时媒体 URL 和宿主支持的安全媒体渲染方式。

使用方式:在 Codex 中调用 ChatCut MCP 工具 ask_followup_questions,把相关字段放入同一表单,可见文本用用户语言,调用后停止等待回答;playable_single_choice 映射为 variant:"voice",MG 参考样式与 AI 头像身份映射为 variant:"visual"。在 Claude Code 中改用 chatcut-plugin-basics-claude 的结构化输入配方:一个 visualize.show_widget Elicitation 表单,仅通过 .elicit-submit 提交,并等待用户发送填好的提示;不要在 Claude Code 调用 ask_followup_questions。

适用场景:需要用户填写或确认结构化信息、选择语音、选择 MG 参考样式、选择 AI 头像身份,或展示音频预览的插件流程。

限制:插件表单不能录制或上传媒体;不得返回本地路径、附件 URL 或原始字节作为 assetId;不得输出原始 widget 标签或 <audio> HTML;playable_preview 是被动展示,不应仅为显示它而调用 ask_followup_questions。Claude Code 中 bundled 媒体键需通过清单解析,运行时媒体 URL 不在清单内,不应嵌入 Elicitation HTML;新参考条目可能尚未收录,缺失时用仅标签选项,不得编造 CDN 路径。MG 参考选择返回参考 ID 给 MG 技能,由后者负责应用;create_avatar 为仅标签选项,选择后仍需对话附件加 asset-import。具体安装命令、收费与价格信息资料未提供。