Skip to content

SForum v3.1.0

Latest

Choose a tag to compare

@github-actions github-actions released this 14 Nov 14:31
· 41 commits to main since this release
1126c88

Maintainable, plugin-first open-source forum framework.

v3.1.0 是以信任等级(Trust Levels)+ 徽章为主轴的互动能力版本。自 v3.0.23 起 149 个提交(146 个非 merge + 3 个 merge;32 个 feat、27 个 fix,其余为 docs / test / chore / ci),在既有 RBAC 之上叠出「按累计行为自动升降的能力层」,并把徽章从写死枚举升级为可配置的规则引擎;同时修掉两条 govulncheck 可达漏洞、最后 4 条 CodeQL 告警,以及 PostgreSQL 17.12 对 REASSIGN OWNED 的权限收紧(CVE-2026-120146) 在非超级用户部署下的四处生产路径故障;17 个 Dependabot PR 一次性合并。


新功能

信任等级体系(Trust Levels)

  • 信任等级落地(M1–M8) —— 在既有 RBAC 之上叠一层按累计行为自动升降的能力层:TL 在装载期合并进 Actor.Permissions,Can() 零改动(裁决仍只有一个入口)。装载公式 effective = Expand(static) ∪ (earned ∖ denied);既有「新人信任阶梯」(trustForActor 七项 trust.new_user*)收编为 TL0。默认 earnable = ∅,权限解锁是运营开启的框架能力。f63ad2cf9
  • 后台独立页 + 收尾(M9–M13) —— /control-panel/forum/trust-levels(论坛管理 → 信任等级),门控 trust.manage;旧 ?tab=trustLevels 重定向;能力解锁编辑器与 P0 授权闸修复同批落地。57a3de5ad
  • 档位管理(1–8 档,默认 5 档) —— 档位增删、插序、改名、换图标;停用与删除走确认;TL0 为固定档不可改。92d6991cf
  • 档位外观 Modal —— 外观从行内面板改为 modal,图标走共享 SFIconPicker(lucide + tabler 全量,存 i-<collection>-<name> 全名,16 短名仍是默认序列),颜色 = 9 token 推荐色板 ∪ 自定义 #rrggbb(深色变体由 CSS color-mix 派生,明/暗双底预览,低对比只提示不阻断)。f7c425c43
  • 分档发言限额编辑器 —— 后台第 5 个 tab,按档配置发帖/回复限额。da1d01683
  • 配色收敛为单一实现 —— 前端一处投影,管理台信任等级归入「身份」分组,消除双实现漂移。c7fdafede
  • 条件化门槛(M1 / M3b) —— 配置可携带可选规则树(5 层 / 32 叶);后台阈值 tab 加「更多条件(N)」折叠面板、保存前影响面估算与目录闸门。无规则站点零新增查询。e11cadca6、9396dd155
  • 规则求值接入判定 —— 合成根单次 Prepare + fail-closed + 公开句子输出;规则与数值门槛同一份求值链。307fc3672
  • 变更台账 + 事件 + 重算(M4b) —— 变更账本表与 sforum_core_v1 稳定视图、trust_level.changed 事件(载荷 6 字段 + 三条不发路径)、recompute worker、双入队触发点(reactions ×2 / bookmarks / comments / topics / visits)、策略批量与每日 sweep。e66a8bfbc、899a4c07d、9f6061e43
  • 两条公开 HostQuery(M4b-3) —— 等级目录与「单用户现算」(不读账本);incomplete / disabled 时 level 为 null 而非 0。fddfb535d
  • identity.profile 条件 —— 共享条件目录 13 → 14、信任子集 11 → 12;field 四值文案与棘轮放行清单守卫同批。9169ba30d、3c546b5a4
  • 插件扩展面四条 —— 事实条件 userFactConditions、permissionDefinitions[].trustLevelEarnable、trust_level.changed 事件、两条 HostQuery;可挣得权限白名单从「解码期硬拒」改为「运行期过滤 + 写期拒绝」。启用弹窗新增「可被信任等级授予的权限」披露。e0c67b7bf、9f84bf8e8
  • 死键清理 —— 删 8 条死 i18n 键,档位错误抬头接 errors.tierTitle,死键棘轮收缩到空。404d09ed2

