先启动
用一条命令拿到框架、运行时、本地域名和安装入口，先让项目真实跑起来。
落地路径
从下载安装到长期运营，官网应该让路径一眼可见
优秀开源官网不只展示能力，还要让开发者知道下一步该怎么开始。Weline 的主路径是启动工程、组装模块、持续运营。
再组装
按业务选择模块、主题、Hook、事件和应用生态，把能力装进同一个工程。
可长期运营
用缓存、迁移、多语言 URL、文档和商业支持边界支撑真实站点持续演进。
安装方式
一键安装或三步纯净安装
快速获得可运行环境时使用一键安装；需要自行控制 PHP、数据库和依赖时，按纯净安装三步完成源码依赖、数据库初始化与 WLS 启动。
Linux / macOS / Git Bash
适合 Linux、macOS 和 Windows Git Bash，一条命令克隆仓库、准备运行时、安装依赖并进入初始化流程。
curl -fsSL https://gitee.com/aiweline/WelineFramework/raw/master/bin/bootstrap.sh | bash -s --Windows PowerShell
适合 Windows 本地开发环境，脚本会下载到临时目录后执行，避免复制大段脚本内容。
$f="$env:TEMP\weline-bootstrap.ps1"; irm 'https://gitee.com/aiweline/WelineFramework/raw/master/bin/bootstrap.ps1' -OutFile $f; & $f一键安装参数
脚本支持分支选择、自动确认、强制重装、PATH 修复和组件选择，适合快速准备本地运行环境。
-b <分支>
指定分支，例如 -b dev
-y
自动确认安装过程中的提示
-f
强制重新安装，会清空已有数据
--path-only
只写入 PATH，不重新安装组件
php / pgsql / mysql
指定安装组件
安装 dev 分支并自动确认
示例命令用于快速切到 dev 分支并跳过交互确认；生产和团队环境建议先确认分支与数据清理策略。
Linux / macOS / Git Bash：安装 dev 分支并自动确认
curl -fsSL https://gitee.com/aiweline/WelineFramework/raw/master/bin/bootstrap.sh | bash -s -- -b dev -y
Windows PowerShell：安装 dev 分支并自动确认
$f="$env:TEMP\weline-bootstrap.ps1"; irm 'https://gitee.com/aiweline/WelineFramework/raw/master/bin/bootstrap.ps1' -OutFile $f; & $f -b dev -y纯净安装
三步完成源码、数据库与 WLS
纯净安装不安装 extend/server 下的 PHP 或项目本地数据库，适合已有 PHP、Composer 和数据库环境的开发者。
获取源码和 Composer 依赖
纯净安装只获取源码和 Composer 依赖，不安装 extend/server 下的 PHP 或项目本地数据库。
Git
git clone https://gitee.com/aiweline/WelineFramework.git weline
cd weline
composer install
php bin/w command:upgrade
指定分支
git clone -b dev https://gitee.com/aiweline/WelineFramework.git weline
cd weline
composer install
php bin/w command:upgrade
Composer
composer create-project aiweline/weline-framework weline --prefer-dist
cd weline
php bin/w command:upgrade初始化数据库
首次安装数据库必须通过命令行初始化；先查看当前版本支持的安装参数模板，再按数据库类型执行安装。
查看安装参数模板
php bin/w system:install:sample
MySQL 初始化示例
php bin/w system:install \
--db-type=mysql \
--db-hostname=127.0.0.1 \
--db-database=weline \
--db-username=weline \
--db-password=weline \
--db-charset=utf8mb4 \
--db-collate=utf8mb4_general_ci \
--sandbox_db-type=mysql \
--sandbox_db-hostname=127.0.0.1 \
--sandbox_db-database=sandbox_weline \
--sandbox_db-username=sandbox_weline \
--sandbox_db-password=sandbox_weline \
--sandbox_db-charset=utf8mb4 \
--sandbox_db-collate=utf8mb4_general_ci启动框架内置服务器（WLS）
数据库初始化完成后启动框架内置服务器，进入本地开发和验证流程。
启动 WLS
php bin/w server:start框架特性
为商业站点而生的 PHP 8.4 工程底座
WLS 长驻运行时、多层缓存、模块化架构、属性 ORM 与全球化 URL 收敛在同一套工程体系，覆盖从本地开发到生产托管的完整链路。
WLS 长驻服务器
内置 Master/Worker 架构，默认 80/443 直连，支持 *.weline.test 本地域名、HTTPS 与热重载，无需 Nginx 即可上线。
双运行时统一链路
FPM 传统模式与 WLS 长驻模式共用 Bootstrap → Router → Controller，开发调试与生产性能无缝切换。
全页缓存 FPC
HIT/STALE 全页缓存，按语言与货币变体，Gzip 存储与 stale 回退，响应头可观测命中状态。
多层缓存体系
统一请求缓存、路由缓存、规则缓存与 RuntimeCachePolicy 分层 TTL，File / Redis 双驱动。
MemoryServer 共享缓存
WLS 进程间 TCP 共享内存缓存，配合模板编译缓存与 cache:warm 预热，长驻场景下稳定低延迟。
模块化生命周期
register.php 注册，Install/Upgrade 自动化，模块可独立安装、升级与卸载，按需扩展业务能力。
约定优于配置
Controller 目录自动映射 URL，无需 routes.xml；Schema 用 PHP 8 属性声明，setup:upgrade 自动同步。
Event / Hook / Extends
事件解耦业务、Hook 插槽扩展视图、Extends 环绕增强方法，三种机制覆盖模块协作全场景。
属性驱动 ORM
#[Table] #[Col] #[Index] 声明 Schema，链式查询器，支持 PostgreSQL / MySQL，WLS 下连接池复用。
企业级数据库迁移
语义化迁移文件、事务安全、依赖管理与智能回滚，适合长期演进的商业项目。
多语言全球化 URL
/{currency}/{language}/... URL 结构，词典运营、语言切换与 SEO 重写协同，支撑跨境站点增长。
高性能模板与主题
Taglib 标签引擎，去标签化/去翻译化缓存，多主题继承可复写任意模块模板，Hook 可视化插槽。
框架模块
核心模块能力一览
完整收录已注册的 75 个 Weline 模块；支持按模块、能力、场景关键词搜索，并可在弹窗中翻看每个模块的功能说明。
Weline Framework
PHP 8.4 核心框架，提供 MVC、ORM、w_query/QueryProvider、Plugin、CLI 与模块全生命周期。
WLS 运行时
高性能常驻内存服务器，支持 HTTP/WebSocket、Dispatcher 透传、滚动零停机、共享 Session 与多 Worker。
多站点管理
多网站、域名池、DNS/证书生命周期与全球化 URL 解析，支撑本地建站与生产域名一站式交付。
后台管理
响应式后台管理面板，动态菜单、模块化运维入口与后台 REST 边界一体化。
权限控制
基于角色的访问控制，管理资源权限、菜单可见性与操作授权。
前台展示
theme.js + Weline.Api 二进制 Worker 统一前端请求链，页面渲染、graph/stream 与 SEO 一体化。
主题系统
多主题继承、Taglib 高性能模板、Widget 插槽与主题编辑器，支撑可视化建站。
多语言
语言包、翻译词条、本地化模型与国家地区管理能力。
多货币
站点多货币展示与切换，支撑跨境独立站的价格本地化。
全球支付
统一支付抽象层，通过 Provider 接入多种支付方式与回调校验。
结账流程
统一结账链路，承接购物车、地址、配送、支付与订单创建，适合电商和业务交易场景。
订单管理
订单模型、状态流转、金额记录与后台管理入口，为交易型站点提供核心履约数据。
购物车
购物车会话、商品行、数量更新与结账前校验，连接商品选择和交易提交。
CDN 加速
多适配器 CDN 管理，缓存规则与预热能力，并与 WLS 攻击信号联动开启防护。
AI 助手
多供应商模型、场景适配器与 Adapter 扩展，统一 Chat REST 与后台 AI 能力底座。
应用商城
本地应用商店集成，支持模块下载、安装记录、许可证与版本更新。
队列任务
基于数据库的消息队列与 Cron 计划任务，支撑异步业务与 WLS 攻击监控等后台作业。
客服聊天
多语言实时客服，支持会话分配、消息翻译与邮件绑定。
文件管理
统一文件上传、存储、检索与权限控制，支持多种存储策略。
全球 Geo
地理定位与区域服务，支撑全球化站点的地区识别与策略分发。
开发者文档
内置开发者知识库、API 文档浏览与模块文档索引，支撑团队协作与 AI 辅助开发。
API 管理
API 用户、令牌、文档生成与沙盒调试，支撑对外开放接口与集成测试。
EAV 模型
实体-属性-值动态字段模型，支撑可配置商品属性、队列类型与业务扩展字段。
Hook 系统
视图层插槽扩展机制，模块在布局与模板中注册 Hook 点，主题与业务可挂载片段。
事件系统
观察者模式事件总线，模块通过事件解耦业务，支持 w_query 与调试追踪。
URL 管理
SEO 友好 URL 重写、路由规则与多语言路径协同，支撑全球化站点链接结构。
SEO 优化
SEO 集成与智能优化模块
部署发布
Webhook 触发部署、多环境与代码同步，衔接 WLS 滚动发布实现持续交付。
AiKnowledge
AI Knowledge module providing MCP server, hybrid search, and multi-dimensional documentation collectors for WelineFramework.
Backend
Admin模块
BackendActivity
后台操作日志管理，用于追踪后台操作和操作数据。
CacheManager
缓存管理器 - 新增定时清理功能
Captcha
人机验证模块 - 提供Google reCAPTCHA v2/v3验证和备用图形验证码功能
CKEditorEditorManager
CKEditor5富文本管理器.
Code
Code代码修复模块
Component
系统组件模块
Cron
官网提供计划任务调度。兼容win/linux（win7以上，linux支持crontab）
Customer
前端客户管理模块
数据库
企业级数据库迁移管理系统，支持版本控制、数据备份、安全回滚、版本历史追踪
DataTable
提供数据表格功能
DbManager
WLS Panel database profile manager.
EditorManager
编辑器管理器。提供editor标签。
ElFinderFileManager
ElFinder文件管理器.你可以修改前后端的elfinder.html模板文件，修改成你想要的样式。一旦前后端存在此elfinder.html模板文件，更新或者安装不会受到影响。
Extends
扩展管理模块，用于管理和查看系统中所有模块的扩展关系、循环依赖检测等功能。
FakeData
Development-only fake data import module. Providers are registered through extends and executed only by CLI commands.
Indexer
官网提供Model模型索引功能。
Installer
安装模块
Layout
Weline Layout 模块，扩展框架在 Layout 方向的能力。
Location
Location module for browser location and IP location lookup.
企业邮箱管理模块：管理自建邮件服务环境、域名、账号、DNS 检测和服务状态。
Maintenance
官网维护模块
Marketing
市场营销模块，提供全面的优惠规则引擎系统，支持多种优惠类型和多维度条件判断，符合国际标准
MediaManager
媒体管理器：图片链接裁剪、缓存及 WLS 兼容的文件浏览/上传/下载，支持作为默认文件管理器
Meta
元数据管理模块，统一管理系统中各种文件的元数据，支持多语言翻译
ModuleManager
官网模块管理器。
ModuleRouter
官网提供模组控制路由规则的功能模块。
Multipass
Multipass 多通道登录模块 - 支持第三方站点直接跳转登录
Parts
官网提供缓存预热。
PhpManager
WLS Panel PHP profile manager.
SessionManager
Session管理
Shipping
地址管理模块，管理发货地址和运送地址
Smtp
邮件发送服务模组，支持多模块 SMTP 配置、w_query、w_smtp 全局函数.
Social
融媒体社媒管理模块，提供统一平台账户、AI 创意和多平台发布能力
Sticker
Sticker 模块：提供一种非侵入式修改其他模块文件的能力，通过编译机制将源文件和 Sticker 规则合并。
存储源
统一存储抽象层，支持本地存储、AWS S3、阿里云 OSS 等多种存储后端。
SystemConfig
官网系统配置模块：管理系统配置
Taglib
Taglib标签库插件，协助支持自定义标签功能
ThemeFancy
前端Fancy模板
TranslationService
翻译服务模块，为其他模块提供全球主流翻译渠道对接服务
TwoFactorAuth
完全自主开发的双因素身份验证模块，提供标准TOTP实现和独立PWA客户端应用
Visitor
系统组件模块: 访客统计
Vue
Vue支持
WarmCache
官网提供缓存预热。
WebsiteMonitoring
网站监控工具
Widget
可视化编辑器模块，支持通过拖放方式组织页面，使用 w:widget 标签存储和渲染部件。
未找到匹配模块，请换一个关键词。
Weline Account / Multipass
官网登录注册与生态统一身份
官网账号作为 Weline 生态的身份入口，承接个人中心、应用授权、跨站一键登录和可信应用资料读取。
先拥有一个 Weline 账号
注册后即可使用官网登录，并在 App、Skill、BBS、A2A 等站点发起授权时确认身份。
生态服务
围绕框架扩展的生态服务
应用商城、A2A、Skill 与社区论坛共同构成 Weline Framework 的生态入口，帮助站点从框架安装走向业务落地。
关于
关于 Aiweline 与 Weline Framework
Aiweline 负责 Weline Framework 的开源维护、生态建设与商业支持，帮助开发者在同一套工程体系中完成框架安装、模块扩展和长期运维。
Aiweline 维护 Weline Framework 开源框架与相关生态模块。开源框架用于降低商业应用工程底座成本；商业保障、专属支持、定制开发、赔偿责任和 SLA 以单独书面协议为准。