在houbb/sensitive-word项目中动态添加敏感词标签的方法

敏感词过滤系统在实际应用中经常需要动态更新词库和标签，houbb/sensitive-word项目提供了灵活的API来实现这一需求。本文将详细介绍如何在初始化后动态添加敏感词及其标签。

初始化敏感词过滤系统

项目初始化时通常会从数据库加载敏感词列表并构建过滤系统：

// 创建敏感词对象并设置查询条件
SwSensitveWord swSensitveWord = new SwSensitveWord();
swSensitveWord.setStatus(0L);

// 获取服务实例并查询敏感词列表
ISwSensitveWordService swSensitveWordService = SpringUtils.getBean(ISwSensitveWordService.class);
List<SwSensitveWord> swSensitveWords = swSensitveWordService.selectSwSensitveWordList(swSensitveWord);

// 构建文字标签集合
Set<String> tags = swSensitveWords
        .stream()
        .map(item -> item.getWordName() + " " + item.getTriggerType())
        .collect(Collectors.toSet());
IWordTag wordTag = WordTags.lines(tags);

// 初始化敏感词过滤系统
SensitiveWordBs sensitiveWordBs = SensitiveWordBs.newInstance()
        .wordDeny(() -> swSensitveWords.stream()
                .map(SwSensitveWord::getWordName)
                .collect(Collectors.toList()))
        .wordTag(wordTag)
        .init();

动态添加敏感词和标签

系统运行过程中，当需要新增敏感词时，可以直接调用addWord方法：

// 添加单个敏感词
sensitiveWordBs.addWord("新的敏感词");

// 批量添加敏感词
List<String> newWords = Arrays.asList("敏感词1", "敏感词2");
sensitiveWordBs.addWord(newWords);

对于需要同时添加标签的情况，houbb/sensitive-word项目提供了灵活的标签管理机制。可以通过以下方式为新增的敏感词添加标签：

// 创建新的标签对象
IWordTag newWordTag = WordTags.lines(Collections.singleton("新的敏感词 标签类型"));

// 将新标签合并到现有标签系统中
sensitiveWordBs.getWordTagContext().addWordTag(newWordTag);

最佳实践建议

1. 批量操作：当需要添加大量敏感词时，建议使用批量添加方法，减少性能开销。

2. 标签设计：合理设计标签格式，如示例中的"敏感词 触发类型"格式，便于后续管理和查询。

3. 线程安全：在多线程环境下操作敏感词库时，需要注意同步问题，可以考虑使用读写锁等机制。

4. 性能监控：动态更新敏感词库可能影响系统性能，建议在低峰期执行批量更新操作。

5. 版本管理：对于关键敏感词更新，建议维护版本信息，便于问题追踪和回滚。

通过合理使用houbb/sensitive-word项目提供的API，开发者可以轻松实现敏感词库的动态更新和标签管理，满足业务系统对内容安全过滤的实时性要求。