徽章与用户活动

  • 徽章数据域 —— 五张表(user_activity / user_visits / badge_groups / badges / user_badges)+ users.top_badge_id,独立包 app/Models/Badges/;14 条路由(2 公开 + 12 后台)、3 个稳定视图 + HostQuery、features.badges 开关、badge.view / badge.manage 权限键。统计层是信任等级的地基。9bb188362、f63ad2cf9
  • 徽章等级表 badge_tiers —— 把 badges.tier 从写死 bronze/silver/gold 枚举升级为可管理的数据表;后台拆四分区页签 + 批量授予。9bb188362
  • 规则引擎与插件事实层 —— 徽章获得条件改由规则自动解释,规则编辑器双模式收口;插件可声明事实条件。4457106e2、7c07edf9d、082f98624
  • 条件参数引用候选项 —— 条件参数可选值由宿主候选目录下发,日界折算收敛到进程时钟(消除跨时区分歧)。fab8d708a
  • 授予通知 + 自由佩戴 —— 授予通知补全、用户可自由选择佩戴的徽章、「不佩戴」hidden 态、进度口径统一。f522edf58
  • 佩戴中徽章(资料页 + 评论卡) —— chip 点击开徽章说明弹窗。68ec55ec0
  • 徽章卡片组件 —— 资料页与 /badges 目录页共享同一张卡片。18cbc5e06
  • /badges 公共目录页 —— page ID forum.badge.index、GET /api/v1/badges(core.route.badges.public_catalog,private, no-store)、Page Registry 七件套 + 内置主题模板。cd8dbf248、09821208b

互动:点赞与收藏

  • 内容点赞 —— 主题 + 评论单 like、可撤销、计数反规范化;点赞者头像组。bd46b265f
  • 内容收藏 —— 主题 + 评论、公开/私密、到期提醒;content_bookmarks 多态关系 + 6 条路由 + forum.bookmark_reminders 周期任务与 bookmark_reminder 通知(邮件默认开)+ 稳定视图与 HostQuery。82a6b014e

插件设置面贡献点(settingsSection)

  • 个人设置页与站点设置页首次有宿主契约 —— 插件可声明「一个设置 tab / 一组按用户存的表单字段」,声明、存储、权限、运营治理、错误定位全部复用宿主既有机制;新增 settings_surface_items 治理表(sparse overlay:无行 = manifest 默认、enabled=false = 运营关掉、删行 = 恢复默认)。33fcc7dc9
  • 新增端点 —— GET /admin/extensions/contributions、PUT|DELETE /admin/extensions/contributions/:point/:contributionId(同形 /items/:itemKey)、GET /admin/settings/surface-tabs;GET /profile 增可选 settingsSections + settingsValues,PUT /profile 接受 meta。33fcc7dc9

个人资料页

  • 头部移除个人简介行 —— bio 只保留在「关于」tab,身份行更紧凑。94d394cae

随 v3.0.23 一并交付、此前未在发布说明单列

以下三项已包含在 v3.0.23 的代码线里(v3.0.23 的 release body 只写了 x/net 安全修复),此处补齐说明,便于对照实际行为:

  • 扩展管理「更新」三态词汇 —— /extensions、/extensions/plugins、/extensions/themes 三页不再渲染原始 stagedVersion 徽章,改为每行派生一个更新状态:可升级 v{staged} / 重启后生效 / 激活后生效;新增上下文主按钮与行尾 ⋯ 完整动作清单、工具栏「只看有更新」视图开关、{m} 个内置更新待重启 计数。f93817434
  • 附件引用核对 —— POST /api/v1/admin/attachments/reconcile(body {dryRun},dryRun 默认 true;dry run 只发 SELECT,apply 只修漂移行且幂等);cleanup 现在回报 skipped 与 retentionDays,让只有 attachment.manage 的运营能自行解释等待窗口;cleanupAdmin 解码加固(空 body 回落服务默认、非法 JSON 返回 400 attachments.cleanup_body_invalid)。f93817434
  • 测试库隔离 —— 集成测试改为各自 seed 自己需要的行,共享测试库不再互相污染;后续 users_id_seq 落后导致的 users_pkey 偶发冲突由 03c9a794b 收口(见「依赖与工程」)。f93817434

修复

PostgreSQL 17.12:REASSIGN OWNED 权限检查(CVE-2026-120146)

