atproto下載 - atproto原始碼下載

atproto

其他源碼

1.0.0

下載

AT 協定參考實作 (TypeScript)

歡迎朋友們！

此儲存庫包含 Bluesky AT 協定和app.bsky微博應用服務後端的參考實作。

這裡有什麼？

打字稿包：

包裹	文件	國家公共管理
`@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 帳戶的儲存庫內容。大多數實作程式碼位於packages/pds中，執行時期包裝器位於services/pds中。有關自架的說明，請參閱 bluesky-social/pds。
bsky ： app.bsky.* API 端點的 AppView 實作。在主網路api.bsky.app上運行。大多數實作程式碼位於packages/bsky中，執行時期包裝器位於services/bsky中。

字典：對於com.atproto.*和app.bsky.*來說，目前在該儲存庫中都具有規範版本，位於./lexicons/下。這些是 Lexicon 架構定義語言中的 JSON 文件，類似於 JSON Schema 或 OpenAPI。

互通性測試資料： ./interop-test-files/ interop-test-files/ 中的語言中立測試檔案可能對其他協定實作有用，以確保它們正確遵循規範

Bluesky Social 用戶端應用程式（適用於網頁和行動裝置）的原始程式碼可以在 bluesky-social/social-app 中找到。

Go程式語言原始碼位於bluesky-social/indigo，包括BGS實作。

開發者快速入門

我們建議使用nvm來管理 Node.js 安裝。此專案需要Node.js版本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

關於AT協議

身份驗證傳輸協議（“ATP”或“atproto”）是一種去中心化社交媒體協議，由 Bluesky PBC 開發。了解更多：

概述和指南 ?最佳起點
Github 討論？提問的好地方
協定規範
關於自驗證資料結構的部落格文章

Bluesky Social 應用程式包含一組建構在整個 AT 協定框架中的模式和 API。這些「字典」的命名空間是app.bsky.* 。

貢獻

雖然我們確實接受貢獻，但我們會優先考慮高品質的問題和拉取請求。遵守以下準則將確保更及時的審查。

規則：

我們可能不會回覆您的問題或 PR。
我們可能會在沒有太多回饋的情況下關閉問題或 PR。
如果我們的注意力受到 DDOS 攻擊，我們可能會鎖定討論或貢獻。
我們不為構建問題提供支援。

指南：

請在提交新問題之前檢查現有問題。
在提交 PR 之前提出一個問題並給予一些時間進行討論。
如果提交包含字典變更的 PR，請在實施之前簽署字典變更。
問題是與 atproto 和相關服務的 TypeScript 實作相關的錯誤和功能請求。
- 對於高層討論，請使用討論論壇。
- 對於客戶端問題，請使用相關的社交應用程式儲存庫。
遠離以下 PR：
- 重構大部分程式碼庫
- 無需事先討論即可新增全新功能
- 未經事先討論就更改所使用的工具或框架
- 引入新的不必要的依賴項

請記住，我們為廣泛的用戶社群提供服務。在我們的日常生活中，我們不斷地問「哪一個是我們的首要任務」。如果您提交的 PR 寫得很好，可以簡潔地解決問題，那麼這就是一個了不起的貢獻。否則，儘管我們很樂意接受您的想法和貢獻，但我們確實沒有足夠的頻寬。