Kuaiz CMS documentation

先看清边界,
再开始开发

快智 CMS Community 是独立 PHP CMS。这里公开内核的运行要求、机器可读协议与安全原则;正式下载仍以生产发行公钥和签名记录为准。

开发预览协议可以阅读和集成;生产公钥指纹与正式下载尚未开放。
01 · Product boundary

免费 CMS 内核与商业运营服务分开

Community CMS 负责本地账号、内容、媒体、发布、历史和备份。快智中央 AI 自动运营是客户主动开通的外部服务,不是公开网站或人工编辑的前置条件。

  • 公开网站、人工编辑和备份不依赖快智总台在线
  • 每个网站只选择一种内容语言,另一个市场建立另一个网站
  • 普通 Theme 不运行 PHP、不查询数据库、不发起网络请求
  • 社区版源码使用 Apache License 2.0,快智品牌与商业服务另行保留
首发从全新安装开始旧轻量 Runtime 只用于内部测试,不纳入兼容范围。正式发行只维护 Community CMS 自身的升级、备份与恢复,避免让历史试验拖累产品。
02 · Runtime

开发环境与运行要求

当前开发路径需要 PHP 8.1 或更高版本,并启用 PDO SQLite、Fileinfo、GD WebP 和 Sodium;EXIF 为可选扩展。数据库和媒体目录必须位于 Web 根目录之外。

php bin/cms-init.php php -S 127.0.0.1:8080 -t public public/index.php
不要直接运行 installer-template.php它只是带防篡改占位符的发行模板。正式单文件安装器必须经过离线发行签名,并由下载服务生成专属安装码。
03 · Theme SDK v2

给 AI 一份确定的主题协议

Theme v2 是声明式页面组件树,不是 PHP 模板。AI 工具可以安排首页、列表、详情和 404 的组件与视觉参数;Core 统一负责字段绑定、安全转义、Canonical、结构化数据和站点地图。

SCHEMA

Theme Manifest v2

组件、布局、配色、内容绑定、LTR/RTL 与验收种子的完整 JSON Schema。

打开机器可读协议 →
04 · Extension SDK v1

业务能力通过受控扩展接入

第一阶段只自动安装不执行 PHP 的声明式内容扩展。预约、会员和外部连接器需要官方签名、最小权限、独立迁移与隐私声明;第三方 PHP 暂不允许普通管理员上传执行。

SCHEMA

Extension Manifest v1

权限、路由、事件、Theme 插槽、内容类型、数据策略和网络目标。

打开机器可读协议 →
05 · Hosting

首版主机兼容范围

环境当前状态安装说明
Apache + PHP 8.1+真实验收通过首版单文件零配置路径,主机仍需满足扩展与目录权限。
OpenLiteSpeed / LiteSpeed真实验收通过新建 .htaccess 后需要在面板刷新 URL 重写或 graceful restart。
Nginx专用档案待完成不能使用 .htaccess;不把数据库退回 Web 根目录作为兼容办法。
IIS尚未支持需要独立重写和私有目录部署方案。
06 · Release trust

正式文件必须能独立验真

生产私钥只在离线签名环境使用。官网和下载服务器只接收公钥、固定指纹、签名令牌和已经签名的发行摘要。源码 ZIP 与个性化安装器分别签名,不能互相冒充。

  • 先从官网读取 SHA-256 SPKI DER 公钥指纹
  • 再核对下载文件、发行摘要与签名令牌
  • 安装器在显示管理员表单前重验模板和全部载荷
  • 官网未公布生产指纹时,不存在正式发行版