Bichon：基于Rust与Tantivy的高性能邮件归档器存储引擎与WebSocket实时WebUI架构

// Tantivy支持多种压缩后端
use tantivy::store::Compressor;
// LZ4提供快速压缩解压，适合实时搜索
// ZSTD提供更高压缩比，适合归档存储

// WebSocket连接建立与重连机制
class BichonWebSocket {
  private ws: WebSocket | null = null;
  private reconnectAttempts = 0;
  private maxReconnectAttempts = 5;
  
  connect() {
    this.ws = new WebSocket(`ws://${location.host}/ws`);
    this.ws.onmessage = this.handleMessage;
    this.ws.onclose = this.handleDisconnect;
  }
  
  private handleDisconnect = () => {
    if (this.reconnectAttempts < this.maxReconnectAttempts) {
      setTimeout(() => this.connect(), 1000 * Math.pow(2, this.reconnectAttempts));
      this.reconnectAttempts++;
    }
  };
}

# 创建数据目录
mkdir -p ./bichon-data

# 运行容器
docker run -d \
  --name bichon \
  -p 15630:15630 \
  -v $(pwd)/bichon-data:/data \
  -e BICHON_LOG_LEVEL=info \
  -e BICHON_ROOT_DIR=/data \
  rustmailer/bichon:latest

# Docker环境（注意不要使用外部引号）
-e BICHON_CORS_ORIGINS=http://192.168.1.16:15630,http://myserver.local:15630

# 错误示例（引号会被传递到容器内）
-e BICHON_CORS_ORIGINS="http://localhost:15630"  # 错误！

2025-12-06T23:56:30.422+08:00 DEBUG bichon::modules::rest: CORS: Incoming Origin = "http://localhost:15630"
2025-12-06T23:56:30.422+08:00 DEBUG bichon::modules::rest: CORS: Configured origins = ["http://192.168.3.2:15630"]

// 使用async/await处理并发IMAP连接
async fn sync_account(account: &AccountConfig) -> Result<()> {
    let client = imap::Client::connect(&account.server).await?;
    // 并发获取多个邮箱文件夹
    let folders = client.list_folders().await?;
    let tasks: Vec<_> = folders.into_iter()
        .map(|folder| sync_folder(&client, folder))
        .collect();
    join_all(tasks).await;
    Ok(())
}

// 使用Zustand进行客户端状态管理
import { create } from 'zustand';

interface SearchState {
  query: string;
  filters: Filter[];
  results: Email[];
  setQuery: (query: string) => void;
  executeSearch: () => Promise<void>;
}

const useSearchStore = create<SearchState>((set, get) => ({
  query: '',
  filters: [],
  results: [],
  setQuery: (query) => set({ query }),
  executeSearch: async () => {
    const { query, filters } = get();
    const results = await api.search(query, filters);
    set({ results });
  },
}));

特性维度	传统邮件客户端	Bichon 邮件归档器
核心目标	实时收发通信	历史邮件归档与检索
发送能力	✅ 支持	❌ 不支持
运行模式	桌面 / 移动应用	服务器端应用
数据存储	本地缓存 + 服务器	本地归档存储
搜索能力	基础搜索	全文索引，高级搜索
API 接口	通常不提供	完整 REST API
多账户管理	有限支持	统一搜索跨账户

Bichon：基于Rust与Tantivy的高性能邮件归档器存储引擎与WebSocket实时WebUI架构

设计理念：归档优先的架构差异

Tantivy 统一存储引擎：存储与索引的融合架构

1. 消除数据冗余的传统困境

2. 透明压缩与去重机制

3. 索引结构优化

WebSocket 实时同步的 WebUI 架构

1. 实时同步机制

2. 搜索体验优化

3. 多账户统一管理

工程化部署与配置要点

1. Docker 部署最佳实践

2. CORS 配置注意事项

3. 安全配置

性能基准与扩展性

1. 实际案例性能数据

2. 扩展性考虑

技术栈深度解析

1. Rust 后端架构

2. 前端技术选型

限制与未来展望

1. 当前限制

2. 路线图展望

总结：重新定义邮件归档