找回密码
 立即注册
首页 资源区 代码 sensitive-word-admin v2.0.0 全新 ui 版本发布!vue+前 ...

sensitive-word-admin v2.0.0 全新 ui 版本发布!vue+前后端分离

即息极 2025-5-29 10:49:42
前言

sensitive-word-admin 最初的定位是让大家知道如何使用 sensitive-word,所以开始想做个简单的例子。
不过秉持着把一个工具做好的原则,也收到很多小伙伴的建议。
v2.0.0 在 ruoyi-vue(也非常感谢若依作者多年来的无私奉献) 的基础之上,对整体 UI 进行重构。
为了实现一个让用户可以开箱就用的敏感词控台。
项目介绍

平台简介

sensitive-word-admin 是和 sensitive-word 配套使用的控台。

  • 前端采用Vue、Element UI。
  • 后端采用Spring Boot、Spring Security、Redis & Jwt。
  • 权限认证使用Jwt,支持多终端认证系统。
  • 支持加载动态权限菜单,多方式轻松权限控制。
  • 高效率开发,使用代码生成器可以一键生成前后端代码。
拓展阅读

sensitive-word-admin 敏感词控台 v1.2.0 版本开源
sensitive-word 基于 DFA 算法实现的高性能敏感词工具介绍
特性


  • 基本的 CRUD
  • 敏感词修改实时生效
变更日志
本地启动

依赖

redis
mysql
node
后端

2)执行 mysql 脚本
登录 mysql
清空库(谨慎操作,别清空了以前的数据)
  1. use test;
  2. drop database sensitive_word;
复制代码
创建库
  1. create database sensitive_word;
  2. use sensitive_word;
复制代码
执行 sql 下的 init.sql+ sensitive_word.sql
3)修改配置
application-druid.yml 调整一下数据库链接+账户密码
  1. spring:
  2.     datasource:
  3.         type: com.alibaba.druid.pool.DruidDataSource
  4.         driverClassName: com.mysql.cj.jdbc.Driver
  5.         druid:
  6.             # 主库数据源
  7.             master:
  8.                 url: jdbc:mysql://localhost:3306/sensitive_word?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
  9.                 username: root
  10.                 password: PASSWORD
复制代码
运行 SpringBootApplication#main()
前端
  1. cd admin-ui
  2. npm install --registry=https://registry.npm.taobao.org
  3. npm run dev
复制代码
登录

打开浏览器,输入:http://localhost:80 (默认账户 admin/admin123)
敏感词基本管理

你可以在敏感词管理菜单,进行管理。
1.png

API

ApiSensitiveWordController 中包含对应的 api 方法,后续可以添加验签等校验。
接口列表

api入参出参说明/api/sensitiveWord/containsstringboolean是否包含敏感词/api/sensitiveWord/findAllstringList获取所有的敏感词/api/sensitiveWord/findFiststringstring获取第一个的敏感词/api/sensitiveWord/replacestringstring获取替换后的结果/api/sensitiveWord/tagsstringSet获取敏感词的标签列表接口验证

token

2.png

我们登录之后,可以获取到对应的 token。
比如我们打开【系统工具】-【系统接口】,任意找一个接口,看一下对应的 Authorization
比如这里就是
  1. eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImxvZ2luX3VzZXJfa2V5IjoiYzBjMmY0MWQtMjliMS00YzlkLWI2ZmMtNDhlZTk4MGIwZjJjIn0.67qpqIndfAd4J769ny1jqq8kEnATE9u5DbjJoMpbiMCSvAg2WaBV0b4nBjo5UxKVqcqbYgmnIN4gUi3AP2p6uw
复制代码
swagger 认证

然后点击绿色认证按钮认证一下,输入上面的 token。
就可以想基本的 swagger 一样验证接口。
curl 请求

