技术栈

ChainlessChain 采用现代化的技术栈，确保系统的性能、安全性和可维护性。

PC端技术栈

核心框架

Electron + React

{
  "electron": "^28.0.0",
  "react": "^18.2.0",
  "typescript": "^5.3.0"
}

选择理由:

• 跨平台支持 (Windows, macOS, Linux)
• 活跃的社区和丰富的生态
• 原生API访问能力
• 热更新支持

UI框架

Ant Design / shadcn/ui

npm install antd @shadcn/ui

特性:

• 企业级UI设计语言
• 丰富的组件库
• TypeScript支持
• 主题定制

状态管理

Zustand / Redux Toolkit

import create from 'zustand'

const useStore = create((set) => ({
  knowledge: [],
  addKnowledge: (item) => set((state) => ({
    knowledge: [...state.knowledge, item]
  }))
}))

优势:

• 简单直观的API
• TypeScript友好
• 性能优秀
• 易于调试

数据库

SQLCipher (better-sqlite3)

import Database from 'better-sqlite3'

const db = new Database('data.db', {
  nativeBinding: 'sqlcipher'
})

// 设置加密密钥
db.pragma('key = "x\'...\'"')

特性:

• AES-256加密
• 零配置
• 同步API，高性能
• SQL全功能支持

Git操作

isomorphic-git

import git from 'isomorphic-git'
import fs from 'fs'

await git.commit({
  fs,
  dir: '/path/to/repo',
  message: 'Add new knowledge',
  author: {
    name: 'User',
    email: 'user@example.com'
  }
})

优势:

• 纯JavaScript实现
• 跨平台
• 支持加密Git操作
• 轻量级

加密库

node-forge + U盾SDK

import forge from 'node-forge'

// RSA加密示例
const publicKey = forge.pki.publicKeyFromPem(pem)
const encrypted = publicKey.encrypt(data, 'RSA-OAEP')

功能:

• RSA/AES加密解密
• 数字签名验证
• 证书处理
• 哈希计算

移动端技术栈

Android

Kotlin + Jetpack Compose

@Composable
fun KnowledgeList(items: List<Knowledge>) {
    LazyColumn {
        items(items) { knowledge ->
            KnowledgeCard(knowledge)
        }
    }
}

技术栈:

• 语言: Kotlin
• UI: Jetpack Compose
• 架构: MVVM + Clean Architecture
• 依赖注入: Hilt / Koin
• 网络: Ktor Client
• 数据库: Room + SQLCipher for Android

核心库

功能	库	版本
UI框架	Jetpack Compose	1.5+
导航	Navigation Compose	2.7+
数据库	Room + SQLCipher	2.6+ / 4.5+
网络	Ktor Client	2.3+
JSON	Kotlinx Serialization	1.6+
图片	Coil	2.5+
Git	JGit	6.7+
加密	BouncyCastle	1.77+
SIMKey	OMAPI	-

iOS

Swift + SwiftUI

struct KnowledgeList: View {
    @State var knowledge: [Knowledge] = []

    var body: some View {
        List(knowledge) { item in
            KnowledgeRow(knowledge: item)
        }
    }
}

技术栈:

• 语言: Swift
• UI: SwiftUI
• 架构: MVVM + Combine
• 数据库: Core Data + SQLCipher
• 网络: Alamofire
• Git: ObjectiveGit (libgit2)

核心库

功能	库	版本
UI框架	SwiftUI	iOS 15+
数据库	Core Data + SQLCipher	-
网络	Alamofire	5.8+
JSON	Codable (原生)	-
图片	Kingfisher	7.10+
Git	ObjectiveGit	0.19+
加密	CryptoKit	iOS 13+

AI服务技术栈

LLM推理引擎

Ollama

# 安装Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# 拉取模型
ollama pull qwen2:7b
ollama pull llama3:8b

# API调用
curl http://localhost:11434/api/generate -d '{
  "model": "qwen2:7b",
  "prompt": "解释量子计算"
}'

支持的模型:

• Qwen2 (7B, 14B, 72B)
• LLaMA3 (8B, 70B)
• Mistral (7B)
• Phi-3 (3.8B, mini)

向量数据库

Qdrant

from qdrant_client import QdrantClient
from qdrant_client.models import Distance, VectorParams

client = QdrantClient("localhost", port=6333)

client.create_collection(
    collection_name="knowledge_base",
    vectors_config=VectorParams(size=768, distance=Distance.COSINE)
)

特性:

• 高性能向量检索
• 支持过滤条件
• 分布式部署
• REST API

ChromaDB (可选)

import chromadb

chroma_client = chromadb.Client()
collection = chroma_client.create_collection("knowledge")

collection.add(
    embeddings=[[1.1, 2.3, 3.2], ...],
    documents=["doc1", "doc2", ...],
    ids=["id1", "id2", ...]
)

优势:

• 嵌入式部署
• 简单易用
• 适合移动端

Embedding模型

bge系列

from sentence_transformers import SentenceTransformer

# PC端 - 大模型，高精度
model = SentenceTransformer('BAAI/bge-large-zh-v1.5')
embeddings = model.encode(['文本1', '文本2'])

# 移动端 - 小模型，快速
model_mobile = SentenceTransformer('BAAI/bge-small-zh-v1.5')

模型对比:

模型	维度	大小	场景
bge-large-zh-v1.5	1024	1.3GB	PC端
bge-base-zh-v1.5	768	400MB	通用
bge-small-zh-v1.5	512	95MB	移动端

RAG框架

AnythingLLM / QAnything

# docker-compose.yml
services:
  anythingllm:
    image: mintplexlabs/anythingllm:latest
    ports:
      - "3001:3001"
    environment:
      - LLM_PROVIDER=ollama
      - OLLAMA_BASE_URL=http://ollama:11434
      - VECTOR_DB=qdrant

功能:

• 文档解析
• 向量化
• 检索
• 答案生成
• 对话历史管理

P2P网络技术栈

libp2p

import { createLibp2p } from 'libp2p'
import { tcp } from '@libp2p/tcp'
import { noise } from '@chainsafe/libp2p-noise'
import { mplex } from '@libp2p/mplex'

const node = await createLibp2p({
  transports: [tcp()],
  connectionEncryption: [noise()],
  streamMuxers: [mplex()]
})

模块:

• 传输层: TCP, WebRTC, WebSocket
• 加密: Noise Protocol
• 多路复用: mplex, yamux
• 发现: mDNS, DHT
• NAT穿透: AutoNAT, STUN, TURN

Signal协议

libsignal

import { SignalProtocolStore, SessionBuilder } from '@signalapp/libsignal-client'

// 建立加密会话
const sessionBuilder = new SessionBuilder(
  store,
  recipientAddress
)
await sessionBuilder.processPreKey(preKeyBundle)

特性:

• 端到端加密
• 前向安全 (Forward Secrecy)
• 双棘轮算法 (Double Ratchet)
• 异步通信支持

IPFS (可选)

js-ipfs

import { create } from 'ipfs-core'

const ipfs = await create()
const { cid } = await ipfs.add('Hello IPFS!')
console.log(cid.toString())

用途:

• 公开内容分布式存储
• 内容寻址
• 永久存储

区块链技术栈

智能合约

Solidity + Hardhat

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;

contract EscrowContract {
    address public buyer;
    address public seller;
    uint256 public amount;

    constructor(address _seller) payable {
        buyer = msg.sender;
        seller = _seller;
        amount = msg.value;
    }

    function release() public {
        require(msg.sender == buyer, "Only buyer can release");
        payable(seller).transfer(amount);
    }
}

工具链:

• 开发框架: Hardhat
• 测试: Waffle, Chai
• 部署: Hardhat Deploy
• 验证: Etherscan Plugin

区块链交互

Ethers.js v6

import { ethers } from 'ethers'

const provider = new ethers.JsonRpcProvider('https://...')
const wallet = new ethers.Wallet(privateKey, provider)

const contract = new ethers.Contract(
  contractAddress,
  abi,
  wallet
)

await contract.release()

功能:

• 钱包管理
• 合约调用
• 事件监听
• ENS支持

支持的区块链

区块链	用途	手续费
Ethereum	主网，高价值交易	高
Polygon	低成本交易	低
BSC	备选方案	中

后端服务 (可选)

中继服务器

Rust + Actix-web

use actix_web::{web, App, HttpServer, Responder};

async fn relay_message(data: web::Json<Message>) -> impl Responder {
    // 中继消息逻辑
    "OK"
}

#[actix_web::main]
async fn main() -> std::io::Result<()> {
    HttpServer::new(|| {
        App::new()
            .route("/relay", web::post().to(relay_message))
    })
    .bind("0.0.0.0:8080")?
    .run()
    .await
}

技术栈:

• 语言: Rust
• 框架: Actix-web
• 数据库: PostgreSQL
• 缓存: Redis
• 消息队列: RabbitMQ

引导节点

Go + libp2p

package main

import (
    "github.com/libp2p/go-libp2p"
    dht "github.com/libp2p/go-libp2p-kad-dht"
)

func main() {
    host, _ := libp2p.New()
    kdht, _ := dht.New(ctx, host)
    kdht.Bootstrap(ctx)
}

功能:

• DHT引导
• 节点发现
• NAT穿透协助

开发工具

代码质量

• Linter: ESLint, Prettier
• 类型检查: TypeScript
• 测试: Jest, Vitest
• E2E测试: Playwright

构建工具

• PC端: Electron Builder
• 移动端: Gradle (Android), Xcode (iOS)
• 前端: Vite, Webpack

CI/CD

# .github/workflows/build.yml
name: Build and Test

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - uses: actions/setup-node@v3
      - run: npm install
      - run: npm test
      - run: npm run build

文档工具

• API文档: TypeDoc
• 用户文档: VitePress (本站)
• 架构图: Mermaid

性能监控

Sentry

import * as Sentry from "@sentry/electron"

Sentry.init({
  dsn: "https://...",
  integrations: [
    new Sentry.BrowserTracing(),
  ],
})

功能:

• 错误追踪
• 性能监控
• 用户反馈

总结

ChainlessChain 的技术栈选型遵循以下原则：

1. 安全第一: 硬件加密、端到端加密、开源可审计
2. 性能优秀: 本地优先、异步处理、缓存优化
3. 跨平台: 一次开发，多端运行
4. 开发效率: 成熟框架、丰富生态、易于维护
5. 用户体验: 流畅交互、响应迅速、界面美观

所有技术选型都经过充分验证，确保系统的稳定性和可靠性。