postgres:17-alpine 于 2026-11-12 随 17.12 发布滚动更新。17.12 收紧了 REASSIGN OWNED 的调用者权限检查(release notes:Align REASSIGN OWNED's caller-privilege checks with ALTER ... OWNER TO's checks,CVE-2026-120146):PG 16 起把对象交给另一个 role 就要求能 SET ROLE 到该 role,但 INHERIT TRUE, SET FALSE 的成员关系此前可经 REASSIGN OWNED 绕过接收者一侧的检查;17.12 把这个缺口堵上,接收者也必须可 SET ROLE。

  • 后果 —— 非超级用户宿主在 17.12 上,扩展数据库的租约回收、迁移角色退役、扩展卸载三条路径全部报 must be able to SET ROLE ... (SQLSTATE 42501)。同一份代码在 17.11 上是好的;这也是 CI Go gate 连续多日红的根因(CI 镜像已滚动到 17.12,本地 dev 容器仍是 17.11,于是本地恒绿、CI 恒红)。f1567e244
  • 修法 —— 在回收事务内临时 acquire 接收者的 SET ROLE 权限,用完立即 release,不留常驻成员关系:acquire 走 GRANT <owner> TO <session_user> WITH ADMIN FALSE, INHERIT TRUE, SET TRUE,release 走 REVOKE ... GRANTED BY CURRENT_USER;旧 role 一侧继续用 SET FALSE(存活租约 role 是带密码的 LOGIN role,给它 SET TRUE 等于允许冒充,属提权)。不做常驻授权是因为扩展 owner 的成员关系本身被隔离校验要求为「无任何成员」,常驻会让下一次 provisioning 直接报 ErrExtensionDatabaseResourceConflict。f1567e244
  • grantor 维度隔离 —— pg_auth_members 主键是 (roleid, member, grantor):CREATEROLE 会话建 role 时 PostgreSQL 自动留下 grantor=<creator>, admin=true 一行,我们的 GRANT 不覆盖它而是新增一行,REVOKE ... GRANTED BY CURRENT_USER 只删自己那条,creator 的 ADMIN 仍在(随后的 DROP ROLE <旧 role> 依旧成立)。PG 17.12 上逐步打印 pg_auth_members 实测:CREATE ROLE 后只有 creator 行 → acquire 后多出 admin=f, inherit=t, set=t → release 后只剩 creator 行,SET ROLE owner 报 permission denied、DROP ROLE owner 仍成功。
  • 覆盖四处窗口 —— ① 建 schema(CREATE SCHEMA ... AUTHORIZATION <owner>,PG 16 起就要求接收者 SET ROLE,与 17.12 无关,非超级用户宿主在 17.11 上同样失败,此前被测试里手工补的 GRANT ... SET TRUE 盖住);② configure(REVOKE ALL ON SCHEMA / GRANT USAGE, CREATE / 4 条 ALTER DEFAULT PRIVILEGES FOR ROLE <owner>,窗口开在函数内部,避免将来多一个调用方就漏);③ 运行时租约默认权限(ALTER DEFAULT PRIVILEGES FOR ROLE <lease>,此前该缺口意味着非超级用户宿主仍发不出运行时租约);④ 卸载(窗口卡在 DROP SCHEMA ... CASCADE / DROP OWNED BY <owner> 之前、DROP ROLE <owner> 之前,否则 REVOKE 会打在已删除的角色上)。3d5dda827、193712498
  • 回归覆盖 —— 原失败用例保留「回收前宿主不得继承扩展 owner」的严格前提,改为调用生产同款 helper,并把「不得残留权限」的断言从只查 pg_has_role(..., 'USAGE') 扩到同时检查 USAGE 与 SET;新增非超级用户 provisioning 端到端用例,走真正的生产入口 ensureExtensionDatabaseResources(自然覆盖 configure),宿主全程不补任何接收者 GRANT。反证:注释掉 configure 的 acquire 报 permission denied for schema ...,注释掉租约默认权限的 acquire 报 permission denied to change default privileges。87965eac9、193712498
  • 决策记录:knowledge/decisions/2026-11-14-postgres-1712-reassign-owned-set-role.md(含本地 17.11 / 17.12 双镜像复现表与 pg_auth_members 实测)。

