发现协议

## 关于 Index Network Index Network 通过一个复杂的机会检测系统实现了**私密的、意图驱动的发现**。用户将他们寻求的内容表达为结构化的意图，而协议会识别**机会**——当协调的意图在信任阈值、时间约束和预期价值计算的交汇处浮现时，产生的可辨识的协调点，使得行动对所有相关方都变得合理。 与基于个人资料相似性的传统匹配系统不同，Index 将机会视为**一等协调原语**：它们作为具有自身生命周期、解释和上下文元数据的独立实体存在，从而实现对连接*为何*以及*何时*有意义，而不仅仅是*它*匹配的细微理解。 ## 核心特性 ### 私密的意图驱动发现 - **基于意图**：表达具体需求，例如“寻找注重隐私的AI工程师” - **设计即隐私**：基于索引的访问控制，具有精细的权限 - **机会检测**：当意图对齐时，上下文感知的代理浮现出协调点 - **语义理解**：用于智能匹配的向量相似性和 HyDE 策略 - **代理编排**：由 LangGraph 驱动的工作流，用于复杂的发现任务 - **双边谈判**：两个AI代理——每位用户一个——在提议的匹配成为机会之前进行辩论，确保双方都真正受益 ## 工作原理 1. **用户表达意图**：用自然语言定义您正在寻找的内容 2. **上下文组织**：将意图分组到具有隐私控制的索引中 3. **机会检测**：当个人资料和意图对齐时，代理识别协调点 4. **双边谈判**：提议者和回应者代理就每个匹配进行辩论，在持久化之前就契合度分数和角色达成一致 5. **连接促成**：双重视角描述在保护隐私的同时解释价值 6. **持续发现**：个人资料更新会触发新的机会搜索 ## 架构 ``` +------------------------+ +------------------------+ +------------------------+ | Intent Graph |--->| Opportunity Engine |--->| Discovery Layer | | | | | | | | - Semantic vectors | | - Multi-strategy | | - Bilateral | | - Index partitions | | HyDE generation | | negotiation | | - Speech act types | | - 4-dimensional | | - Dual synthesis | | - Felicity scores | | threshold eval | | - Contextual | | - Temporal decay | | - Confidence scoring | | integrity | +------------------------+ +------------------------+ +------------------------+ ``` **三层架构**： 1. **意图图**：结构化意图存储，具有语义嵌入、言语行为验证和基于索引的访问控制。意图是一等实体，具有质量分数（语义熵、适切性条件），确保高信号输入。 2. **机会引擎**：多维检测系统，它在LLM推断的搜索视角下生成假设文档（HyDE），根据信任/时间/价值/对齐阈值评估候选者，并产生带有双重视角解释的评分机会。 3. **发现层**：隐私保护的呈现系统，具有双边谈判。两个AI代理（提议者和回应者）在它成为真正的机会之前就每个候选匹配进行辩论。每一方都会收到关于潜在连接的综合见解，而不会暴露原始的私人数据。 **核心基础设施**： - **LangGraph** 用于11个代理状态机（意图、机会、谈判、个人资料、聊天等），编排复杂的工作流 - **PostgreSQL 配合 pgvector** 用于2000维语义搜索（HNSW索引） - **Drizzle ORM** 用于类型安全的数据库操作，具有模式驱动的类型 - **OpenRouter** 用于LLM驱动的代理，具有Zod验证的结构化输出 - **BullMQ (Redis)** 用于异步作业处理和事件驱动编排 ## 命令行界面 Index CLI 让您直接从终端与协议交互——与AI代理聊天、管理信号、审查机会以及向其他用户发送消息。 ### 安装 ``` npm install -g @indexnetwork/cli ``` ### 快速开始 ``` # 认证（打开浏览器） index login # 与AI代理交互（交互式REPL） index conversation # 单次消息 index conversation "What opportunities do I have?" # 浏览你的信号 index intent list # 通过搜索发现机会 index opportunity discover "looking for an AI engineer" # 提议与某人建立直接连接 index profile search "Jane Smith" index opportunity discover "collaborate on LLM tooling" --target # 介绍两个人 index opportunity discover --introduce # 审阅并接受 index opportunity list --status pending index opportunity accept ``` ### 命令 | 命令 | 描述 | |---|---| | `index login` | 通过浏览器（OAuth）或 `--token` 进行身份验证 | | `index logout` | 清除存储的会话 | | `index conversation` | 与AI代理聊天（交互式或单次） | | `index conversation sessions` | 列出AI聊天会话 | | `index conversation list` | 列出所有对话（H2A + H2H） | | `index conversation with ` | 打开或恢复私聊 | | `index profile` | 显示您的个人资料 | | `index profile sync` | 重新生成您的个人资料 | | `index profile search ` | 按名称搜索个人资料 | | `index intent list` | 列出您的信号 | | `index intent create ` | 创建一个信号 | | `index intent update ` | 更新一个信号 | | `index intent link ` | 将一个信号链接到一个网络 | | `index opportunity list` | 列出您的机会 | | `index opportunity accept/reject ` | 对某个机会采取行动 | | `index opportunity discover ` | 发现新的机会 | | `index network list` | 列出您的网络 | | `index network create ` | 创建一个网络 | | `index network update ` | 更新一个网络 | | `index network delete ` | 删除一个网络 | | `index contact list` | 列出您的联系人 | | `index contact add ` | 通过电子邮件添加联系人 | | `index scrape ` | 从URL抓取内容 | | `index sync` | 同步上下文到 ~/.index/context.json | 完整的命令参考和渲染输出示例，请参见 [packages/cli/cli-output-reference.html](packages/cli/cli-output-reference.html)。 ## 入门指南 ### 前置条件 - **Bun** 1.2+（运行时、包管理器、测试运行器） - **PostgreSQL** 14+，需要 **pgvector** 0.5+ 扩展 - **Redis** 6+（用于BullMQ作业队列和缓存） - **Git** 2.30+ ### 快速开始 有关完整的设置演练（环境变量、数据库创建、故障排除），请参阅 [docs/guides/getting-started.md](docs/guides/getting-started.md)。 1. **克隆仓库** ``` git clone https://github.com/indexnetwork/index.git cd index ``` 2. **安装依赖** ``` bun install ``` 3. **设置环境变量** ``` cp backend/.env.example backend/.env cp frontend/.env.example frontend/.env # 编辑 backend/.env：设置 DATABASE_URL、OPENROUTER_API_KEY、BETTER_AUTH_SECRET ``` 4. **初始化数据库** ``` cd backend bun run db:migrate bun run db:seed # optional: populate sample data ``` 5. **启动开发服务器** ``` # 终端1：后端服务器（端口3001） cd backend bun run dev # 终端2：前端开发服务器（端口3000，将 /api 代理到后端） cd frontend bun run dev ``` 访问 `http://localhost:3000` 查看应用程序。 ## 开发 ### 项目结构 ``` index/ ├── backend/ # Backend API and agent engine (Bun, Express, TypeScript) ├── frontend/ # Vite + React Router v7 SPA (React 19, Tailwind CSS 4) ├── docs/ # Project documentation (see Documentation section) └── scripts/ # Worktree helpers, hooks, dev launcher ``` ## 协议实现 `backend/` 目录包含核心代理基础设施： ### 关键组件 - **代理**：基于LangGraph的代理，用于意图推断、机会评估、个人资料生成和双边谈判 - **图工作流**：11个状态机（聊天、意图、索引、索引成员资格、意图索引、机会、谈判、个人资料、HyDE、主页、维护），编排复杂操作 - **数据库层**：PostgreSQL配合pgvector用于语义搜索，Drizzle ORM用于类型安全 - **语义治理**：使用言语行为理论和适切性条件进行意图质量验证 ### 开发命令 有关后端命令（数据库、工作者、维护）的完整列表，请参阅 [CLAUDE.md](CLAUDE.md)。 ``` cd backend # 启动开发服务器（Bun.serve，端口3001） bun run dev # 数据库操作 bun run db:generate # Generate migrations after schema changes bun run db:migrate # Run database migrations bun run db:studio # Open Drizzle Studio (DB GUI) # 代码质量 bun run lint # Run ESLint ``` ## 文档 详细文档位于 `docs/` 目录： ### 指南 - **[快速开始](docs/guides/getting-started.md)** -- 包含前置条件、环境配置、数据库设置和故障排除的完整设置演练 ### 设计 - **[架构概述](docs/design/architecture-overview.md)** -- 单仓库结构、协议分层、代理系统、数据流图 - **[协议深入解析](docs/design/protocol-deep-dive.md)** -- 详细的图、代理和工具文档，包含序列图 ### 领域 - **[意图](docs/domain/intents.md)** -- 意图生命周期、语义治理、言语行为验证 - **[机会](docs/domain/opportunities.md)** -- 机会检测、评估和持久化 - **[谈判](docs/domain/negotiation.md)** -- 双边代理对代理谈判协议 - **[个人资料](docs/domain/profiles.md)** -- 用户个人资料生成和HyDE文档嵌入 - **[索引](docs/domain/indexes.md)** -- 社区结构、成员资格和访问控制 - **[HyDE](docs/domain/hyde.md)** -- 用于语义搜索的假设文档嵌入策略 - **[信息流与维护](docs/domain/feed-and-maintenance.md)** -- 主页信息流策划和定期维护 ### 规范 - **[API参考](docs/specs/api-reference.md)** -- REST API端点、身份验证、请求/响应格式 - **[CLI参考](packages/cli/cli-output-reference.html)** -- 每个CLI命令的完整渲染输出参考 - **[CLI参考规范](docs/specs/cli-reference.md)** -- 完整的CLI命令行为规范 - **[CLI npm分发](docs/specs/cli-npm-publish.md)** -- 通过npm进行的平台特定二进制分发 ## 资源 - **[index.network](https://index.network)** - 生产环境应用 - **[GitHub](https://github.com/indexnetwork/index)** - 源代码和问题跟踪 - **[Twitter](https://x.com/indexnetwork_)** - 最新更新和公告 - **[博客](https://blog.index.network)** - 最新见解和更新 - **[预约通话](https://calendly.com/d/2vj-8d8-skt/call-with-seren-and-seref)** - 与创始人聊天 ## 许可证 Index Network 根据 MIT 许可证授权。详情请参阅 [LICENSE](LICENSE)。

标签：Apex, Streamlit, Web3, 上下文感知, 人工智能匹配, 信任阈值, 内核驱动, 匹配系统, 区块链, 协调原语, 去中心化协议, 发现协议, 向量相似度, 意图表达, 意图驱动, 搜索引擎查询, 数据匹配, 时间约束, 机会检测, 机器学习, 测试用例, 索引网络, 网络协议, 网络安全, 自动化攻击, 访问控制, 语义搜索, 语义理解, 隐私保护, 隐私发现, 隐私计算, 预期价值计算