【开发必看】XIUNOX 插件互斥机制开发者指南

贰先生管理 4天前

XIUNOX 通过目录命名规范自动识别同类插件，安装/启用新插件时自动禁用已有的同类插件（保留配置，不卸载数据）。

命名你的插件

目录名按下划线分段：作者_功能标识。功能标识可以含下划线（如 ad_selfbuy、ai_reply）。

类型	命名格式	示例	互斥行为
主题类	`作者_theme` 或 `作者_theme_变体`	`xnx_theme`、`xnx_theme_moments`	所有主题互相禁用（只能启用一个主题）
功能插件	`作者_功能标识`（功能标识可含下划线）	`xnx_checkin`、`xnx_ad_selfbuy`、`my_ai_reply`	功能标识相同才互斥
单段	`myplugin`	—	不参与互斥（不推荐）

主题插件第二段必须是 theme → 所有主题互相互斥
- xnx_theme 与 xnx_theme_moments 互斥（无论变体多少）
- 错误命名：xnx_moments_theme（第二段不是 theme，会被当作功能插件）
功能插件按"功能标识"匹配 → 功能标识相同才互斥
- 功能标识 = 第二段及以后的所有段拼接
- xnx_checkin → 功能标识 checkin
- xnx_ad_selfbuy → 功能标识 ad_selfbuy
- xnx_ai_reply → 功能标识 ai_reply
功能标识不同则不互斥（自然共存）
- xnx_ad_selfbuy 与 xnx_ad_banner → ad_selfbuy ≠ ad_banner → 不互斥
- xnx_checkin 与 xnx_checkin_info → checkin ≠ checkin_info → 不互斥（基础与扩展可共存）

插件 A	插件 B	功能标识 A	功能标识 B	互斥
`xnx_checkin`	`jack_checkin`	`checkin`	`checkin`	✅ 互斥
`xnx_ad_selfbuy`	`jack_ad_selfbuy`	`ad_selfbuy`	`ad_selfbuy`	✅ 互斥
`xnx_ad_selfbuy`	`xnx_ad_banner`	`ad_selfbuy`	`ad_banner`	❌ 不互斥
`xnx_ai_reply`	`xnx_avatar_ai`	`ai_reply`	`avatar_ai`	❌ 不互斥
`xnx_checkin`	`xnx_checkin_pro`	`checkin`	`checkin_pro`	❌ 不互斥
`xnx_theme`	`xnx_theme_dark`	theme	theme	✅ 互斥（主题）

功能标识的灵活性（可含下划线、段数不限）是为了让真正不同的功能可以共存（如 ad_selfbuy 自助广告与 ad_banner 横幅广告），不是为了帮功能重复的插件逃避互斥。

判断标准：如果你的插件与某个已有插件功能实质重复（用户装两个会导致数据冲突、UI 重复、hook 互相覆盖），就必须使用相同的功能标识，让系统自动禁用旧的。只有功能确实不同（各自独立运行、不产生冲突）时，才允许用不同的功能标识。

场景	错误（规避互斥）	正确（参与互斥）
独立签到插件，想避开与 `jack_checkin` 互斥	`my_checkin_v2`（功能标识 `checkin_v2`）	`my_checkin`（功能标识 `checkin`）
功能重复的广告插件，想与 `xnx_ad_selfbuy` 共存	`my_ad_buy`（功能标识 `ad_buy`）	`my_ad_selfbuy`（功能标识 `ad_selfbuy`）
主题插件想避开主题互斥	`my_dark_theme`（第二段不是 theme，被当作功能插件）	`my_theme_dark`（第二段是 theme，正确归入主题互斥组）

允许用不同功能标识的正当场景：

违规后果：

场景 1：开发签到插件

my_checkin/          ← 功能标识 checkin

用户若已安装 jack_checkin，安装 my_checkin 时会自动禁用 jack_checkin（两者功能标识都是 checkin）。

场景 2：开发签到插件的扩展包

my_checkin/          ← 基础版，功能标识 checkin
my_checkin_pro/      ← 高级版，功能标识 checkin_pro

两者功能标识不同，可以同时启用。

场景 3：开发广告插件（细分功能）

my_ad_selfbuy/       ← 自助购买广告，功能标识 ad_selfbuy
my_ad_banner/        ← 横幅广告，功能标识 ad_banner

两者是不同的广告功能，可以同时启用。

场景 4：开发主题插件

my_theme_lightly/            ← 基础主题
my_theme_dark/               ← 暗色变体

两个主题互相禁用，用户只能启用其中一个。简单的样式更改建议升级主题本体，复杂的建议使用插件扩展或新开主题

点赞收藏