prism

#快速示例

///|
let prism = Prism::new().with_provider("openai")

///|
let req_json = prism.encode_request("你好", PrismOptions::default())
// → {"model":"gpt-4o","input":[{"type":"message","role":"user","content":[...]}]}

///|
let reply = prism.decode_response(resp_json) // Ok("你好！有什么可以帮你的？")

///|
let prism = Prism::new().with_provider("anthropic") // 自动适配 Claude 格式
// → {"model":"claude-sonnet-4","messages":[...]}

///|
let prism = Prism::new().with_provider("openai-chat")

// send 是 Host 注入的 HTTP 回调

///|
let result = prism.complete("你好", PrismOptions::default(), send)
// result = Ok("你好！有什么可以帮你的？")

#架构设计

从概念到代码：四层递进，每个包只有单一职责。

#概念：为何需要中间协议？

Provider A  ──┐
Provider B  ──┤── Lucent IR ──→ 任意目标协议
Provider C  ──┘                (O(N) 替代 O(N²))

#协议层：6-Function 适配器契约

#代码层：四层包结构

#运行时：一次 encode_request 的完整路径

Prism::encode_request("你好", opts)
  → Context::new().add_user("你好")
    → context_to_lux_request()           # L0: 构建 LucentRequest
      → match_provider_name("openai")    # L2: SDK 注册表调度
        → reg.request_encode(req)         # L1: openai_chat 适配器
          → OpenAI JSON 字符串 → Host 发 HTTP

#数据流全景

                    ┌──────────────┐
  Provider JSON ──► │  Lucent IR   │ ──► Provider JSON
  (decode ←)        │  (中立格式)    │     (→ encode)
                    └──────────────┘
                         ↕
                    SDK 注册表调度
                         ↕
                    WASM 通用导出层

#依赖收敛

优化前: 根包 + sdk + wasm 各独立 import 7 个 provider  →  3 处修改
优化后: 只需在 sdk/ 注册 1 处 → wasm 和根包零感知

#多级 API

#L1：应用开发者——一行调用

///|
let prism = Prism::new().with_provider("openai")

///|
let req = prism.encode_request("写一首诗", PrismOptions::default())

///|
let reply = prism.decode_response(resp_json)

#L2：框架作者——事件循环

let ctx = Context::new()
  .add_system("你是一个有用的助手")
  .add_user("帮我查北京的天气")
  .add_tools([SdkTool { name: "get_weather", ... }])

match prism.decode_sse(sse_text) {
  Ok(events) => {
    for event in events {
      match event {
        TextDelta(s) => ui.append(s)        // 流式文本
        ToolCall(tc) => execute_tool(tc)    // 工具调用
        Thinking(t) => ui.show_thinking(t)  // 推理过程
        Finish(r) => break                  // 结束
      }
    }
  }
}

#项目状态

• 请求转换 (OpenAI Chat → Anthropic/Gemini) ✅
• 响应解码 ✅
• 流式 SSE 解码 ✅
• 协议转换 ✅

# MoonBit SDK 示例
moon run src/examples/sdk-basic

# TypeScript WASM 示例（真实 API），详见 examples/README.md
cd examples/ts-wasm && bun run src/main.ts

#开发原则

1. 纯函数 — 无 IO、无状态、无副作用
2. String 进出 — WASM 导出零摩擦
3. Round-trip 安全 — Provider → Lux → Provider 语义一致
4. JSON Schema 事实标准 — schemas/lux-ir-v1.json

#运行示例

#MoonBit SDK 示例

moon run src/examples/sdk-basic

• 编码请求 / 解码响应
• SSE 流式解码
• 协议转换 (OpenAI Chat → Anthropic/Gemini)
• 能力查询

#TypeScript WASM 示例（真实 API）

#开源协议