项目背景

sensitive-word-admin 项目最初旨在展示如何应用 sensitive-word 工具。随着用户反馈不断增加，我们决定将其打造为更完善的产品。
本次v2.0.0版本基于ruoyi-vue框架（特别鸣谢若依开源项目）进行了全面UI革新，致力于为用户提供即装即用的敏感词管理解决方案。

系统概述

平台特性

sensitive-word-admin 是专为 sensitive-word 设计的配套管理系统。
技术架构：
– 前端：Vue.js + Element UI组件库
– 后端：Spring Boot框架 + Spring Security安全框架 + Redis缓存 + JWT认证
– 权限管理：基于JWT的多终端认证机制
– 动态菜单：支持权限菜单动态加载
– 代码生成：内置代码生成器可快速生成前后端基础代码

相关资源

敏感词管理系统 v1.2.0 开源版本发布
基于DFA算法的高效敏感词检测工具详解

核心功能

• 基础增删改查操作
• 敏感词修改即时生效
  

  版本更新记录

环境部署

必备组件

• Redis缓存服务
• MySQL数据库
• Node.js运行环境

后端配置

1. 数据库初始化
   执行MySQL命令：

CREATE DATABASE IF NOT EXISTS sensitive_word;
USE sensitive_word;

运行项目sql目录下的初始化脚本
2. 配置文件修改
调整application-druid.yml中的数据库连接参数：

datasource:
master:
url: jdbc:mysql://localhost:3306/sensitive_word?useSSL=true
username: your_username
password: your_password

启动主应用类

前端运行

cd admin-ui
npm install
npm run dev

系统登录

访问地址：http://localhost (默认账号：admin/admin123)

敏感词管理

系统提供专门的敏感词管理模块：

接口文档

ApiSensitiveWordController封装了完整的API方法，未来可扩展签名验证等功能。

接口概览

接口	参数	返回值	功能说明
/api/sensitiveWord/contains	字符串	布尔值	检测是否包含敏感词
/api/sensitiveWord/findAll	字符串	列表	获取全部敏感词
/api/sensitiveWord/findFist	字符串	字符串	获取首个匹配词
/api/sensitiveWord/replace	字符串	字符串	获取替换后文本
/api/sensitiveWord/tags	字符串	集合	获取敏感词标签
## 接口测试
### 认证令牌
登录后获取的JWT令牌格式如下：

eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImxvZ2luX3VzZXJfa2V5IjoiYzBjMmY0MWQtMjliMS00YzlkLWI2ZmMtNDhlZTk4MGIwZjJjIn0.67qpqIndfAd4J769ny1jqq8kEnATE9u5DbjJoMpbiMCSvAg2WaBV0b4nBjo5UxKVqcqbYgmnIN4gUi3AP2p6uw

接口调用示例

cURL请求示例：

curl -X GET "http://localhost/api/sensitiveWord/tags?text=测试内容" -H "Authorization: Bearer [token]"

响应示例：

{
"respCode": "0000",
"respMessage": "操作成功",
"result": ["分类1","分类2"]
}

标签定制

自定义标签配置

通过配置类实现：

@Configuration
public class SensitiveWordConfig {
// 注入相关组件
@Bean
public SensitiveWordBs sensitiveWordBs() {
return SensitiveWordBs.newInstance()
.wordTag(customWordTags)
// 其他配置项
.init();
}
}

实现原理

标签系统包含两个核心表：
1. 标签映射表：存储词语与标签编码的对应关系
2. 标签描述表：存储标签详细信息
关联查询SQL：

SELECT mapping.word, tag.tag_label
FROM word_tag_mapping mapping
JOIN tag ON mapping.tag_code = tag.tag_code
WHERE tag.status = 'Y'

发展路线

v2.0.0版本仍有优化空间，诚邀开发者共同完善：交流社区

待优化功能

• 单词语义实时更新
• 标签增量更新机制
• 标签枚举标准化
• 应用接入鉴权
• 调用日志追踪
• 数据统计看板

致谢

特别感谢ruoyi-vue开源项目的贡献

延伸阅读

敏感词管理系统分布式部署方案
中文处理技术全家桶

技术生态

sensitive-word 敏感词检测
pinyin 拼音转换
中文分词引擎
繁简转换工具
汉字相似度计算
拼写检查工具