SealChat 是一款自托管的轻量即时通讯与角色协作平台，服务端使用 Go 1.22 开发，前端基于 Vue 3 + Vite。通过“世界 → 频道 → 消息”的结构以及细粒度权限控制，它既能满足跑团/同人/社区的沉浸式聊天场景，也能覆盖小型团队的内部沟通需求。
- 多层组织模型：
service/world.go定义公开/私有世界、默认大厅、收藏夹；频道支持子层级、身份卡、嵌入窗 (iForm)。 - 灵活权限与身份：
pm权限树结合频道身份 (service/channel_identity.go) 提供多角色扮演、主持/观众模式、Bot 权限。 - 丰富消息形态：文本、附件、图库、音频素材库、骰子宏、悄悄话、OOC/IC 标记、全文检索、导出任务等功能均在
api/*文件中实现。 - 资产与归档：附件/图库 (
api/attachment.go,api/gallery.go)、音频库 (api/audio.go)、导出 worker (service/export_*.go) 让素材沉淀、聊天备份和合规审计更加简单。 - 监控与自动化：
service/metrics+/status页面输出运行指标，api/admin_*管理用户与 Bot，兼容 Satori 协议扩展。
- 账号与访问控制：参考
docs/product-introduction.md第 4.1 节，覆盖注册/登录、系统角色、好友、Presence 的 UI 与 API 操作。 - 世界与频道治理：同文档第 4.2-4.3 节描述如何创建世界、维护频道层级、身份/权限、iForm 及骰子宏设置。
- 消息与资产：第 4.4-4.5 节梳理 WebSocket 流程、消息撤回、附件/图库/音频库上传与复用。
- 检索与归档：第 4.6 节提供全文搜索、历史锚点、导出任务的详细流程与注意事项。
- 监控与自动化：第 4.7-4.8 节总结
/status看板、Presence/时间线，以及 Bot token、命令注册和自动化范式。 - 频道未读提醒：参考
doc/channel-digest-push.md，覆盖时间窗口、访问阈值、主动推送、被动拉取、测试推送及接收端校验程序。
- 服务端：Go + Fiber + WebSocket，单一可执行文件内嵌
ui/dist，默认 SQLite (WAL) 也支持 PostgreSQL/MySQL。 - 前端：
ui/目录使用 Vue 3、Naive UI、Tiptap、RxJS，开发期可独立运行 Vite 服务，构建后通过go:embed打包。 - 存储：附件可存储在本地或 S3/兼容对象存储 (
service/storage)，音频依赖可选ffmpeg（转码）与ffprobe（时长探测，缺失时回退ffmpeg -i解析），导出与音频的缓存位置均由config.yaml配置。
SealChat 支持将附件/图片、音频与平台字体分片资源分别存入 S3（或兼容协议的对象存储，如 MinIO、腾讯 COS 等），并提供“迁移到 S3”的管理端工具。
- 配置入口：
config.yaml的storage段（参考config.yaml.example/config.docker.yaml.example）。 - 分类开关：
storage.s3.attachmentsEnabled（附件/图片）、storage.s3.audioEnabled（音频）、storage.s3.fontsEnabled（平台字体原文件/分片/manifest）、storage.s3.theaterEnabled（小剧场视觉与音频资源；省略时继承对应分类开关）。 - 安全建议：建议通过环境变量配置 AK/SK（
SEALCHAT_S3_ACCESS_KEY、SEALCHAT_S3_SECRET_KEY、SEALCHAT_S3_SESSION_TOKEN），避免把密钥写入配置文件。 - 启动自检：启用 S3 时会进行一次小文件
put/get/delete自检，自检失败会回退本地并输出原因日志。 - 迁移工具：管理端“迁移到 S3”支持图片、音频、小剧场视觉资源分别迁移，建议先“模拟运行（dryRun）”。小剧场音频仍归入音频迁移。
更完整的 S3/COS 配置示例与常见问题请参考 deploy_zh.md 的“对象存储（S3 兼容）”章节。
SealChat 的未读信息邮件通知与**邮箱认证（邮件注册验证/邮件密码重置）**共用 config.yaml 的 SMTP 配置。
- 配置入口：
emailNotification.smtp（即使只启用邮箱认证，也需要完整 SMTP 配置）。 - 功能开关：
emailNotification.enabled控制未读信息提醒；emailAuth.enabled控制邮件注册验证/密码重置。
配置示例与常见问题请参考 deploy_zh.md 的“未读信息邮件通知与邮箱登录认证”章节。
示例（节选自 config.yaml.example）：
# 1. 拉取最新镜像
docker pull ghcr.io/kagangtuya-star/sealchat:latest
# 2. 创建配置文件（推荐，便于持久化）
cp config.docker.yaml.example config.yaml
# 3. 使用 Docker Compose 启动
docker compose up -d
# 4. 访问 http://localhost:3212/ ，首个注册账号将成为管理员
# 更新到最新版本
docker compose pull && docker compose up -d或使用 docker run 一键启动：
docker run -d --name sealchat --restart unless-stopped \
-u 0:0 \
-p 3212:3212 \
-v $(pwd)/data:/app/data \
-v $(pwd)/sealchat-data:/app/sealchat-data \
-v $(pwd)/static:/app/static \
-v $(pwd)/config.yaml:/app/config.yaml \
-e TZ=Asia/Shanghai \
ghcr.io/kagangtuya-star/sealchat:latest说明：在群晖 NAS、Btrfs 子卷、多个外部挂载目录等场景下，建议将上传/音频的临时目录配置到与最终存储目录相同的挂载点下，例如将 storage.local.tempDir 设为 ./sealchat-data/temp、将 audio.tempDir 设为 ./static/audio-temp，可避免跨设备移动带来的额外复制开销。
详细的 Docker 部署说明请参考
deploy_zh.md中的 Docker 部署章节。
- 从发行页下载或
go build ./...编译，运行./sealchat_server（Windows 下为.exe）。发行包内附config.yaml.example与config.docker.yaml.example，可按需复制为config.yaml。 - 首次启动会生成
config.yaml与data/目录，按照示例修改域名、端口、数据库、附件/音频/导出目录。 - 浏览器访问
http://<domain>:3212/，注册首个账号（自动成为管理员并创建默认世界）。 - 参考
docs/product-introduction.md或deploy_zh.md完成世界、频道、权限与资产配置。
如果你希望管理员在“平台管理 → 主题与样式管理”里使用“分割并发布”来把平台字体切成多片，请在主程序同目录准备 bin/cn-font-split/。这个能力是可选的：
- 缺少分割器时，普通访问、富文本使用平台字体、全局 UI 启用平台字体都不受影响。
- 只有管理员点击“分割并发布”时，前端才会懒加载分割 worker 并通过后端读取这里的运行时文件。
- 字体分割器可以将大型字体库拆解为迷你字体库，按需加载，保证正常的打开速度。
目录结构如下：
sealchat-server(.exe)
bin/
cn-font-split/
libffi-wasm32-wasip1.wasm
version
安装步骤：
- 从
cn-font-split上游 release 下载libffi-wasm32-wasip1.wasm。 - 在
bin/cn-font-split/下新建version文件。 - 将
version内容写成wasm32-wasip1@<前端构建所使用的 cn-font-split npm 版本>。
当前仓库前端依赖固定为 cn-font-split@7.4.1，因此当前版本推荐直接写：
wasm32-wasip1@7.4.1
补充说明：
- 上游 release 一般只提供
libffi-wasm32-wasip1.wasm，不会额外提供version文件。 version只是运行时探测与版本展示用途，可以手工创建。- 不建议混用跨度过大的 JS 包版本与 wasm 版本；最佳实践是让
version中声明的版本与前端实际安装的cn-font-split版本保持一致。 - 安装完成后，可在管理员页面点击“检测分割器”确认是否就绪。
- 先决条件：Go >= 1.22，Node.js >= 18（建议搭配 pnpm 或 npm），
ffmpeg可选（转码），建议同时提供ffprobe用于更稳定的时长探测。 - 步骤：
go mod downloadcd ui && npm install && npm run build（或pnpm i && pnpm build）- 回到仓库根目录执行
go build -o sealchat_server ./
- 开发模式：可运行
npm run dev启动前端热更新，同时在根目录go run main.go。
如果你是从源码构建并希望启用管理员前端字体分割，构建完成后同样需要在产物旁边放置 bin/cn-font-split/。如果本地已经安装了前端依赖，可以参考以下方式准备：
mkdir -p bin/cn-font-split
# 从上游 release 下载 libffi-wasm32-wasip1.wasm 到 bin/cn-font-split/
printf 'wasm32-wasip1@7.4.1\n' > bin/cn-font-split/versionWindows PowerShell 可使用：
New-Item -ItemType Directory -Force bin/cn-font-split | Out-Null
Set-Content -Path bin/cn-font-split/version -Value "wasm32-wasip1@7.4.1"go run main.go：启动服务端并自动托管静态资源。go test ./...：执行后端单元测试（导出/骰子等模块含示例测试）。./sealchat_server -i/./sealchat_server --uninstall：在 Windows 上注册/卸载系统服务。
SealChat 支持配置文件数据库持久化与版本历史管理，最多保留 10 个历史版本。
# 列出配置历史版本
./sealchat_server --config-list
# 查看指定版本配置详情（敏感字段已遮罩）
./sealchat_server --config-show 3
# 回滚到指定版本
./sealchat_server --config-rollback 2
# 导出指定版本为 YAML 文件
./sealchat_server --config-export 1 --output config.backup.yaml配置同步逻辑：
- 配置文件存在时：读取并同步到数据库
- 配置文件丢失时：从数据库恢复并重建配置文件
可通过命令行直接读取当前配置对应数据库，列出平台管理员，或按用户名重置密码为 123456。
# 列出平台管理员用户
./sealchat_server --user-secret list
# 重置指定用户密码（支持平台管理员和普通用户）
./sealchat_server --user-secret reset --username alice --username bob
# 仅允许重置平台管理员，并跳过确认
./sealchat_server --user-secret reset --admin-only --username alice --yes数据库连接优先级：
SEALCHAT_DSN环境变量config.yaml中的dbUrl- 默认
./data/chat.db
| 目录 | 说明 |
|---|---|
api/ |
Fiber HTTP/WebSocket 接口、业务 RPC 封装 |
cmd/ |
可独立运行的辅助命令与示例程序 |
service/ |
世界、频道、附件、音频、导出、指标等业务逻辑 |
model/ |
GORM 模型与数据访问层 |
pm/ |
权限模型与代码生成器 (go generate ./pm/generator) |
ui/ |
Vue 3 前端工程与导出 Viewer 构建脚本 |
specs/ & plans/ |
需求与实现规划文档 |
doc/ |
外部接口与专题说明文档 |
docs/ |
产品/部署等补充文档，新增的《产品介绍》位于 docs/product-introduction.md |
deploy_zh.md |
官方部署指南（含数据库切换、系统兼容性） |
本项目仍处于持续迭代阶段（WIP），欢迎根据实际场景扩展世界/频道权限、Bot 能力与前端组件。
- tanis
- 爱发电用户_NTdp（不愿透露姓名的xnn）