summon-protocol

SUMMON(唤名)은 크로스 디바이스 AI Agent 경험을 위한 오픈소스 프로토콜이자 참조 구현으로, EvoTavern 进化酒馆 해커톤 선전(Shenzhen) 지점 트랙 01 「具身与穿戴硬件」에서 비롯되었다. 핵심 목표는 원격에서 실행되는 지능형 에이전트가 통합 프로토콜을 통해 주변 기기(휴대용 화면, 로봇 팔 등)에 접속하고, 기기 핸드오프 후에도 이미 확인된 선호도를 유지하며 계속 상호작용할 수 있게 하는 것이다. 프로젝트는 네 가지 주요 컴포넌트로 구성된다. Ghost Adapter는 기존 Agent를 연결하고 기기 능력을 호출 가능한 도구로 노출하는 역할을 한다. SUMMON Hub는 아이덴티티, 세션, 메모리 및 기기 핸드오프를 관리한다. Shell Gateway는 로컬 하드웨어를适配하고 동작을 실행한다. 성도 인터페이스(Nebula)는 시각적 진입점을 제공하여 Agent 온라인 상태와 핸드오프 과정을 보여준다. 프로토콜은 기기 능력, 제어권 및 실행 영수증을 분리하여 기술하며, 각 접속에는 명확한 세션이 있고, 핸드오프에는 중지 확인이 필요하며, 선호도 업데이트에는 버전 기록이 따른다. 현재 버전은 계약 v0.1.0으로, Hub, 웹 콘솔, 시뮬레이션 Agent/기기, SQLite 메모리 및 기기 경험 라이브러리를 제공하며, 소환, 핸드오프, 선호도 저장, 실행 증거入库 및 실행 전 검색을 검증할 수 있다. 온라인 데모는 SIMULATED이며, 아직 실제 모델과 하드웨어에 연결되지 않았다. 첫 번째 실물 방향은 FoloToy AI Passport이며, 로봇 팔 접속은 후속 확장으로 다룬다. 기기 경험은 계정, 기기, 능력, 실행 모드 및 버전별로 매칭되어 과거 결과와 통계 제안을 제공하지만, 모델 훈련이나 검증된 운동 기술을 의미하지는 않는다. 저장소에는 완전한 문서가 포함되어 있다. 프로토콜 사양(docs/PROTOCOL.md), JSON Schema, 접속 가이드(docs/ADAPTER.md), 하드웨어 및 배포(docs/HARDWARE.md), 성도 설계(docs/NEBULA.md), 펌웨어 이식 매뉴얼(docs/FIRMWARE.md, `summon_port_t` 구조체만 구현하면 되며 물리적 비상 정지는 명시적으로 제공하지 않음), 프로젝트 방안(docs/方案书.md) 및 실행 계획(docs/PLAN.md)이 있다. 개발자는 `python tools/validate_contract.py`를 통해 계약 검증(권장 Python 3.10+)을 실행하여 메시지 구조, 샘플 시퀀스 및 문서 링크를 확인할 수 있다. 프로젝트는 MIT 라이선스를 채택하며, 크로스 디바이스 Agent 프로토콜, 구현 지능 또는 하드웨어 접속에 관심 있는 개발자에게 참고 자료로 적합하다.