番组开发#1 - 2024-11-16 17:04
唯独惑
[New] 效果预览图
功能
- 获取条目类型
- 支持 所有 条目类型，包含5种 subject 类型以及 character 和 person 类型；
- 目前仅 动画 条目有覆盖性较广的默认设置数据；
- 对条目的制作人员信息 infobox 进行职位的排序与折叠
- 将原本存在的 更多制作人员 一次性按钮改为永久性左右双开关，若不存在则按需添加：
- [New] 为连续的折叠职位的首 / 尾添加该连续职位的展开按钮 + ，并可显示被折叠职位的名称；
- [New] 为展开折叠职位添加动画效果；
- [New] 对新匹配到的职位名称进行记录；
- 对 行数 超过限制的职位人员信息进行二次折叠
- 将作用于不包含副信息（如 别名 ）以外的所有职位信息；
- 可设置为任意正整数；
- [New] 可自定义折叠图标相对于职位名称的位置；
- [New] 同时支持关联制作人员页面内的 infobox 排序，此场景中禁用所有的折叠效果
- 可在 设置 - 隐私 界面进行相关自定义设置（仅在同一浏览器内生效）
- [New] 可选择对历史的匹配记录在设置变更时进行继承；
- 支持使用正则表达式，对职位名称进行匹配；
- [New] 支持对正则表达式自定义匹配优先级；
- 支持将未匹配的职位信息，插入指定位置；
- [New] 支持将二级职位引导信息，插入指定位置；
- 对输入文本具备一定的鲁棒性与自我纠错能力；
- 在部分浏览器中，文本框具备历史完整的 撤销、重做 功能，不会被诸如 保存、恢复默认 等操作阻断
接口
- [New] 提供了一个基于 localStorage 的 共享数据 接口，共享用户当前自定义 / 默认设置的各类型条目的职位顺序，详情说明 #6
- 已联动的组件/脚本：
- [组件] 音乐条目显示各曲目参与制作人员信息
- [组件/脚本] 重置人物作品过滤器布局
<<< 设置前可以阅读 格式说明 #2 ，建议参照其中的 标准格式 >>>
欢迎在评论区分享你 调教的设置～
也欢迎对已有的默认设置提供修改建议
链接
- 超合金组件 v1.4.5-2.2
- Greasy Fork v1.4.5-2.2 墙外
- OpenUserJS v1.4.5-2.2 墙内
版本说明
- 版本号前部表示 程序 版本；
- 版本号后部表示 数据 版本；囊括脚本内存储的默认数据、localStorage 内存储的用户数据
- 当前，红色New 表示 v1.4.5 所更新的内容，橙色New 表示 v1.4.0-1.4.4 所更新的内容;
- 更新日志 #3
待开发功能
- 为更多的条目类型添加更加完备的默认设置数据；
- 优化职位信息的折叠效果
兼容性
- 对于书籍、游戏类型条目已实验性地出现了的 sub_group 二级引导页面以及属其所有的 sub_container 子信息进行特殊处理：
- 禁止 本脚本对其任何方式的折叠与隐藏；
- 允许 将其视为一个整体进行排序，可以二级引导页面的名称（如平台、版本）为关键字进行匹配，或直接以二级引导页面为目标进行插入匹配，可操作的 案例对象；
- 对其样式做了一定的适配优化；
- 考察了其他修改或读取网页 infobox 信息的脚本：
- [组件] 获取条目罗马字标题，完全兼容；
- [组件] 音乐条目显示各曲目参与制作人员信息，完全兼容；
- [组件] 喂shi警告！staff黑名单+高亮，兼容；
- [组件] bangumi书籍外链，兼容；
- [组件] Hyperlink，兼容
相关组件/脚本
- 建议同步开启的组件/脚本：
- [脚本/组件] 代码高亮 / 一键复制，由于本帖后续说明中存在大量的代码块；
- [脚本/组件] 折叠Bangumi，由于本贴后续说明中使用了该脚本的内容折叠功能；
- [组件] 折叠关联条目并展示缩略图，进一步折叠美化条目页面；
- 参考的组件/脚本：
- [组件] bangumi infobox fold 巧妙地使用非常便捷的方法，获取当前条目的类型；
- [脚本/组件] 首页与超展开内容屏蔽 参考了其UI的实现；
- 本组件是原作者 nthrkbrk 的 [脚本] 动画条目staff表职位排序 Plus 版，在此声明感谢；真是感叹...究竟是如何从百来行代码变成上千行的
翻到了 Sai 老板近期有关 infobox 的 发言，后续应该会朝着主次折叠、二级页面功能发展，未来只要主体结构不变...本脚本修修改改还是能用的，如果主站最终替代实现了本脚本的功能，那更好啦～
功能
- 获取条目类型
- 支持 所有 条目类型，包含5种 subject 类型以及 character 和 person 类型；
- 目前仅 动画 条目有覆盖性较广的默认设置数据；
- 对条目的制作人员信息 infobox 进行职位的排序与折叠
- 将原本存在的 更多制作人员 一次性按钮改为永久性左右双开关，若不存在则按需添加：
- [New] 为连续的折叠职位的首 / 尾添加该连续职位的展开按钮 + ，并可显示被折叠职位的名称；
- [New] 为展开折叠职位添加动画效果；
- [New] 对新匹配到的职位名称进行记录；
- 对 行数 超过限制的职位人员信息进行二次折叠
- 将作用于不包含副信息（如 别名 ）以外的所有职位信息；
- 可设置为任意正整数；
- [New] 可自定义折叠图标相对于职位名称的位置；
- [New] 同时支持关联制作人员页面内的 infobox 排序，此场景中禁用所有的折叠效果
- 可在 设置 - 隐私 界面进行相关自定义设置（仅在同一浏览器内生效）
- [New] 可选择对历史的匹配记录在设置变更时进行继承；
- 支持使用正则表达式，对职位名称进行匹配；
- [New] 支持对正则表达式自定义匹配优先级；
- 支持将未匹配的职位信息，插入指定位置；
- [New] 支持将二级职位引导信息，插入指定位置；
- 对输入文本具备一定的鲁棒性与自我纠错能力；
- 在部分浏览器中，文本框具备历史完整的 撤销、重做 功能，不会被诸如 保存、恢复默认 等操作阻断
接口
- [New] 提供了一个基于 localStorage 的 共享数据 接口，共享用户当前自定义 / 默认设置的各类型条目的职位顺序，详情说明 #6
- 已联动的组件/脚本：
- [组件] 音乐条目显示各曲目参与制作人员信息
- [组件/脚本] 重置人物作品过滤器布局
<<< 设置前可以阅读 格式说明 #2 ，建议参照其中的 标准格式 >>>
欢迎在评论区分享你 调教的设置～
也欢迎对已有的默认设置提供修改建议
链接
- 超合金组件 v1.4.5-2.2
- Greasy Fork v1.4.5-2.2 墙外
- OpenUserJS v1.4.5-2.2 墙内
版本说明
- 版本号前部表示 程序 版本；
- 版本号后部表示 数据 版本；囊括脚本内存储的默认数据、localStorage 内存储的用户数据
- 当前，红色New 表示 v1.4.5 所更新的内容，橙色New 表示 v1.4.0-1.4.4 所更新的内容;
- 更新日志 #3
待开发功能
- 为更多的条目类型添加更加完备的默认设置数据；
- 优化职位信息的折叠效果
兼容性
- 对于书籍、游戏类型条目已实验性地出现了的 sub_group 二级引导页面以及属其所有的 sub_container 子信息进行特殊处理：
- 禁止 本脚本对其任何方式的折叠与隐藏；
- 允许 将其视为一个整体进行排序，可以二级引导页面的名称（如平台、版本）为关键字进行匹配，或直接以二级引导页面为目标进行插入匹配，可操作的 案例对象；
- 对其样式做了一定的适配优化；
- 考察了其他修改或读取网页 infobox 信息的脚本：
- [组件] 获取条目罗马字标题，完全兼容；
- [组件] 音乐条目显示各曲目参与制作人员信息，完全兼容；
- [组件] 喂shi警告！staff黑名单+高亮，兼容；
- [组件] bangumi书籍外链，兼容；
- [组件] Hyperlink，兼容
相关组件/脚本
- 建议同步开启的组件/脚本：
- [脚本/组件] 代码高亮 / 一键复制，由于本帖后续说明中存在大量的代码块；
- [脚本/组件] 折叠Bangumi，由于本贴后续说明中使用了该脚本的内容折叠功能；
- [组件] 折叠关联条目并展示缩略图，进一步折叠美化条目页面；
- 参考的组件/脚本：
- [组件] bangumi infobox fold 巧妙地使用非常便捷的方法，获取当前条目的类型；
- [脚本/组件] 首页与超展开内容屏蔽 参考了其UI的实现；
- 本组件是原作者 nthrkbrk 的 [脚本] 动画条目staff表职位排序 Plus 版，在此声明感谢；真是感叹...究竟是如何从百来行代码变成上千行的
翻到了 Sai 老板近期有关 infobox 的 发言，后续应该会朝着主次折叠、二级页面功能发展，未来只要主体结构不变...本脚本修修改改还是能用的，如果主站最终替代实现了本脚本的功能，那更好啦～
顺序
#2 - 2024-11-16 17:05
唯独惑
设置说明 v2025.5.3
跳转至设置界面 设置 - 隐私 - 条目职位排序
[New] 界面预览图
<<< 内容较为冗长繁琐，请按 需 看不见我 阅读与使用 >>>
一 · 二、职位信息高度限制 · 折叠开关图标的位置
对 行数 超过限制的职位人员信息进行二次折叠。
- 将作用于所有类型条目；
- 将作用于不包含副信息（如 别名 ）以外的所有职位信息；准确地说是除了 sub_group 类别与 sub_container 类别以外的信息
- 可开关，并设置为任意正整数；
- 启用后，可在条目界面点击职位信息首部的三角图标或该职位名称，进行内容的展开 / 折叠；
- [New] 自定义该三角图标相对于职位名称的位置，可选择：隐藏、左、右，示意图见 #8-3；
- [New] 不建议设为 1 ，不然可能影响连续的折叠职位的展开按钮的显现。因为当连续的折叠职位的前后元素均被二次折叠时，在其二次折叠未展开的情形下将无法显示该按钮，但不影响通过 更多制作人员 按钮展开。实测当设置大于 1 时，将极大降低此类事件的发生概率；
- 当折叠区域超过视口高度 25% 时，将在展开内容的末尾再提供一个折叠按钮，并为其添加上下文防迷失；
- 下方出现的 折叠 均不是指代职位信息高度限制，而是指被匹配的职位名称的职位信息被整体隐藏。
三、继承历史匹配记录
[New] 将在解析初始化时，对历史匹配记录的职位名称进行继承，并进行预排序。
- 继承数据的来源：来自用户历史浏览条目中的职位匹配记录；
- 继承的触发情景：
1. 用户执行有效的文本内容 保存；
2. 默认设置的数据版本自动 更新；
- 开启后，将提高总体职位排序的速度，并为 共享数据 接口提供更加完备的匹配数据，因此默认开启，也建议开启；
- 在关闭状态下，出现该触发情景，历史匹配记录将被删除；
- 若保持关闭状态，历史匹配记录的生命周期，在继承被触发的前次后次之间；
- 虽为全局配置，但若有需求可以即时性地切换，当作各条目类型的局部配置。
四、各类型条目功能启用状态
控制所在类型条目下的文本内容的功能启用状态。
共有三个挡位：
- 蓝色：启用自定义 / 默认设置的排序与折叠功能；
- 红色：仅启用排序功能，禁用折叠功能；相当于下方文本内容中的所有 true 均失效
- 灰色：禁用设置，但仍可编辑保存，此时将实行网页原有的职位顺序与折叠。相当于下方文本内容中的设置空缺，
- 特殊用法：当文本内容设置空缺，且挡位为红色，此时将实行网页原有的职位顺序，并禁止原有的折叠。（不推荐使用，文本内容设置空缺会导致历史匹配记录被删除）
五、文本内容格式说明
若仅需在 默认设置 的基础上进行 微调，请阅读完毕 非星号* 章节中的 非灰色 内容
再次推荐 [脚本/组件] 折叠Bangumi，由于本贴后续说明中使用了该脚本的内容折叠功能
1. 标准格式
以下将该格式命名为 StaffMapListJSON ，它是以 JSON 格式为基础的。
- 由于设定的数据类型较为复杂，不能通过 split 解析，因此采用了 JSON 格式，由于未使用 对象类型，其实相较简单。但还是不够随心所欲，因此在 2.2 中实现了对 JavaScript 语法的基本兼容；
- 最终在 localStorage 中存储的 StaffMapListJSON 均为规整化后的标准格式 + 2.1.2 中允许的多维数组格式。
StaffMapList 是一个 二维 嵌套数组，同时存储了 职位的顺序、折叠的职位 两者的信息。
[spoiler=* 1.1 基本类型]
而 StaffMapListJSON 就是 StaffMapList 类型的 JSON 格式化字符串。
- string 类型表示职位精确匹配与特殊插入匹配；
- RegExp 类型表示职位正则匹配；
- number 类型表示相关正则匹配的匹配优先级；
- boolean 类型表示相关职位是否被折叠。
[/spoiler]
[spoiler=1.2 职位顺序]
直白地说 StaffMapList 数组内元素的出现顺序，就是其所匹配的职位的顺序。
- 未被匹配的职位们之间，将按原顺序排序；
- sub_group 二级职位引导以及属其所有的 sub_container 子信息将被视为一个整体进行排序，所匹配的关键字为二级职位引导的名称，如平台、版本；
- 被同一个正则表达式所匹配的职位们之间，将按原顺序排序；
- 严格地说，是 StaffMapList 嵌套数组扁平化后的一维数组中元素的顺序。
[/spoiler]
[spoiler=1.3 职位折叠]
所有的职位默认不折叠，当且仅当 StaffMapList 子序列 的 首元素 值为 true 时，使得该子序列内的所有被匹配的职位信息被折叠。例如：
其中，职位顺序就是 A-L 的字母顺序，且只有 I 与 J 两个职位信息被折叠。想要对 G 与 H 进行折叠的想法未被实现，正确的做法应该是：
- 脚本对无效的 true 值不会报错，而是忽略；
- 虽然 false 值表示不折叠，与默认不折叠作用重复，但保留 false 值与其外套的 [ ] 符号可以方便部分场景中进行切换；
- true 值对 sub_group 二级职位引导以及属其所有的 sub_container 子信息的作用无效；
- 对于 2.1.2 规范 StaffMapList 可以是多维嵌套数组，此时当且仅当 true 为数组一级子序列的 最左节点 时，对该子序列内的 所有 元素生效。比如，对于上述例子，可以直接通过下述简单的修改让 A-E 职位被折叠，而不用逐一修改：
[/spoiler]
[spoiler=1.4 插入未被匹配职位]
可以在 StaffMapList 中的任意位置使用以 ‘==’ 这两个字符 开头 的任意字符串，来指示未被匹配的职位信息的插入指定位置。
- 若无该指示，则默认插入到制作人员信息的 末尾 ；
- 若该指示有重复多个，那么仅最后一个指示有效；
- 非最后一个的指示可以充当内容注释；
- 该指示可以与职位折叠功能相配合，例如：其中，假设网页中制作人员信息原本的职位顺序为 A C D E，那么脚本执行后顺序为 A D E C ，同时 D E 职位信息将被折叠。
[/spoiler]
[spoiler=* 1.5 插入二级职位引导]
[New] 可以在 StaffMapList 中的任意位置使用以 ‘>>’ 这两个字符 开头 的任意字符串，来指示 sub_group 二级职位引导以及属其所有的 sub_container 子信息的插入指定位置。
- 若无该指示，则对其实行其他类型的匹配；
- 若有该指示，该匹配的 优先级 大于所有其他类型的匹配；
- 该指示无法被 true 值生效；
- 若该指示有重复多个，那么仅最后一个指示有效；
- 若该指示位于 StaffMapList 的末尾，同时没有插入未被匹配职位的指示，未被匹配职位将插入到二级职位引导之前而非末尾；
- 不建议对不包含二级职位引导的条目类型使用该指示，以免降低匹配排序的性能。如果有一天，动画类型条目也使用了二级职位引导我再来优化吧；
- 功能诞生由来：
1. 由于将插入未被匹配职位功能泛化为了插入匹配，想着那不再加点；
2. 如果仅使用关键字匹配，则无法区分该关键字是存在于普通职位，还是二级职位引导。
[/spoiler]
[spoiler=1.6 默认设置]
首次安装脚本后，将自动启用默认设置的 StaffMapList 。
在满足格式规范的前提下，可自由对默认设置进行元素与序列的移动插入、删除、添加等修改操作，并保存。
- 对于通过移动插入来微调默认设置的职位顺序，最保险的就是移动默认设置中的 整行 内容、或以 方括号 为单元的内容；
- 如果要 单独 移动某一个元素，尤其是 "/文本/" 形式的元素，若近邻该元素前有 数字 元素，请携同一起进行移动。含义见1.8
- 默认设置状态下，设置将随脚本版本更新而改变，若想回溯先前版本的设置，可至 更新日志 找到对应的版本，并手动复制粘贴修改设置；
- [New] 可在设置界面的右上角观察到当前默认设置的数据版本；
- 若修改设置后希望回到默认设置，可先后按下 恢复默认 与 保存 按键；
- 对于 动画 类型的条目，默认设置具有较广的覆盖性。并覆盖了部分国产动画与早期日本动画条目，目前容易未被匹配的职位主要是一些 日语 名称职位。吐槽下国内职位叫得真乱
[/spoiler]
[spoiler=* 1.7 设置空缺]
文本内容若以 空白 形式保存，则会 关闭 脚本的职位排序与折叠功能，但会保留将原本存在的 更多制作人员 一次性按钮改为永久性开关的功能。用户可以通过这种形式，观察网页原有的职位顺序与折叠的职位。
- [New] 不推荐 使用，文本内容设置空缺会导致历史匹配记录被删除，请 改用 ③中滑动开关置为灰色，达成网页原有的职位顺序与折叠职位的效果；
- 空白 具体是指设置 StaffMapList 保存为长度为零的数组。
[/spoiler]
[spoiler=* 1.8 正则表达式]
在 StaffMapList 中，职位名称同时支持 string 类型的 精确匹配 与 JavaScript 格式 RegExp 类型的 正则匹配。同时，为了满足 JSON 格式，正则表达式在文本内容中需以 双引号 包裹才能被正确解析。然而这种必须双引号包裹的格式，在 2.2.1 规范下变为了非必须。例如：其中的正则表达式可以用于匹配机械作画监督、特效作画监督等职位名称。
- [New] 脚本从 1.4.0 版本起，重构了匹配排序的逻辑，使得精确匹配绝对优先于正则匹配，同时降低了正则匹配的开销，使得正则表达式原本的部分使用限制被松解。新的逻辑，将先尝试进行精确匹配，再按序遍历所有的正则式进行正则匹配，并将成功匹配的结果写入缓存，下次可直接用于精确匹配。
[New] 可以为每个正则表达式自定义匹配优先级。优先级为 number 数字类型，数值越小级别越高。优先级需要置于正则表达式之前，才可对该正则表达式作效，且仅能对其作效。同时规定，优先级缺损值为 100。例如：表示该正则表达式三者的优先级数值为 100, 90, 100，表现为优先级 /放送星期/ > /开始|放送|播出/ > /(上|公)映/。
- 当正则表达式优先级数值相同时，顺序靠前的优先级更高；
- 以此将职位顺序与匹配顺序解耦，替代了原先使用否定查找如 x(?!y) 方法所达成的效果，便于维护与扩展，减小了阅读障碍与正则匹配的复杂度。
对正则表达式的使用，提供以下建议：
- 对同一类型的职位作正则匹配时，折叠与次序要求若一致，建议将多个表达式合并为一个，以提高匹配性能；
- [New] 对于过度匹配，只需要防范正则表达式间的匹配冲突，无需再考虑精确匹配；
- [New] 对同一类型的职位，同时使用精确匹配与正则匹配，折叠与次序要求若一致，在不损害语义、不过度匹配的前提下，可以合并为一个正则式，以压缩信息。
[/spoiler]
2. 非标准格式
为了方便内容编写、格式转化，提高用户友好性，提供了非标准格式。
[spoiler=2.1 将被忽略的问题]
以下问题将被忽略，且脚本不会有任何提示。
2.1.1 可省略最外层首尾两端的 ‘[ ]’ 符号
例如以下的文本内容是符合规范的：
而无需写为：
* 2.1.2 StaffMapList 可以是多维嵌套数组
但需注意 true 值的有效性与有效区间，详见 1.3。
[/spoiler]
[spoiler=* 2.2 自动纠正的错误]
以下错误将在保存设置时进行自动纠正，并作提示，详细提示仅控制台可见。
2.2.1 将未被引号包裹的正则表达式以双引号包裹
2.2.2 删除序列末尾元素后的 , 逗号
2.2.3 删除序列首位元素前的 , 逗号
2.2.4 删除连续重复的 , 逗号
2.2.5 将半角单引号替换为半角双引号
至此，不通过自定义解析器，而是一种暴力的方法实现了 StaffMapListJSON 对 JavaScript 语法的基本兼容。
2.2.6 将部分全角符号，包含 ‘’“”，、 替换为相应的半角符号
[/spoiler]
===本楼层请勿回复===
== 本楼层请勿回复 ==
求求你了！不然我只能要挪窝了
设置说明 v2025.5.3
跳转至设置界面 设置 - 隐私 - 条目职位排序
[New] 界面预览图
<<< 内容较为冗长繁琐，请按 需 看不见我 阅读与使用 >>>
一 · 二、职位信息高度限制 · 折叠开关图标的位置
对 行数 超过限制的职位人员信息进行二次折叠。
- 将作用于所有类型条目；
- 将作用于不包含副信息（如 别名 ）以外的所有职位信息；准确地说是除了 sub_group 类别与 sub_container 类别以外的信息
- 可开关，并设置为任意正整数；
- 启用后，可在条目界面点击职位信息首部的三角图标或该职位名称，进行内容的展开 / 折叠；
- [New] 自定义该三角图标相对于职位名称的位置，可选择：隐藏、左、右，示意图见 #8-3；
- [New] 不建议设为 1 ，不然可能影响连续的折叠职位的展开按钮的显现。因为当连续的折叠职位的前后元素均被二次折叠时，在其二次折叠未展开的情形下将无法显示该按钮，但不影响通过 更多制作人员 按钮展开。实测当设置大于 1 时，将极大降低此类事件的发生概率；
- 当折叠区域超过视口高度 25% 时，将在展开内容的末尾再提供一个折叠按钮，并为其添加上下文防迷失；
- 下方出现的 折叠 均不是指代职位信息高度限制，而是指被匹配的职位名称的职位信息被整体隐藏。
三、继承历史匹配记录
[New] 将在解析初始化时，对历史匹配记录的职位名称进行继承，并进行预排序。
- 继承数据的来源：来自用户历史浏览条目中的职位匹配记录；
- 继承的触发情景：
1. 用户执行有效的文本内容 保存；
2. 默认设置的数据版本自动 更新；
- 开启后，将提高总体职位排序的速度，并为 共享数据 接口提供更加完备的匹配数据，因此默认开启，也建议开启；
- 在关闭状态下，出现该触发情景，历史匹配记录将被删除；
- 若保持关闭状态，历史匹配记录的生命周期，在继承被触发的前次后次之间；
- 虽为全局配置，但若有需求可以即时性地切换，当作各条目类型的局部配置。
四、各类型条目功能启用状态
控制所在类型条目下的文本内容的功能启用状态。
共有三个挡位：
- 蓝色：启用自定义 / 默认设置的排序与折叠功能；
- 红色：仅启用排序功能，禁用折叠功能；相当于下方文本内容中的所有 true 均失效
- 灰色：禁用设置，但仍可编辑保存，此时将实行网页原有的职位顺序与折叠。相当于下方文本内容中的设置空缺，
- 特殊用法：当文本内容设置空缺，且挡位为红色，此时将实行网页原有的职位顺序，并禁止原有的折叠。（不推荐使用，文本内容设置空缺会导致历史匹配记录被删除）
五、文本内容格式说明
若仅需在 默认设置 的基础上进行 微调，请阅读完毕 非星号* 章节中的 非灰色 内容
再次推荐 [脚本/组件] 折叠Bangumi，由于本贴后续说明中使用了该脚本的内容折叠功能
1. 标准格式
以下将该格式命名为 StaffMapListJSON ，它是以 JSON 格式为基础的。
- 由于设定的数据类型较为复杂，不能通过 split 解析，因此采用了 JSON 格式，由于未使用 对象类型，其实相较简单。但还是不够随心所欲，因此在 2.2 中实现了对 JavaScript 语法的基本兼容；
- 最终在 localStorage 中存储的 StaffMapListJSON 均为规整化后的标准格式 + 2.1.2 中允许的多维数组格式。
StaffMapList 是一个 二维 嵌套数组，同时存储了 职位的顺序、折叠的职位 两者的信息。
[spoiler=* 1.1 基本类型]
// 可以是字符串或正则表达式
type MatchJob = string | RegExp | number;
// 以MatchJob为单元的二维嵌套数组，其中子序列的首元素还可以是布尔类型
type StaffMapList = Array<MatchJob | [boolean | MatchJob, ...MatchJob[]]>;;
- string 类型表示职位精确匹配与特殊插入匹配；
- RegExp 类型表示职位正则匹配；
- number 类型表示相关正则匹配的匹配优先级；
- boolean 类型表示相关职位是否被折叠。
[/spoiler]
[spoiler=1.2 职位顺序]
直白地说 StaffMapList 数组内元素的出现顺序，就是其所匹配的职位的顺序。
- 未被匹配的职位们之间，将按原顺序排序；
- sub_group 二级职位引导以及属其所有的 sub_container 子信息将被视为一个整体进行排序，所匹配的关键字为二级职位引导的名称，如平台、版本；
- 被同一个正则表达式所匹配的职位们之间，将按原顺序排序；
- 严格地说，是 StaffMapList 嵌套数组扁平化后的一维数组中元素的顺序。
[/spoiler]
[spoiler=1.3 职位折叠]
所有的职位默认不折叠，当且仅当 StaffMapList 子序列 的 首元素 值为 true 时，使得该子序列内的所有被匹配的职位信息被折叠。例如：
[
"A", "B", [false, "C"], [false, "D", "E"],
["F", true, "G"], true, "H",
[true, "I", "J"], ["K", "L"]
]
[
"A", "B", [false, "C"], [false, "D", "E"],
"F", [true, "G"], [true, "H"],
[true, "I", "J"], ["K", "L"]
]
- 虽然 false 值表示不折叠，与默认不折叠作用重复，但保留 false 值与其外套的 [ ] 符号可以方便部分场景中进行切换；
- true 值对 sub_group 二级职位引导以及属其所有的 sub_container 子信息的作用无效；
- 对于 2.1.2 规范 StaffMapList 可以是多维嵌套数组，此时当且仅当 true 为数组一级子序列的 最左节点 时，对该子序列内的 所有 元素生效。比如，对于上述例子，可以直接通过下述简单的修改让 A-E 职位被折叠，而不用逐一修改：
[
[true, "A", "B", [false, "C"], [false, "D", "E"], ],
"F", [true, "G"], [true, "H"],
[true, "I", "J"], ["K", "L"]
]
[/spoiler]
[spoiler=1.4 插入未被匹配职位]
可以在 StaffMapList 中的任意位置使用以 ‘==’ 这两个字符 开头 的任意字符串，来指示未被匹配的职位信息的插入指定位置。
- 若无该指示，则默认插入到制作人员信息的 末尾 ；
- 若该指示有重复多个，那么仅最后一个指示有效；
- 非最后一个的指示可以充当内容注释；
- 该指示可以与职位折叠功能相配合，例如：
["A", "B", [true, "==未被匹配的职位=="], "C"]
[/spoiler]
[spoiler=* 1.5 插入二级职位引导]
[New] 可以在 StaffMapList 中的任意位置使用以 ‘>>’ 这两个字符 开头 的任意字符串，来指示 sub_group 二级职位引导以及属其所有的 sub_container 子信息的插入指定位置。
- 若无该指示，则对其实行其他类型的匹配；
- 若有该指示，该匹配的 优先级 大于所有其他类型的匹配；
- 该指示无法被 true 值生效；
- 若该指示有重复多个，那么仅最后一个指示有效；
- 若该指示位于 StaffMapList 的末尾，同时没有插入未被匹配职位的指示，未被匹配职位将插入到二级职位引导之前而非末尾；
- 不建议对不包含二级职位引导的条目类型使用该指示，以免降低匹配排序的性能。如果有一天，动画类型条目也使用了二级职位引导我再来优化吧；
- 功能诞生由来：
1. 由于将插入未被匹配职位功能泛化为了插入匹配，想着那不再加点；
2. 如果仅使用关键字匹配，则无法区分该关键字是存在于普通职位，还是二级职位引导。
[/spoiler]
[spoiler=1.6 默认设置]
首次安装脚本后，将自动启用默认设置的 StaffMapList 。
在满足格式规范的前提下，可自由对默认设置进行元素与序列的移动插入、删除、添加等修改操作，并保存。
- 对于通过移动插入来微调默认设置的职位顺序，最保险的就是移动默认设置中的 整行 内容、或以 方括号 为单元的内容；
- 如果要 单独 移动某一个元素，尤其是 "/文本/" 形式的元素，若近邻该元素前有 数字 元素，请携同一起进行移动。含义见1.8
- 默认设置状态下，设置将随脚本版本更新而改变，若想回溯先前版本的设置，可至 更新日志 找到对应的版本，并手动复制粘贴修改设置；
- [New] 可在设置界面的右上角观察到当前默认设置的数据版本；
- 若修改设置后希望回到默认设置，可先后按下 恢复默认 与 保存 按键；
- 对于 动画 类型的条目，默认设置具有较广的覆盖性。并覆盖了部分国产动画与早期日本动画条目，目前容易未被匹配的职位主要是一些 日语 名称职位。吐槽下国内职位叫得真乱
[/spoiler]
[spoiler=* 1.7 设置空缺]
文本内容若以 空白 形式保存，则会 关闭 脚本的职位排序与折叠功能，但会保留将原本存在的 更多制作人员 一次性按钮改为永久性开关的功能。用户可以通过这种形式，观察网页原有的职位顺序与折叠的职位。
- [New] 不推荐 使用，文本内容设置空缺会导致历史匹配记录被删除，请 改用 ③中滑动开关置为灰色，达成网页原有的职位顺序与折叠职位的效果；
- 空白 具体是指设置 StaffMapList 保存为长度为零的数组。
[/spoiler]
[spoiler=* 1.8 正则表达式]
在 StaffMapList 中，职位名称同时支持 string 类型的 精确匹配 与 JavaScript 格式 RegExp 类型的 正则匹配。同时，为了满足 JSON 格式，正则表达式在文本内容中需以 双引号 包裹才能被正确解析。然而这种必须双引号包裹的格式，在 2.2.1 规范下变为了非必须。例如：
[
"作画监督", "/.*作画.*(监|导)/"
]
- [New] 脚本从 1.4.0 版本起，重构了匹配排序的逻辑，使得精确匹配绝对优先于正则匹配，同时降低了正则匹配的开销，使得正则表达式原本的部分使用限制被松解。新的逻辑，将先尝试进行精确匹配，再按序遍历所有的正则式进行正则匹配，并将成功匹配的结果写入缓存，下次可直接用于精确匹配。
[New] 可以为每个正则表达式自定义匹配优先级。优先级为 number 数字类型，数值越小级别越高。优先级需要置于正则表达式之前，才可对该正则表达式作效，且仅能对其作效。同时规定，优先级缺损值为 100。例如：
[
"/开始|放送|播出/", 90, "/放送星期/", "/(上|公)映/"
]
- 当正则表达式优先级数值相同时，顺序靠前的优先级更高；
- 以此将职位顺序与匹配顺序解耦，替代了原先使用否定查找如 x(?!y) 方法所达成的效果，便于维护与扩展，减小了阅读障碍与正则匹配的复杂度。
对正则表达式的使用，提供以下建议：
- 对同一类型的职位作正则匹配时，折叠与次序要求若一致，建议将多个表达式合并为一个，以提高匹配性能；
- [New] 对于过度匹配，只需要防范正则表达式间的匹配冲突，无需再考虑精确匹配；
- [New] 对同一类型的职位，同时使用精确匹配与正则匹配，折叠与次序要求若一致，在不损害语义、不过度匹配的前提下，可以合并为一个正则式，以压缩信息。
[/spoiler]
2. 非标准格式
为了方便内容编写、格式转化，提高用户友好性，提供了非标准格式。
[spoiler=2.1 将被忽略的问题]
以下问题将被忽略，且脚本不会有任何提示。
2.1.1 可省略最外层首尾两端的 ‘[ ]’ 符号
例如以下的文本内容是符合规范的：
"A", [false, "B"], [false, "C", "D"], [], "G", [true, "H", "I"], ["J", "K"]
[ "A", [false, "B"], [false, "C", "D"], [], "G", [true, "H", "I"], ["J", "K"] ]
* 2.1.2 StaffMapList 可以是多维嵌套数组
但需注意 true 值的有效性与有效区间，详见 1.3。
[/spoiler]
[spoiler=* 2.2 自动纠正的错误]
以下错误将在保存设置时进行自动纠正，并作提示，详细提示仅控制台可见。
2.2.1 将未被引号包裹的正则表达式以双引号包裹
2.2.2 删除序列末尾元素后的 , 逗号
2.2.3 删除序列首位元素前的 , 逗号
2.2.4 删除连续重复的 , 逗号
2.2.5 将半角单引号替换为半角双引号
至此，不通过自定义解析器，而是一种暴力的方法实现了 StaffMapListJSON 对 JavaScript 语法的基本兼容。
2.2.6 将部分全角符号，包含 ‘’“”，、 替换为相应的半角符号
[/spoiler]
===本楼层请勿回复===
#4 - 2024-11-16 17:16
Hyary
(✩ <ゝω・)
#4-1 - 2024-11-16 17:35
唯独惑
其实本身数据格式很简单很直观...但原本是不支持用户从外部修改，为了能修改，就需要UI...但我不想设计一个复杂的UI，想仅仅通过一个输入文本框来实现...但由于你不知道用户会输入什么？用户也不知道你需要输入什么？所以代码的行数与说明文档的行数才蹭蹭地往上涨了...
#5 - 2024-11-24 15:48
唯独惑
想了想...还是将部分已完善的功能整合出来，先发布一个小版本
正在将一些功能通过对象类型与类进行重构，以便于后续添加其他模块并拓展支持的条目类型
直到代码逻辑部分上千行了才这么做，是不是有点晚了...
正在将一些功能通过对象类型与类进行重构，以便于后续添加其他模块并拓展支持的条目类型
直到代码逻辑部分上千行了才这么做，是不是有点晚了...
#7 - 2024-12-19 18:57
唯独惑
又是一个大版本的更新，又重构了一次代码
本次完全丢弃了之前的匹配排序逻辑，其实先前已经优化了好几次，但都未触及根本
简述下更改前后的变化：
经算法重构，并修改 StaffMapList 的解析数据的结构，诞生了 JobOrderMap
总的解析排序复杂度由原本的 O(k+m+n + nk·T) 变为 O(k+m+n + nk·t + klogk)
借助记忆匹配记录，最高可达到 O(k+m+n + klogk) ，其中：
- k 为 li 元素的个数
- m 为精确匹配规则的数量
- n 为正则匹配规则的数量
- t / T 为正则表达式平均匹配时间
其中的匹配逻辑 nk·T 实现为 for(n+m){for(k not M){T}} ，nk·t 实现为 for(k not M){for(n){t}}，
因此对总复杂度的影响 T >> t，同时借助该循环方式的改变，实现了精确匹配绝对优先于正则匹配
其实更改数据结构后，是意外发现可以记忆匹配记录的...
但此匹配记录记忆和待开发功能中的匹配记录存储、管理与解析稍有不同，我的预期实现如图：
但目前连数据结构都还没设计好，未来也可能要鸽一段时间了
本次完全丢弃了之前的匹配排序逻辑，其实先前已经优化了好几次，但都未触及根本
简述下更改前后的变化：
经算法重构，并修改 StaffMapList 的解析数据的结构，诞生了 JobOrderMap
总的解析排序复杂度由原本的 O(k+m+n + nk·T) 变为 O(k+m+n + nk·t + klogk)
借助记忆匹配记录，最高可达到 O(k+m+n + klogk) ，其中：
- k 为 li 元素的个数
- m 为精确匹配规则的数量
- n 为正则匹配规则的数量
- t / T 为正则表达式平均匹配时间
其中的匹配逻辑 nk·T 实现为 for(n+m){for(k not M){T}} ，nk·t 实现为 for(k not M){for(n){t}}，
因此对总复杂度的影响 T >> t，同时借助该循环方式的改变，实现了精确匹配绝对优先于正则匹配
其实更改数据结构后，是意外发现可以记忆匹配记录的...
但此匹配记录记忆和待开发功能中的匹配记录存储、管理与解析稍有不同，我的预期实现如图：
但目前连数据结构都还没设计好，未来也可能要鸽一段时间了
#8 - 2025-1-8 15:30
Hyary
(✩ <ゝω・)
组件使用感想：三状态切换键好炫酷
一个对UI的主观审美提议：开启职位信息高度限制折叠后，这个「▶」展开按钮会让 infobox 的字段名不再垂直对齐，造成一定程度的强迫症效应
可以考虑把展开按钮移到字段末尾吗？
左侧箭头：现在展开按钮的位置；右侧箭头：字段末尾
一个对UI的主观审美提议：开启职位信息高度限制折叠后，这个「▶」展开按钮会让 infobox 的字段名不再垂直对齐，造成一定程度的强迫症效应
可以考虑把展开按钮移到字段末尾吗？
左侧箭头：现在展开按钮的位置；右侧箭头：字段末尾
#11 - 2025-7-6 17:40
OH_toothache
(小圣杯邀请码: whyjxz14#576501)
虽然但是，我想问一下，你为什么要做成点了更多制作人员然後它就变成更少制作人员了，只是因为这样点起来比较快吗