Communitygithub.com

MolyKit Skill 中文指南

用于在 Makepad 中构建跨平台 AI 聊天界面的技能,集成 OpenAI、SSE 流式响应和多种聊天组件。

MolyKit Skill 中文指南 是什么?

MolyKit 是一个用于构建跨平台 AI 聊天界面的工具包,专为 Makepad 框架设计。它提供了跨平台异步工具(如 PlatformSend、spawn()、ThreadToken),使同一代码库能同时兼容原生平台与 WASM 环境。该技能涵盖了 BotClient 特性的实现——用于集成 AI 提供商(如 OpenAI),并支持 SSE 流式响应、消息协议类型(Message、BotId、MessageContent)以及多种可重用聊天组件(Chat、Messages、PromptInput、Avatar)。此外,还包含 Slot 组件用于运行时内容替换、UiRunner 模式用于异步更新 UI,以及 MCP(模型上下文协议)支持。此技能适用于需要在桌面端和 Web 端(WASM)提供一致 AI 聊天体验的开发者。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/ai-llm/molykit-galacticvraj-vraj-portfolio

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

MolyKit 技能

使用 MolyKit 在 Makepad 中构建 AI 聊天界面的最佳实践——一个跨平台 AI 聊天应用工具包。

源码路径:/Users/zhangalex/Work/Projects/FW/robius/moly/moly-kit

使用时机

使用此技能的场景:

  • 使用 Makepad 构建 AI 聊天界面
  • 集成 OpenAI 或其他 LLM API
  • 为原生和 WASM 实现跨平台异步
  • 创建聊天组件(消息、输入框、头像)
  • 处理 SSE 流式响应
  • 关键词:molykit、moly-kit、ai chat、bot client、openai makepad、chat widget、sse streaming

概述

MolyKit 提供:

  • 跨平台异步工具(PlatformSend、spawn()、ThreadToken)
  • 可直接使用的聊天组件(Chat、Messages、PromptInput、Avatar)
  • BotClient 特性用于 AI 提供商集成
  • 兼容 OpenAI 的客户端,支持 SSE 流式响应
  • 消息、机器人和工具调用的协议类型
  • MCP(模型上下文协议)支持

跨平台异步模式

PlatformSend - 仅在原生上发送

/// 仅在原生平台暗示 Send,不在 WASM 上
/// - 原生上:由实现 Send 的类型实现
/// - WASM 上:由所有类型实现
pub trait PlatformSend: PlatformSendInner {}

/// 跨平台使用的盒装 Future 类型
pub type BoxPlatformSendFuture<'a, T> = Pin<Box<dyn PlatformSendFuture<Output = T> + 'a>>;

/// 跨平台使用的盒装 Stream 类型
pub type BoxPlatformSendStream<'a, T> = Pin<Box<dyn PlatformSendStream<Item = T> + 'a>>;

平台无关的任务生成

