小竹

xz-modules · Monorepo

小竹模块仓库

开源 Rust crate 集合，为 AI 应用提供统一的 LLM 调用、记忆、检索、知识图谱、Agent 调度等基础设施。所有小竹产品的 AI 能力基石。

开发与真相源：github.com/xiaozhu-eco/xz-modules· 发布至 crates.io · 许可 MIT OR Apache-2.0 · Rust 1.85+

18
Crates
9
Categories
MIT/Apache
License
1.85+
Rust
GitHub · xz-modulesCrates.io 团队 →

基础设施

统一 LLM 接入

1 crates

  • xz-provider

    v0.5.0

    统一 LLM 服务接口（OpenAI / Claude / Ollama），路由、重试、限流。

    LLM
    OpenAI
    Ollama
    crates.iodocs.rs源码

检索增强

RAG 流水线

1 crates

知识

图谱与结构化知识

1 crates

记忆

core + engine

2 crates

Skill

插件与沙箱

2 crates

Agent

调度 · 引擎 · Hooks

3 crates

  • xz-agent-core

    v0.10.0

    Agent 引擎抽象层：traits、类型与 CoreEngine 循环。

    core
    DAG
    crates.iodocs.rs源码

  • xz-agent-hooks

    v0.1.0

    Agent 生命周期 Hook 契约、有序注册表与扩展解析。

    hooks
    crates.iodocs.rs源码

媒体 / 通知

TTS · 系统通知

3 crates

  • xz-tts

    v0.1.0

    流式语音合成抽象层（首期接入火山/豆包等 TTS）。

    TTS
    audio
    crates.iodocs.rs源码

  • xz-notification-core

    v0.2.0

    跨平台通知核心：类型、路由、模板与限流。

    notification
    crates.iodocs.rs源码

  • xz-notification-desktop

    v0.1.0

    桌面端系统通知后端（macOS / Linux / Windows）。

    desktop
    crates.iodocs.rs源码

协议

MCP 客户端

2 crates

规划 / 暂未纳入 workspace

  • xz-asr语音识别，workspace 暂 exclude（依赖 sherpa-onnx 待就绪）
  • xz-event-graph事件图谱，规划中

快速开始

cargo
# 添加依赖（crates.io）
cargo add xz-provider

# 或克隆 monorepo 本地开发
git clone https://github.com/xiaozhu-eco/xz-modules
cd xz-modules
cargo build --workspace
cargo test --workspace --all-features
Rust
use xz_provider::Provider;

let provider = Provider::from_json(r#"{
    "openai": {
        "api_key": "sk-...",
        "models": [{
            "name": "gpt-4o",
            "capabilities": {
                "context_window": 128000,
                "max_output_tokens": 4096
            }
        }]
    }
}"#)?;

let response = provider.chat("Hello!").await?;
println!("{}", response.content);
在 GitHub 查看源码浏览使用这些模块的产品