技术栈与产品组成
本页提供产品技术概览；实际源码、接口与自建说明在同一主库的开发文档和部署文档维护。生产配置和用户资料不随源码公开。客户端发行的安装要求见开始使用。
谁需要准备这些技术
网站使用者、客户端使用者和 Hub 运营者的准备范围见客户端入门的使用方式表。这里按技术列出承担的工作，安装环境与步骤统一见开始使用。
产品组成
网站、Native、自己的 AI、业务服务、Worker、Hub 与 Bridge 的职责集中见架构中的组成部分。下面的依赖为这些职责提供实现基础。
采用的主要技术
| 领域 | 技术 | 用途 |
|---|---|---|
| Web | Next.js、TypeScript、React、Vite、Tailwind CSS | 类型化开发、组件界面、构建与样式 |
| 业务与本机核心 | Go、River、SQLite | go/ 中的 Hub 与 Native 独立入口；业务库使用 PostgreSQL，本机资料保留原 JSON／PEM／SQLite 格式 |
| 网页与宿主运行 | Node.js、JavaScript／TypeScript、Python | Next.js 网页、宿主 SDK／UI 与公开内容编译保留各自运行时；Go 核心不依赖旧 Node 业务进程 |
| 服务端数据 | PostgreSQL | Hub／官方的业务数据持久化，由服务维护者配置 |
| 客户端宿主接入 | 插件、MCP、MCP Apps、Skill | 在已有 AI 环境中连接工具、初始化本地身份并使用宿主支持的界面；由安装程序和 AI 协助处理配置 |
| 专用 Agent 执行接入 | A2A | 所支持执行环境的协作接口；普通客户端初次接入无需全部配置 |
| Hub／官方服务端认证 | Keycloak / OpenID Connect | 由服务维护者配置，承接相应网站环境的账户认证 |
| Hub／官方服务端聊天 | Prosody / XMPP | 服务器内部的消息传输与归档；客户端经银河 HTTPS 业务接口使用，无需安装、配置 XMPP 或单独注册 XMPP 账户 |
| Hub／官方服务端文件 | S3 兼容存储、ClamAV；Garage 是自部署对象存储工程选择 | 对象存储与安全扫描，自部署标准和运行覆盖继续落实 |
| 指标、告警与日志 | Prometheus、Alertmanager、Grafana OSS、Loki、Alloy | 已选定的运行工具组合，真实集中采集覆盖分别核对 |
| 统一备份与恢复 | restic、pgBackRest | 已采用的运行保障方案；配置和构建不等于完整灾备验收 |
表中技术不一定在每种入口中同时运行，客户端与各服务组件分别管理版本。
接入与开放方向
MCP 与 A2A 的协议分工见愿景与架构。Hub 的 galaxy-direct-proof/1 有限直连、可交换字段和未启用的 Relay 统一见Hub 信息流。技术采用本身不代表全部可选协议、跨站聊天室联邦或独立生态已经实现。
基础组件的工程整合
运营后台采用 Payload、Next.js 与银河业务扩展，Go 任务传输使用 River，原任务 ID／回执和持久调度由实际业务适配接续；旧 pg-boss 是迁移来源，不是 Go 队列权威。存储、监测、日志和备份恢复复用相应成熟工具；实际接线、部署与完整验收分别处理。
AI 运营引擎、专门服务和候选框架的实际采用范围集中见开放组件。普通使用者继续使用自己的模型；框架选型不替代产品效果，整体成熟度见当前状态。