프로젝트 소개

Downcity는 많은 에이전트 기반 제품과 워크플로우를 출시하는 개발자, 독립 빌더 및 팀을 위한 에이전트 인프라 프로젝트입니다. 이 프로젝트의 전제는 하나의 재사용 가능한 런타임 레이어가 여러 에이전트와 제품을 지원한다는 것으로, 이를 통해 모델 라우팅, 도구, 메모리, 작업, 인증, 사용량, 청구 및 운영을 매번 새로 구축할 필요가 없습니다. 이 저장소는 pnpm 워크스페이스 모노레포입니다. 공개된 downcity 패키지는 두 가지 명령 인터페이스를 노출합니다: 로컬 에이전트 관리 및 실행을 위한 city/downcity, 그리고 연합 서버 관리를 위한 fed/downfed. 지원 패키지로는 @downcity/workspace(워크스페이스 리소스, 파일 및 검색 도구, 환경, 개인 저장소, 내장 쉘), @downcity/agent(에이전트 런타임 및 City 컨테이너, AgentWorkspace, Session, Plugin SDK, 다중 에이전트 소유권, HTTP/RPC 전송), @downcity/federation(연합 런타임 및 서비스, 인증, 환경, Bureau, 사용자 및 관리자 액세스를 위한 Embassy SDK), @downcity/type(공유 프로토콜 타입), @downcity/services(계정, 잔액, 사용량, 결제 및 Stripe 흐름), @downcity/ui(콘솔 및 호스트 애플리케이션을 위한 React + Tailwind 컴포넌트)가 있습니다. 스타터 템플릿은 에이전트, 에지 연합, 로컬 연합, React UI 시나리오를 다루며, 홈페이지 디렉토리에는 웹사이트와 최종 사용자 문서가 포함되어 있습니다. 일반적인 로컬 사용법은 다음과 같습니다: npm 또는 pnpm으로 CLI를 설치하고, downcity federation use 및 federation status로 연합에 연결한 후, downcity agent create .로 저장소를 워크스페이스로 등록하고, downcity on으로 로컬 City를 시작하며, downcity agent list 또는 downcity status로 이를 검사합니다. 에이전트 ID와 구성은 사용자 수준의 ~/.downcity 디렉토리(agents/, plugins/)에 저장되며, 워크스페이스는 실행 시에만 진입합니다. README에는 에이전트가 독립적인 시작/정지 상태를 가지지 않으며, CLI City가 꺼져 있어도 채팅이 작동하는 것은 일시적인 로컬 City가 생성되고 폐기되기 때문이라고 설명되어 있습니다. 내장된 에이전트 기능으로는 채팅, 작업, 메모리, 쉘, 연락처, 스킬, 웹, 사운드, 워크보드가 나열되어 있습니다. 통합은 여러 수준에서 제공됩니다. SDK 예제는 쉘 샌드박스가 있는 워크스페이스를 구축하고, 에이전트와 세션을 생성하며, 호스트 애플리케이션에서 생성한 모델을 주입한 후(README에 따르면 @downcity/agent는 공급자나 모델 ID를 직접 해석하지 않음), 프롬프트를 보내고 완료된 턴을 기다립니다. RemoteAgent 클래스는 기본 URL을 통해 HTTP로 실행 중인 City에 연결합니다. 제품 인터페이스로는 Downcity CLI, Agent SDK, City SDK, UI SDK, 플러그인, 서비스 및 React UI 컴포넌트가 있습니다. 플랫폼 지원 및 안전성: macOS는 Seatbelt, Linux는 Bubblewrap을 사용하며, Windows 11 24H2 이상(빌드 26100+)은 Microsoft MXC processcontainer를 통해 개발/불안정 상태로 지원되며, cmd.exe를 네이티브로 실행합니다. README에는 사전 검사 실패 시 절대 무제한 실행으로 대체되지 않으며, MXC는 공개 프리뷰 단계로 프로덕션 보안 경계가 아니라고 명시되어 있습니다. 쉘 및 스크립트 명령은 기본적으로 에이전트 샌드박스에서 실행되며, 쓰기 가능한 프로젝트, 개방형 네트워크 및 .downcity/sandbox 아래의 샌드박스 홈/캐시를 포함합니다. 조언으로는 git status 및 git diff로 변경 사항을 감사하고, 비밀은 로컬 환경 변수나 downcity env에 저장하며, 콘솔, HTTP 및 채팅 경계에 토큰을 사용하고, 호스트 수준 설치 및 시스템 디렉토리 쓰기는 샌드박스 범위를 벗어난다는 점을 유의해야 합니다. 문서는 downcity.ai/docs에 게시되어 있으며, City SDK, Agent SDK, UI SDK 페이지, 패키지 수준 README, 그리고 주요 README의 간체 중국어 번역을 포함합니다.