Typecho博客lhypy插件与主题管理器

简介

为 Typecho 后台提供插件和主题的上传安装与卸载管理功能。

1. 核心功能

• 插件上传安装：通过 ZIP 文件上传安装插件到 usr/plugins/ 目录
• 主题上传安装：通过 ZIP 文件上传安装主题到 usr/themes/ 目录
• 插件卸载：在后台一键卸载插件（自动先禁用再删除文件）
• 主题卸载：在后台一键卸载主题（当前使用中的主题不可卸载）
• ✅ 新增：主题市场：在线浏览主题，一键远程安装

2. 系统要求
   Typecho 1.2+
   PHP 8.0+
   PHP ZipArchive 扩展（用于 ZIP 文件处理）
   管理员权限
   服务器支持 file\_get\_contents 远程请求
3. 安装方法
   将 lhypy 目录上传到 usr/plugins/ 目录下
   登录 Typecho 后台，进入「控制台 → 插件」
   找到「lhypy」插件，点击「启用」
   启用后，在后台左侧菜单会出现「扩展管理」菜单项
   点击「插件与主题管理」/「主题市场」进入对应功能
4. 使用说明
   上传安装插件
5. 进入「扩展管理 → 插件与主题管理」
6. 在「插件管理」选项卡下，点击「选择文件」选择插件的 ZIP 压缩包
7. 点击「上传安装」按钮
8. 安装成功后，前往「控制台 → 插件」页面启用新插件

卸载插件

1. 在「插件管理」选项卡下，找到要卸载的插件
2. 点击「卸载」按钮
3. 确认卸载操作
4. 如果插件已启用，系统会自动先禁用再删除文件

卸载主题

1. 在「主题管理」选项卡下，找到要卸载的主题
2. 点击「卸载」按钮（当前正在使用的主题不可卸载）
3. 确认卸载操作

ZIP 包结构要求

插件 ZIP 包

ZIP 文件必须包含以插件名命名的子目录，子目录中包含 Plugin.php：

文件结构

lhypy/
├── Plugin.php # 主插件文件（激活/停用/菜单注册）
├── Action.php # 处理上传,主题/卸载请求的 Action 类
├──market.php # 主题市场后台
├── panel.php # 管理面板视图
└── README.md # 说明文档

安全说明

• 所有操作需要管理员权限
• 所有表单操作包含CSRF,Token 保护
• ZIP 文件验证文件魔数（防止伪文件）
• 目录名仅允许字母、数字、下划线和连字符
• 不允许卸载当前正在使用的插件（lhypy 自身）
• 不允许卸载当前正在使用的主题