// yazi-core/src/io.rs (概念代码)
pub struct IoWorker {
    pool: ThreadPool,
    rx: Receiver<IoRequest>,
}

impl IoWorker {
    pub async fn read_file(&self, path: PathBuf) -> Result<Vec<u8>> {
        // 异步文件读取，不阻塞其他操作
        tokio::fs::read(&path).await
    }
    
    pub async fn list_dir(&self, path: PathBuf) -> Result<Vec<DirEntry>> {
        // 异步目录列表
        tokio::fs::read_dir(&path)
            .await?
            .entries()
            .collect()
            .await
    }
}

// yazi-scheduler/src/lib.rs (概念代码)
pub struct Scheduler {
    tasks: PriorityQueue<Task>,
    worker_pool: Vec<Worker>,
}

impl Scheduler {
    // 优先级调度：高优先级任务（如 UI 更新）优先处理
    pub fn schedule(&mut self, task: Task) {
        self.tasks.push(task.priority, task);
    }
    
    // 任务取消支持
    pub fn cancel(&mut self, task_id: u64) {
        self.tasks.remove_if(|t| t.id == task_id);
    }
}

// yazi-core/src/image.rs (概念代码)
pub struct ImageDecoder {
    cache: LruCache<PathBuf, CachedImage>,
}

impl ImageDecoder {
    // 预处理图片，加速加载
    pub fn decode(&mut self, path: &Path) -> Result<CachedImage> {
        let data = self.read_file(path)?;
        let format = self.detect_format(&data)?;
        
        match format {
            Format::Png => self.decode_png(&data),
            Format::Jpeg => self.decode_jpeg(&data),
            Format::Gif => self.decode_gif(&data)?,
            // ... 更多格式
        }
    }
}

-- my-plugin/init.lua
local M = {}

function M.name()
    return "我的插件"
end

function M.setup()
    -- 注册快捷键
    require("yazi").map("yy", "复制文件路径")
end

function M.copy_path()
    local cwd = require("yazi").cwd()
    local selected = require("yazi").selected()
    -- 复制选中文件的绝对路径
    vim.fn.setreg("+", cwd .. "/" .. selected)
end

return M

// yazi-vfs/src/lib.rs (概念代码)
pub trait FileSystem {
    fn read_dir(&self, path: &Path) -> Vec<DirEntry>;
    fn read_file(&self, path: &Path) -> Vec<u8>;
    fn write_file(&mut self, path: &Path, data: &[u8]) -> Result<()>;
}

// 内置实现
pub struct LocalFs;
pub struct SftpFs { /* SSH 连接 */ }
pub struct SearchFs { /* 搜索结果 */ }
pub struct ArchiveFs { /* 压缩包内容 */ }

# 安装插件
yazi --install https://github.com/yazi-rs/plugins/blob/main/readme.yazi

# 安装主题
yazi --install https://github.com/yazi-rs/themes/blob/main/gruvbox.yazi

# 更新所有
yazi --update

# 锁定版本
yazi --pin <plugin-name>=<version>

# macOS
brew install yazi

# Linux (二进制)
curl -fsSL https://github.com/sxyazi/yazi/releases/latest/download/yazi-x86_64-linux-musl.tar.gz
tar -xzf yazi-x86_64-linux-musl.tar.gz
sudo mv yazi /usr/local/bin/

# Rust 源码编译
cargo install yazi-bundle
ya --install yazi

-- ~/.config/yazi/init.lua (Yazi initial.lua)
local yazi = require("yazi")

yazi.setup({
    -- 文件管理器配置
    manager = {
        show_hidden = true,           -- 显示隐藏文件
        sort_by = "name",          -- 按名称排序
        case_sensitive = false,       -- 大小写不敏感
    },
    
    -- 预览器配置
    previewer = {
        image_protocol = "kitty",   -- 使用 kitty 协议
        cache_dir = "~/.cache/yazi",
    },
    
    -- 主题
    theme = "gruvbox",
})

# 打开文件时自动预览
yazi --preview

# 使用内置 git 集成
yazi --cwd .

# 远程文件管理
yazi sftp://user@host:/path/to/dir

# 查看文件校验和
yazi --checksum

[manager]
show_hidden = true
sort_by = "mtime"          # 按修改时间排序
sort_dir_first = true        # 目录优先
case_sensitive = false

[previewer]
image_protocol = "kitty"
cache_dir = "~/.cache/yazi/previewer"
 hep = true

[plugin]
install_dir = "~/.config/yazi/plugins"

[theme]
active = "catppuccin-mocha"

[input]
escape_timeout = 200

# 启用调试模式
RUST_LOG=yazi_debug yazi

# 检查配置
yazi --debug-config

# 查看日志
tail -f ~/.local/state/yazi/yazi.log

# Fork 后克隆
git clone https://github.com/YOUR_NAME/yazi.git
cd yazi

# 开发
cargo run

# 测试
cargo test

# 提交 PR
git checkout -b feat/your-feature

local yazi = require("yazi")

-- 将 "yy" 映射为复制路径
yazi.map("yy", function()
    local path = yazi.selected()
    yazi.execute("cp", {"-r", path, "."})
end)

# 一行命令安装（macOS）
brew install yazi

# 或下载二进制
curl -fsSL https://github.com/sxyazi/yazi/releases/latest/download/yazi-x86_64-apple-darwin.tar.gz
tar -xzf yazi-x86_64-apple-darwin.tar.gz
./yazi