YaCy.Uno 设计方案

> 基于 Uno Platform (C#/.NET 9) 的去中心化 P2P 搜索引擎 > 兼容 YaCy 协议，跨平台运行（Windows / macOS / Linux / WebAssembly / iOS / Android） --- ## 一、项目概述 ### 1.1 项目定位 YaCy.Uno 是 YaCy 去中心化搜索引擎的 **Uno Platform (C#)** 实现版本。它将： - **完全兼容** YaCy P2P 协议（可与 Java/Go 版本节点互通） - 采用 **Uno Platform 5.x + .NET 9** 实现真正的跨平台 - 提供 **Material Design 3** 风格的现代 UI - 支持 **WebAssembly / Desktop / Mobile** 多目标平台 - 拥抱 .NET 开源生态，充分利用高性能库 ### 1.2 命名与端口 | 项目 | 值 | |------|-----| | 名称 | YaCy.Uno | | 默认端口 | **8900** (HTTP) / **8943** (HTTPS) | | 网络名称 | `freeworld`（与 Java/Go YaCy 同网络） | | 协议兼容 | YaCy P2P Protocol v1 | ### 1.3 与其他版本对比 | 特性 | Java YaCy | YaCy-Go | **YaCy.Uno** | |------|-----------|---------|-------------| | 语言 | Java 8+ | Go 1.25 | **C# / .NET 9** | | UI框架 | JSP/Servlet | go-app WASM | **Uno Platform (XAML)** | | 搜索引擎 | Solr + Kelondro | SQLite FTS5 | **SQLite FTS5** | | HTTP框架 | Jetty | Fiber | **ASP.NET Core Kestrel** | | P2P端口 | 8090 | 8899 | **8900** | | 跨平台 | JVM | 原生编译 | **.NET 跨平台** | | 移动端 | ❌ | ❌ | **✅ iOS/Android** | | WASM | ❌ | ✅ (go-app) | **✅ (Uno WASM)** | | TUI | ❌ | ✅ (Bubble Tea) | **✅ (Spectre.Console)** | --- ## 二、技术架构 ### 2.1 总体架构 ``` ┌─────────────────────────────────────────────────────────────┐ │ YaCy.Uno Application │ ├─────────────────────────────────────────────────────────────┤ │ ┌──────────────┐ ┌──────────────┐ ┌───────────────────┐ │ │ │ Uno Platform│ │ ASP.NET Core │ │ Spectre.Console │ │ │ │ XAML UI │ │ Web API │ │ TUI │ │ │ │ (Desktop/ │ │ (REST/SSE/ │ │ (Terminal Client) │ │ │ │ WASM/ │ │ WebSocket) │ │ │ │ │ │ Mobile) │ │ │ │ │ │ │ └──────┬───────┘ └──────┬───────┘ └───────┬───────────┘ │ │ │ │ │ │ │ ┌──────┴─────────────────┴──────────────────┴───────────┐ │ │ │ Application Services │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌───────────┐ │ │ │ │ │ Search │ │ Crawl │ │ P2P/DHT │ │ Index │ │ │ │ │ │ Service │ │ Service │ │ Service │ │ Service │ │ │ │ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └─────┬─────┘ │ │ │ └───────┼────────────┼────────────┼─────────────┼───────┘ │ │ ┌───────┴────────────┴────────────┴─────────────┴───────┐ │ │ │ Core Engine │ │ │ │ ┌──────────────┐ ┌───────────┐ ┌──────────────────┐ │ │ │ │ │ SQLite FTS5 │ │ Document │ │ Protocol │ │ │ │ │ │ Full-Text │ │ Parsers │ │ (YaCy P2P compat)│ │ │ │ │ │ Index │ │ (30+) │ │ │ │ │ │ │ └──────┬───────┘ └───────────┘ └──────────────────┘ │ │ │ │ ┌──────┴────────────────────────────────────────────┐│ │ │ │ │ Storage Layer ││ │ │ │ │ SQLite (EF Core + FTS5) - 统一数据与索引存储 ││ │ │ │ └───────────────────────────────────────────────────┘│ │ │ └───────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────┘ ``` ### 2.2 技术栈选型 #### 核心框架 | 组件 | 技术选型 | 版本 | 说明 | |------|---------|------|------| | **运行时** | .NET 9 | 9.0 | 最新 LTS，高性能 | | **UI 框架** | Uno Platform | 5.x | 跨平台 XAML UI | | **Web 服务** | ASP.NET Core | 9.0 | Kestrel 高性能 HTTP | | **全文搜索** | SQLite FTS5 | 内置 | 全文搜索虚拟表 | | **ORM/数据库** | EF Core + SQLite | 9.0 | 元数据存储 | | **DI 容器** | Microsoft.Extensions.DI | 9.0 | 内置依赖注入 | | **日志** | Serilog | 4.x | 结构化日志 | | **配置** | Microsoft.Extensions.Configuration | 9.0 | 多源配置 | #### 网络与通信 | 组件 | 技术选型 | 说明 | |------|---------|------| | **HTTP 客户端** | System.Net.Http + Polly | 带重试/熔断的 HTTP 客户端 | | **WebSocket** | System.Net.WebSockets | 内置 WebSocket 支持 | | **SSE** | 自实现 (IAsyncEnumerable) | 流式搜索结果 | | **P2P 网络** | 自实现 (兼容 YaCy 协议) | TCP/HTTP 混合 | | **DNS** | System.Net.Dns | 节点发现 | #### 文档解析 | 组件 | 技术选型 | 说明 | |------|---------|------| | **HTML 解析** | AngleSharp | 高性能 HTML5 解析器 | | **PDF 解析** | PdfPig | 纯 .NET PDF 文本提取 | | **Office** | NPOI / Open XML SDK | DOC/DOCX/XLS/PPT 解析 | | **XML/RSS** | System.Xml.Linq + SyndicationFeed | 内置 XML/RSS 解析 | | **中文分词** | jieba.NET | 中文全文搜索支持（ITextSegmenter + JiebaTextSegmenter，爬取入库前对含 CJK 正文分词后写入 FTS） | | **语言检测** | NTextCat | 语言识别 | #### UI 与体验 | 组件 | 技术选型 | 说明 | |------|---------|------| | **UI 框架** | Uno Platform 5.x | XAML 跨平台 | | **设计系统** | Uno.Material (Material Design 3) | MD3 控件和主题 | | **图标** | Uno.Material Icons | Material Symbols | | **图表** | LiveChartsCore / Uno.Toolkit | 统计可视化 | | **导航** | Uno.Extensions.Navigation | MVVM 导航 | | **状态管理** | CommunityToolkit.Mvvm | MVVM 源生成器 | | **TUI** | Spectre.Console | 终端命令行界面 | #### 测试 | 组件 | 技术选型 | 说明 | |------|---------|------| | **单元测试** | xUnit | 测试框架 | | **Mock** | NSubstitute | 模拟框架 | | **集成测试** | Microsoft.AspNetCore.Mvc.Testing | API 集成测试 | | **性能测试** | BenchmarkDotNet | 性能基准 | --- ## 三、项目结构 ``` yacy.uno/ ├── 设计方案.md # 本文档 ├── 研发计划.md # 开发计划 ├── README.md # 项目说明 ├── LICENSE # Apache 2.0 / LGPL ├── Directory.Build.props # 全局构建属性 ├── Directory.Packages.props # 中央包版本管理 ├── yacy.uno.sln # 解决方案文件 │ ├── src/ # 源代码 │ ├── YaCy.Uno.Core/ # 核心引擎库 (net9.0) │ │ ├── Models/ # 数据模型 │ │ │ ├── Document.cs # 文档模型 │ │ │ ├── Seed.cs # P2P 节点种子 │ │ │ ├── WordReference.cs # 词引用 (RWI) │ │ │ ├── CrawlProfile.cs # 爬取配置 │ │ │ ├── SearchResult.cs # 搜索结果 │ │ │ └── ... │ │ ├── Search/ # 搜索引擎 │ │ │ ├── SearchEngine.cs # 搜索引擎入口 │ │ │ ├── QueryParser.cs # 查询解析 │ │ │ ├── RankingEngine.cs # 排名算法 │ │ │ ├── SnippetGenerator.cs # 摘要生成 │ │ │ └── FederatedSearch.cs # 联邦搜索 │ │ ├── Index/ # 索引管理 │ │ │ ├── FtsIndexManager.cs # FTS5 索引管理器 │ │ │ ├── DocumentIndexer.cs # 文档索引器 │ │ │ └── RwiStore.cs # 反向词索引存储 (RWI) │ │ ├── Crawler/ # 网页爬虫 │ │ │ ├── CrawlEngine.cs # 爬虫引擎 │ │ │ ├── CrawlScheduler.cs # 爬取调度 │ │ │ ├── RobotsParser.cs # robots.txt 解析 │ │ │ ├── UrlQueue.cs # URL 队列 │ │ │ ├── HttpLoader.cs # HTTP 加载器 │ │ │ └── SitemapParser.cs # Sitemap 解析 │ │ ├── Parser/ # 文档解析器 │ │ │ ├── IDocumentParser.cs # 解析器接口 │ │ │ ├── HtmlParser.cs # HTML 解析 │ │ │ ├── PdfParser.cs # PDF 解析 │ │ │ ├── OfficeParser.cs # Office 解析 │ │ │ ├── RssParser.cs # RSS/Atom 解析 │ │ │ ├── XmlParser.cs # XML 解析 │ │ │ ├── PlainTextParser.cs # 纯文本解析 │ │ │ └── ParserFactory.cs # 解析器工厂 │ │ ├── P2P/ # P2P 网络 │ │ │ ├── Protocol/ # YaCy 协议实现 │ │ │ │ ├── HelloProtocol.cs # 握手协议 │ │ │ │ ├── SearchProtocol.cs # 远程搜索 │ │ │ │ ├── TransferProtocol.cs # 索引传输 │ │ │ │ └── SeedEncoding.cs # 种子编解码 │ │ │ ├── DHT/ # 分布式哈希表 │ │ │ │ ├── DHTManager.cs # DHT 管理 │ │ │ │ ├── DHTSelection.cs # DHT 节点选择 │ │ │ │ ├── DHTDispatcher.cs # DHT 分发 │ │ │ │ └── DHTTransmission.cs # DHT 传输 │ │ │ ├── Network/ # 网络管理 │ │ │ │ ├── PeerManager.cs # 节点管理 │ │ │ │ ├── SeedDB.cs # 种子数据库 │ │ │ │ ├── ConnectionManager.cs # 连接管理 │ │ │ │ └── Bootstrap.cs # 引导发现 │ │ │ └── Security/ # 安全 │ │ │ ├── CryptoHelper.cs # 加密工具 │ │ │ └── AuthManager.cs # 认证管理 │ │ ├── Storage/ # 存储层 │ │ │ ├── YaCyDbContext.cs # EF Core DbContext │ │ │ ├── IDocumentStore.cs # 文档存储接口 │ │ │ ├── SqliteDocumentStore.cs # SQLite 实现 │ │ │ └── Migrations/ # 数据库迁移 │ │ ├── Config/ # 配置 │ │ │ ├── YaCyConfig.cs # 配置模型 │ │ │ ├── NetworkConfig.cs # 网络配置 │ │ │ └── CrawlConfig.cs # 爬取配置 │ │ └── Utils/ # 工具类 │ │ ├── UrlUtils.cs # URL 工具 │ │ ├── HashUtils.cs # 哈希工具 │ │ ├── TextUtils.cs # 文本工具 │ │ └── Tokenizer.cs # 分词器 │ │ │ ├── YaCy.Uno.Server/ # Web API 服务 (ASP.NET Core) │ │ ├── Program.cs # 入口点 │ │ ├── Controllers/ # API 控制器 │ │ │ ├── SearchController.cs # 搜索 API │ │ │ ├── CrawlController.cs # 爬取 API │ │ │ ├── PeersController.cs # 节点 API │ │ │ ├── DhtController.cs # DHT API │ │ │ ├── StatsController.cs # 统计 API │ │ │ ├── ConfigController.cs # 配置 API │ │ │ ├── IndexController.cs # 索引管理 API │ │ │ └── YaCyProtocolController.cs# YaCy 协议兼容端点 │ │ ├── Hubs/ # SignalR Hub │ │ │ ├── SearchHub.cs # 搜索实时推送 │ │ │ └── CrawlHub.cs # 爬取状态推送 │ │ ├── Services/ # 后台服务 │ │ │ ├── CrawlBackgroundService.cs # 后台爬取 │ │ │ ├── P2PBackgroundService.cs # P2P 网络维护 │ │ │ └── DHTBackgroundService.cs # DHT 维护 │ │ ├── Middleware/ # 中间件 │ │ │ ├── AuthMiddleware.cs # 认证中间件 │ │ │ └── RateLimitMiddleware.cs # 限流中间件 │ │ └── appsettings.json # 应用配置 │ │ │ ├── YaCy.Uno.App/ # Uno Platform 桌面/WASM UI │ │ ├── App.xaml / App.xaml.cs # 应用入口 │ │ ├── MainWindow.xaml # 主窗口 │ │ ├── Views/ # 页面视图 │ │ │ ├── HeroPage.xaml # 首页 (搜索入口) │ │ │ ├── SearchPage.xaml # 搜索结果 │ │ │ ├── CrawlPage.xaml # 爬虫管理 │ │ │ ├── PeersPage.xaml # 节点列表 │ │ │ ├── DhtPage.xaml # DHT 统计 │ │ │ ├── StatsPage.xaml # 系统统计 │ │ │ ├── ConfigPage.xaml # 设置 │ │ │ └── HelpPage.xaml # 帮助 │ │ ├── ViewModels/ # MVVM ViewModel │ │ │ ├── HeroViewModel.cs │ │ │ ├── SearchViewModel.cs │ │ │ ├── CrawlViewModel.cs │ │ │ ├── PeersViewModel.cs │ │ │ ├── DhtViewModel.cs │ │ │ ├── StatsViewModel.cs │ │ │ ├── ConfigViewModel.cs │ │ │ └── MainViewModel.cs │ │ ├── Controls/ # 自定义控件 │ │ │ ├── SearchBar.xaml # 搜索栏 │ │ │ ├── SearchResultCard.xaml # 结果卡片 │ │ │ ├── NavigationDrawer.xaml # 导航抽屉 │ │ │ ├── StatusBar.xaml # 状态栏 │ │ │ └── NotificationStack.xaml # 通知栈 │ │ ├── Themes/ # 主题资源 │ │ │ ├── MaterialTheme.xaml # Material Design 3 │ │ │ ├── LightTheme.xaml # 亮色主题 │ │ │ └── DarkTheme.xaml # 暗色主题 │ │ ├── Services/ # UI 服务 │ │ │ ├── ApiClient.cs # REST API 客户端 │ │ │ ├── NavigationService.cs # 导航服务 │ │ │ └── ThemeService.cs # 主题切换 │ │ ├── Converters/ # 值转换器 │ │ ├── Strings/ # 国际化 │ │ │ ├── en/Resources.resw # English │ │ │ └── zh-CN/Resources.resw # 中文 │ │ └── Platforms/ # 平台特定代码 │ │ ├── Desktop/ # 桌面平台 │ │ ├── WebAssembly/ # WASM 平台 │ │ ├── iOS/ # iOS │ │ └── Android/ # Android │ │ │ └── YaCy.Uno.Cli/ # TUI 命令行客户端 │ ├── Program.cs # CLI 入口 │ ├── Commands/ # 命令定义 │ │ ├── SearchCommand.cs # yacy search <query> │ │ ├── CrawlCommand.cs # yacy crawl <url> │ │ ├── StatusCommand.cs # yacy status │ │ ├── PeersCommand.cs # yacy peers │ │ └── ServeCommand.cs # yacy serve │ └── UI/ # TUI 界面 │ └── DashboardView.cs # 仪表盘 │ ├── tests/ # 测试项目 │ ├── YaCy.Uno.Core.Tests/ # 核心库测试 │ ├── YaCy.Uno.Server.Tests/ # API 集成测试 │ └── YaCy.Uno.Benchmarks/ # 性能基准 │ ├── docs/ # 文档 │ ├── api.md # API 文档 │ ├── p2p-protocol.md # P2P 协议说明 │ └── deployment.md # 部署指南 │ └── docker/ # Docker 部署 ├── Dockerfile # Docker 构建 └── docker-compose.yml # Docker Compose ``` --- ## 四、核心模块设计 ### 4.1 搜索引擎 (Search Engine) #### 全文索引 — SQLite FTS5 采用 **SQLite FTS5** 作为全文搜索引擎，与 YaCy-Go 技术栈一致： ```sql -- FTS5 全文索引虚拟表 CREATE VIRTUAL TABLE documents_fts USING fts5( url_hash, -- 文档唯一标识 (UNSAFE not indexed) url, -- 原始 URL title, -- 标题 (高权重) description, -- 描述 content, -- 正文 (主搜索字段) host, -- 主域名 language, -- 语言 content_type, -- MIME 类型 tokenize = 'unicode61 porter', -- 多语言 + 词干提取 content = '', -- 无内容表关联 content_rowid = 'rowid' ); -- 元数据表（与 FTS 配合） CREATE TABLE documents ( rowid INTEGER PRIMARY KEY, url_hash TEXT UNIQUE NOT NULL, url TEXT NOT NULL, title TEXT, size INTEGER, crawl_date TEXT, last_modified TEXT, inbound_links INTEGER DEFAULT 0, outbound_links INTEGER DEFAULT 0, keywords TEXT, author TEXT ); ``` ```csharp // 索引字段常量（对应 FTS5 列） public static class IndexFields { public const string UrlHash = "url_hash"; public const string Url = "url"; public const string Title = "title"; public const string Description = "description"; public const string Content = "content"; public const string Host = "host"; public const string Language = "language"; public const string ContentType = "content_type"; } ``` #### 搜索流程 ``` 查询输入 → QueryParser (FTS5 语法解析) → SQLite FTS5 全文匹配 (bm25 排序) → 本地索引查询 → 并行: P2P 远程搜索 (DHT 目标节点) → 结果合并 (RankingEngine: BM25 + 入链/新鲜度因子) → SnippetGenerator (FTS5 highlight 高亮) → SSE/SignalR 流式输出 ``` #### 排名因子 | 因子 | 权重 | 说明 | |------|------|------| | BM25 文本相关性 | 40% | FTS5 内置 | | 标题匹配 | 20% | 标题中包含查询词 | | URL 深度 | 10% | 短 URL 优先 | | 入链数量 | 15% | 被引用越多排名越高 | | 内容新鲜度 | 10% | 新内容优先 | | 语言匹配 | 5% | 用户语言偏好 | ### 4.2 网页爬虫 (Crawler) ```csharp // 爬虫引擎架构 CrawlEngine ├── CrawlScheduler // 调度器（优先级队列 + 域名频率限制） ├── UrlQueue // URL 队列（SQLite 持久化） ├── HttpLoader // HTTP 加载器（HttpClient + Polly 重试） ├── RobotsParser // robots.txt 遵守 ├── SitemapParser // Sitemap 发现 ├── ContentExtractor // 内容提取（AngleSharp） ├── ParserPipeline // 解析器管道（HTML→PDF→Office→...） └── IndexSubmitter // 索引提交（→ FTS5 + DHT 分发） ``` **特性：** - 多工作者并行爬取（`Channel<T>` + `Task` 并行模型） - 域名级别频率限制（Polite crawling） - robots.txt / meta robots 遵守 - 可配置爬取深度、广度、文件类型过滤 - 增量爬取 / 条件抓取（If-Modified-Since / ETag） - 爬取状态实时推送（SignalR / SSE） ### 4.3 P2P 网络 (P2P Network) #### 协议兼容性 完全实现以下 YaCy 协议端点（兼容 Java YaCy 和 Go YaCy）： | 端点 | 方法 | 功能 | |------|------|------| | `/yacy/hello` | GET/POST | P2P 握手 / 节点发现 | | `/yacy/search` | POST | 远程搜索 | | `/yacy/seedlist` | GET | 种子节点列表 | | `/yacy/transferRWI` | POST | 反向词索引传输（已实现：接收 JSON { word, docRefs }；RwiIndexTransferService 向对等节点推送） | | `/yacy/transferURL` | POST | URL 元数据传输 | | `/yacy/crawlReceipt` | GET/POST | 爬取确认 | | `/yacy/query` | GET/POST | 查询 | | `/yacy/profile` | GET | 节点资料 | | `/yacy/idx.json` | GET | 索引信息 | | `/yacy/message` | POST | 节点消息 | #### DHT 实现 ``` DHT 设计: - 分区数: 256 (2^8) - 冗余因子: 3 (senior 节点) - 分区算法: 词哈希 → 节点哈希 → 最近节点选择 - 索引分发: 后台定时分发到目标节点 ``` #### 节点类型 | 类型 | 条件 | 说明 | |------|------|------| | virgin | 刚启动 | 未加入网络 | | junior | 有 NAT | 无法接受入站连接 | | senior | 公网 IP | 可接受入站 + 出站 | | principal | senior + 高可用 | 提供种子列表服务 | ### 4.4 文档解析器 (Document Parsers) ```csharp public interface IDocumentParser { string[] SupportedMimeTypes { get; } int Priority { get; } Task<ParsedDocument> ParseAsync(Stream content, string mimeType, Uri sourceUrl, CancellationToken ct); } ``` **支持的格式（优先级排序）：** | 解析器 | 格式 | NuGet 包 | |--------|------|----------| | HtmlParser | HTML/XHTML | AngleSharp | | PdfParser | PDF | UglyToad.PdfPig | | OfficeParser | DOCX/XLSX/PPTX | DocumentFormat.OpenXml | | LegacyOfficeParser | DOC/XLS/PPT | NPOI | | RssParser | RSS/Atom | System.ServiceModel.Syndication | | XmlParser | XML/SVG | System.Xml.Linq | | JsonParser | JSON/JSON-LD | System.Text.Json | | PlainTextParser | TXT/CSV/MD | 内置 | | ImageParser | JPEG/PNG (EXIF) | MetadataExtractor | ### 4.5 存储层 (Storage) #### 双存储架构 ``` 存储层: ├── SQLite (EF Core + FTS5) → 统一数据与索引存储 │ ├── documents → 文档元数据表 │ ├── documents_fts → FTS5 全文索引 (虚拟表) │ ├── rwi_terms → 反向词索引 (RWI) │ ├── seeds → 节点种子表 │ ├── crawl_queue → 爬取队列表 │ ├── crawl_profiles → 爬取配置表 │ ├── bookmarks → 书签表 │ ├── blacklist → 黑名单表 │ └── config → 配置表 └── 文件系统 ├── data/yacy.db → SQLite 数据库文件 (含 FTS5 索引) ├── data/log/ → 日志文件 └── data/export/ → 导出文件 ``` --- ## 五、API 设计 ### 5.1 REST API 端点 完全对标 YaCy-Go 的 API 设计，确保生态兼容： #### 搜索 API ``` GET /api/search?q={query}&offset={0}&limit={10}&lang={all} GET /api/search/stream?q={query} # SSE 流式 GET /api/search/async # 异步搜索 GET /api/suggest?q={prefix} # 搜索建议 ``` #### 爬取 API ``` POST /api/crawl # 提交爬取任务 GET /api/crawl/status # 爬取状态 GET /api/crawl/history # 爬取历史 POST /api/crawl/pause # 暂停 POST /api/crawl/resume # 恢复 POST /api/crawl/abort # 中止 ``` #### 节点 API ``` GET /api/peers # 节点列表 GET /api/peers/stats # 节点统计 POST /api/peers/connect # 连接节点 ``` #### DHT API ``` GET /api/dht/stats # DHT 统计 GET /api/dht/distribution/stats # 分布统计 ``` #### 管理 API ``` GET /api/stats # 系统统计 GET /api/config # 配置读取 PUT /api/config/:key # 配置更新 GET /api/index/browse # 索引浏览 POST /api/index/export # 索引导出 POST /api/index/import # 索引导入 ``` ### 5.2 实时通信 - **Server-Sent Events (SSE)**: 搜索结果流式推送 - **SignalR**: 爬取状态/P2P 事件实时推送 - **WebSocket**: 备选方案（WASM 兼容） --- ## 六、UI 设计 ### 6.1 设计语言 参考 YaCy-Go 的 Material Design 3 风格： - **主色调**: `#667eea` (蓝紫渐变) → `#764ba2` - **字体**: Segoe UI / Inter / Noto Sans CJK - **圆角**: 12-16px (卡片), 24px (按钮) - **阴影**: Material elevation system - **动画**: 流畅的页面切换和状态转换 - **主题**: 明暗主题切换 + 系统跟随 ### 6.2 页面设计 | 页面 | 功能 | 说明 | |------|------|------| | **Hero** (首页) | 搜索入口 | 居中 Logo + 搜索框（Google 风格） | | **Search** (搜索) | 搜索结果 | 结果卡片列表 + 分面筛选 | | **Crawl** (爬取) | 爬虫管理 | URL 提交 + 实时状态监控 | | **Peers** (节点) | P2P 节点 | 节点列表 + 地理分布 | | **DHT** (哈希表) | DHT 状态 | 分区可视化 + 统计 | | **Stats** (统计) | 系统仪表盘 | 图表 + 指标卡片 | | **Config** (设置) | 配置管理 | 分组设置面板 | | **Help** (帮助) | 帮助文档 | 使用指南 + FAQ | ### 6.3 导航 ``` 桌面端: ┌──────┬────────────────────────────────────────┐ │ │ [AppBar: Logo | 搜索框 | 主题切换 | 通知] │ │ 侧边 │──────────────────────────────────────────│ │ 导航 │ │ │ 菜单 │ 页面内容区域 │ │ │ │ │ │ │ └──────┴────────────────────────────────────────┘ 移动端: ┌──────────────────────────────────────────────┐ │ [AppBar: ≡ | 标题 | 主题 | 通知] │ │──────────────────────────────────────────────│ │ │ │ 页面内容区域 │ │ │ │──────────────────────────────────────────────│ │ [🏠首页] [🔍搜索] [🕷爬取] [👥节点] [⚙设置] │ └──────────────────────────────────────────────┘ ``` --- ## 七、部署方案 ### 7.1 运行模式 | 模式 | 说明 | |------|------| | **Desktop** | Uno Desktop 窗口应用 + 内嵌 Kestrel 服务 | | **Server** | 纯 ASP.NET Core 服务（无 GUI） | | **WASM** | 浏览器端 WebAssembly（连接远程 API） | | **Mobile** | iOS/Android 应用（连接远程 API） | | **CLI** | Spectre.Console 命令行工具 | | **Docker** | 容器化部署 | ### 7.2 Docker 支持 ```dockerfile FROM mcr.microsoft.com/dotnet/aspnet:9.0 AS base FROM mcr.microsoft.com/dotnet/sdk:9.0 AS build # Multi-stage build for minimal image size ``` ### 7.3 系统要求 | 项目 | 要求 | |------|------| | .NET Runtime | 9.0+ | | 内存 | 最低 256MB，推荐 1GB+ | | 磁盘 | 最低 100MB (应用)，索引按需增长 | | 操作系统 | Windows 10+ / macOS 12+ / Linux (glibc 2.17+) | --- ## 八、安全设计 - **HTTPS/TLS**: 内置 Kestrel TLS 支持 - **认证**: 管理界面 HTTP Basic Auth + JWT Token - **RSA 2048**: 节点身份密钥对（兼容 YaCy 协议） - **速率限制**: ASP.NET Core Rate Limiting 中间件 - **CORS**: 可配置跨域策略 - **Input Validation**: 所有输入参数校验 --- ## 九、国际化 - 使用 .NET 资源文件 (`.resw`) 实现 i18n - 初始支持：English (en), 中文 (zh-CN) - 可扩展的翻译框架 --- ## 十、开源协议 - **许可证**: Apache License 2.0（与 YaCy-Go 一致） - **贡献**: 遵循 GitHub Flow，PR + Code Review - **CI/CD**: GitHub Actions 自动化构建/测试/发布