# LcCitrus

**Repository Path**: lczld/LcCitrus

## Basic Information

- **Project Name**: LcCitrus
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-16
- **Last Updated**: 2026-10-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LcCitrus & LcSticky

Typecho 1.3 博客主题 **LcCitrus** 与它的配套插件 **LcSticky**，同仓维护：播放器的配置与界面在主题侧、置顶开关与歌单音源解析在插件侧，两边要一起改才不脱节，所以放一个仓库、一次提交说清整组改动。

| 目录 | 是什么 | 当前版本 | 安装位置 |
| --- | --- | --- | --- |
| `LcCitrus/` | 柑橘色调格子卡片主题 | `LcCitrus/index.php` 的 `@version` | `usr/themes/LcCitrus` |
| `LcSticky/` | 置顶 + 站点地图 + 音乐歌单解析插件 | `LcSticky/Plugin.php` 的 `@version` | `usr/plugins/LcSticky` |

主题的安装、功能与后台说明在 [LcCitrus/README.md](LcCitrus/README.md)。

## LcSticky 做什么

启用后提供三件事，停用即全部消失：

- **文章置顶**：写文章侧栏出现「置顶文章：是 / 否」，写入自定义字段 `sticky=yes`，主题首页与归档优先展示并加「置顶」徽章。没装插件时手动加同一个自定义字段效果相同。
- **`/sitemap.xml`**：输出首页、已发布文章、独立页面、分类/标签归档与系列详情；独立页面按主题的「自定义模板」识别，页面别名随便改都能跟上。
- **音乐直链 `/music/url`**：按歌单 ID 实时解析网易云 / QQ / 酷狗 / 酷我 / 百度音源，302 到最新播放直链，供主题的磁铁播放器逐首取流。解析结果缓存在 `LcSticky/cache/music-*.json`。

依赖：PHP `curl` 扩展（缺扩展时音乐解析直接返回空，置顶与站点地图不受影响）；`LcSticky/cache/` 建议可写，不可写时每次现场解析。

设置项只有一个，在后台启用插件的弹窗里：**音乐解析 Cookie（可选）**——填网易云等音源的登录 Cookie（如 `MUSIC_U=...`）可解析 VIP 完整曲目，留空按匿名解析（可能只有 30 秒试听）。歌单 ID、音源类型、API 地址等都在主题的「音乐设置」分组里填。

## 版本与升级

后台「设置外观 → 主题说明」读的是本仓库 `LcCitrus/index.php` 的 `@version`（`https://gitee.com/lczld/LcCitrus/raw/main/LcCitrus/index.php`，Gitee 有约 1 分钟 CDN 缓存）。**发布新版 = 改 `@version` → 推到 main**，各站点后台自动提示，并在同一行给出「在线升级到 x」：备份整目录 → 下载 `main` 压缩包 → 校验版本 → 覆盖 → 复核，失败自动回滚；只动 `LcCitrus/` 下的文件，设置数据与 `LcSticky` 不受影响。前提是 PHP 有 `zip` 扩展、且 PHP 改写得了主题文件（用宝塔 / 1Panel 的「文件」页上传解压出来的文件属主是 `root`，得 `chown` 给 PHP 运行用户 `www` 或 `www-data`）。

`@version`、安装包文件名（`LcCitrus-v<版本>-<日期>.zip`）、后台「当前版本」三处保持一致，每次功能改动一起递增——`@version` 不动，后台那一行永远显示「已是最新」。

仓库布局有一处约束：主题文件必须留在仓库根的 `LcCitrus/` 这一层，否则这一行读不到版本（要挪就得同步改 `LcCitrus/functions.php` 里的 `citrus_repo_url()`）。

## 许可

仓库根 [LICENSE](LICENSE)（MIT）同时覆盖 `LcCitrus/` 与 `LcSticky/`；主题内置的第三方库（swup 等）在各自目录内附带许可证文件。