Light_Quanta's Site

使用Kotlin开发Bukkit插件的命令处理DSL

Sat, 13 Jan 2024 00:00:00 GMT

本文适合有Java基础并且想了解下Kotlin的人阅读，没有Java或别的程序语言基础的不建议继续阅读（

前言

最近在开发一个Minecraft Bukkit服务端插件，需要写一个玩家命令处理。由于Bukkit原版的命令处理非常答辩，所以基本上插件都是自己实现了一套命令处理系统。

先来看看Bukkit给JavaPlugin插件提供的onCommand事件的签名：

boolean onCommand(CommandSender sender, Command command, String label, String[] args)

可以看到该事件仅仅是传递了命令发送者sender、命令本体command、标签label和后续的参数args，对于命令的处理则是完全没有提供对应的方法。因此，你不得不自己研究一套命令处理机制。

比如CoreProtect就是嗯写了几十个if ... else ...来处理的（

正好我前段时间在写的插件InteractionSupervisor是用Kotlin进行开发的，而Kotlin正好适合用于写DSL（比如gradle就可以使用build.gradle.kts进行配置），因此我就用Kotlin写了个迫真命令处理DSL

成品展示

先看看最终效果（插件里定义的完整命令见此）

val commands = buildCommand {
    "test" {
        execute {
            sender.sendMessage("args=" + args.joinToString(","))
        }
        tabComplete { mutableListOf("1", "2", "3") }
    }
    "group" {
        usage("group [a|b]")
        "a" {
            execute { sender.sendMessage("a") }
        }
        "b" {
            execute { sender.sendMessage("b") }
        }
    }
}

以上代码定义了以下内容：

test命令，执行后输出该命令附带的参数（如test a b c会向命令发送者发送args=a,b,c），同时在输入该命令时提供补全内容1、2、和3
命令组group：
- 该命令组会要求所有子命令都以此作为开头，如下文定义的命令a和b需要以group a和group b的方式调用
- 同时命令组也会自动提供对其子命令的补全，玩家输入group时，会自动提供补全内容a和b
- 玩家输入错误内容时会向上查找由usage定义的第一条有效的帮助内容并返回给玩家

在onCommand和onTabComplete事件处调用commands变量内定义的对应方法即可实现以上功能。

使用buildCommand即可开始构建命令处理模块，在模块中：

使用"命令(组)名称" { ... }即可定义一个命令
在命令组中继续使用"命令名称" { ... }即可定义子命令，同时命令组也会提供对该组命令所有子命令的补全
使用execute { ... }即可定义命令执行代码，其中command、sender、args等命令参数会被一同提供至上下文中，可以直接使用
使用tabComplete { ... }可以定义命令的Tab补全内容
使用usage("...")可以定义命令组的帮助信息

相比于传统的方法，使用DSL写出来的命令处理可读性更强，代码也更清晰。

能实现以上功能都得归功于Kotlin的一大堆逆天语法和特性。

前置知识介绍

以上DSL的核心代码基本就这些：

class Command(val name: String) {
    val subCommands = mutableListOf<Command>()
    var usage: String? = null
    var tabComplete: (() -> MutableList<String>) = { mutableListOf() }
    var execute: ((CommandExecuteParams) -> Unit)? = null

    fun tabComplete(init: () -> MutableList<String>) {
        tabComplete = init
    }

    fun execute(init: CommandExecuteParams.() -> Unit) {
        execute = init
    }

    fun usage(init: String) {
        usage = init
    }

    operator fun String.invoke(init: Command.() -> Unit) = Command(this).apply(init).also(subCommands::add)
}

class CommandBuilder {
    private val commands = mutableListOf<Command>()
    operator fun String.invoke(init: Command.() -> Unit) = Command(this).apply(init).also(commands::add)
    fun build() = CommandExecutor(commands)
}

fun buildCommand(init: CommandBuilder.() -> Unit) = CommandBuilder().apply(init).build()

完整的定义可在这里查看。

该DSL涉及到大量的Kotlin特性，我们一个个来讲。

扩展函数

Kotlin可以给任意类型添加扩展函数。扩展函数我认为可以理解成一种特殊的普通函数的简写，如以下函数：

fun String.aaa() {
    println(this)
}

在定义后即可在任意的String变量上调用，如"test".aaa()。

运算符重载

Kotlin支持运算符重载，可以重新定义各个类型的变量对于不同的运算符的操作，使用operator fun 运算符类型()即可为当前类定义运算符的重载。

例如以下定义：

class A {
    operator fun plus(other: Any) {
        println("A 与 $other 相加了！")
    }
}

重载了类型A的plus（+）运算符，当你将A类型的变量与任意别的变量相加（+）时，将会在控制台输出A 与另一个变量相加了！

A() + 123
// 控制台输出：A 与 123 相加了！

运算符重载同样可以配合上述的扩展函数使用，如以下定义：

operator fun String.times(count: Int) = this.repeat(count)

重载了字符串的times（*）运算符和Int的操作，将允许你在任意的字符串上使用*n将该字符串的内容重复n遍，如"a" * 5将得到"aaaaa"。

在扩展函数里可以直接以this来访问该变量本身，上文就是在用this表示字符串的值。

在Kotlin中还有个神秘的运算符叫invoke，实现这个运算符即可将任何对象都当作一个迫真函数来使用，非常离谱。如以下定义：

operator fun String.invoke() = println(this)

将允许你在任意字符串上以"xxx"()（或"xxx".invoke()）的形式直接当成一个迫真函数来进行使用，效果是在控制台输出该字符串本身。

如果你在一个类/接口里面定义一个其他类型的运算符重载，那么这个重载就只在这个类/接口及其子类里面可用，避免外部环境受到污染。

例如我这里在Command和CommandBuilder里重载了String的invoke，使得你可以直接在一个字符串上执行代码，这样就实现了写个字符串就能定义一个命令。并且由于该重载并没有定义在全局上，这种写法只在这个DSL里面可用，不会影响到项目的其他部分。

其实Kotlin的官方文档里也存在类似的写法，在他们的HTML示例里也是通过重载字符串的unaryPlus（+）运算符，使得你可以直接使用+"xxx"的方式直接往HTML元素里添加正文。并且同样由于该重载扩展函数只存在于这个DSL的定义中，这种重载也不会污染到外部环境，可以放心使用。至于为什么最终成品的写法能简化成"xxx" { ... }而不是"xxx"( ... )，这就要看下文的lambda表达式简写了

高阶函数

和Java不同的是，Kotlin提供了强大的函数式编程的支持（Java里的lambda最多算是个SAM（单抽象方法）的语法糖）。在Kotlin里，函数是一等公民。函数不仅可以正常定义和调用，也可以像普通变量一样被存储和传递。如果一个函数的参数里有其他函数，或者说这个函数的返回值也是一个函数，那这个函数就是一个高阶函数。

在Kotlin里，你可以直接声明一个函数类型的变量，写法：

val f : (Int, Int) -> Int = { a, b -> a + b }

以上代码定义了变量f，该变量是一个函数，可以用f(111, 222)的方式直接调用，返回的值是333。

我们可以看到这个函数变量由以下几个部分组成：

类型声明
(Int, Int) -> Int
前面的(Int, Int)表示的是这个函数所接收的参数，这里是接收两个Int。
后面的-> Int表示函数的返回值类型，这里就是返回一个Int。
代码块
{ a, b -> a + b }
这里的a, b就是上面说的函数所接收的参数，后面的a + b就是这个函数具体执行的内容了。

类似{ a, b -> a + b }的这种定义函数的方法有很多名称，例如匿名函数、lambda表达式、箭头函数等。

匿名函数：因为用这种方式定义函数的时候，你没有说明函数的名称（正常情况下定义函数都是需要声明函数名称的），所以用这种写法就是定义了一个没有名字的匿名函数。

lambda表达式：这个名字来源于数学中的λ演算，具体的我也不懂，反正在编程里lambda表达式指的就是用这种方式定义的匿名函数。

箭头函数：顾名思义，在各个编程语言里，定义这种函数往往都需要使用->或=>。

匿名函数的简写

只是使用以上方法还写不出这个DSL，因为按上述定义：

operator fun String.invoke(init: Command.() -> Unit) = Command(this).apply(init).also(commands::add)

，那要调用这个扩展函数应该是这么写的：

"xxx"({
    execute({
        ...
    })
})

那为什么能写成现在这样呢？这就要提到kotlin对于lambda表达式的专用简写了。

匿名函数作为函数的最后一个参数

kotlin规定，当一个匿名函数是函数的最后一个参数时，可以把它挪到小括号外面，所以上文我们可以改成：

