原型上下文
RAG系统的确定性知识层。
开放标准+搜索引擎+语义检索，用于人工智能可读的网络内容。
ProtoContext让AI代理从中读取结构化知识 context.txt 而不是仅仅依赖于原始HTML抓取和完全概率检索管道。您可以发布 context.txt 或者直接从仪表板上传结构化上下文（不需要URL）。
使用ProtoContext作为快速确定性路径，仅在需要时添加语义/向量检索。
网站：https://protocontext.org/
______________________________________________________________________
为什么选择ProtoContext
当知识是结构化和确定性的时，ProtoContext是最好的：
- 产品、价格、工作时间、政策、文件
- 低延迟代理响应
- 来自出版商原创内容的可预测答案
- 减少操作开销（刮擦/分块/嵌入管道成为可选）
传统RAG仍然最适合：
- 庞大的、非结构化的语料库
- 噪声文本中的深层语义发现
- 无法获得精确模式的用例
ProtoContext不会取代RAG。它使许多生产流程可以选择完整的RAG管道。
______________________________________________________________________
快速通道与传统RAG
| 传统RAG管道 | ProtoContext快速路径 | |
|---|---|---|
| 主要输入 | 非结构化页面/文档 | 结构化 context.txt |
| 典型延迟 | ~200-500ms | \ One-line description of what this site does |
@lang: en @version: 1.0 @updated: 2026-02-25 @topics: your, relevant, topics @content_type: website
section: About
What your site does, in plain text.
section: Key Information
Prices, hours, contacts, features.
阅读完整规格： [规格.md](SPEC.md)
______________________________________________________________________
## 搜索引擎
ProtoContext包括一个AI代理搜索引擎：
- 索引 `context.txt` （或丢失时退回刮擦）
- 在确定性快速路径中提供结构化结果
- 配置后支持语义检索
### 内容摄入优先级
|优先级|来源|方法|需要AI密钥|
|---|---|---|---|
| 1 | `/context.txt` |直接解析|否|
| 2 | `/llms-full.txt` 或 `/llms.txt` |AI转换|是|
| 3 | `sitemap.xml` |报废+转换|是|
|4|内部链接|BFS爬网回退|是|
当结构化上下文不可用时，报废是可选的回退。
______________________________________________________________________
## API
所有受保护的端点都需要 `X-Proto-Token`.
|方法|端点|描述|
|---|---|---|
| `GET` | `/search?q=...` |跨索引网站搜索|
| `GET` | `/site?domain=...` |获取一个域的部分|
| `POST` | `/submit` |提交域以进行索引|
| `POST` | `/delete` |删除域|
| `POST` | `/batch` |多查询搜索|
| `GET` | `/stats` |指数统计|
| `GET` | `/health` |健康检查|
常用过滤器： `domain`, `lang`, `content_type`, `section`, `limit`.
______________________________________________________________________
## n8n节点
社区节点 [n8n](https://n8n.io) --将ProtoContext用作工作流节点或AI Agent工具。
### 安装
在n8n中： **设置→ 社区节点→ 安装** → `n8n-nodes-protocontext`
或手动：
cd ~/.n8n/nodes && npm install n8n-nodes-protocontext
### 运营
|操作|说明|
|---|---|
| **搜索** |在所有索引内容中搜索|
| **获取网站** |获取域的所有部分|
| **提交域名** |提交域以进行索引|
| **上传内容** |上传原始context.txt|
| **删除域** |从索引中删除域|
| **统计** |指数统计|
### AI代理工具
将ProtoContext节点连接到 **工具** AI Agent节点的输入。代理将使用它自动搜索和检索结构化知识。
📦
______________________________________________________________________
## 建筑
protocontext/ ├── engine/ # API + indexer + crawler/scraper + auth ├── web/ # Dashboard (search, submit, setup, settings) ├── mcp-server/ # MCP tools for AI agents ├── n8n-node/ # n8n community node (workflow + AI Agent tool) ├── validator/ # context.txt validation ├── wordpress-plugin/ # WordPress + WooCommerce integration ├── examples/ # Example context files └── SPEC.md # Spec v1.0
规格稳定(`v1.0`).引擎处于测试阶段(`v0.1.1-beta`).
______________________________________________________________________
## 许可证
Apache 2.0。看 [许可证](LICENSE).