你可以本地直接 curl
  1. curl -X GET "http://localhost:80/dev-api/api/sensitiveWord/tags?text=%E4%BA%8C%E5%8D%81%E5%85%AB%E7%94%BB%E7%94%9F" -H "accept: */*" -H "Authorization: eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImxvZ2luX3VzZXJfa2V5IjoiYzBjMmY0MWQtMjliMS00YzlkLWI2ZmMtNDhlZTk4MGIwZjJjIn0.67qpqIndfAd4J769ny1jqq8kEnATE9u5DbjJoMpbiMCSvAg2WaBV0b4nBjo5UxKVqcqbYgmnIN4gUi3AP2p6uw"
复制代码
结果:
  1. {
  2.   "respCode": "0000",
  3.   "respMessage": "成功",
  4.   "result": [
  5.     "伟人",
  6.     "画家"
  7.   ]
  8. }
复制代码
如何自定义标签

自定义单词 TAG

我们在配置中指定:
  1. @Configuration
  2. public class SensitiveWordConfig {
  3.     @Autowired
  4.     private MyDdWordAllow myDdWordAllow;
  5.     @Autowired
  6.     private MyDdWordDeny myDdWordDeny;
  7.     /**
  8.      * 自定义单词标签
  9.      *
  10.      * @since v1.4.0
  11.      */
  12.     @Autowired
  13.     private MyDdWordTags myDdWordTags;
  14.     /**
  15.      * 初始化引导类
  16.      * @return 初始化引导类
  17.      * @since 1.0.0
  18.      */
  19.     @Bean
  20.     public SensitiveWordBs sensitiveWordBs() {
  21.         return SensitiveWordBs.newInstance()
  22.                 .wordAllow(WordAllows.chains(WordAllows.defaults(), myDdWordAllow))
  23.                 .wordDeny(WordDenys.chains(WordDenys.defaults(), myDdWordDeny))
  24.                 .wordTag(myDdWordTags)
  25.                 // 各种其他配置
  26.                 .init();
  27.     }
  28. }
复制代码
MyDdWordTags 自定义实现

MyDdWordTags 是一个实现的例子:
核心分为两步:
1)根据【标签单词映射表】获取单词对应的标签编码(tag_code) 列表
2)根据【标签表】中的 tag_code 去查询对应的 标签描述(tag_label) 列表
所以需要分别配置二者,然后进行关联。
  1. SELECT DISTINCT
  2. mapping.word AS word,
  3. tag.tag_label AS tagLabel
  4. FROM word_tag_mapping mapping
  5. INNER JOIN tag tag ON mapping.tag_code = tag.tag_code
  6. WHERE tag.status = 'Y'
复制代码
road-map

当然,v2.0.0 出版的能力还比较欠缺,用户体验还是不够友好。
感兴趣的小伙伴也可以针对下面的需求进行 PR,欢迎一起交流。
如果你有需求,可以去这里issues
待改进点


  • 单个词的修改实时生效
  • word/tags 的修改,增量的变化,而不是全量
  • word-tag 的处理,改为枚举映射,而不是手动输入
  • 限定接入系统 appKey appSecret
  • 系统的调用记录
  • 数据大盘
  • [ ] word 操作时对应的日志表,有必要存在吗?(可以不保留,ruoyi 本身就有操作日志)
技术鸣谢


  • 感谢 ruoyi-vue 的无私奉献
拓展阅读

sensitive-word-admin v1.3.0 发布 如何支持分布式部署?
sensitive-word-admin 敏感词控台 v1.2.0 版本开源
sensitive-word 基于 DFA 算法实现的高性能敏感词工具介绍
更多技术交流
开源矩阵

sensitive-word 敏感词
pinyin 汉字转拼音
pinyin2hanzi 拼音转汉字
segment 高性能中文分词
opencc4j 中文繁简体转换
nlp-hanzi-similar 汉字相似度
word-checker 拼写检测
参考资料

https://github.com/houbb/sensitive-word-admin

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!
您需要登录后才可以回帖 登录 | 立即注册