🔧 插件开发与API集成：让YaCy听懂你的语言

想象YaCy不是软件，而是通过共识建立的*活档案*——一个图书馆，其中每个节点既是赞助人又是图书管理员，每个查询是手递手耳语直到回答的耳语。到目前为止，你已经学会*阅读*它的目录，*上架*它的书，并*导航*它的迷宫书库。现在是*编辑它的语法*、*训练它的策展人*并*连接它的门到你自己的大厅*的时候了。这是YaCy停止成为工具并开始表现得像一个合作者的时候——一个讲HTTP，用Java字节码思考，通过定义良好的契约协商意义的地方。

> SolrSelect 不仅仅是一个端点——它是YaCy的*查询皮层*：自然语言意图被解析、重写、评分并最终翻译成Lucene段扫描的层。其 /yacysearch.json 变体不仅返回命中；它暴露完整的决策轨迹——从查询扩展和同义词注入到面聚集和文档年龄的相关性衰减。调用它就像要求神经科医生不仅映射*你记住什么*，而且*记忆如何被检索、加权和交叉引用*。

🌐 集成即对话：REST API作为语义桥梁

YaCy的REST API不是一组孤立端点——它是基于HTTP语义和自描述媒体类型的*对话协议*。每次交互以意图开始：GET /YACYSEARCH 声明*"我寻求知识"*，而 POST /CRAWL/start 断言*"我授权获取"*。力量不在于体积，而在于*契约的精确性*。考虑将YaCy集成到企业内部门户：与其嵌入重定向到YaCy UI的搜索栏，不如编排无缝流程，其中用户查询—— enriched with 上下文如部门ID或许可级别——直接POST到 /solr/select，带有 fq=department_s:$(userDept) 和 defType=edismax 以激活YaCy的企业级查询解析器。响应不作为HTML到达，而是作为干净JSON——准备好缝合到React组件中或通过WebSockets转换为语音搜索响应。

这使它不仅是粘合代码的力量是YaCy的*内省设计*：/api/v1/status 端点返回实时指标——活跃爬虫线程、索引段计数、堆使用——不是静态数字，而是*实时健康转录*。你不监控YaCy；你*倾听它的脉搏*。当跨十个节点扩展时，/p2p/neighbors.json 不仅列出IP——它报告握手延迟、共享索引卷和最后见到时间戳，将网络拓扑转变为你可以遍历、修剪或优先考虑的*活图*，具有手术般的精度。

> CrawlProfile 是YaCy的*网页遍历数字护照*：它不仅编码礼貌规则（爬虫延迟、robots.txt尊重）而且*语义许可*——是否跟随