其他修复

  • 徽章授予通知被静默吞掉 —— NotifyBadgeGrantedTx 去重键 badge:{slug} → badge:{recipientUserID}:{slug}(邮件 IdempotencyKey 同键),规则回扫补上通知出口;同函数内的空页 panic(userIDs 为空时取 userIDs[len-1] → index -1,job 重试永远命中同一页、回扫永不结束)一并修掉。e8d6e63df
  • 话题页原生 confirm 换站内弹窗 —— 4 处 window.confirm(评论删除、话题删除、话题扩展动作、评论扩展动作)换成 SFConfirmDialog + useConfirmDialog;同时修复举报对话框 reactive 失真。e13cbfa99
  • 佩戴出口三态收口 —— hidden 行不再进入全量重算作用域,避免「选了不佩戴却被自动改回」。9c2da0f04
  • 徽章目录页左栏分类导航补全 —— 资料页右栏 min-width 裁切修复。6502fb25b
  • 徽章等级身份统一 —— 统一为「图标 + 颜色 + 名字」,消除三处不同表述。d502f19a3
  • 徽章等级配色取色器 —— 即时写入,色块显示有效色而非输入值。5e8bbd035
  • objectRef 候选残留收口 —— 手动徽章影响面中性化。d4f952d24
  • 资料字段长度统一为码点 —— 身份行不再重复 @handle。b3d2defa4
  • 通知收件箱 UI/UX 与 SEO 一次收口 —— 含 ?tab= 深链与目标卡可用性。53928c4a8
  • 规则编辑器按宿主注入标签族 —— 信任侧不再跨族读徽章文案;参数标签先探 .label,对象参数不再走命名空间取词。276e2a7a1、91a2e18df
  • 目录按候选过滤(F1) —— 停用档 round-trip、跳过校验告警、500 断言补全。9d3734f96
  • identity.profile 的 SQL CASE 由枚举表派生 —— 测试从目录推导取值,枚举表漂移不再静默。b7acf2268
  • Manifest V3 plugin-only 约束补齐 —— seo / aiTools / notificationTypes 三处约束、permissionDefinitions schema 约束;plugin-only 家族清单成为首个 kind 判据(主题闸之前),7 个家族全部由清单先拒且报错带家族名。b23b19bf0、6af500b1c、bcbe314ff
  • 升级探针静默重试 —— 备用槽冷启动的探针失败不再上屏,改为重试后一行回执、每 15 秒心跳、超时 dump 最后一次探针输出与该槽容器状态和 60 行日志。275cc66d2
  • 披露段 label 回落断言改为节点级 —— 断言口径更正。428e23c41
  • 核心 schedule 断言改为逐项比对 —— 修 HEAD 红。54b339701

安全

  • GO-2026-6888 github.com/andybalholm/brotli 已修复 —— 可达路径 Pages.FileDigestSHA256 → io.Copy → brotli.Reader.Read;v1.2.2 → v1.2.7。5c2935890
  • GO-2026-6865 github.com/klauspost/compress 已修复 —— 可达路径 fiberCoreRouteInvoker.InvokeCore → fasthttp.Response.Body → fse/huff0;v1.19.0 → v1.20.3(该漏洞修于 v1.20.2)。5c2935890
  • 两条均为间接依赖,只抬版本、不动任何直接依赖。但 8 个内置插件后端模块与 compat farm 都用 replace 复用主模块依赖图,主模块版本抬高后它们原有的 go.sum 会缺哈希并导致构建失败,因此同批同步 13 个文件:apps/api 的 go.mod / go.sum、sforum-content-policy 的 go.mod / go.sum、其余 7 个内置插件后端模块的 go.sum、以及 tests/compat 的 go.mod / go.sum。5c2935890
  • CVE-2026-118257 @intlify/* / vue-i18n 已修复 —— vue-i18n 的 iframe srcdoc 净化缺陷导致跨站脚本;11.4.6 → 11.4.20(修复版 11.4.14,registry 上 11.4.x 线最新为 11.4.20)。全部为 @nuxtjs/i18n 的传递依赖,未新增 overrides 条目,@nuxtjs/i18n 本身未动。这条是发版门禁自己拦下来的:第一次 v3.1.0 Release 在 Publish candidate / sforum-web 被 Trivy 判 Total: 3 (HIGH: 3) 失败,修复后重跑。808dec267
  • CodeQL 48 条告警全部闭环,open 归零 —— 仓库 code-scanning 现为 0 open(43 fixed + 5 dismissed,dismiss 的 5 条是 2026-07/10 的历史判定,非本版新增)。本版收口最后 4 条:
    • go/allocation-size-overflow #45 / #47 / #48 —— 改代码,不 dismiss:TrustLevels 预分配容量改用 max(len(a), len(b)),DefaultSink → OverflowProneOperand → AllocationSize 链条断裂;业务语义、判空顺序、去重与返回顺序零改动。af18ef94e
    • js/clear-text-logging #46 —— 删除一次性 QA 脚本 setup-account.mjs(其文件头自述「跑完必须删干净」),不做脱敏改造。52fb2b50a
  • Dependabot #612(otel CVE-2026-128085 / GHSA-q7gw-24fr-5p69)已修复 —— tools/proto 的 go.opentelemetry.io/otel/trace 1.44.0 → 1.47.0(otel / otel-log / otel-metric 同步),go mod verify 通过。3563b2055

扫描覆盖边界(自查项,非本版变更)

.github/workflows/security.yml 的 CodeQL 作业是 build-mode: manual + working-directory: apps/api,仓库无 go.work、apps/api/go.mod 无 replace,因此 8 个 extensions/builtin/plugins/*/backend 独立 Go module 与 tools/proto 不在 CodeQL 的 Go 数据库里;govulncheck 同理只覆盖 core。workflow 里「内建插件与 apps/api 共享同一依赖树,core 绿即代表可达漏洞面已覆盖」那句只对依赖可达性成立,对插件自身源码不成立。

