prism

#它解决什么问题

• 一次适配，全协议互通 —— 每家厂商只需实现 6 个纯函数 （request / response / stream × decode / encode），接入成本与协议数量成 O(N)，而非两两互转的 O(N²)；
• 任何格式先归一、再编码 —— 代码可以在 IR 层“插一手”，做审计、改写、路由、过滤；
• 流式同等待遇 —— SSE 被归一为统一事件流，消费端只写一次事件处理逻辑；
• 不静默丢数据 —— 承载不了的能力显式失败或打上诊断，转换结果可检查保真度。

OpenAI JSON  ──[decode]──►  Lucent IR  ──[encode]──►  Anthropic JSON
Gemini JSON  ◄──[encode]──  Lucent IR  ◄──[decode]──  OpenAI JSON
                                │
                  你的代码在这里（审计 / 改写 / 路由 / 过滤）

#快速开始

moon add morning-start/prism

fn main {
  // 想用哪家就写哪家：openai / responses / anthropic / gemini
  let prism = Prism::new().with_provider("openai")

  // 编码请求：文本 → OpenAI JSON
  let req_json = prism.encode_request("你好", PrismOptions::default())

  // 解码响应：OpenAI JSON → 文本
  let text = prism.decode_response(resp_json)
}

完整端到端场景见 USAGE.md： 嵌入 SDK（应用内转换）、网关模式（OpenAI 客户端接 Claude 后端）、流式转码、企业审计网关。

#支持的协议

#流式与事件

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(_) => break                  // 结束
    }
  }
}

#诊断与保真

#代码架构

• src/lux —— Lucent IR：类型、序列化、诊断、流事件（无 IO、无厂商绑定）
• src/provider/* —— 协议适配器：openai / responses / messages / gemini
• src/sdk —— Prism 门面 + 注册表 + 路由 + Context 构建（唯一收敛点）
• src/internal —— JSON 字段访问、SSE 帧解析、extras 合并等共享基元
• src/wasm + src/cmd/main —— WASM 字符串 ABI 导出（进出皆 String，零 provider 耦合）
• src/conformance —— 8 个 check_* 协议符合性验证器（测试工具包）

#测试与质量

• 双形态测试：moon test 同时跑 native 与 wasm-gc
• 800+ 条用例：黑盒（test/ 子包，只走公共 API）+ 白盒（*_wbtest 留在包内）
• 质量门禁：moon fmt --check、moon check --deny-warn、moon test

#文档

• USAGE.md —— 四种场景的完整上手指南
• docs/architecture.md · docs/status.md —— 设计决策与项目状态
• docs/lux-ir-design.md · schemas/lux-ir-v1.json —— Lucent IR 规范与 JSON Schema
• docs/api-protocol-converter.md —— 三端点协议转换契约
• src/lux/README.md · src/sdk/README.md —— 包内导航

#License

#友情链接

• LINUX DO
• Moonbit 官方

#赞助感谢

• Akanyi 佬赞助的公益API
• atomcode 的dpv4的额度