Skip to content

tao3k/xiuxian-artisan-workshop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

353 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

type knowledge
metadata
title
CyberXiuXian Artisan Workshop (赛博修仙创意工坊)

CyberXiuXian Artisan Workshop (赛博修仙创意工坊)

(赛博修仙创意工坊)

The Agentic OS Kernel. Native-First. Synaptic Flow. Valkey-Powered.

CyberXiuXian Artisan Workshop (赛博修仙创意工坊) is a High-Performance AI Operating System Kernel designed for the next generation of autonomous intelligent agents. The repository is published as xiuxian-artisan-workshop. It bridges the gap between LLM reasoning and system-level execution via a Zero-copy Native Memory Bus, self-evolving Synaptic Workflows, and a distributed Valkey Synapse for real-time state orchestration.


🏛️ Architecture: The Neural Kernel (Trinity V2)

The system has evolved from a simple gateway into a Microkernel & Native Plugins architecture, heavily inspired by the internal performance optimizations of OpenAI's Codex and the human-centric design of OpenClaw.

flowchart TB
    subgraph Client["Interaction Layer"]
        User["User / Developer"]
        IM["Telegram / Discord / CLI"]
    end

    subgraph Zhenfa["Zhenfa: The Neural Kernel (Agent OS)"]
        Registry["Native Tool Registry<br/>(Arc&lt;dyn ZhenfaTool&gt;)"]
        Orchestrator["Zhenfa Orchestrator<br/>(Policy & Safety)"]
        Stripper["XML-Lite Stripping Layer<br/>(Token Economics)"]
    end

    subgraph SpinalCord["Valkey Synapse (Distributed State)"]
        Locks["Atomic Mutation Locks"]
        Memo["Execution Memoization"]
        Audit["Webhook & Trace Audit"]
    end

    subgraph Execution["Synaptic Execution Hub"]
        direction LR
        Wendao["<b>Wendao (Memory)</b><br/>Native KG + PPR Search"]
        Qianji["<b>Qianji (Workflow)</b><br/>Synaptic Flow V2"]
        Qianhuan["<b>Qianhuan (Persona)</b><br/>Dynamic Manifestation"]
    end

    subgraph External["Matrix Gateway (Legacy/Ext)"]
        HTTP["Axum JSON-RPC"]
        ToolGateway["Streamable Tool Gateway"]
    end

    User --> IM
    IM --> Zhenfa
    Zhenfa <--> SpinalCord
    Zhenfa --> Registry
    Registry --> Wendao
    Registry --> Qianji
    Registry --> Qianhuan
    External -.-> Zhenfa
Loading

💎 Why xiuxian-artisan-workshop?

Feature The Legacy AI Way The xiuxian-artisan-workshop Way
Execution External Microservices (HTTP/JSON) Native In-Process Calls (Rust Pointers)
Latency 50ms - 500ms (Serialization Tax) < 1ms (Zero-Copy Dispatch)
Reasoning Stateless prompt-response Synaptic Flow V2 (Adversarial Loops)
Interaction "Dumb" sequential queue Human-Centric (Interrupt, HITL, Steer)
Context Bloated JSON Blobs Stripped XML-Lite (Attention Optimized)

🧠 Core Breakthroughs

1. Synaptic Flow V2: Adversarial Reasoning

We implement the Unity of Knowledge and Action.

  • The Scenario: "Agenda Steward" proposes a plan; "Strict Teacher" critiques it.
  • Dynamic Control: The Critic node can emit a RetryNodes instruction based on an LLM-generated <score>, forcing the Proposer to rewrite until it meets historical reality constraints stored in Wendao.

2. The Stripping Layer (JSON Stripping)

To solve "Formatting Hallucination," our native tools bypass JSON for content delivery. They return XML-Lite tags (<hit>, <score>) directly into the LLM's attention window, maximizing reasoning precision and minimizing token cost.

3. Distributed Synapse (Valkey)

Valkey acts as the system's spinal cord, providing:

  • Atomic Locking: Prevents race conditions during multi-agent tool execution.
  • Caching: Microsecond-level recall for repeated tool invocations.
  • Persistence: Context survives server restarts with OpenClaw-style "Fake Restore" indexing.

🦀 The Rust Ecosystem (19+ Crates)

The kernel is built on a robust, high-performance Rust foundation:

  • xiuxian-zhenfa: The Agent OS Kernel. Native registry and orchestrator.
  • xiuxian-qianji: The Synaptic workflow engine. Supports LLM-driven flow control.
  • xiuxian-wendao: High-performance Knowledge Graph & PPR Search engine.
  • xiuxian-memory-engine: MemRL-inspired self-evolving episodic memory.
  • xiuxian-macros: Proc-macros for zero-boilerplate tool integration (#[zhenfa_tool]).

🛠️ What you can do today

  • Native Tool Calling: Implement a tool in 5 minutes using #[zhenfa_tool] and get microsecond performance.
  • Adversarial Validation: Run complex "Draft-Critique-Revise" loops with Qianji manifests.
  • Human-Centric Interaction: Interrupt a rambling agent, or require approval for destructive tools.
  • Zero-Trust Security: Unified permission gatekeeping via ZhenfaOrchestrator.

CyberXiuXian Artisan Workshop (赛博修仙创意工坊) - Building the Neural Backbone of the Future.