/// 独立运行一个 future
/// - 原生上使用 tokio(需要 Send)
/// - WASM 上使用 wasm-bindgen-futures(不需要 Send)
pub fn spawn(fut: impl PlatformSendFuture<Output = ()> + 'static);

// 用法
spawn(async move {
    let result = fetch_data().await;
    Cx::post_action(DataReady(result));
    SignalToUI::set_ui_signal();
});

使用 AbortOnDropHandle 取消任务

/// 当其被丢弃时中止 future 的句柄
pub struct AbortOnDropHandle(AbortHandle);

// 用法 —— 组件丢弃时任务自动取消
#[rust]
task_handle: Option<AbortOnDropHandle>,

fn start_task(&mut self) {
    let (future, handle) = abort_on_drop(async move {
        // 异步工作...
    });
    self.task_handle = Some(handle);
    spawn(async move { let _ = future.await; });
}

ThreadToken 用于 WASM 上的非 Send 类型

/// 将非 Send 值存储在 thread-local 中,通过 token 访问
pub struct ThreadToken<T: 'static>;

impl<T> ThreadToken<T> {
    pub fn new(value: T) -> Self;
    pub fn peek<R>(&self, f: impl FnOnce(&T) -> R) -> R;
    pub fn peek_mut<R>(&self, f: impl FnOnce(&mut T) -> R) -> R;
}

// 用法 —— 包装非 Send 类型以在 Send 边界上使用
let token = ThreadToken::new(non_send_value);
spawn(async move {
    token.peek(|value| {
        // 使用 value...
    });
});

BotClient 特性

实现 AI 提供商集成

pub trait BotClient: Send {
    /// 发送消息并获取流式响应
    fn send(
        &mut self,
        bot_id: &BotId,
        messages: &[Message],
        tools: &[Tool],
    ) -> BoxPlatformSendStream<'static, ClientResult<MessageContent>>;

    /// 获取可用的机器人/模型
    fn bots(&self) -> BoxPlatformSendFuture<'static, ClientResult<Vec<Bot>>>;

    /// 克隆以便传递
    fn clone_box(&self) -> Box<dyn BotClient>;
}

// 用法
let client = OpenAIClient::new("https://api.openai.com/v1".into());
client.set_key("sk-...")?;
let context = BotContext::from(client);

BotContext - 可共享的包装器

/// 可共享的包装器,带有加载的机器人以同步 UI 访问
pub struct BotContext(Arc<Mutex<InnerBotContext>>);

impl BotContext {
    pub fn load(&mut self) -> BoxPlatformSendFuture<ClientResult<()>>;
    pub fn bots(&self) -> Vec<Bot>;
    pub fn get_bot(&self, id: &BotId) -> Option<Bot>;
    pub fn client(&self) -> Box<dyn BotClient>;
}

// 用法
let mut context = BotContext::from(client);
spawn(async move {
    if let Err(errors) = context.load().await.into_result() {
        // 处理错误
    }
    Cx::post_action(BotsLoaded);
});

协议类型

消息结构

pub struct Message {
    pub from: EntityId,         // User, System, Bot(BotId), App
    pub metadata: MessageMetadata,
    pub content: MessageContent,
}

pub struct MessageContent {
    pub text: String,           // 主要内容(markdown)
    pub reasoning: String,      // AI 推理/思考
    pub citations: Vec<String>, // 来源 URL
    pub attachments: Vec<Attachment>,
    pub tool_calls: Vec<ToolCall>,
    pub tool_results: Vec<ToolResult>,
}

pub struct MessageMetadata {
    pub is_writing: bool,       // 仍在流式传输中
    pub created_at: DateTime<Utc>,
}

机器人标识

/// 全局唯一机器人 ID:<len>;<id>@<provider>
pub struct BotId(Arc<str>);

impl BotId {
    pub fn new(id: &str, provider: &str) -> Self;
    pub fn id(&self) -> &str;       // provider-local id
    pub fn provider(&self) -> &str; // provider domain
}

// 示例:BotId::new("gpt-4", "api.openai.com")
// -> "5;[email protected]"

组件模式

Slot 组件 - 运行时内容替换

live_design! {
    pub Slot = {{Slot}} {
        width: Fill, height: Fit,
        slot = <View> {}  // 默认内容
    }
}

// 用法 —— 在运行时替换内容
let mut slot = widget.slot(id!(content));
if let Some(custom) = client.content_widget(cx, ...) {
    slot.replace(custom);
} else {
    slot.restore();  // 恢复默认
    slot.default().as_standard_message_content().set_content(cx, &content);
}

Avatar 组件 - 文本/图像切换

live_design! {
    pub Avatar = {{Avatar}} <View> {
        grapheme = <RoundedView> {
            visible: false,
            label = <Label> { text: "P" }
        }
        dependency = <RoundedView> {
            visible: false,
            image = <Image> {}
        }
    }
}

impl Widget for Avatar {
    fn draw_walk(&mut self, cx: &mut Cx2d, ...) -> DrawStep {
        if let Some(avatar) = &self.avatar {
            match avatar {
                Picture::Grapheme(g) => {
                    self.view(id!(grapheme)).set_visible(cx, true);
                    self.view(id!(dependency)).set_visible(cx, false);
                    self.label(id!(label)).set_text(cx, &g);
                }
                Picture::Dependency(d) => {
                    self.view(id!(dependency)).set_visible(cx, true);
                    self.view(id!(grapheme)).set_visible(cx, false);
                    self.image(id!(image)).load_image_dep_by_path(cx, d.as_str());
                }
            }
        }
        self.deref.draw_walk(cx, scope, walk)
    }
}

PromptInput 组件

#[derive(Live, Widget)]
pub struct PromptInput {
    #[deref] deref: CommandTextInput,
    #[live] pub send_icon: LiveValue,
    #[live] pub stop_icon: LiveValue,
    #[rust] pub task: Task,           // 发送或停止
    #[rust] pub interactivity: Interactivity,
}

impl PromptInput {
    pub fn submitted(&self, actions: &Actions) -> bool;
    pub fn reset(&mut self, cx: &mut Cx);
    pub fn set_send(&mut self);
    pub fn set_stop(&mut self);
    pub fn enable(&mut self);
    pub fn disable(&mut self);
}

Messages 组件 - 会话视图

#[derive(Live, Widget)]
pub struct Messages {
    #[deref] deref: View,
    #[rust] pub messages: Vec<Message>,
    #[rust] pub bot_context: Option<BotContext>,
}

impl Messages {
    pub fn set_messages(&mut self, messages: Vec<Message>, scroll_to_bottom: bool);
    pub fn scroll_to_bottom(&mut self, cx: &mut Cx, triggered_by_stream: bool);
    pub fn is_at_bottom(&self) -> bool;
}

UiRunner 异步到 UI 模式

impl Widget for PromptInput {
    fn handle_event(&mut self, cx: &mut Cx, event: &Event, scope: &mut Scope) {
        self.deref.handle_event(cx, event, scope);
        self.ui_runner().handle(cx, event, scope, self);

        if self.button(id!(attach)).clicked(event.actions()) {
            let ui = self.ui_runner();
            Attachment::pick_multiple(move |result| match result {
                Ok(attachments) => {
                    ui.defer_with_redraw(move |me, cx, _| {
                        me.attachment_list_ref().write().attachments.extend(attachments);
                    });
                }
                Err(_) => {}
            });
        }
    }
}

SSE 流式响应

/// 将 SSE 字节流解析为消息流
pub fn parse_sse<S, B, E>(s: S) -> impl Stream<Item = Result<String, E>>
where
    S: Stream<Item = Result<B, E>>,
    B: AsRef<[u8]>,
{
    // 按 "\n\n" 分割,提取 "data:" 内容
    // 过滤注释和 [DONE] 消息
}

// 在 BotClient::send 中的用法
fn send(&mut self, ...) -> BoxPlatformSendStream<...> {
    let stream = stream! {
        let response = client.post(url).send().await?;
        let events = parse_sse(response.bytes_stream());

        for await event in events {
            let completion: Completion = serde_json::from_str(&event)?;
            content.text.push_str(&completion.delta.content);
            yield ClientResult::new_ok(content.clone());
        }
    };
    Box::pin(stream)
}

最佳实践

  1. 使用 PlatformSend 实现跨平台:同一代码在原生和 WASM 上工作
  2. 使用 spawn() 而不是 tokio::spawn:平台无关的任务生成
  3. 使用 AbortOnDropHandle:组件丢弃时取消任务
  4. 使用 ThreadToken 处理 WASM 上的非 Send 类型:带 token 访问的线程本地存储
  5. 使用 Slot 实现自定义内容:允许 BotClient 提供自定义组件
  6. 使用 read()/write() 模式:通过 WidgetRef 安全地借用访问
  7. 使用 UiRunner::defer_with_redraw:从异步上下文更新组件
  8. 处理 ClientResult 的部分成功:可能同时包含值和错误

参考文件

  • llms.txt - 完整的 MolyKit API 参考

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Conduct domain and industry research. Use when the user says "lets create a research report on [domain or industry]

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

相关技能