SaltMCBBS

本条目有待完善，当前内容并不完整。 原因在于：

• 更新日志与开发文档章节没写
• 可能有其他错漏的地方

MCBBS Wiki欢迎您帮助我们完善条目。

SaltMCBBS
软件信息
名称	SaltMCBBS
作者	Salt_lovely
语言	简体中文
最新版本	0.1.8.2
开源	GitHub
编写语言	TypeScript、SCSS
运行环境	油猴脚本等用户脚本管理器插件
许可证	CC BY-NC-SA 4.0
查看MCBBS上的发布帖

SaltMCBBS（中文名“加盐的MCBBS”）是一个MCBBS样式优化与功能拓展脚本。

简介

SaltMCBBS（中文名“加盐的MCBBS”）是一个完全开源的MCBBS用户脚本，主要目标是解决MCBBS日常使用时的一些小问题，优化论坛使用体验。

SaltMCBBS的耗时模块均异步启用，一般不会使页面加载产生肉眼可见延迟；设计上遵循非必要无日志原则，正常加载时控制台上只有3条信息（SaltMCBBS信息、初始化耗时、主模块耗时）——例外情况是：反探针模块与图片懒加载模块、图片代理模块可能会产生大量的日志。

SaltMCBBS卖点之一（也是写这个脚本的最初计划）是夜间模式，一键切换MCBBS进入适合夜间阅读的暗色风格；夜间模式的SCSS代码编译前就有约1300行（含注释），覆盖了大部分论坛页面。

使用说明

安装

方法一：在greasyfork网站点击安装即可。

新版的SaltMCBBS（0.1.9开始）不再支持v2版本的论坛前端，因此还在使用v2论坛皮肤的坛友需要通过方法二来获取0.1.8的后续更新。

方法二：从GitHub下载最新版本，手动粘贴到浏览器的脚本管理扩展面板里。

配置

• 默认启用左侧栏代替顶栏，可以在设置中调整。
• 设置面板入口在左侧栏底部，同一位置还有切换夜间模式按钮和使用表情包按钮。
• 绝大多数配置的修改立即生效无需刷新，但是页面间不会自动同步，需要手动刷新。

控制台

同时按下ctrl+`（Tab上面的那个反引号键）可以呼出控制台。

输入help后按下enter（回车键），可以看到当前版本SaltMCBBS可用的所有指令；使用help <指令名>可以看到某个指令的使用帮助。

控制框内若想正常换行，请同时按下shift和enter（回车键）。

常用指令列表如下：

指令	说明	指令	说明
gid <数字>	前往对应gid的大区	fid <数字/版块别名>	前往对应fid的版块
tid <数字>	前往对应tid的主题帖	pid <数字>	前往对应pid的回复帖
uid <数字>	前往对应uid的用户主页	uname <用户名>	前往对应用户名的用户主页
eval <JS代码	执行JS代码这个功能好鸡肋啊	cls	控制台清屏

功能

主要功能

压缩页面顶部空间相关功能
这部分主要是尽量压缩顶部内容较少的部分，在用户看第一眼的时候，尽可能多地展示主要内容。 1. 将顶部栏变为左侧栏，压缩顶部空间。 2. 压缩MCBBS Logo与广告栏的上下边距，同时提供屏蔽这两个元素的设置项。

一键切换夜间模式
夜间模式一键切换，同时可以在页面间同步——这个页面切换为夜间模式了，其他页面也会变成夜间模式（反之亦然）。

更改背景图片
你可以在配置栏中填入多个URL，SaltMCBBS会随机选择一张图片显示——你也可以直接填入随机图片API。 正常模式与夜间模式下的背景图片是分开控制的。 你也可以控制鼠标尚在页面中，和鼠标离开网页后，页面主体部分的不透明度。

自定义正则表达式来检测水帖
你可以自己写正则表达式来匹配水帖。 你写入的正则表达式会储存在indexeDB中，无需担心写得太多占用其他脚本的数据存储空间。 匹配过程异步进行，一般不会导致页面出现明显卡顿；匹配到水帖后将会显示在页面右下角。 点击气泡即可直达对应楼层。

简易的控制台
你可以使用Ctrl + `快捷键或设置面板顶栏的入口呼出控制台。 使用help查看所有可用指令；使用help <指令名>来查看某个指令的用法。

