친구들을 환영합니다!
이 저장소에는 AT 프로토콜 및 app.bsky
마이크로블로깅 애플리케이션 서비스 백엔드에 대한 Bluesky의 참조 구현이 포함되어 있습니다.
타입스크립트 패키지:
패키지 | 문서 | NPM |
---|---|---|
@atproto/api : 클라이언트 라이브러리 | 읽어보기 | |
@atproto/common-web : 웹 브라우저에서 실행할 수 있는 공유 코드 및 도우미 | 읽어보기 | |
@atproto/common : 웹 브라우저에서 작동하지 않는 공유 코드 및 도우미 | 읽어보기 | |
@atproto/crypto : 암호화 서명 및 키 직렬화 | 읽어보기 | |
@atproto/identity : DID 및 핸들 확인 | 읽어보기 | |
@atproto/lexicon : 스키마 정의 언어 | 읽어보기 | |
@atproto/repo : MST를 포함한 데이터 저장 구조 | 읽어보기 | |
@atproto/syntax : 식별자를 위한 문자열 파서 | 읽어보기 | |
@atproto/xrpc : 클라이언트 측 HTTP API 도우미 | 읽어보기 | |
@atproto/xrpc-server : 서버 측 HTTP API 도우미 | 읽어보기 |
타입스크립트 서비스:
pds
: "개인 데이터 서버", atproto 계정에 대한 저장소 콘텐츠를 호스팅합니다. 대부분의 구현 코드는 services/pds
에 런타임 래퍼가 있는 packages/pds
에 있습니다. 자체 호스팅에 대한 지침은 bluesky-social/pds를 참조하세요.bsky
: app.bsky.*
API 엔드포인트의 AppView 구현입니다. api.bsky.app
의 메인 네트워크에서 실행됩니다. 대부분의 구현 코드는 packages/bsky
에 있고 런타임 래퍼는 services/bsky
에 있습니다. 어휘: com.atproto.*
및 app.bsky.*
모두 이 저장소의 정식 버전으로 현재 ./lexicons/
아래에 있습니다. 이는 JSON 스키마 또는 OpenAPI와 유사한 Lexicon 스키마 정의 언어로 된 JSON 파일입니다.
상호 운용성 테스트 데이터: ./interop-test-files/
의 언어 중립적 테스트 파일은 다른 프로토콜 구현이 사양을 올바르게 따르는지 확인하는 데 유용할 수 있습니다.
Bluesky Social 클라이언트 앱(웹 및 모바일용)의 소스 코드는 bluesky-social/social-app에서 찾을 수 있습니다.
Go 프로그래밍 언어 소스 코드는 BGS 구현을 포함하여 bluesky-social/indigo에 있습니다.
Node.js 설치를 관리하려면 nvm
권장합니다. 이 프로젝트에는 Node.js 버전 18이 필요합니다. pnpm
여러 패키지의 작업 공간을 관리하는 데 사용됩니다. npm install --global pnpm
으로 설치할 수 있습니다.
기본 개발 작업에 도움이 되는 Makefile이 있습니다.
# use existing nvm to install node 18 and pnpm
make nvm-setup
# pull dependencies and build all local packages
make deps
make build
# run the tests, using Docker services as needed
make test
# run a local PDS and AppView with fake test accounts and data
# (this requires a global installation of `jq` and `docker`)
make run-dev-env
# show all other commands
make help
인증된 전송 프로토콜("ATP" 또는 "atproto")은 Bluesky PBC에서 개발한 분산형 소셜 미디어 프로토콜입니다. 다음에서 자세히 알아보세요.
Bluesky Social 애플리케이션은 전체 AT 프로토콜 프레임워크에 구축된 일련의 스키마 및 API를 포함합니다. 이러한 "어휘"의 네임스페이스는 app.bsky.*
입니다.
우리는 기여를 받아들이지만 고품질 문제와 끌어오기 요청을 우선시합니다. 아래 지침을 준수하면 보다 시기적절한 검토가 보장됩니다.
규칙:
지침:
우리는 광범위한 사용자 커뮤니티에 서비스를 제공한다는 것을 기억하십시오. 우리의 일상은 "무엇이 최우선인가?"라는 질문을 끊임없이 던집니다. 문제를 간결하게 해결하는 잘 작성된 PR을 제출한다면 그것은 대단한 기여입니다. 그렇지 않으면 우리는 귀하의 아이디어와 기여를 받아들이고 싶지만 실제로는 대역폭이 없습니다.
Bluesky는 AT 프로토콜을 기반으로 구축된 개방형 소셜 네트워크입니다. AT 프로토콜은 개발자가 구축하는 생태계에서 결코 벗어나지 않는 유연한 기술입니다. atproto를 사용하면 타사도 맞춤 피드, 연합 서비스, 클라이언트 등을 통해 자사만큼 원활하게 작업할 수 있습니다.
보안 문제를 발견하시면 [email protected]으로 이메일을 보내주세요. 해당 이메일은 자동으로 팀 전체에 참조로 추가되며 즉시 답변해 드리겠습니다. 자세한 내용은 SECURITY.md를 참조하세요.
이 프로젝트는 MIT 및 Apache 2.0 조건에 따라 이중 라이선스가 부여됩니다.
다운스트림 프로젝트와 최종 사용자는 재량에 따라 라이선스를 개별적으로 선택하거나 두 가지를 함께 선택할 수 있습니다. 이 이중 라이센스의 동기는 Apache 2.0에서 제공하는 추가 소프트웨어 특허 보증입니다.