工作原理
架构
一个 TypeScript monorepo,核心与协议无关。运行简单,代码易读。
原则
与协议无关的核心
领域层只认识帖子和人,不认识协议。
隐私优先
可见性是每个对象上的数据,并在同一处检查。
易于自建
Node、PostgreSQL、Redis。一台小型 VPS 就够了。
可迁移
导出、导入和账号迁移。
从第一天起就有审核
举报、屏蔽、频率限制、审计日志。
端到端类型化
服务器和 Web 应用共享类型和模式。
技术栈
服务器
- Node.js 22 LTS
- Fastify + Zod
- Drizzle ORM + PostgreSQL 16+
- Redis + BullMQ
- Fedify (ActivityPub)
- 我们自己的 diaspora* 库
Web
- React 19 + Vite
- TanStack Router & Query
- Tailwind CSS v4
- i18next (en, it, es)
- PWA + Web Push
- 供应用使用的 Mastodon 兼容 API
质量
- TypeScript strict
- Vitest: 450+ 测试
- 来自官方 gem 的 diaspora* 测试样例
- Biome
- Turborepo
- 持续集成
monorepo
apps/server REST API, inbox/outbox, WebSocket
apps/worker BullMQ jobs: federated delivery
apps/web React single-page app
packages/core domain: posts, people, canView()
packages/db Drizzle schema and migrations
packages/activitypub ActivityPub adapter (Fedify)
packages/diaspora diaspora* protocol and bridge
packages/diaspora-import in-place pod migration
packages/shared shared types and Zod schemas
packages/config typed configuration每个可联邦的对象都同时拥有 ActivityPub URI 和 diaspora* GUID。设计决策记录在 docs/decisions.md 中。
分层
Web 与应用
React 应用和 Mastodon 应用都与同一个 /api/v1 通信。
API
Fastify 路由用 Zod 校验输入,然后调用核心。
核心
社交规则、可见性和事件,内部不含任何协议。
适配器
ActivityPub 和 diaspora* 适配器把事件翻译成消息,也把消息翻译回事件。
