海豹 TRPG 骰点核心,开源跑团辅助工具,支持 QQ/Kook/Discord 等。
轻量 · 易用 · 全能
本项目是基于原 sealdice 项目的分叉,采用 monorepo 模式合并了原项目的多个子仓库,便于管理代码。该仓库下每个文件夹为一个独立子仓库:
core:对应 原 core 仓库,Go 后端代码,为海豹核心的主要逻辑部分;ui:对应 原 ui 仓库,前端代码,基于 Vue3 + ElementPlus 开发;android:对应 原 android 仓库,Android 应用源码;builtins: 对应 原 builtins 仓库,存储了海豹的内置牌堆与查询资料;manual:对应原 手册仓库,官方手册源码,由 VitePress 驱动;story-painter:对应原 染色器仓库,跑团 Log 染色器前端源码;verify:对应 原 verify 仓库,客户端验证工具前端源码;- ……
你可以阅读各个子文件夹下的 README.md 文件,了解对应仓库的详情。
注:如无特殊说明,所有代码文件均遵循 MIT 开源协议。
见 使用手册。
本项目提供了 go-task 配置,方便执行预置好的任务。在开发之前,强烈推荐 安装相应工具。
此外,对于不同的子项目,你可能需要配置相应的开发环境(如 core 需要配置 golang 环境,前端需要配置 node 等),请参考各语言相关自行配置。在配置时,一些子项目依赖额外的 Lint 工具,也强烈建议安装:
- 对于 Go 项目(如
core),请安装 golangci-lint 进行静态分析。
# 例如:mac 下使用 brew 安装:
$ brew install go-task golintci-lint更多信息请参考各子文件夹下的 README.md 文件。同时,在安装 go-task 以后,可以运行提供的 doctor 任务对开发环境进行检测。
$ task doctor
🟢 git 已安装 (git version 2.51.0)
🟢 go 已安装 (go version go1.25.1 X:nodwarf5 linux/amd64)
🟢 golangci-lint 已安装 (golangci-lint has version 2.4.0 built with go1.25.0 from 43d03392 on 2025-08-13T23:36:29Z)
🟢 pnpm 已安装 (version: v10.17.0)见 手册 - 参与项目。