"xxx"() {
    execute() {
        ...
    }
}

函数参数仅有单个匿名函数时的小括号省略

kotlin还规定了，当一个函数的参数仅有一个匿名函数时，小括号也可以省略，所以我们还可以改成：

"xxx" {
    execute {
        ...
    }
}

这就已经是成品的样子了。

对于单个参数的匿名函数的变量声明省略

虽然这里没有用到这个特性，但也单独讲一下，当lambda表达式的参数只有一个的时候，这个参数可以省略不写，kotlin会直接将it作为它的名称：

val f : (Int) -> Int = { it * 2 }

这里的it就是那个参数的名字，可以直接在lambda表达式里面使用。

最终原理讲解

讲完上述这些就可以开始讲解这个DSL究竟是如何做到的了。

我们先来逐个看上文的定义：

buildCommand {
    ...
}

有上文基础就能看懂这段在干什么了。很明显，buildCommand是一个函数，接收一个匿名函数作为参数。因此，小括号可以省略，并且能把大括号写到外面，大括号里面的内容就是这个匿名函数的代码了。

回头看一眼buildCommand的定义：

fun buildCommand(init: CommandBuilder.() -> Unit) = CommandBuilder().apply(init).build()

可以看到这个函数接收的参数init是一个针对CommandBuilder的扩展函数，返回类型为Unit，即空。

这个函数的作用就是创建一个CommandBuilder的实例，并调用init初始化它的内容，最后build()得到我们需要的CommandExecutor实例。

这里的apply表示将指定的函数作用于该对象上，这里的效果基本等同于CommandBuilder().init()。

既然init是CommandBuilder的扩展函数，那这个函数的this也就会被赋值为上文的CommandBuilder实例，因此我们可以直接在buildCommand { ... }里使用CommandBuilder的成员实例String.invoke（即上文使用的"xxx" { ... }语法，看到这里就能明白这其实是在调用字符串的invoke运算符操作）了。

接下来我们看看核心部分，String.invoke到底定义了什么：

operator fun String.invoke(init: Command.() -> Unit) = Command(this).apply(init).also(commands::add)

创建一个命令（组），可以看到传递的参数还是一个init，所以依然可以使用kotlin特有的匿名函数简写。后面的代码大同小异，同样是apply(init)，然后附加一个also将定义的命令加到命令列表里。

同样的，由于init是Command的扩展函数，因此也可以直接在里面使用Command类的tabComplete、execute和usage方法，以及定义子命令的同样的String.invoke扩展函数。

最后这几个方法就很简单了，比如execute的函数签名长这样：

fun execute(init: CommandExecuteParams.() -> Unit) {
    execute = init
}

仅仅是将Command内部的execute变量赋值为init。

同样的，由于init是CommandExecuteParams的扩展函数，函数内的this直接指向CommandExecuteParams实例，因此可以直接在里面使用CommandExecuteParams内定义的命令参数而无需单独传递。

总结

以上就是这个迫真命令DSL的实现原理，希望本文能多少让你了解点Kotlin的逆天特性（）

B站前端评论区源码逆向

Mon, 27 Feb 2023 00:00:00 GMT

简介

之前看到一个UP主因为一些原因在视频底下大规模控评，我注意到在控评的评论区下，原本网页端应该每次加载返回20条评论，但实际上要少很多。我就好奇是评论本身后端没有返回还是怎么回事，就打开F12抓了下请求看看，结果发现被标记为隐藏的评论后端也在正常返回数据，只是前端隐藏了。不仅如此，我还发现评论的API还有返回评论者评论时的IP属地，只是前端没有进行渲染。于是我就打算写个脚本来把这些数据显示出来

~~脚本目前已经发布，详见这里~~

以下功能已集成至Bilibili Evolved，请搜索IP属地显示、关注时间显示、相簿发布时间显示等组件

此文就来讲解该脚本的原理

实现原理

以下是该脚本的实现原理讲解

前期准备

API分析

B站网页端每次会请求20条评论，后端的评论API会返回评论的相关信息。评论的详细JSON格式可以参考这个。

以下是一条评论数据的示例

{
  ...
  "invisible": false,
  "reply_control": {
    "max_line": 6,
    "time_desc": "10秒前发布",
    "location": "IP属地：江苏"
  }
  ...
}

根据我和网页上实际显示的评论和后端实际返回的评论比较，我发现前端会检测评论条目对象里的invisible属性，若属性为空时则不会渲染评论本身。除此之外，可以发现reply_control.location属性正是App端显示的IP属地，而网页端并没有对这个属性进行解析。因此，只要能实现对这两个属性进行单独处理，就能实现显示隐藏评论以及在网页端显示IP属地

技术选择

为了实现这些功能多半得直接修改B站的前端JS脚本源码，因为众所周知这年头的打包工具全都会把JS脚本压缩成IIFE运行，变量全都给整成闭包了，根本没法用JS脚本在外部进行操作，所以用TamperMonkey这种在网页上执行用户JS脚本的插件肯定没辙，得想别的办法

幸好我以前凑巧就用过一个能实现这种功能的插件，Header Editor

Header Editor除了修改Header和请求重定向等功能之外，在Firefox里也能使用自定义脚本直接修改响应体，这样就能实现修改源码的功能

不过我经过研究发现Chrome等浏览器貌似不支持这么做，找了几个同类型的插件都说Chrome里无法修改响应体，估计是浏览器本身的限制幸好这类插件的重定向请求等功能在Chrome里也可以用，可以在修改完B站前端的源码后把修改后的文件放到别的CDN上，然后把B站原先的脚本重定向到CDN那里存储的修改后的脚本，这样也能实现一样的效果

最终我选择在GitHub新建一个仓库，并且使用jsDelivr作为CDN直接获取GitHub仓库里的文件，这样就能在非Firefox浏览器里也实现同样的效果

旧版评论区逆向

我是先从网页端旧版界面开始逆向的，先看看网页端的评论元素长什么样

<div class="con ">
  ...
  <div class="info">
    <span class="time-location">
      <span class="reply-time"> xx分钟/小时前 / 评论具体时间 </span>
      <span class="like "> 点赞信息... </span>
      ...
    </span>
  </div>
  ...
</div>

要添加自定义元素，那肯定得先找到是哪段代码创建的这个评论元素。这里的class非常明显，我们可以直接在浏览器的开发者工具里全局搜索time-location、reply-time等样式。以下是我在Firefox开发者工具里搜索的结果

可知脚本来自comment.min.js ~~这个.min.js后面根本不min啊（恼）~~ 。注意这里搜到了两个片段，分别是处理评论主楼和楼中楼回复的，处理的时候两个地方都得改一遍。跳转过去查看代码，我们就会发现这是在创建评论区对应的DOM元素

很明显这是在用字符串拼接的方式直接创建了HTML元素并直接插入到<body>里。但是等等，有没有注意到什么

// item?.reply_control?.location ? `<span class="reply-location">IP属地：${item?.reply_control?.location || ''}</span>` : '',

注释？

是的，你没看错，他们已经把IP属地显示都写好了，仅仅是去掉这行注释就可以直接启用网页端IP属地显示。而且注释里写的样式reply-location也是个确实存在的可用的CSS样式这说明B站早就做好了对应的功能，只是由于某种未知的原因没有把这个功能在网页端上线那这样的话只需要去掉这行注释就能实现IP属地显示了

但我要做的可不止是这个，我要做的还有显示被隐藏评论。另外有人觉得只显示IP属地不够明显，所以我还顺便改了下IP属地的样式（

简单检查下代码可以发现这一段行大致是这样的

var con = [
  ..., 
  '<div class="info">',
  this._createPlatformDom(item.content.plat),
  "<span class=\"time-location\">",
  "<span class=\"reply-time\">".concat(this._formateTime(item.ctime), "</span>"), 
  // item?.reply_control?.location ? `<span class="reply-location">IP属地：${item?.reply_control?.location || ''}</span>` : '',
  ...
]

因此我们可以猜测con数组就是原始HTML片段，只要我们在后面继续加就可以实现添加自己的元素

同时可以注意到这其中用的参数都是item.xxx，比如评论时间是取的item.ctime，评论属地用的是item?.reply_control?.location 因此我们可以猜测item就是评论元素本身，那要检测评论是否被隐藏的话，只要取item.invisible即可判断

所以最终我的处理方法是把

// item?.reply_control?.location ? `<span class="reply-location">IP属地：${item?.reply_control?.location || ''}</span>` : '',

替换成

