Sub-Store项目中如何通过JavaScript读取订阅标签信息

前言

在Sub-Store项目中，订阅管理是一个核心功能，而标签系统则为用户提供了灵活的分类和组织方式。本文将详细介绍如何通过JavaScript脚本访问和操作订阅中的标签信息，帮助开发者更好地利用这一功能。

订阅标签的基本概念

订阅标签是Sub-Store中用于标记和组织订阅的重要元数据。它们可以用于：

1. 分类管理不同类型的订阅
2. 快速筛选特定类型的节点
3. 实现基于标签的自动化处理

访问标签信息的三种场景

在Sub-Store中，根据脚本应用的位置不同，访问标签信息的方式也有所区别。主要分为以下三种情况：

1. 单条订阅中的脚本

当脚本直接应用在单条订阅上时，可以通过context.source对象访问当前订阅的详细信息，包括标签。

function operator(proxies, targetPlatform, context) {
    const currentSub = context.source[Object.keys(context.source)[0]];
    const tags = currentSub.tag; // 获取当前订阅的标签数组
    // 处理逻辑...
    return proxies;
}

2. 组合订阅中的脚本

当脚本应用在整个组合订阅上时，context.source会包含一个特殊的_collection对象，其中存储了组合订阅的元数据。

function operator(proxies, targetPlatform, context) {
    if(context.source._collection) {
        const collectionTags = context.source._collection.tag; // 组合订阅的标签
        const subNames = context.source._collection.subscriptions; // 包含的订阅名称列表
        // 处理逻辑...
    }
    return proxies;
}

3. 组合订阅中单条订阅的脚本

这种情况下最为复杂，context.source会同时包含单条订阅的信息和所属组合订阅的信息。

function operator(proxies, targetPlatform, context) {
    // 获取当前订阅的名称
    const subName = Object.keys(context.source).find(key => key !== '_collection');
    
    if(subName) {
        const subTags = context.source[subName].tag; // 当前订阅的标签
        const collectionTags = context.source._collection.tag; // 所属组合的标签
        
        // 可以比较或合并两种标签
        const allTags = [...new Set([...subTags, ...collectionTags])];
    }
    return proxies;
}

实际应用示例

示例1：根据标签过滤节点

function operator(proxies, targetPlatform, context) {
    const requiredTag = "VIP";
    const currentSub = context.source[Object.keys(context.source)[0]];
    
    if(currentSub.tag && currentSub.tag.includes(requiredTag)) {
        return proxies.filter(p => p.name.includes("Premium"));
    }
    return proxies;
}

示例2：为特定标签的订阅添加前缀

function operator(proxies, targetPlatform, context) {
    const currentSub = context.source[Object.keys(context.source)[0]];
    
    if(currentSub.tag && currentSub.tag.includes("游戏")) {
        return proxies.map(p => {
            p.name = "[游戏] " + p.name;
            return p;
        });
    }
    return proxies;
}

最佳实践建议

1. 错误处理：始终检查标签是否存在，避免未定义错误

   const tags = context.source[subName].tag || [];
   

2. 性能考虑：在处理大量订阅时，尽量减少不必要的标签检查

3. 代码复用：将常用的标签处理逻辑封装为函数

4. 调试技巧：使用console.log输出上下文对象，了解数据结构

总结

通过Sub-Store提供的JavaScript脚本接口，开发者可以灵活地访问和操作订阅标签信息，实现各种高级功能。理解三种不同的上下文场景是正确使用标签信息的关键。本文介绍的方法和示例可以帮助开发者快速上手，在实际项目中发挥标签系统的最大价值。