核心集成架构

架构解析

StudioCMS 是专为 Astro 构建的强大 CMS 系统，基于 Astro DB^ 实现内容管理与服务。其设计兼具易用性与灵活性，能处理各种类型的内容需求。

扩展 StudioCMS 非常简单！您可以创建自定义插件来增强系统功能。StudioCMS 集成是整个生态系统的基石，为 Astro 项目提供无头 CMS 解决方案。以下是其核心组件的详细解析。

虚拟模块系统

StudioCMS 集成提供多个虚拟模块^，使您能完全控制动态内容。这些模块主要供内部使用，但开发者也可访问 StudioCMS 数据：

认证虚拟模块

模块路径	功能描述
studiocms:auth/lib/encryption	加密工具
studiocms:auth/lib/password	密码管理工具
studiocms:auth/lib/rate-limit	请求限流工具
studiocms:auth/lib/session	会话管理工具
studiocms:auth/lib/types	类型定义
studiocms:auth/lib/user	用户管理工具
studiocms:auth/utils/authEnvCheck	认证环境检查工具
studiocms:auth/utils/getLabelForPermissionLevel	权限标签工具

核心虚拟模块

模块路径	功能描述
studiocms:config	集成配置解析
studiocms:version	当前版本信息
studiocms:plugins	运行时插件接口
studiocms:plugin-helpers	插件辅助函数
studiocms:components	导出组件库
studiocms:components/Editors	页面编辑器组件
studiocms:components/dashboard-grid-components	仪表板内部组件
studiocms:components/dashboard-grid-items	仪表板网格项组件
studiocms:component-proxy	用户自定义组件代理
studiocms:lib	核心库辅助工具

SDK 虚拟模块

模块路径	功能描述
studiocms:sdk	主 SDK 接口
studiocms:sdk/cache	带缓存的 SDK
studiocms:sdk/types	SDK 类型定义

国际化与渲染

模块路径	功能描述
studiocms:i18n	国际化支持
studiocms:renderer	内容渲染器
studiocms:renderer/config	渲染器配置
studiocms:renderer/current	当前渲染上下文
studiocms:renderer/markdown-remark/css	Markdown 样式支持

图像处理

模块路径	功能描述
studiocms:imageHandler/components	图像处理组件

路由系统

仪表板路由（用户界面）

主路由

路径	功能
/dashboard/	主控制面板
/dashboard/profile/	用户配置管理
/dashboard/content-management/	内容管理界面
/dashboard/configuration/	系统配置中心
/dashboard/user-management/	用户管理系统
/dashboard/plugins/	插件管理中心

认证路由

路径	功能
/dashboard/login/	登录界面
/dashboard/signup/	注册界面
/dashboard/logout/	退出登录

API 路由（后端接口）

主接口

端点路径	功能
/studiocms_api/dashboard/api-tokens	API 令牌管理
/studiocms_api/dashboard/search-list	全局搜索接口
/studiocms_api/dashboard/live-render	实时内容预览
/studiocms_api/dashboard/user-list-items	用户列表项
/studiocms_api/dashboard/editor	编辑器数据接口
/studiocms_api/dashboard/config	配置管理接口
/studiocms_api/dashboard/users	用户数据接口
/studiocms_api/dashboard/profile	用户资料接口
/studiocms_api/dashboard/create-reset-link	密码重置链接生成
/studiocms_api/dashboard/reset-password	密码重置处理
/studiocms_api/dashboard/content/page	页面内容操作
/studiocms_api/dashboard/content/folder	文件夹管理
/studiocms_api/dashboard/plugins	插件管理接口
/studiocms_api/dashboard/create-user	用户创建接口
/studiocms_api/dashboard/update-user-invite	用户邀请更新

认证接口

端点路径	功能
/studiocms_api/auth/login	登录认证
/studiocms_api/auth/logout	退出处理
/studiocms_api/auth/register	注册处理
/studiocms_api/auth/github	GitHub 认证
/studiocms_api/auth/github/callback	GitHub 回调
/studiocms_api/auth/discord	Discord 认证
/studiocms_api/auth/discord/callback	Discord 回调
/studiocms_api/auth/google	Google 认证
/studiocms_api/auth/google/callback	Google 回调
/studiocms_api/auth/auth0	Auth0 认证
/studiocms_api/auth/auth0/callback	Auth0 回调

SDK 接口

端点路径	功能
/studiocms_api/sdk/list-pages	页面列表获取
/studiocms_api/sdk/fallback-list-pages.json	页面列表回退机制
/studiocms_api/sdk/update-latest-version-cache	版本缓存更新

渲染接口

端点路径	功能
/studiocms_api/renderer/render	动态内容渲染