item?.reply_control?.location ? `<span style="margin-left:5px; color: #0CC;">${item?.reply_control?.location || ''}</span>` : '',
item?.invisible ? '<span style="margin-left: 5px;color: red;">评论被隐藏</span>' : '',

注意IP属地：这几个字在返回的JSON数据里已经加上了，所以这里应该把HTML里的IP属地：这几个字删掉，不然就会重复显示了除了恢复IP属地显示之外，我加了一条判断，如果item.invisible为true就添加一个用来说明评论被隐藏，否则就什么也不添加这样就能在显示评论属地的时候也能标记出隐藏评论了

但是别忘了，前文刚说了

我发现前端会检测评论条目对象里的invisible属性，若属性为空时则不会渲染评论本身

如果元素直接不被创建，在这光拼接HTML也没有用，所以还得把这个判断给整掉但有了之前的经验，要整掉这个判断就很简单了

在该脚本里直接搜索invisible就能发现5段相同的判断

if (item.invisible) {
  return '';
}

明显是在评论被隐藏时不渲染评论那想干掉这个判断就很简单了，直接把判断条件替换成if (false)或者干脆删掉这段代码都行

所以最后在Header Editor里实现个替换脚本就很简单了

return val
  .replaceAll("// item?.reply_control?.location ? `<span class=\"reply-location\">IP属地：${item?.reply_control?.location || ''}</span>` : '',",
    "item?.reply_control?.location ? `<span style=\"margin-left:5px; color: #0CC;\">${item?.reply_control?.location || ''}</span>` : '',item?.invisible ? '<span style=\"margin-left: 5px;color: red;\">评论被隐藏</span>' : '',"
  )
  .replaceAll(
    "item.invisible",
    "false"
  );

这就是网页端旧版评论区逆向的原理了

新版评论区逆向

就在我整完旧版评论区逆向发布脚本后，有群友跟我说不能用，F12抓网络也只能找到个comment-pc-vue.next.js的东西。经我测试发现B站网页端的旧版和新版界面竟然用的不是同一套处理方案，新版的是以vue为基础整的，并且这个comment-pc-vue.next.js虽然名字里没有min但确实是给压缩完了。幸好有前面逆向旧版评论区的经验，我猜测新版评论区也保留了reply-location等一系列和IP属地相关的样式等，所以可以按类似的方法分析

获取js源码

首先要做的自然是获取相关脚本的源码了 B站新版界面前端的源码似乎还处于开发中，大概每隔几天就会重新打包更新一次，这里以2023/3/5的版本为例

源码 Firefox开发者工具格式化后的源码

从https://s1.hdslb.com/bfs/seed/jinkela/commentpc/comment-pc-vue.next.js把脚本下载下来看看

彳亍，这可是真的是.min.js了。不过问题不大，先用Firefox对代码进行格式化并保存后再来找找reply-location看看

// 第44279行
os = {
  key: 0,
  class : 'reply-location'
}

搜索出来能搜出好几个，这里明显能看出这段代码是把reply-location样式给整进变量os里了，那我们来看看os在哪里被引用了

