{"id":14461814,"url":"https://github.com/PRO-2684/transitio","last_synced_at":"2025-08-28T19:32:08.116Z","repository":{"id":187152601,"uuid":"676356314","full_name":"PRO-2684/transitio","owner":"PRO-2684","description":"Load custom UserStyles for QQNT","archived":false,"fork":false,"pushed_at":"2024-11-26T11:54:32.000Z","size":4733,"stargazers_count":93,"open_issues_count":3,"forks_count":15,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-12-20T03:15:08.121Z","etag":null,"topics":["css","liteloaderqqnt","llqqnt","stylus","transitio","userstyle"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PRO-2684.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-09T02:53:23.000Z","updated_at":"2024-12-13T10:11:46.000Z","dependencies_parsed_at":"2023-08-09T06:59:09.609Z","dependency_job_id":"d5826392-1241-434d-88ca-5129784a8f01","html_url":"https://github.com/PRO-2684/transitio","commit_stats":null,"previous_names":["pro-2684/transitio"],"tags_count":35,"template":false,"template_full_name":"LiteLoaderQQNT/Plugin-Template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRO-2684%2Ftransitio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRO-2684%2Ftransitio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRO-2684%2Ftransitio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PRO-2684%2Ftransitio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PRO-2684","download_url":"https://codeload.github.com/PRO-2684/transitio/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":231297086,"owners_count":18354596,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["css","liteloaderqqnt","llqqnt","stylus","transitio","userstyle"],"created_at":"2024-09-01T22:01:16.804Z","updated_at":"2025-08-28T19:32:08.104Z","avatar_url":"https://github.com/PRO-2684.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cimg alt=\"Transitio Logo\" src=\"./icons/icon.svg\" align=\"right\" style=\"width: 6em; height: 6em;\"\u003e\u003c/img\u003e\n\n# Transitio\n\n[![GitHub License](https://img.shields.io/github/license/PRO-2684/transitio?logo=gnu)](https://github.com/PRO-2684/transitio/blob/main/LICENSE)\n[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/PRO-2684/transitio/release.yml?branch=main\u0026logo=githubactions)](https://github.com/PRO-2684/transitio/blob/main/.github/workflows/release.yml)\n[![GitHub Release](https://img.shields.io/github/v/release/PRO-2684/transitio?logo=githubactions)](https://github.com/PRO-2684/transitio/releases)\n[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/PRO-2684/transitio/total?logo=github)](https://github.com/PRO-2684/transitio/releases)\n[![GitHub Downloads (all assets, latest release)](https://img.shields.io/github/downloads/PRO-2684/transitio/latest/total?logo=github)](https://github.com/PRO-2684/transitio/releases/latest)\n\n[LiteLoaderQQNT](https://github.com/mo-jinran/LiteLoaderQQNT) 插件，用于为 QQNT 加载任意用户样式。\n\n你可能也感兴趣：[Scriptio](https://github.com/PRO-2684/Scriptio)，自定义渲染层 JavaScript 脚本加载器。\n\n## 🪄 具体功能\n\n- 导入/搜索/查看/删除用户样式\n- 启用/禁用/配置/重置用户样式\n- 开发者模式：监控文件更改，实时预览效果\n- 立即重载：立即重载所有用户样式\n\n## 🖼️ 截图\n\n\u003e 演示中使用了 [MSpring-Theme](https://github.com/MUKAPP/LiteLoaderQQNT-MSpring-Theme)，主题色为 `#74A9F6`。\n\n![Transitio settings](./attachments/settings.jpg)\n\n## 📥 安装\n\n### 稳定版\n\n下载 Release 中的 `transitio-release.zip`，解压后放入[数据目录](https://github.com/mo-jinran/LiteLoaderQQNT-Plugin-Template/wiki/1.%E4%BA%86%E8%A7%A3%E6%95%B0%E6%8D%AE%E7%9B%AE%E5%BD%95%E7%BB%93%E6%9E%84#liteloader%E7%9A%84%E6%95%B0%E6%8D%AE%E7%9B%AE%E5%BD%95)下的 `plugins/transitio` 文件夹中即可。(若没有该文件夹请自行创建)\n\n### CI 版\n\n若想体验最新的 CI 功能，需要下载源码后安装要求的依赖 (`pnpm i --prod`)。\n\n## 🤔 使用方法\n\n\u003e [!WARNING]\n\u003e 所有不是通过配置界面进行的更改，除非打开了 *开发者模式*，都只在双击 *导入用户样式* 这行字或重启 QQ 后生效。\n\n- 导入样式：在配置界面导入用户样式文件，或将之放入 `data/transitio/styles/` 文件夹。\n    - 样式的编写请参考 [Wiki](https://github.com/PRO-2684/transitio/wiki)。\n    - 可以在此文件夹下创建多层目录，插件会自动扫描所有支持的用户样式文件，但是设置界面导入的还是默认直接放在 `data/transitio/styles/` 下\n- 搜索样式：在设置界面搜索框中输入关键词即可。\n    - 未聚焦到其它输入框时可以直接按下 `Enter` 键或 `Ctrl+F` 聚焦到搜索框\n    - 根据空格将输入分解为多个关键词，所有关键词均大小写不敏感\n    - 可以通过 `@` 符号筛选满足指定条件的样式\n        - `@enabled`/`@on`/`@1`：启用的样式\n        - `@disabled`/`@off`/`@0`：禁用的样式\n    - 可以通过 `#` 符号根据预处理器的 Hashtag 筛选样式，例如 `#none`, `#transitio`, `#stylus` 等\n    - 搜索结果展示匹配 **所有普通关键词**，**所有 @ 关键词** 以及 **任一 Hashtag 关键词** (若有) 的样式\n- 查看样式\n    - 鼠标悬停在样式标题上时，会显示其绝对路径。\n    - 鼠标悬停在样式上时，会展示 \"在文件夹中显示\" 按钮。\n- 删除样式：鼠标悬停在样式上并点击删除 `🗑️` 按钮，或进入 `data/transitio/styles/` 文件夹删除对应文件。\n- 启用/禁用样式：打开插件设置界面，将对应的样式开关打开/关闭，即时生效。\n    - 若点击各个开关速度过快，可能会导致错位等情况，此时请双击 \"导入用户样式\" 来重载。\n- 配置样式：鼠标悬停在样式上并点击设置 `⚙️` 按钮。\n- 重置样式：右键 `⚙️` 按钮，即可将样式的配置重置为默认值。\n- 更新样式：重新导入、禁用后启用或重载样式即可。\n\n## 🔗 URL Scheme\n\n\u003e [!WARNING]\n\u003e 此功能并未完善，仅作测试使用。\n\n若您安装了 [Protocio](https://github.com/PRO-2684/protocio)，可以使用 `llqqnt://transitio/` 协议来与 Transitio 交互。下面列举了支持的协议参数：\n\n- `install/\u003curl\u003e`：导入指定 URL 的用户样式，`url` 需要经过 URL 编码 (`encodeURIComponent`)。\n- `ping`：测试 URL Scheme 功能。\n\n## 💻 调试\n\n- 开发者模式 (不推荐)：若您想要调试 **您的用户样式的效果**，可以在插件设置界面打开*开发者模式*，此时插件会监控 `data/transitio/styles/` 文件夹，当发生更改时，会自动重载。\n- Debug 模式：若您想要调试 **此插件本身以及您的用户样式中的错误**，可以使用 `--transitio-debug` 参数启动 QQNT，此时插件会在控制台输出调试信息。\n\n## 📜 用户样式列表\n\n\u003e [!NOTE]\n\u003e 网站内列出的样式均为由我/其它用户编写的用户样式，不内置在插件中。\n\u003e\n\u003e 若你有愿意分享的样式，欢迎 [提交 PR 或 Issue](https://github.com/PRO-2684/transitio/issues/4) 来将它们添加到这里。编写样式前推荐先阅读 [Wiki](https://github.com/PRO-2684/transitio/wiki)。\n\n访问 [此网址](https://pro-2684.github.io/?page=transitio_userstyles) 查看用户样式列表。\n\n## ⭐ Star History\n\n[![Stargazers over time](https://starchart.cc/PRO-2684/transitio.svg?variant=adaptive)](https://starchart.cc/PRO-2684/transitio)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPRO-2684%2Ftransitio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FPRO-2684%2Ftransitio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FPRO-2684%2Ftransitio/lists"}