Vibecape Server

Vibecape Server 管理 Group、成员、Space、Git repository 和同步授权。一个 Server 实例绑定一个 Downcity Federation。

初始化与运行

vibecape server init
vibecape server start
vibecape server status

初始化会交互式写入权限为 0600 的 ~/.vibecape/server.env，并询问 Federation URL、Bureau Token、City ID、监听地址、公开地址和数据目录。Bureau Token 输入时不会回显。

server start 会启动后台进程，健康检查通过后归还终端。运行文件位于配置的数据目录：

• server.pid 记录受管理进程；
• server.log 保存后台日志；
• SQLite 数据库保存 Group、成员、Space 和审计信息；
• bare repositories 保存 Space 内容与历史。

vibecape server restart
vibecape server stop
vibecape server start --foreground

只有前台调试或交给 systemd、Docker、Dokploy 等外部进程管理器时，才使用 start --foreground。不带参数的 start 由 Vibecape 自己管理后台进程。

Group 管理

vibecape server group create --name "Research Team"
vibecape server group list
vibecape server group member list <group-id>
vibecape server group member add <group-id> <user-id> --role editor
vibecape server group transfer-owner <group-id> <user-id>

备份时应整体备份配置的数据目录，确保数据库与 bare repositories 保持一致。