# DHT 元数据搜索服务

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

## 目录

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

当前已完成 DHT 采集持久化全文搜索内容聚合可用性验证 HTTP API 和本地 Web 搜索界面

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

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

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

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

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

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

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

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

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