本版用 Go AST 对这两个范围补扫命中 0 处(结论是「实测无此类漏洞」,不是「扫不到所以认为没有」)。消除盲区需扩 workflow 构建范围,属后续项。详见 knowledge/modules/backend.md §Security And Dependency Governance 与 knowledge/reports/security-2026-11-14/overflow-pattern-audit.md(473399720)。

仓库既有安全姿态(非本版变更,仅供对账) —— secret_scanning 与 secret_scanning_push_protection 当前均为 enabled,Dependabot open 安全告警为 0。这些是既有状态,本版没有改任何 GitHub 仓库设置。


依赖与工程

  • 14 个新迁移,全部标注 +sforum OnlineSafe —— 覆盖点赞、收藏、徽章与用户活动、徽章权限键、trust.manage 权限键、badge_tiers、badge_rules、badge_backfill_runs、设置面治理、庆祝展示、自由佩戴与 hidden 态、徽章授予通知去重键、信任等级变更账本。见 apps/api/database/migrations/。
  • 测试库隔离收口 —— 修复共享测试库 users_id_seq 落后导致的 users_pkey 偶发冲突;新增 FK 清理顺序地雷测试与序列断言。03c9a794b
  • 测试与门禁 —— jobs 服务目录改成逐项点名清单、双向报差异(含第 10 条 trustlevels.sweep)2bf893170;HostAPI incomplete/disabled 读面契约补真实现与真库守门人 32265e251;跨文件模块 mock 泄漏修复(trustLevels whitelist 用例全量跑红)830dd2c5b;装载路径 SQL 条数常开断言 + 10k 延迟 A/B ece2d1ee4;棘轮放行改成「声明式例外 + 责任人」db65871fc;运行次数口径收紧 9913a3eb5、5cac2038e;QA H10 迁移可逆性断言按目标迁移分流 eb4d0c6c1;M5 门禁脚本与基线报告 6359b98e4。
  • 夹具(fixtures) —— 正样本可重放的幂等安装路径 + README 新增节 34f22eaaf;loader 夹具只认自己 seed 的 id,克隆模板库的外来行不再污染探针 81b7ba3d4;插件夹具补 trustLevelEarnable 正样本(两种 label 形态)4927bcde7。
  • 契约与目录生成物 —— 重新生成 v3 路由行号 + manifest-v3 补 userFactConditions 1ac0c0a9b;登记共享规则编辑器的 7 条 ui source 0983233d2;徽章路由 422 与生成物同步 4e1876331;trust_level.changed 与 trustlevels.sweep 进 docs/extensions/v3/catalogs/*;node scripts/v3-catalog/generate.mjs --check 18 文件 current。
  • 架构基线 —— isThemeManifestSupported 拆出 manifest.go,文件行数基线下调 720 → 703 8d7d71298;共享插件运行时变更后同步内置插件版本与发布基线 df35a75d2;依赖抬版后再同步 8 个内置插件 patch 版本与发布基线 7b83b161e。
  • 文档 —— 新增中英双语 docs/{zh-CN,en-US}/usage/trust-levels.md、docs/extensions/trust-levels.md、docs/extensions/badge-plugin-facts.md,docs/extensions/authoring-guide.md 补 settingsSection 与徽章事实层;运维手册同步「TL0 被门控两个键」。
  • 仓库卫生 —— .gitignore 忽略本机 DSH 会话状态与团队编排产物(.dsh/、work-team/)daacece1c。

依赖批量(PR #212)

一次性合并 17 个 Dependabot PR(合成一条 deps 分支,只烧一轮 CI)。merge commit:efc317cfb。

合入部分

  • bun 1.4.4,三处对齐 —— apps/web/Dockerfile(deps / prod 两个阶段)、.github/workflows/ci.yml(两处 bun-version)、.github/workflows/release-tooling.yml(一处)。此前 CI 钉 1.3.14 而镜像已抬版会让门禁与镜像跑在不同 bun 上,这次一并拉到 1.4.4。67afc9eb7、51d7eccfb
  • api 镜像运行阶段 alpine:3.22 → 3.24 —— 只动 api / worker / migrate 三个运行阶段;golang 基础镜像保持 1.26.10-alpine(golang:1.27.0 要求连 go 指令一起迁,见「排除部分」)。c3359a7de
  • Compose 镜像四条 —— mailpit v1.30.7 → v1.33.1、redis 7.4.10-alpine → 8.10.2-alpine、meilisearch v1.53.1 → v1.56.1、caddy 2.10.2-alpine → 2.11-alpine;postgres 保持 17.11,与上面那条 PG 修复的版本前提一致。557c9fceb
  • web 依赖组(9 个 PR) —— Tiptap 全家 15 个包统一到 3.32.0(顺带把原来 ^3.31.x 的浮动范围钉成精确版本)、altcha 3.1.0 → 3.5.0、highlight.js 11.11.1 → 11.12.0、@vitejs/plugin-vue 6.0.7 → 6.0.10、esbuild 0.28.1 → 0.28.2。5ee7f975c
  • 内置插件 Go 依赖(3 个 PR) —— sforum-auth-github、sforum-content-policy、sforum-storage-s3 三个后端模块的 go.mod / go.sum。57b958ec1
  • github-actions 组 —— release.yml 与 security.yml 的 action 版本。d1fadfd18
  • ImgBot 图片优化 —— 39 个文件(12 个扩展品牌 icon.svg / social-preview.png + 27 张 knowledge 截图),净 -244 行,图片体积普遍降 15–20%。8f4509cae

排除部分(每条一句原因)

  • #194 typescript 6.0.3 → 7.0.2 —— TS 7 不再发布 lib/typescript.js,vue-tsc@3.3.x 的 require('typescript/lib/tsc') 直接 ERR_PACKAGE_PATH_NOT_EXPORTED;vue-tsc 目前无 TS7 兼容线。
  • #195 @nuxtjs/i18n 10.4.0 → 10.6.0 —— 同时引入 unhead v3 + v2、vue-router 5.5.1 + 5.1.0 两套运行时;且本次 CVE-2026-118257 的修复已在不升 @nuxtjs/i18n 的前提下完成(只抬 @intlify/* 传递依赖,见「安全」),所以该 PR 继续留在待处理。
  • #208 core-go 组 18 项 —— 其中 gofiber/fiber/v3 3.4.0 → 3.6.1 让新版 session store 自存 time.Time 绝对过期键,被 storedSessionAbsoluteExpiration 以「非字符串键 + time.Time」认出后,生产代码转而信任 fiber 墙钟值、绕过注入时钟,TestPluginSessionScopeAnchorsAbsoluteBoundaryAtCreation 变红。生产行为本身没错,但那条是带注释保护的安全不变量,留待单独一轮处理。
  • #186 的工具链部分 —— golang:1.27.0 要求连 go 1.26.10 一起迁(apps/api + 全部 extensions + tools/proto),属独立工程;本次只取了运行阶段 alpine。

两条工程性变更

  1. .github/workflows/release-tooling.yml 的 paths 过滤器补上了插件 digest 的输入面 —— extensions/builtin/plugins/*/backend/**、*/sforum.extension.json、*/manifest/**、*/schemas/**、apps/api/go.mod、apps/api/sdk/plugin/**、apps/api/app/Support/PluginBootstrap/contract.go、contracts/proto/**、tests/builtin-plugin-release-baseline.json,pull_request 与 push(main) 两个触发块各一份。此前这些路径变更根本不会触发该工作流,插件 source digest 漂移时门禁只在本地 test.sh 里红——本次发版前就踩到了(8 个内置插件 digest 变了但版本没 bump)。51d7eccfb
  2. 8 个内置插件 patch 版本 —— 本版最终为 auth-github 1.0.13、content-policy 1.1.12、search-site 1.0.11、shortcodes 1.3.9、smtp 1.1.11、storage-fs 1.1.12、storage-s3 1.0.15、web-push 1.0.11;tests/builtin-plugin-release-baseline.json 用 node tests/validate-builtin-plugin-versions.mjs --write 重算。相对 v3.0.23 每个插件都抬了 patch;其中本 PR 只再抬后端 go.sum 确有变化的 3 个(auth-github / content-policy / storage-s3),另 5 个已在 7b83b161e 抬过。695cac047

升级注意

以下按「必须动作 / 行为变更 / 回滚风险」三类列出。回滚风险三条(第 4–6 项)换二进制前必读。

  1. 必须执行迁移(14 个) —— 全部标注 +sforum OnlineSafe,可在线应用,不需要停机窗口。upgrade.sh / sforum-bootstrap.sh upgrade 与 sforum-migrate 镜像会正常带出;手工部署请先跑迁移再切 API 镜像。
  2. 确认 PostgreSQL 版本与数据库账号(不需要升级 PostgreSQL) —— 本版不要求你动 PostgreSQL:17.11 及更早照旧工作(旧代码只在 17.12+ 上才会炸),而修复对两个版本都成立。但两种情况请务必用上本版:① 部署跑 17.12+ 且用非超级用户数据库账号——旧版本的扩展租约回收 / 迁移角色退役 / 卸载会直接报 must be able to SET ROLE ... (SQLSTATE 42501);② 用非超级用户账号做扩展 provisioning——建 schema 那条缺口在 PG 16 起就存在,与 17.12 无关,旧版本同样会失败。超级用户账号不受影响。f1567e244、3d5dda827、193712498
  3. 行为变更:TL0 默认被扣下两个基线键(D34) —— 默认安装下 TL0 不能发新主题、不能上传附件,TL1 起自动恢复;能回帖、能改删自己的内容。features.trust_levels 推荐默认 enabled,所以升级即生效。机制走「减法门」(零迁移、不动权限白名单与关闭语义)。若要保留旧行为,关闭 features.trust_levels——注意那会同时关掉整个信任等级能力,不只是这一条减法;关闭状态下 TL0 仍能开主题。185be5701、knowledge/decisions/2026-11-11-trust-level-baseline-narrowing.md
  4. 回滚风险(高):信任等级档位外观 —— 旧 API 二进制只认 9 个 token 推荐色与 16 个短名图标,读到 #rrggbb 或 i-<collection>-<name> 全名图标会 422(trust.levels 保存被拒;库内已有配置不会自动损坏,但再保存就失败)。回滚必须同时回退该配置值,不能只回退二进制。 f7c425c43、knowledge/decisions/2026-11-12-trust-level-appearance-modal-and-custom-color.md
  5. 回滚风险:信任等级条件(rule) —— trust.levels 是单键 JSON,解码走 DisallowUnknownFields:配置里出现旧二进制不认识的字段,整份配置被拒绝(不是跳过那一档)。解码失败的后果是整站按未解析处理(没有任何已挣得权限、权限面等同 TL0、资料页不渲染等级卡、identity 侧每次求值一条 warn)。因此从带条件的新版本回滚到不认识 rule 的旧版本,顺序是:① 用新版本把所有档位的 rule 清空并保存(PUT /admin/trust-levels);② 确认读回配置里 rule 全部消失;③ 再换回旧二进制。e11cadca6、knowledge/modules/trust-levels.md §回滚口径
  6. 回滚风险:trust.levels 的 v1 → v2 配置形状 —— DecodeConfig 同时接受 schemaVersion 1 与 2(v1 在内存里升级),但 EncodeConfig 只写 v2,旧二进制解不了 v2。回滚是两步:先回退镜像,再把 trust.levels 的值回退到 v1 形状;只换镜像会让站点开机读不到配置并回落到推荐默认。color 与 deletedTierIds 对更早版本同理——只有运营真正用过这些字段时旧二进制才整份拒绝。
  7. 徽章授予通知:历史行只改键、不补发 —— 202611140001 把历史 badge_granted 行改写为新键格式(等值判据,不用 LIKE 'badge:%'),不补发此前被吞掉的通知;Down 故意为空(反向退键会撞唯一约束)。升级后若有人在等旧通知,需要手工重跑一次规则回扫。e8d6e63df
  8. users.top_badge_id 语义变更 —— 从「自动推导的最高级徽章」改为「用户自由佩戴」。202611130003 / 202611130004 之后存量值保持原样,但用户可自行改选或选「不佩戴」(top_badge_hidden = TRUE);依赖该列做「最高徽章」推导的第三方查询需要改口径。
  9. 新增权限键需复核角色 —— badge.view / badge.manage(202611100003)与 trust.manage(202611100004)由迁移落库并映射到岗位。升级后请复核自定义角色是否具备这些键;badge.view 单独存在是死权限,可达性前提是 admin.access。
  10. upgrade.sh 是发布资产 —— 升级探针的静默重试改动随本 Release 的 upgrade.sh 生效。用旧 upgrade.sh 升级仍能工作,但看不到新的超时现场 dump 与该槽容器状态;要拿到新行为请用 v3.1.0 的发布资产(sforum-bootstrap.sh upgrade --version v3.1.0 会自动取对应版本)。275cc66d2
  11. 产品口径说明(不是回滚) —— 论坛读面(列表 / 详情 / 回复)的信任等级徽章与 authorTrustLevel 载荷已撤回(46c2f52cb);等级标识只在个人中心呈现:资料页头部 TL{n} 小牌、右栏等级卡、以及两者共用的等级详情弹窗。此功能未在任何已发布版本中出现过,升级不会造成可见回退。

Installation

Docker images:

docker pull ghcr.io/keeptrue/sforum-api:v3.1.0
docker pull ghcr.io/keeptrue/sforum-migrate:v3.1.0
docker pull ghcr.io/keeptrue/sforum-web:v3.1.0

One-line install (latest stable, same one-liner as the README):

curl -fsSL https://github.com/keeptrue/SForum/releases/latest/download/sforum-install.sh | bash

One-line update (does not trust the local bootstrap):

curl -fsSL https://github.com/keeptrue/SForum/releases/latest/download/sforum-install.sh | bash -s -- upgrade

Update an existing installation with a verified bootstrap:

(
  set -eu
  cd /path/to/sforum
  bootstrap_dir="$(mktemp -d .sforum-bootstrap.XXXXXX)"
  trap 'rm -rf "$bootstrap_dir"' EXIT HUP INT TERM
  curl -fsSLo "$bootstrap_dir/sforum-bootstrap.sh" https://github.com/keeptrue/SForum/releases/download/v3.1.0/sforum-bootstrap.sh
  curl -fsSLo "$bootstrap_dir/SHA256SUMS" https://github.com/keeptrue/SForum/releases/download/v3.1.0/SHA256SUMS
  (
    cd "$bootstrap_dir"
    awk '$2 == "sforum-bootstrap.sh" { print }' SHA256SUMS > sforum-bootstrap.sha256
    test "$(wc -l < sforum-bootstrap.sha256 | tr -d '[:space:]')" = 1
    if command -v sha256sum >/dev/null 2>&1; then
      sha256sum -c sforum-bootstrap.sha256
    else
      shasum -a 256 -c sforum-bootstrap.sha256
    fi
    if command -v gh >/dev/null 2>&1; then
      gh attestation verify sforum-bootstrap.sh --repo keeptrue/SForum
    fi
  )
  install -m 0755 "$bootstrap_dir/sforum-bootstrap.sh" ./sforum-bootstrap.sh
  rm -rf "$bootstrap_dir"
  trap - EXIT HUP INT TERM
  ./sforum-bootstrap.sh upgrade --version v3.1.0
)

Fresh install with the verified deploy bundle:

(
  set -eu
  mkdir -p sforum
  cd sforum
  curl -fsSLo sforum-deploy.tar.gz https://github.com/keeptrue/SForum/releases/download/v3.1.0/sforum-deploy.tar.gz
  curl -fsSLo SHA256SUMS https://github.com/keeptrue/SForum/releases/download/v3.1.0/SHA256SUMS
  awk '$2 == "sforum-deploy.tar.gz" { print }' SHA256SUMS > sforum-deploy.sha256
  test "$(wc -l < sforum-deploy.sha256 | tr -d '[:space:]')" = 1
  if command -v sha256sum >/dev/null 2>&1; then
    sha256sum -c sforum-deploy.sha256
  else
    shasum -a 256 -c sforum-deploy.sha256
  fi
  if command -v gh >/dev/null 2>&1; then
    gh attestation verify sforum-deploy.tar.gz --repo keeptrue/SForum
  fi
  tar -xzf sforum-deploy.tar.gz --strip-components=1
  ./sforum-bootstrap.sh install --yes --version v3.1.0
)

Manual download: Download the matching Linux or macOS archive from the assets below.

Documentation