Repository navigation
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(深色变体由 CSScolor-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 IDforum.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 上是好的;这也是 CIGo 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三处约束、permissionDefinitionsschema 约束;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 的 iframesrcdoc净化缺陷导致跨站脚本;11.4.6 → 11.4.20(修复版 11.4.14,registry 上 11.4.x 线最新为 11.4.20)。全部为@nuxtjs/i18n的传递依赖,未新增overrides条目,@nuxtjs/i18n本身未动。这条是发版门禁自己拦下来的:第一次v3.1.0Release 在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 条:
- Dependabot #612(otel CVE-2026-128085 / GHSA-q7gw-24fr-5p69)已修复 ——
tools/proto的go.opentelemetry.io/otel/trace1.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;HostAPIincomplete/disabled读面契约补真实现与真库守门人32265e251;跨文件模块 mock 泄漏修复(trustLevels whitelist 用例全量跑红)830dd2c5b;装载路径 SQL 条数常开断言 + 10k 延迟 A/Bece2d1ee4;棘轮放行改成「声明式例外 + 责任人」db65871fc;运行次数口径收紧9913a3eb5、5cac2038e;QA H10 迁移可逆性断言按目标迁移分流eb4d0c6c1;M5 门禁脚本与基线报告6359b98e4。 - 夹具(fixtures) —— 正样本可重放的幂等安装路径 + README 新增节
34f22eaaf;loader 夹具只认自己 seed 的 id,克隆模板库的外来行不再污染探针81b7ba3d4;插件夹具补trustLevelEarnable正样本(两种 label 形态)4927bcde7。 - 契约与目录生成物 —— 重新生成 v3 路由行号 + manifest-v3 补
userFactConditions1ac0c0a9b;登记共享规则编辑器的 7 条 ui source0983233d2;徽章路由 422 与生成物同步4e1876331;trust_level.changed与trustlevels.sweep进docs/extensions/v3/catalogs/*;node scripts/v3-catalog/generate.mjs --check18 文件 current。 - 架构基线 ——
isThemeManifestSupported拆出manifest.go,文件行数基线下调 720 → 7038d7d71298;共享插件运行时变更后同步内置插件版本与发布基线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-router5.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。
两条工程性变更
.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- 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 项)换二进制前必读。
- 必须执行迁移(14 个) —— 全部标注
+sforum OnlineSafe,可在线应用,不需要停机窗口。upgrade.sh/sforum-bootstrap.sh upgrade与sforum-migrate镜像会正常带出;手工部署请先跑迁移再切 API 镜像。 - 确认 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 - 行为变更:TL0 默认被扣下两个基线键(D34) —— 默认安装下 TL0 不能发新主题、不能上传附件,TL1 起自动恢复;能回帖、能改删自己的内容。
features.trust_levels推荐默认 enabled,所以升级即生效。机制走「减法门」(零迁移、不动权限白名单与关闭语义)。若要保留旧行为,关闭features.trust_levels——注意那会同时关掉整个信任等级能力,不只是这一条减法;关闭状态下 TL0 仍能开主题。185be5701、knowledge/decisions/2026-11-11-trust-level-baseline-narrowing.md - 回滚风险(高):信任等级档位外观 —— 旧 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 - 回滚风险:信任等级条件(
rule) ——trust.levels是单键 JSON,解码走DisallowUnknownFields:配置里出现旧二进制不认识的字段,整份配置被拒绝(不是跳过那一档)。解码失败的后果是整站按未解析处理(没有任何已挣得权限、权限面等同 TL0、资料页不渲染等级卡、identity侧每次求值一条 warn)。因此从带条件的新版本回滚到不认识rule的旧版本,顺序是:① 用新版本把所有档位的rule清空并保存(PUT /admin/trust-levels);② 确认读回配置里rule全部消失;③ 再换回旧二进制。e11cadca6、knowledge/modules/trust-levels.md§回滚口径 - 回滚风险:
trust.levels的 v1 → v2 配置形状 ——DecodeConfig同时接受schemaVersion1 与 2(v1 在内存里升级),但EncodeConfig只写 v2,旧二进制解不了 v2。回滚是两步:先回退镜像,再把trust.levels的值回退到 v1 形状;只换镜像会让站点开机读不到配置并回落到推荐默认。color与deletedTierIds对更早版本同理——只有运营真正用过这些字段时旧二进制才整份拒绝。 - 徽章授予通知:历史行只改键、不补发 ——
202611140001把历史badge_granted行改写为新键格式(等值判据,不用LIKE 'badge:%'),不补发此前被吞掉的通知;Down 故意为空(反向退键会撞唯一约束)。升级后若有人在等旧通知,需要手工重跑一次规则回扫。e8d6e63df users.top_badge_id语义变更 —— 从「自动推导的最高级徽章」改为「用户自由佩戴」。202611130003/202611130004之后存量值保持原样,但用户可自行改选或选「不佩戴」(top_badge_hidden = TRUE);依赖该列做「最高徽章」推导的第三方查询需要改口径。- 新增权限键需复核角色 ——
badge.view/badge.manage(202611100003)与trust.manage(202611100004)由迁移落库并映射到岗位。升级后请复核自定义角色是否具备这些键;badge.view单独存在是死权限,可达性前提是admin.access。 upgrade.sh是发布资产 —— 升级探针的静默重试改动随本 Release 的upgrade.sh生效。用旧upgrade.sh升级仍能工作,但看不到新的超时现场 dump 与该槽容器状态;要拿到新行为请用v3.1.0的发布资产(sforum-bootstrap.sh upgrade --version v3.1.0会自动取对应版本)。275cc66d2- 产品口径说明(不是回滚) —— 论坛读面(列表 / 详情 / 回复)的信任等级徽章与
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.0One-line install (latest stable, same one-liner as the README):
curl -fsSL https://github.com/keeptrue/SForum/releases/latest/download/sforum-install.sh | bashOne-line update (does not trust the local bootstrap):
curl -fsSL https://github.com/keeptrue/SForum/releases/latest/download/sforum-install.sh | bash -s -- upgradeUpdate 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
- GitHub Repository
- 中文部署文档
- English Deployment Guide
- 完整变更记录 / Full Changelog:
v3.0.23...v3.1.0