agent-host-protocol

让多个客户端同时连同一个 AI 会话,状态不再各说各话

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 智能体 🍴 复刻 154 🐛 待处理 82 👀 关注 17
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 443
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,微软GitHub Pages文档站,无付费信息

项目预览

agent-host-protocol 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类智能体
开发团队microsoft
定价模式🏷️完全免费
价格说明开源免费,微软GitHub Pages文档站,无付费信息
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言TypeScript
GitHub 星标★ 443
上线时间2026-03-12 00:00:00
代码更新2026-11-06
仓库体积15.9 MB
本站数据更新2026-11-06
维护状态活跃
收录时间2026-09-22
浏览次数1

项目介绍

agent-host-protocol 是一个面向 AI 智能体会话的多客户端状态同步协议,用 TypeScript 实现。它要解决的问题是:当同一个 AI 智能体会话被多个客户端(如网页、桌面端、移动端、IDE 插件)同时接入时,各端看到的状态容易不一致,历史消息、工具调用、流式输出等会错乱。该项目定义了一套主机与客户端之间的通信协议和状态模型,让所有接入端共享同一份会话状态,并保持同步。核心能力包括会话状态的统一表示、增量更新与事件广播、多客户端加入与重连时的状态对齐,以及为流式 token、工具调用结果等智能体特有事件提供结构化传输。它适合作为构建多端 AI 助手、协作式智能体应用的基础设施层,让开发者不必自己处理复杂的状态合并与同步逻辑。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 443

使用教程

难度:入门 约 15 分钟 部署方式:本地构建 4 步

环境要求

  • Node.js 18+

安装与启动步骤

  1. 1先读协议里的状态同步一节

    多客户端同时改同一会话是它要解决的核心问题。

  2. 2装依赖

    文档站与参考实现共用一个 Node 工程。

    npm install
  3. 3起文档站

    本地起一份方便对照规范读。

    npm run docs:dev
  4. 4跑参考客户端验证同步

    两个客户端连同一个会话,改一边看另一边。

如何确认成功

两个客户端同时连同一个会话时,任一方改状态另一边立刻收到,且断线重连后能补齐缺失的状态

注意事项

  • 它是协议规范加参考实现,不是成品应用,别指望装完就有一个能用的助手。
  • 冲突合并策略写在规范里,自己实现之前先读那一节,否则多端会互相覆盖。
  • 文档站只是阅读入口,不是服务端,起了它也不代表协议服务在跑。
  • 生态还在早期,字段与消息类型可能变,锁版本再集成。

核心亮点

  • 把多客户端会话同步抽象成协议层,前端/客户端可复用同一套状态模型,避免各端各写一套合并逻辑
  • 针对智能体场景设计,覆盖流式输出、工具调用等事件,而非通用 CRDT 方案
  • TypeScript 实现,类型定义清晰,便于在 Node/浏览器/Electron 等环境接入

不足之处

  • 项目处于早期,星标仅 353,API 和协议格式可能频繁变动,生产使用需锁定版本
  • 目前生态和文档积累有限,缺少大规模多客户端并发场景的验证案例

适用场景

  • 同一 AI 助手同时开在网页、桌面端和手机端,消息与工具调用状态实时一致
  • IDE 插件与网页端共享一个编码智能体会话,两边看到相同的执行进度
  • 团队协作场景中多人接入同一个智能体会话,共同查看和跟进任务状态

替代项目

Yjs、Automerge

上一篇:database-skills

下一篇:chat-ollama

同类项目推荐

deepseek-harness 开源

把 AI 能力拆成乐高积木,拼出你的专属智能体。

DeepSeek Harness: Everything is a Plugin.

★ 274789 2026-08-15
askimo 开源

一个客户端搞定多模型、RAG 和智能体工具调用

AI desktop app for chat, RAG, Skills, MCP tools, and agents. Support multiple LLMs (···

★ 541 2026-08-09
omnibase 开源

自托管 AI 工作台,管好知识、模型和智能体

Self-hosted AI workbench for knowledge, RAG, model providers, and safely governed us···

★ 2 2026-08-09
KiCAD-MCP-Server 开源

让 Claude 直接画 PCB,说句话就改板子

KiCAD MCP is a Model Context Protocol (MCP) implementation that enables Large Langua···

★ 3181 2026-09-15
agora 开源

一键召唤31位思想家,多角度辩证你的每个决策

31 位思想家组成的多 Agent 审议系统,覆盖工程、商业、人生抉择、关系、心理、创作六大领···

★ 170 2026-08-09
vsync 开源

一份配置,同步所有 AI 编程工具,告别重复设置。

Sync MCP servers, Skills, Agents & Commands across Claude Code, Cursor, OpenCode, Co···

★ 63 2026-08-09
agentic-awesome-skills 开源

一站式管理 2000+ AI 技能,让智能体自主选型与编排,告别重复造轮子

2,926+ reusable AI agent skills for Claude Code, Codex, Cursor and Gemini CLI. AAS C···

★ 49273 2026-08-09
mnemosyne 开源

给 AI 智能体装一个本地长期记忆库

Auditable, local-first memory for AI agents in one SQLite file. MCP server for Claud···

★ 157 2026-10-27
agentic-ai-engineering 开源

手把手从零写AI智能体,搞懂底层原理

Hands-on tutorials for building AI agents from scratch. Learn LLM APIs, prompt engin···

★ 384 2026-08-09