设计依据:docs/SITE_GROUP.md。依赖 M1–M3(核心已站点化)。 目标:把站群能力收敛到插件层——提供统一 SDK,内置插件(form/friend_link/product/job/analytics 等)接入站点维度,第三方插件按文档低成本接入;补齐开发者文档。
docs/SITE_GROUP.md
site_id
SiteScopedMixin
app/models/site.py
class Form(SiteScopedMixin, db.Model): __tablename__ = 'forms' ...
plugin_api
app/plugin_api.py
current_site_id()
site_filter(query)
site_id=current_site_id()
site_url(site_id, ...)
docs/PLUGIN_DEV.md
(site_id, slug)
_table_exists
0010
forms
friend_links
product
job
analytics
db.create_all()
form
Form
friend_link
FriendLink
banner
member
member_scope
auto_translate
具体插件清单以 plugins/ 目录实际内容为准;含内容表/前台路由/后台管理的插件均需过一遍「站点过滤 + slug 唯一」检查。
plugins/
site_filter
README.md
UPGRADE.md
plugin_api.current_site_id()
README
UPGRADE
站群模式 M4:插件 SDK + 内置插件改造 + 文档
前置条件
site_id列 + 解析器 +SiteScopedMixin。范围
A. 插件 SDK
SiteScopedMixin(M1 已建于app/models/site.py):插件内容模型继承即获得site_id列:class Form(SiteScopedMixin, db.Model): __tablename__ = 'forms' ...plugin_api扩展(app/plugin_api.py):current_site_id()(供插件查询过滤);SiteScopedMixin(供插件模型继承);site_filter(query)辅助:自动给模型查询追加site_id=current_site_id()(仅对含site_id的模型生效)。site_url(site_id, ...)生成跨站点绝对 URL。docs/PLUGIN_DEV.md站群章节):(site_id, slug)复合唯一;B. 插件迁移(各自加 site_id,幂等守卫)
site_id(沿用核心_table_exists幂等守卫范式),或随核心0010一并处理(推荐内置随核心,第三方各插件自管):forms(slug →(site_id, slug))friend_links(无 slug 全局唯一,加site_id列即可)product/job等含内容模型与 slug 的插件analytics(无自有内容表,仅按站点键读 Setting,无需加列)db.create_all()兜底建表自动带site_id(模型已继承 mixin)。C. 内置插件改造(逐插件)
formForm继承 mixin;表单 slug 站点内唯一;前台表单按当前站点过滤;后台表单/提交列表按站点过滤friend_linkFriendLink继承 mixin;前台友链全局函数按站点过滤productjobbannermembermember_scope处理(共享/独立),登录/短信按站过滤auto_translateanalyticsD. 文档
docs/PLUGIN_DEV.md新增「站群接入」章节:mixin 继承、current_site_id()/site_filter用法、slug 唯一约束约定、后台列表过滤。docs/SITE_GROUP.md:把 M4 落地后的实际 API(plugin_api暴露的函数签名)回填,保持设计与实现一致。README.md特性表新增「站群模式(多站点)」行;UPGRADE.md增加 v3.2.0 站群升级说明(默认站点零感知、新站点创建流程)。验收标准
不做
关联
docs/SITE_GROUP.md§10