// 44714行
(0, P._) ('div', ts, [
    (0, P._) ('span', rs, (0, kt.toDisplayString) ((null === (a = (0, z.SU) (m)) || void 0 === a ? void 0 : a.last_mtime_text) || (0, z.SU) (lt) ((0, z.SU) (v))), 1),
    (0, z.SU) (f) ? ((0, P.wg) (), (0, P.iD) ('span', os, (0, kt.toDisplayString) ((0, z.SU) (f)), 1)) : (0, P.kq) ('v-if', !0),
    (0, P._) ('span', {
        class : 'reply-like',
        onClick: ke
    }, ...
]),
...

找是找出来了，可是这坨代码是nm啥啊（

先别急，一步步来分析

源码分析

首先我们可以注意到，这段代码里有很多字符串常量，如div、span、reply-like等。再加上我们刚刚找到的os变量，可以合理猜测这里就是在创建评论区对应的DOM元素

再注意一下每行代码的开头

(0, P._)
(0, P._)
(0, z.SU)

不熟悉JavaScript特性的话可能就不知道这段是在整啥，这个其实是在使用JavaScript的逗号表达式，会返回最后一个表达式的值，详见这里

所以这里其实就是等于直接取后面的值，也就是P._和z.SU。在这几个后面直接就跟了括号，所以这里其实就是取P._和z.SU，并把它们当作函数进行调用为什么是P._、z.SU这种鬼畜的变量名？这是打包工具对源码进行压缩的结果，就当作是混淆后的变量名得了。因为是经过打包压缩的代码，所以我们这里就不指望能通过删注释就复原IP属地显示了，我们得自己写一个出来

至于为什么不直接写P._()进行调用，而要写(0, P._) ()这种鬼畜的形式？这是为了改变函数里的this指向，可以看看隔壁的讲解，这里不再赘述

所以这里摆明了就是函数调用，包括后面的(0, P.wg)、(0, P.iD)、(0, kt.toDisplayString)、(0, z.SU)、(0, P.kq)全都是一个意思，都是在进行函数调用而已

接下来尝试分析其中的一行

(0, P._) ('span', rs, (0, kt.toDisplayString) ((null === (a = (0, z.SU) (m)) || void 0 === a ? void 0 : a.last_mtime_text) || (0, z.SU) (lt) ((0, z.SU) (v))), 1),

先别两眼一黑，一步步来我们知道P._就是一个函数，先不管这个函数具体是啥，一个个来看后面的参数

第一个参数'span'很明显就是指的标签

第二个参数rs我们可以查找一下引用，不难发现

// 44276行
rs = {
    class : 'reply-time'
},

好，这个明显就是评论时间标签的样式。注意rs赋值的方法是上述代码，而不是rs = 'reply-time',，所以我们可以猜测rs和上文提到的os都不止是class，而是这个元素的所有属性，包括class

继续看下一个参数

(0, kt.toDisplayString) ((null === (a = (0, z.SU) (m)) || void 0 === a ? void 0 : a.last_mtime_text) || (0, z.SU) (lt) ((0, z.SU) (v)))

？？？别急，还是一步步来

首先，kt.toDisplayString很明显就是个把后面的东西转换成字符串的函数，那我们直接看后面的参数...

(null === (a = (0, z.SU) (m)) || void 0 === a ? void 0 : a.last_mtime_text) || (0, z.SU) (lt) ((0, z.SU) (v))

这nm是啥？

说实话，我逆向到这的时候我也不知道这是个锤子，但后面能看到几个有意义的参数，如(0, z.SU) (m)、a.last_mtime_text、(0, z.SU) (lt) ((0, z.SU) (v))等

前面两个提供不了什么特别有用的信息，来看看第三个(0, z.SU) (lt) ((0, z.SU) (v))

查看一下lt的引用，可以找到它的定义

// 37575行
lt = function (e) {
    var n = Math.floor((new Date).getTime() / 1000) - e,
    ...
    if (n < 60) {
        var v = 10 * Math.floor(n % 60 / 10);
        return v >= 10 ? ''.concat(v, '秒前') : '刚刚'
    }
    if (60 <= n && n < 3600) {
        var f = Math.floor(n / 60);
        return ''.concat(f, '分钟前')
    }
    if (n >= 3600) {
        var A = Math.floor(n / 3600);
        return ''.concat(A, '小时前')
    }
},

一眼顶针，鉴定为根据评论时间计算该显示的字符串所以这个函数的参数e就是后面的(0, z.SU) (v)了

我们来看看v的定义

// 44345行
v = p.replyTime,

这名字怎么看都像是评论的具体时间

因此，这里我们可以简单猜测一下这行代码的作用

P._是创建HTML元素用的函数，它接收三个参数，第一个是字符串类型的元素名称，第二个是元素的各种属性，第三个估计不是innerText就是innerHTML
z.SU是某种取值函数，像是这里的lt和v就是和评论时间相关的函数/变量

（这里其实可以猜测P._就是vue的渲染函数h()，详见这里，可以看到参数类型跟这里的一模一样）

既然得知了这行代码的大致作用，我们可以修改源码输出一下v试试，将(0, z.SU) (lt) ((0, z.SU) (v))直接整成console.log(v)，会发现v就是vue的响应式对象

那(0, z.SU)的作用就很明显了，就是对响应式对象进行.value取值

接下来我们可以看看下一行代码

(0, z.SU) (f) ? ((0, P.wg) (), (0, P.iD) ('span', os, (0, kt.toDisplayString) ((0, z.SU) (f)), 1)) : (0, P.kq) ('v-if', !0),

好，这nm又是什么（

别急，开头的f我们可以先查找下引用，不难发现

// 44346行
f = p.replyLocation,

这很有可能就是没有被显示出来的IP属地后面跟的是一个三元表达式，既然当f为false时显示(0, P.kq) ('v-if', !0)，那就当这段代码是v-if判断得了，结果应该就是不创建元素

所以我们把重点放到前面来，可以看到关键代码

(0, P.iD) ('span', os, (0, kt.toDisplayString) ((0, z.SU) (f)), 1)

(0, P.iD)和前文类似，一眼顶针鉴定为创建元素后面的三个参数一样，os就是刚刚的reply-location，即IP属地的显示样式。后面的(0, z.SU)就是前面说的对响应式对象取值

我当时逆向时是在这里把前面的(f)改成(true)强制让它输出f的内容，结果发现f恒为false

上文提到f = p.replyLocation，那我们看看这个p是怎么回事

// 44343行
p = xt(t),

// 37905行
xt = function (e) {
    var n = (0, P.Fl) ((function () {
        var n;
        return (null === (n = e.value) || void 0 === n ? void 0 : n.rpid) || 0
    })),
    t = (0, P.Fl) ((function () {
        var n;
        return (null === (n = e.value) || void 0 === n ? void 0 : n.root) || 0
    })),

    ...

    return {
        replyId: n,
        rootReplyId: t,
        replyForReplyId: r,
        ...
    }
}

很明显xt就是把评论数据解析成对象的函数，来看其中一个

var n = (0, P.Fl) ((function () {
    var n;
    return (null === (n = e.value) || void 0 === n ? void 0 : n.rpid) || 0
})),

这里就是在解析一个属性了。注意看n.rpid，这个是后端返回的评论原始JSON数据里的一个属性 P.Fl应该就是vue的ref了，因为返回的值是vue的响应式对象，需要我们使用.value才能获取具体的值前面那一段可以猜测是打包工具针对不支持ES6的浏览器写的polyfill，猜测源码应该是使用链判断运算符写的空值判断

let n = ref(e.value?.rpid ?? 0);

因此可以猜测后面每一个x = (0, P.Fl) ...都是在读取一个属性，最后的return就是把这些读取的单个属性拼接成一个对象那我们就来看看最后返回的replyLocation到底是怎么回事

// 38172行
replyLocation: l,

// 37926行
l = (0, P.Fl) ((function () {
    return !1
})),

这里要提一下js的自动类型转换，!1是打包工具对于false的简写，在比较前会自动转换为false，所以!1 === false 所以我们可以合理猜测源码是

let l = ref(false);

合着location是tm固定返回false啊（恼）

我们还有一个功能是标记隐藏评论，这个就在刚刚p = xt(t)的下面，不难发现C = p.invisible，创建新元素的时候判断一下这个C，并查找下C的引用把原先的判断条件全改成false就行了（

现在我们把需要了解的源码都基本上浏览了一遍，可以开始魔改了

源码修改

我们从44716行开始魔改

(0, z.SU) (f) ? ((0, P.wg) (), (0, P.iD) ('span', os, (0, kt.toDisplayString) ((0, z.SU) (f)), 1)) : (0, P.kq) ('v-if', !0),

这一行的作用是创建IP属地显示元素，若存在就显示，不存在就不创建

按照惯例我们先改一下它的样式，把os改成我们自己的{class:"reply-location",style:{color:"#0CC"}}，这样就能在保持原有样式的同时加上我们自己的字体颜色显示了

源码里已经把创建元素都写好了，改的是收到的IP属地的数据，所以我们这里不需要动创建元素这里，直接取改原数据处理那一段接下来我们就需要改f，即replyLocation了

按照上文的分析，replyLocation本身就被设计成固定返回false，我们得直接修改它的值不过按照上文的分析也不难实现，只要把37927行的return !1改成return e.value?.reply_control?.location即可，这样就可以正确处理IP属地了

下一行我们得创建自己的隐藏评论标记元素，已知C是ref(评论是否被隐藏)，P.iD是创建元素，直接照抄上面创建元素的方法即可

(C.value)?((0,P.iD)("span",{style:{marginLeft:"-10px",marginRight:"10px",color:"red"}},(0,kt.toDisplayString)("评论被隐藏"),1)):(0,P.iD)("span",{style:{display:"none"}}),

这里的逻辑是，先取C.value判断评论是否被隐藏，如果是就在IP属地元素后创建个自己的，设置好样式，内容就是"评论被隐藏"，否则就创建个不显示的空元素（我不知道怎么在不创建元素的情况下还不报错，只能这么弄了）

最后别忘了查找对于C的引用并把判断条件改成false

// 44556行
return (0, z.SU) (w) || (0, z.SU) (C) ? (0, P.kq) ('v-if', !0) : ((0, P.wg) (), (0, P.iD) ('div', { ...

直接把(C)改成(false)即可

这样就完成主楼回复内容替换了

但别忘了上文说的，除了主楼之外还有楼中楼也得进行相同的处理，楼中楼对应的样式是sub-reply-location，按和上文完全相同的流程再走一遍即可

通用替换脚本

按以上方法确实可以实现所需的功能，但是没法整出通用替换脚本，因为B站前端新版界面似乎一直在开发，每几天就会重新打包一次，很多的变量名都会改所以得用一些方法在变量名被修改时也能匹配对应的代码

我用的方法是正则表达式配合捕获组虽然匹配的方法有亿点复杂吧（

//主楼invisible变量
let replyInvisible = val.match(/(return\(0,\w+\.\w+\)\(\w\)\|\|\(0,\w+\.\w+\)\()(\w)(\)\?\(0,\w+\.\w+\)\("v-if",!0\):\(\(0,\w\.\w+\)\(\),\(0,\w+\.\w+\)\("div",{key:0,class:"reply)/)?.[2];
//回复楼invisible变量
let subReplyInvisible = val.match(/(return\(0,\w+\.\w+\)\(\w\)\|\|\(0,\w+\.\w+\)\()(\w)(\)\?\(0,\w+\.\w+\)\("v-if",!0\):\(\(0,\w\.\w+\)\(\),\(0,\w+\.\w+\)\("div",{key:0,class:\()/)?.[2];

//隐藏评论恢复显示
val = val
    .replace(`(${replyInvisible})?(0`, "(false)?(0")
    .replace(`(${subReplyInvisible})?(0`, "(false)?(0");

//主楼IP属地样式reply-location
let classReplyLocation = val.match(/(\w\w)={key:0,class:"reply-location"}/)?.[1];
//回复楼IP属地样式sub-reply-location
let classSubReplyLocation = val.match(/(\w\w)={key:0,class:"sub-reply-location"}/)?.[1];

//主楼元素创建匹配正则
let repRegExp = new RegExp(`(\\(0,\\w+\\.\\w+\\)\\(\\w\\)\\?\\(\\(0,\\w+\\.\\w+\\)\\(\\),\\(0,)(\\w+\\.\\w+)(\\)\\("span",)(${classReplyLocation})(,\\(0,)(\\w+)(\\.toDisplayString\\)\\(\\(0,\\w+\\.\\w+\\)\\(\\w\\)\\),1\\)\\):\\(0,\\w+\\.\\w+\\)\\("v-if",!0\\),)`);
//回复楼元素创建匹配正则
let subRepRegExp = new RegExp(`(\\(0,\\w+\\.\\w+\\)\\(\\w\\)\\?\\(\\(0,\\w+\\.\\w+\\)\\(\\),\\(0,)(\\w+\\.\\w+)(\\)\\("span",)(${classSubReplyLocation})(,\\(0,)(\\w+)(\\.toDisplayString\\)\\(\\(0,\\w+\\.\\w+\\)\\(\\w\\)\\),1\\)\\):\\(0,\\w+\\.\\w+\\)\\("v-if",!0\\),)`);

let createElement = val.match(repRegExp)?.[2];
let toDisplayStringVar = val.match(repRegExp)?.[6];

val = val
    .replace(repRegExp,
        //主楼IP属地显示
        '$1$2$3{class:"reply-location",style:{color:"#0CC"}}$5$6$7' +
        //主楼隐藏评论标记
        `(${replyInvisible}.value)?((0,${createElement})("span",{style:{marginLeft:"-10px",marginRight:"10px",color:"red"}},(0,${toDisplayStringVar}.toDisplayString)("该评论被隐藏"),1)):(0,${createElement})("span",{style:{display:"none"}}),`)
    .replace(subRepRegExp,
        //回复楼IP属地显示
        '$1$2$3{class:"sub-reply-location",style:{color:"#0CC"}}$5$6$7' +
        //回复楼隐藏评论标记
        `(${subReplyInvisible}.value)?((0,${createElement})("span",{style:{marginLeft:"-10px",marginRight:"10px",color:"red"}},(0,${toDisplayStringVar}.toDisplayString)("评论被隐藏"),1)):(0,${createElement})("span",{style:{display:"none"}}),`);

val = val
    // location唯一替换，IP属地还原
    .replace(/(\w=\(0,\w+\.\w+\)\(\(function\(\){return)(!1)(}\)\))/, "$1 e.value?.reply_control?.location||false$3");

return val;

正则表达式的相关内容这里不再叙述，这边匹配的原理就是匹配各段代码之间的不同处理逻辑，而不是变量名，变量名会因为打包工具随便更改，所以我直接用的\w+\.\w+进行匹配，但基础的处理逻辑是基本不会改的

提取指定变量我是直接取的捕获组，用括号区分各个捕获组之后再用match进行匹配，可以直接以数组下标的形式把匹配到的内容提取出来用正则表达式替换的时候也可以使用捕获组，在替换的内容里写$n就可以使用第n个捕获组里的文本内容

~~所以这里为了提取各种变量最多甚至用到了多达7个捕获组~~

我是在这里测试这些超级复杂的正则表达式的，这网站甚至会帮你把捕获组标出来，还能测试替换后的结果

个人空间关注/粉丝数查看上限突破+关注时间显示

讲真这里的逆向比刚刚评论区逆向简单得多，我就不（lan）用（de）放图演示了，直接口述吧

首先F12抓包粉丝/关注显示可以发现，get参数里有个ps=20，这个参数就是控制每页显示多少个人的。经测试可以发现最大可以设置为50。由于访问页数还是只有5页，因此针对其他用户，可查看的粉丝/关注数就由原先的5 * 20 = 100个提升为5 * 50 = 250个

既然参数里有ps，那可以合理猜测发起请求时使用了一个包含ps属性的js对象作为参数，简单搜索ps:20即可发现相应的源码，直接查找替换成ps:50即可

至于页数计算，查看源码可知是由Math.ceil(this.curTag.count/50)写死的......

那就直接把/20替换成/50即可

关注时间显示这块，照例直接找关注界面的css class属性，可以很快就找到这部分源码。查看源码可知变量i很可能是粉丝对象本身，配合抓包内容可以猜测i.mtime就是关注时间。模仿前面的创建元素的代码，使用t._v(t._s())即可创建元素。注意对于部分较早期关注的粉丝，关注时间可能是不存在的，因此记得做空值判断

相簿界面发布时间显示

一样开局根据css的class属性直接找相关代码，比如可以直接搜查看次数的图标的classalbum-card__count-icon--view即可直接找到对应代码。同空间相关代码，可以猜测t.item就是每个相簿元素本身，根据抓包结果可以猜测t.item.ctime就是发布时间。模仿上文代码，使用e()即可创建元素。这里要注意，根据前文代码的staticClass，搜索一下可知这是vue的创建元素的参数。如果我们想添加内嵌样式，得使用staticStyle，而这个参数需要传递一个对象。最后，第三个数组就是元素的内部内容，同样仿造前文使用t._v(t._s())传入一个字符串即可创建对应元素，我这直接使用了new Date(t.item.ctime * 1000).toLocaleString()

总结

以上就是本插件的主要原理讲解。由于该插件的原理是直接修改b站的前端源码，因此我能想到的通用方案就只有使用能重定向请求的插件配合CDN实现了。希望以上原理讲解能给你的开发带来或多或少的帮助

BilibiliEnhance - B站功能增强

Fri, 24 Feb 2023 00:00:00 GMT

简介

注：该项目已不再维护，请移步至Bilibili Evolved搜索IP属地显示、关注时间显示、相簿发布时间显示等组件

项目地址：https://github.com/LightQuanta/BilibiliEnhance 使用Header Editor增强b站部分功能

功能列表

在b站网页端显示IP属地
显示被隐藏的评论
关注数/粉丝数列表查看从每页可查看20个增加至50个
关注数/粉丝数列表可查看关注的具体时间
相簿界面可以看到发布的具体时间

效果图

使用教程

下载浏览器插件Header Editor
转到导出和导入界面，链接填写https://cdn.jsdelivr.net/gh/LightQuanta/BilibiliEnhance@1.1.6/BilibiliEnhance.json ，保存至任意分组并启用规则即可

遇到问题请先尝试重新导入最新规则，若还是不行再联系Light_Quanta反馈问题上次更新：2023/5/13 22:08:22

原理

看这里

联动项目

隔壁群u通过直接修改vue属性在新版ui实现的类似功能 unlock-bilibili-PcBrowser-comment 油猴脚本

常见的各种链接都是什么格式——URL科普

Thu, 28 Jul 2022 00:00:00 GMT

平常我们总是能见到各种各样的链接，比如

https://www.bilibili.com/video/BV1GJ411x7h7?mid=114514&p=1&share_from=ugc&share_medium=android&share_plat=android&share_source=COPY&share_tag=s_i&timestamp=1658778647&unique_k=8yqWp46
https://music.163.com/song?id=18520488&userid=1919810
steam://install/1172470

等等。这些链接往往都很长又非常复杂，而且一些链接里还带跟踪参数什么的，有可能会泄露出一些你不想泄露的个人信息。本文将介绍平常见到的各种链接的具体格式，以及如何删除链接中的无用参数和跟踪参数，从而缩短你的链接

URL协议

我们平常看到的各种链接几乎全都是URL格式的。URL的全称是Uniform Resource Locator（统一资源定位符）。在讲解URL之前，我们需要先了解一下为什么我们需要URL。我们在分享链接的时候是在分享什么？一个指定的网络资源的位置。我们通过链接来确定我们要获取的资源的地址，从而让我们的各种软件可以找到我们需要的资源 URL就是一个表示资源地址和获取方法的协议。如同我们描述一个地理位置一样，我们可能会用国家-省-市-区-道路编号这种格式来描述一个地址。当我们表示一个网上的资源的地址的时候，我们也需要一种格式来表示一个地址，这个格式就是URL

URL的格式基本上是这样的

<scheme>://<user>:<password>@<host>:<port>/<url-path>

是不是有亿点复杂？没关系，这个是完整的格式，其中很多参数都是可选的。我们一个个参数来看

scheme：连接地址所需的协议。我们最常见的协议就是http(s)协议。http(s)协议用于访问网页

user@password：这个参数比较少见，是个可选参数，用于在连接时附加用户名和密码，常见的连接里都是没有这个的，知道一下就行

host:port：表示要访问的服务器的地址和端口，常见的连接里也不会写端口，直接就是个host

/url-path：这段就是要访问的文件的具体地址。如果说host指的是要找哪个大楼的话，那url-path就是大楼里的具体门牌号。知道要访问的文件的具体路径才能最终帮助我们找到文件

我们先以http(s)为例

http(s)链接的格式

以这个连接为例 https://www.bilibili.com/video/online.html 我们拆分开来看

https://：表示访问这个连接时要使用访问网页的https协议 www.bilibili.com：表示要访问的服务器的地址，这里是b站的网页服务器的地址

/video/online.html：要访问的文件的具体地址，可以理解成访问的是/video目录下的online.html文件

这就是个简单的连接的基本结构

但是等等，我们平常访问的连接好像没这么简单啊？在url-pattern后面为什么会有个问号？文件名里不是不允许有问号的吗？而且后面还跟了一大堆莫名其妙的参数。这些都是可选的查询参数

查询参数

查询参数可以在你访问你要的文件的时候提供一些额外信息，比如需要的文件格式等。这种参数的基本格式是?参数1=值1&参数2=值2&参数3=值3...

以上文的https://music.163.com/song?id=18520488&userid=1919810为例，这个链接里跟了两个查询参数id和userid，值分别是18520488和1919810。网易云音乐在你访问音乐播放页面的时候访问的连接其实一直都是https://music.163.com/song，具体播放哪首歌由后面的查询参数id=18520488决定, 若不指定则无法播放。后面的userid=1919810并不会影响播放，只是指定分享这首歌的用户的id。

知道了这一点后，我们就可以缩短链接并删除不需要的查询参数了。以https://www.bilibili.com/video/BV1GJ411x7h7?mid=114514&p=1&share_from=ugc&share_medium=android&share_plat=android&share_source=COPY&share_tag=s_i&timestamp=1658778647&unique_k=8yqWp46为例，这个链接长得一匹，后面还跟了一大堆可能会泄露个人信息的跟踪参数。b站的视频是根据BV号来确定的，所以这里的所有跟踪参数对于视频播放都是没有影响的，所以问号及后面的查询参数全都可以安全删除，我们就可以把链接缩短成https://www.bilibili.com/video/BV1GJ411x7h7，一样可以正常播放。

感兴趣的话还可以猜测一下链接后面的一大堆参数的具体作用。简单猜测和分析可知，mid=114514是分享这个链接的用户的b站uid，share_medium=android表示这个用户是通过安卓平台分享的链接，share_source=COPY表示分享方式是复制链接，timestamp=1658778647表示分享这个链接的时间戳，用一些在线时间戳转换网站转换可知这个链接被分享的时间是2022-07-26 03:50:47。因此，删除这些参数除了可以大幅缩短链接长度外，也能防止部分个人信息被泄露出去。

其他类型的URL

其他的URL和http(s)也差不多，都是这种格式，比如steam一键入库APEX的链接是 steam://install/1172470 简单分析可知，协议是steam，访问的路径是install/1172470

邮件发送链接是 mailto:xxx@xxx.com 协议是mailto（部分URL是没有//的），访问的路径（目标邮箱）是xxx@xxx.com

参考文献：rfc1738

哈希算法是什么，它有什么作用

Sat, 23 Jul 2022 00:00:00 GMT

本文的目的是为了让没什么计算机基础的人也能看懂哈希算法的作用，如果觉得有看不懂或写得不对/不好的地方欢迎联系本人，我会修改到尽量让0基础的人也能看懂

什么是哈希算法

Hash算法 有很多的译名，一般被翻译成哈希、散列、杂凑等（本文就称其为哈希），有时也被叫做信息摘要啥的，本意是指"把...弄糟，搞砸" 它的作用也和它的名字类似，给定一个任意长度输入，它能根据输入计算出一个长度确定的值

以一种哈希算法md5举例，如果你输入的内容是114514，那得到的结果（哈希值）就是c4d038b4bed09fdb1471ef51ec3a32cd

如果只是这样的话那这个算法也没啥用，但哈希算法还有几个特性：

对于所有计算出来的哈希值，只要两个哈希值不同，那原输入就一定不同
哈希算法具有雪崩效应，原输入哪怕只改变一点点，那计算出的哈希值都会完全不同
无法直接从算出来的哈希值反推出原先的输入（因为计算的时候会丢失很多信息）

举个例子，以下是几个不同的数的md5值

114514  => c4d038b4bed09fdb1471ef51ec3a32cd
114513  => 77666beaaa7fd86de9b9373ded05db44
11451   => f0eb6568ea114ba6e293f903c34d7488
1145141 => 9e39382c84a52a4b8fe2e594955901c8

发现没有？不管你是改一位数、增加一位数还是删除一位数，最后得到的md5值都完全不同 如果不相信的话可以找个在线计算md5（别的哈希算法也行）的网站试试

正是因为这些特性，哈希算法才能被用于各种用途

哈希算法的各种用途

由于以上的特性，哈希算法可以用来验证原数据是否是某段数据，就像你识别一个人可以观察TA的指纹，而不需要再观测别的信息。因此，哈希算法有着各种各样的用途

文件完整性校验

上文有提到哈希算法对于输入的数值非常敏感，哪怕你只改了一个比特，那得到的结果都会完全不同

因此，假设我们有个网站提供文件A的下载，只要我们把文件A的哈希值计算出来并放在下载按钮旁边，那用户在拿到文件后只需要在本地计算一遍文件的哈希值再和网站上放的哈希值对比，就可以知道下载下来的问题是否有被损坏

注：哈希算法只能保证文件未被修改，不能保证提供者是可信的。如果真想伪造网站的话可以连文件的哈希值也一起伪造

这种校验也被各种程序使用，假如你有个程序能自动下载并安装某模块，为了防止下载下来的模块有问题导致运行出错，可以让服务器提供一下这个模块的哈希值。然后程序就能自动计算下载下来的模块的哈希值，并和服务器提供的哈希值进行比较，如果不一致就表明下载下来的文件有问题。这时候程序就能选择重新下载这个模块，而不是直接用这个模块然后运行时疯狂报错，还打死都找不到是哪出错了

一些网盘之类的文件扫描、文件秒传也是用哈希算法实现的。秒传的原理就是在上传文件前，客户端先把文件的哈希值计算出来并告诉服务器，服务器就去查找是否有存储过对应哈希值的文件，有的话就直接告诉客户端这文件已经存储过了，然后客户端就直接告诉用户文件上传完成，没有的话再去真正地上传文件。违规文件扫描也是这样的，服务器存储违规文件的哈希值，这样客户端上传文件的时候只要文件的哈希值被识别为违规，那上传就会直接被拒绝。这也是为什么一些聊天软件的图片屏蔽也只要改原图的一个像素都可以轻易绕过，因为哈希算法对输入非常敏感，改一个字节算出的哈希值都完全不同。只用哈希算法进行的文件校验都可以通过修改文件内容（哪怕只改一个字）的方法直接绕过

安全存储用户的密码

假设有个网站要存用户的用户名和密码到数据库里，那可以先看看以下几个方案

明文存储

这是最容易想到的思路，但同时这也是最不安全的存储方式，将用户输入的密码原样存进数据库里。为什么这么做不安全？万一网站后台有内鬼，或者因为别的什么原因数据库泄露了，那就直接寄了，别人可以直接用数据库里存的密码登录你网站的任何用户

最关键的是这样不仅会导致你网站的数据全都寄了，而且还会危害使用你网站的所有用户。很多用户喜欢在所有网站都用同一套（或类似的）用户名和密码，你泄露了用户在A网站注册用的用户名和密码，那攻击者拿到后可以拿它们去B、C、D、E、F网站尝试，就算这么做的成功率不是很高，但只要尝试的数量够多，总会有人中招的，因此作为用户也千万别全网都用同一套用户名和密码

对密码进行对称加密后存储

这样做虽说会比明文存储安全（废话），但也是有挺高的风险的

对称加密基本就是指用一个密码加密数据后，你也只能用这个密码来解密数据。但别忘了一件事，进行对称加密所需的密码你肯定也是要找个地方存储的，况且每次验证用户登录你也必须要使用这个密码，因此当数据库泄露后，如果这个密码也被一起泄露了，那一样是白给

存储密码的哈希值

还记得上文所说的哈希算法的特性吗？哈希算法是不可逆的，当你得到一个哈希值的时候，你是没法反推出它的原始值的。这样看上去用密码的哈希值来验证密码就刚好了。我们不存储原始的密码，而是直接存储密码的哈希值。这样验证密码的时候我们也不拿原始密码去对比，而是先计算用户输入的密码的哈希值，再去数据库里对比存储的密码哈希值

这样，我们在不知道原始密码的情况下依然可以验证用户输入的密码，同时由于哈希算法的特性，就算有人得到了数据库里存储的哈希值，他也没法通过哈希值逆推出原先的密码。所以为什么现在的app和网站在你忘记密码的时候都没法告诉你原始密码，只能让你重新设置？因为服务器自己都不知道你原始密码到底是什么，只有密码的哈希值，因此只能让你去重新设置了

这样做既保证了登录验证功能能正常实现，同时也能保证就算数据泄露用户的密码也不会跟着被泄露，看上去这是个完美的解决方案。

是吗？

存储密码的加盐哈希值

虽然哈希算法是不可逆的，但有个攻击方法叫彩虹表

我虽然知道114514的md5值是c4d038b4bed09fdb1471ef51ec3a32cd，但没法用c4d038b4bed09fdb1471ef51ec3a32cd反推出114514，那怎么办？简单，那就自己搞个数据库，在里面存入数据c4d038b4bed09fdb1471ef51ec3a32cd => 114514。既然没法逆推出原始数据，那就生成一堆常见的数据，并把它们的哈希值算出来，再存进我自己这个数据库里，这样下次遇到对应的哈希值就去查自己的数据库就好了。当然，你不可能穷举所有的排列组合并把它们的哈希值都存储起来，因此这个方法也只能破解常见密码的哈希值

那你总不能说我数据库泄露后只能保证密码复杂的人的密码才不会破解吧 ~~（当然你要觉得用简单密码的人都是傻逼，活该密码被破解的话当我没说）~~ ，因此我们可以使用加盐哈希来存储密码

什么是加盐哈希？简单来说就是我们在计算哈希值之前，先对原先的数据进行处理，加上一点"盐"，再去计算加盐后的数据的哈希值

举个例子，p@ssword是个常见密码，它的md5值是90f2c9c53f66540e67349e0ab83d8cd0，你可以在一些md5破解网站（这些网站的原理就是刚刚说的彩虹表）试试看这段md5值，都能直接查询出来

但如果我给p@ssword后面加上TURaWg==再计算md5值呢？那p@sswordTURaWg==的md5值就是17e7c834da0551e8872d77f741b58bbc，和刚刚的值完全不同（别忘了上文说的哈希算法具有雪崩效应，差一个字结果都完全不同），你再去这些破解网站就查不出来了。这样就算泄露了密码哈希值和盐的值，攻击者也必须得重新跑一遍彩虹表才有可能得知用户的密码是否是某些常见密码，要付出极高的时间成本。但假如我给每个用户都加上随机的的盐呢？那攻击者就真要疯了，要是还想暴力破解的话得针对每个用户都去跑个彩虹表，时间成本高到根本无法接受（当然这样依然是有可能跑出简单的密码的，所以别使用常见或简单的密码）

所以，存储用户密码的时候可以这么设计，往数据库里存用户id + 密码的加盐哈希值 + 随机生成的盐，验证用户登录的时候就先读取盐，再把用户输入的密码加上盐之后计算哈希值，最后再和数据库里的加盐哈希值进行比较，这样可以有效避免密码被暴力破解。为了尽量防止密码被暴力破解，还可以换用计算时间所需更久的哈希算法

思考题：盐的内容对暴力破解的难度有影响吗？盐的长度呢？如果我不在密码后面加盐，而是在密码的前面加盐呢？如果我再换别的加盐方式，比如每隔一个字把盐的一个字符穿插在密码中间呢？

数字签名技术

前面说过哈希算法可以用来整文件完整性校验，但不能确保文件的提供者是可信的。不过配合上非对称加密就可以做到这一点，这种技术被称作数字签名。有关数字签名的内容我不打算在这篇文章介绍，涉及的内容比较多，感兴趣的话可以看看其他人的讲解

【软件科普】如何保证发出去的微信和QQ消息不被篡改？详解RSA加密算法

哈希算法的漏洞

哈希算法也并不是无敌的，也存在着一些漏洞

哈希碰撞

正如你可以通过假指纹的方式骗过指纹验证，哈希算法也有办法碰撞（即用不同的输入得到相同的哈希值）

以md5为例，它输出的结果是个32位的16进制数，那就一共有 16^32^ = 340282366920938463463374607431768211456 种可能的排列组合。别的哈希算法的组合可能更多，但本质还是一样的。虽然这个数非常大，但跟哈希算法可能遇到的各种输入，这个数是远远不够的。计算哈希值的时候都会丢失很多的信息。由于鸽笼原理可知，当我们把10个鸽子存进5个笼子的时候，必定有至少一个笼子里有一只以上的鸽子。因此，当数据的排列组合够多的时候，必然也会产生哈希碰撞，即两个不一样的数据能计算出相同的哈希值。举个最简单的例子，md5的输出是32位的16进制数，那你给他输入100位的16进制数的所有排列组合，它一定会生成很多一样的哈希值

其实可以反过来想，如果哈希值不会碰撞，那就表明一个哈希值能对应一个唯一的原数据，那岂不是说我可以直接用个md5值来代替一个1G的电影，然后存储的时候直接存储那个md5，要播放的时候直接根据这个md5计算出电影的原始数据然后直接播放，这样的话你还买硬盘干什么（

哈希碰撞并不是危言耸听，像md5就被爆出了能快速构造出两个md5相同的不同文件的漏洞

结合上文提到的哈希算法的用途，那就有以下的攻击手段

比如文件下载的时候，正常的文件A哈希值是a，但如果攻击者能想办法构造出一个病毒文件B，并让它的哈希值也为a，那就可以欺骗过简单的文件校验，让别人或别的程序以为A和B是同一个文件。因此，在检验哈希值的时候还可以顺便校验下文件的大小，这样可以大幅降低被假的文件欺骗的概率

不过虽然存在哈希碰撞这种攻击手段，但这并不是说哈希算法就一无是处，就能随便生成相同的哈希值了。虽然理论上是一定可以生成哈希值相同的数据的，但实际上要找到这样的数据是极其困难的，哪怕是已经被证明有缺陷的md5也只能生成两个哈希值相同的文件。对于一个给定的md5值，还是没法逆推出原数据或者可以和原数据哈希碰撞的值。而且现在有不少算法至今仍未被找出碰撞案例，例如sha-256、sha-384和sha-512算法。即使是已被证明为不安全的哈希算法，我们仍然可以在对安全性没什么要求的地方继续使用它们进行简单的验证。但在安全性要求高的地方，还是得用安全的哈希算法来进行各种操作

Light_Quanta[2] Bot 使用帮助

Wed, 22 Jun 2022 00:00:00 GMT

前言

Light_Quanta[2] Bot 的所有功能均由 Light_Quanta 本人开发（QQ: 2224899528）

有建议的话欢迎直接跟我提我会尽快回复

~~尽管我感觉很多功能都搞得乱七八糟的~~

:::note bot的大部分功能都可以私聊使用，请不要在群里刷屏，私聊使用还可以无视大多数功能的冷却时间 :::

:::warning

2025-03-18

目前bot暂停自动接收邀请加群请求，如有需求请联系本人 :::

本Bot开源

~~源码可以在这里查看~~

新版Bot源码可以在这里查看

关于好友请求和邀请入群

bot会自动同意所有好友请求以及邀请入群请求，如果需要加bot好友/邀请bot入群无需通知Light_Quanta

若出现加群失败或无视邀请加群请求等现象，请联系Light_Quanta进行处理

bot的绝大多数功能都可以开关，详见下文

若不需要bot可以直接把bot移出群聊，无需联系Light_Quanta，但如果是因为一部分功能过于刷屏，或是只想使用一部分功能的话，烦请参见下文介绍来单独控制各个功能的开关

:::warning[关于指令的示例（重要）]

(xxx) 表示中括号里的内容是必填的 [xxx] 表示中括号里的内容是可选的

输入指令时请

不要输入括号 不要输入括号 不要输入括号

例如对于指令

dice[ adb]

既可以使用 dice 触发，也可以使用 dice 114d514 触发

对于指令

!subscribe (主播的b站uid)

可以使用 !subscribe 1463028352 触发

对于指令

where (osu!用户名) [游戏模式]

可以使用 where Light_Quanta 或 where Light_Quanta std 触发 :::

主要功能列表

启用/禁用bot

以下指令只有管理员、群主以及bot管理员可以使用

输入!enablebot可以在本群启用bot

输入!disablebot可以在本群禁用bot

功能控制

输入!plugins可以查看当前群的Bot各个插件的启用状态

大部分功能是默认启用的

以下指令只有管理员、群主以及bot管理员可以使用

使用以下指令关闭一个功能

!disable (功能名称)

使用以下指令开启一个功能

!enable (功能名称)

使用以下指令重置一个功能的启用状态

!reset (功能名称)

例如，禁用今天看谁的话，输入以下指令即可

!disable DDTool

智能回复

功能名称：IntelligentReply

在群里@bot的账号发送功能调用请求，bot会尝试理解并直接调用指定功能

注：目前仅为部分功能接入了智能回复，若无法用该方式调用请继续参考文档进行手动设置

示例：

@Light_Quanta[2] 发点哈基米图
@Light_Quanta[2] 这个群订阅了哪些主播
@Light_Quanta[2] 现在谁在直播
@Light_Quanta[2] 抽个禁言套餐

Meme

功能名称：Meme

根据发送消息自动随机回复预设内容（不区分大小写）

为避免刷屏，超过500字的回复内容会在发送一分钟后自动撤回

支持全文匹配、正则表达式匹配、正则表达式替换和文本开头匹配

Meme内容只能由Bot管理员进行审核后更新，如果你想提供建议，可以使用以下这些指令

(操作类型)(关键词检测类型) (触发关键词或id)#回复内容1[|回复内容2|回复内容3|...]

其中操作类型可以是add和addgroup，分别表示添加全局可用的回复和添加只在当前群可用的回复

关键词检测类型可以是meme、regexmeme、startswithmeme、regexreplacememe，分别表示全文匹配、正则表达式匹配、开头匹配和正则表达式替换（注：正则表达式替换需要全文匹配）

示例：

addmeme 114#514

会添加一个全局可用的回复，对于114会回复514

addgroupmeme 114#514

会添加一个仅在当前群可用的Meme，对于当前群里发送的114会回复514

addregexmeme \d+#number!

会添加一个全局可用的回复，对于符合正则表达式\d+的内容，回复number!

删除对于指定内容的全部回复

delmeme (触发关键词或id)

若想删除指定关键词的部分回复，可以用和addmeme一样的格式发送delmeme

delmeme (触发关键词或id)#回复内容1[|回复内容2|回复内容3|...]

群管理或群主如果想在群里禁用某些回复，可以使用以下指令

banmeme (触发关键词或id)

示例：

banmeme 来点二次元

需要解封的话，将banmeme换成unbanmeme即可

如果想为关键词添加别名，请使用以下指令

addalias (原触发关键词或id)#(新触发关键词1)[|新触发关键词2|新触发关键词3...]

例如，原本的触发关键词为A，现在想添加两个新触发关键词B和C，使得无论是发送A、B还是C都能触发，可以使用以下指令添加别名

addalias A#B|C

若要修改Meme的其他信息（关键词、检测类型、群黑/白名单等），请使用以下指令

modifymeme (触发关键词或id) (操作类型) (参数)

（建议触发关键词填写id，避免识别错误）

操作类型可选项有:

addwhitelist (添加群白名单)
removewhitelist (移除群白名单)
addblacklist (添加群黑名单)
removeblacklist (移除群黑名单)
rename (重命名Meme)
modifytype (修改检测类型)

检测类型的可选项为equal、regex、regexreplace、startswith，作用请参考前文

如果想查看一个Meme的详细信息（id，触发类型，触发关键词，别名，回复内容等），可以使用以下指令

getmemejson (触发关键词或id)

如果要查找是否存在某一关键词，可以使用以下指令

findmeme (部分关键词或id)

如果想查找某个关键词是否有对应的回复内容，可以使用以下指令

findmeme (完整关键词或id)#(部分回复内容)

如需要指定回复内容，可以私聊bot使用以下指令指定

setrep (完整关键词或id)#(部分回复内容)

恶臭检测

此功能属于无情的接梗机器

当发言满足正则表达式哼哼哼?[,，]? ?啊啊啊+时，自动回复臭死了

定型文

此功能属于无情的接梗机器

自动将指定的名称带入各种定型文

以下内容不一定为最新

用法

定型文 (名称)

输入后会随机发送一篇定型文

如果使用此格式输入可以自定义发送哪篇定型文

定型文n (名称)

其中n为定型文id

目前的定型文有这些（按照id排序）

我忘不掉{str}了。\n如果不是知道了{str}......

我真的想{str}想得要发疯了。我躺在床上会想{str}......

{str}瘾发作最严重的一次，躺在床上，难受的一直刷{str}的录播......

言いたいことがあるんだよ！\nやっぱり{str}はかわいいよ！......

{str}每早七点按时起床叠被子刷牙晨读十分钟诗歌选集......

你知道雪为什么是白色的吗？那是因为它忘记了自己的颜色......

早上为什么睁开眼睛，因为有{str}的起床闹钟在叫我起床......

{str}给我的感觉，就是一切都很甜。她收起了一些感情......

{str}就是白砂糖，香辛料和某种美好的东西组成的女孩子......

最讨厌{str}了\n总是多管我的闲事，人也笨，麻烦......

我好想做{str}的狗啊\n可是{str}说她喜欢的是猫......

{str}卡哇伊哈啊suki{str}我一直都很喜欢{str}......

我忘不了{str}了。那天在咖啡厅里，我们相互交换了联系方式......

每晚都因为思念{str}而难以入眠。\n{str}娇嫩的面孔是那样可爱......

在最美的夜里想{str}，在最深的呼吸中念{str}......

在我眼中{str}是最美的，她拥有所有女孩梦寐以求的东西......

想和{str}去100个城市来99个拥抱看个拥抱看98场日落......

今天打假，我打电话举报说${str}喜欢我，结果人家说我有病......

${str}依然这么可爱。\n什么都没变，是我没跟上她们......

我的手总是忍不住点进billbill。\n总是忍不住在关注动态里寻找着什么......

每当打开${str}的评论区，我就一阵惶恐......

我是${str}周边的一粒微尘，不知何时起......

${str}晚安的一吻，吻在了我的灵魂......

好想和${str}相遇在3月，用她的微笑驱散余寒......

除此之外还有些定型文可以用以下几个指令触发

(名称1)好想做(名称2)的狗啊
(名称1)忘不掉(名称2)了

为防止刷屏，超过200字的定型文会在发送后60秒自动撤回

营销号生成器

此功能属于无情的接梗机器

自动生成营销号文章

用法

营销号 (名称)

苏联笑话生成器

此功能属于无情的接梗机器

自动生成苏联笑话

用法

苏联笑话 (名称)

禁言抽奖

功能名称： Mute

顾名思义，发送禁言抽奖即可抽到时长随机的禁言

具体的禁言时间为1~180分钟，可以参考源代码

自助禁言

功能名称： Mute

顾名思义，可以自助禁言

使用方法（单位：分钟）

自助禁言 (时长)

示例

自助禁言 10

dice骰子

功能名称： Dice

顾名思义，是一个可以自定义面数的骰子，还可以最多同时投掷10个骰子

用法：

dice[ adb]

其中a为一次性投掷的骰子数量，b为面数

如果直接输入dice则默认为1d6

示例：

dice 10d1000

将会投出10个1000面的骰子

今天看谁/现在看谁

功能名称： DDTool

从vtbs.moe记录的管人列表里随机抽取一个管人并展示其简介等基本信息

使用以下指令可以随机抽取一个管人

今天看谁
今天D谁
现在看谁
现在D谁

为防止刷屏，在使用该功能时，每个人将会有五分钟的冷却时间，冷却时间内发送无效

如果是群管或群主的话，可以设置此功能只能抽到指定的用户，输入以下指令即可

!setddtool (目标用户uid)

~~什么强制单推~~

输入!setddtool reset可以解除绑定

数据来源：vtbs.moe

恶臭论证

功能名称： HomoCalc

发送以下指令会生成数字论证

恶臭论证 (要论证的数字)

~~然而这弱智算法生成的算式又臭又长~~

~~之后我再想办法优化~~

来点猫图

功能名称： CatPic

随机获取一张猫图

发送以下内容即可

来点猫猫
来点猫图

数据来源：TheCatApi

警钟

功能名称：Alarm

精确到100纳秒的警钟

在群里发送以下指令即可使用

警钟
警钟长鸣
警钟敲烂

每个群可以绑定多个警钟，以上3个指令只会抽取最新的警钟

要抽取指定警钟，请使用以下指令

警钟(警钟id)

也可以使用以下指令一次性发送所有警钟的内容

编钟

使用以下指令可以获得所有警钟的内容

!getalarm

管理员和群主以及bot管理可以使用以下指令添加和删除警钟

!addalarm (初始时间)|(回复内容)

其中，初始时间的格式应为年-月-日时:分:秒，例如2022-6-24 21:19:07

回复内容里使用{time}可以自动计算当前时间和初始时间的差值，精确到100纳秒

输入以下指令删除所有的警钟

!delalarm

开播通知

功能名称： LiveNotify

在主播开播/下播时自动通知

此功能仅限于b站主播的开播通知，每30s检测一次

使用以下指令查看本群订阅的主播列表

!showsubscribe

使用以下指令查看当前正在直播的主播列表

!live

管理员、群主以及bot管理员可以用以下指令订阅主播（注意id是主播的b站uid，不是直播间号）

!subscribe (主播的b站uid)

使用以下指令取消订阅

!unsubscribe (主播的b站uid)

一个群可以订阅最多300个主播

示例：

!subscribe 1463028352
!subscribe https://space.bilibili.com/1463028352
!subscribe 1463028352(理塘丁真)

也可以一次性订阅或取消订阅多个主播，示例

!subscribe 1463028352 402574397 163637592
!subscribe 1463028352，402574397,163637592
!unsubscribe 1463028352, 402574397 163637592
!unsubscribe https://space.bilibili.com/1463028352, 402574397(孙笑川258)   UID: 163637592

管理员、群主以及bot管理员可以使用以下指令取消订阅当前群订阅的所有主播

!clearsubscribe

直播推送可以更改部分播报相关配置，群成员可以使用!showliveconfig查看群内相关配置

群主和管理员可以使用!liveconfig指令调整推送相关设置，格式如下：

!liveconfig (配置项名称) (操作)

其中配置项名称为：

下播通知
显示直播时长
显示直播间标题
显示直播间封面
显示直播间链接
显示直播分区
直播时通知直播间标题更改
非直播时通知直播间标题更改

注意：显示直播时长需要打开下播通知才可以看到

操作可以是：

启用
禁用
开
关
true
false

等，挑选任意一个有效的即可

以上配置除了非直播时通知直播间标题更改外全都默认启用

注：在把bot移出群聊后，该群聊的订阅信息也会被清空

使用以下指令查看开播通知功能的统计数据

!livestatis