# DHT 元数据搜索服务

这是一个用于发现持久化索引和搜索 BitTorrent DHT 元数据的 Rust workspace

## 目录

```text
src/search/       最终运行的采集存储搜索和接口应用
src/crawler/      可独立复用的 DHT 协议与 Metadata 获取基础库
src/web/          基于 Vue 和 shadcn-vue 的本地搜索界面
opencodes/        不参与构建的参考项目
```

当前已完成 DHT 采集持久化全文搜索内容聚合可用性验证 HTTP API 本地 Web 搜索界面 有界 SQLite 运行诊断历史和配置管理

基础库的使用方式和指标说明见 [`src/crawler/README.md`](src/crawler/README.md)

当前实施阶段和后续计划见 [`TODOS.md`](TODOS.md)

百万级性能基线和验收目标见 [`BENCHMARKS.md`](BENCHMARKS.md)

Rust 测试分层和默认验证命令见 [`TESTING.md`](TESTING.md)

应用配置模板见 [`dht-search.example.toml`](dht-search.example.toml)

无效文件隐藏规则见 [`content-filters.toml`](content-filters.toml)

应用构建运行和 API 文档见 [`src/search/README.md`](src/search/README.md)

Web 开发和构建方式见 [`src/web/README.md`](src/web/README.md)

开发环境可以直接运行 `scripts\run.bat` 在当前窗口同时启动 Rust 后端和 Web 前端 按一次 `Ctrl+C` 即可统一停止

启动脚本使用本地 `dht-search.toml` 文件 文件不存在时会从 `dht-search.example.toml` 创建 因此 Web 配置页不会修改版本库中的模板

任一服务异常退出时启动脚本会清理 Cargo Bun 及其子进程树 避免遗留 Vite 或后端进程