使用说明
原型上下文
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 | <30ms |
| 检索行为 | 概率 | 确定性优先 |
| 基础设施复杂性 | 较高（分块+嵌入+向量数据库+重新排序） | 较低（结构化索引/搜索） |
| 当需要时 | 语义密集型发现 | 精确、结构化的代理答案 |
快速开始
您有两个选择：
- 发布
context.txt在yourdomain.com/context.txt - 上传结构化
context.txt从仪表板（URL托管可选）
例子：
# Your Site Name
> 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
搜索引擎
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 --将ProtoContext用作工作流节点或AI Agent工具。
安装
在n8n中： 设置→ 社区节点→ 安装 → n8n-nodes-protocontext
或手动：
cd ~/.n8n/nodes && npm install n8n-nodes-protocontext
运营
| 操作 | 说明 |
|---|---|
| 搜索 | 在所有索引内容中搜索 |
| 获取网站 | 获取域的所有部分 |
| 提交域名 | 提交域以进行索引 |
| 上传内容 | 上传原始context.txt |
| 删除域 | 从索引中删除域 |
| 统计 | 指数统计 |
AI代理工具
将ProtoContext节点连接到 工具 AI Agent节点的输入。代理将使用它自动搜索和检索结构化知识。
📦 npm 包
建筑
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。看 许可证.