表情包使用与管理系统
支持所见即所得模式，支持自定义表情图片大小（每张图都可以定一个大小）。 这里有一个比较大的GIF图，点进去看的话，请注意流量

其他功能

1. 自定义举报与评分理由。
   1. 预览图。
   2. 修改后无需刷新页面，但是需要重新打开举报/评分面板。
   3. 与其他多行配置一样，在开头添加“//”即可暂时禁用这一项。
2. 勋章栏样式美化与交互性优化。（会被MCBBSExtender覆盖）
   1. 特别的勋章栏样式。
   2. 交互性强的勋章栏高度控制功能。
   3. 有一个无法解决的冲突，见#脚本冲突章节。
3. 识别并处理防盗链图床5个与无法访问图床2个。
   1. 反防盗链：微博图床、QQ空间图床、贴吧图床、B站图床、百度图床。
   2. 自动代理：imgur图床、uploadcc图床。
   3. 你可以到这个帖子测试一下。
4. 更加现代化的图片懒加载方式。
   1. 可能被MCBBS自带的懒加载顶掉。
5. 帖子分类高亮。
   1. 默认情况下的高亮。
   2. 你可以使用CSS来自定义帖子高亮模式、样式。
6. 反探针功能。
   1. 检测并处理的探针会显示在右下角，这个烦人的提示可以关掉。
7. 层主信息栏跟随页面滚动。
8. 层主信息栏部分内容可以自定义了。（将在0.1.8.3版本实装）
   1. 可以自定义显示的积分/主题等信息。（MCBBS默认显示“金粒、宝石、贡献、爱心”）
   2. 目前最多可以显示这些内容：积分,帖子,主题,精华,金粒,宝石,贡献,爱心,钻石,人气,下界之星,最后登录,注册时间。
9. 控制签名栏高度。
   1. 更改高度的签名栏将出现滚动条。
   2. 小于0禁用此功能，设为0屏蔽签名栏。
10. 一些小小的文本框可以拉大。
11. 透明显示被警告的帖子。（默认开启，被发卡或扣分的帖子将变得半透明且不易看清、不易注意到）
12. 代码栏样式优化。（兼容模式下覆盖MCBBS Extender）
13. 强制使用H5播放器与阻止自动播放音乐。（仅对网易外链播放器有效）

特点

• 大模块异步加载，几乎不产生肉眼可见的加载卡顿。
• 部分数据储存在indexedDB中，为其他脚本节省localStorage空间。
• 提供了localStorage与indexedDB的简单封装，可以用于二次开发。

已知漏洞

1. 懒加载功能可能被MCBBS自带的懒加载顶掉部分图片。没有修复计划。
2. 于火狐浏览器上运行时，会将所见即所得编辑框视为新页面，写入内容。 于0.1.8修复
3. 代码栏优化样式导致行号错位，同时代码栏复制功能会复制行号进去。 于0.1.8.2修复
4. 禁止网易云外链播放器自动播放功能无效。 将于0.1.8.3修复

脚本冲突

1. 与MCBBS Extender的冲突：
   1. 展开/收起勋章栏功能失效：当两个脚本均开启勋章栏功能，且MCBBS Extender的勋章栏高度控制功能未启用（即设为-1）时触发。

借物表

• MCBBS Extender（作者：Zapic）
  • 仿写了查看警告记录功能的代码。
• You-need-to-know-css
  • 仿写了Custom switch selector代码，原工程为CSS代码，仿写为SCSS代码。

灵感与创意来源

• MCBBS Extender（作者：Zapic）
  • 勋章样式功能，功能继承自“盐的MCBBS样式”。
  • 回到顶部按钮的动画。
  • 强制网易云外链播放器使用H5播放器，与禁止外链播放器自动播放功能。
• 极光creeper的未开源脚本和快乐小方的表情包管理脚本。
  • 表情包功能。
• 绵羊的未开源脚本
  • 控制台工具。

你知道吗

• 盐酱最开始写这个脚本的时候，其实只是想写一个可以切换夜间模式、添加“查看警告记录”按钮的脚本，顺便学一下TypeScript。
• 这个脚本有许多功能、CSS代码继承自盐酱的另一个作品盐的MCBBS样式（纯CSS）。
• 脚本的LOGO使用U钙网（uugai.com）工具制作，有二次加工且字体为非商用字体。
• 脚本代码使用的许可证是 CC BY-NC-SA 4.0 这个一般不用于代码的许可证。