骨碌碌阅读端&创作端功能增强

这是一个面向骨碌碌文字世界的综合增强脚本，覆盖阅读端、作品检索/随机推荐、创作端素材管理三个主要场景。

脚本的目标不是做复杂黑箱推荐，而是把站点已有数据和常见创作/阅读需求整理成更顺手、更透明的工具：能本地同步作品索引、按明确条件检索作品，能优化阅读页面，也能在创作端更快管理图片素材、复合模板和常用颜色。

一、阅读端增强

适用页面：

• https://www.gululu.world/book/*
• https://gululu.world/book/*

1. 目录增强

官方目录通常只显示楼层号，信息量较少。脚本会尝试读取网络请求和页面数据中的楼层小标题，并把目录改造成更接近真正目录的样式：

• 显示楼层号。
• 显示对应楼层小标题。
• 保留点击目录跳转楼层的能力。
• 对没有读取到标题的楼层显示缺省提示。
• 避免把原本标题就是 xxF 的情况误判成无标题。

2. 精确跳转增强

针对带有 floorSort、commentId 的链接，脚本会尽量把页面跳转到更精确的位置。

支持的典型链接形式：

https://www.gululu.world/book/68002?floorSort=19&commentId=2690362

增强效果：

• 优先跳转到评论对应的正文段落。
• 跳转完成后让目标段落闪烁提示。
• 自动尝试打开右侧/侧边评论区。
• 对目标评论也进行闪烁提示。
• 对二级评论、楼中楼回复进行额外查找和展开尝试。
• 如果没有索引到具体段落，会提示“未索引到段落，可能是楼层评论”，并退回到楼层/评论区域定位。

注意：由于站点接口、评论结构和页面加载时机并不总是稳定，评论跳转功能可能偶尔失效。

3. 左侧楼层评论精选

阅读页面左侧会显示一个独立的评论精选区域，不会替代官方评论框。

功能包括：

• 默认开启，可在阅读设置中关闭，避免剧透。
• 展示当前正在阅读楼层的“最多点赞评论”。
• 展示当前正在阅读楼层的“最新评论”。
• 尽量保留父评论与子回复的嵌套结构，不把楼中楼拆散。
• 点击评论可尝试跳转到对应正文段落（有时可能失效）。
• 滚动到新楼层后自动刷新当前楼层评论精选。

4. 楼层交界提示

脚本会在楼层交界处插入更醒目的楼层标题条：

• 展示楼层小标题，而不只是楼层号。
• 帮助读者意识到已经进入新楼层。
• 可在设置中开启“悬浮楼层标题条”模式，默认关闭。

5. 阅读设置入口

脚本会把官方侧边栏中的“举报”按钮改造成更醒目的蓝色齿轮“设置”按钮。

设置中目前包含：

• 自定义阅读背景墙图片。
• 恢复默认背景。
• 调整阅读底纸颜色。
• 调整阅读底纸透明度。
• 选择底纸样式，例如纯色、渐变、纸感等。
• 开启/关闭左侧楼层评论精选。
• 开启/关闭悬浮楼层标题条。

脚本针对背景图和底纸做了防闪烁处理，尽量避免滚动和页面更新时反复重绘。

二、作品检索 / 随机推荐

适用页面：

• https://www.gululu.world/*
• https://gululu.world/*

页面上会出现一个蓝色圆形按钮“作品检索 / 随机推荐”。

1. 可移动入口按钮

• 点击按钮打开检索浮窗。
• 按住按钮右上角的小拖拽点可移动按钮位置。
• 按钮位置会保存到本地。
• 下次打开页面会恢复到上次位置。
• 拖拽会限制在屏幕内，避免按钮被拖出页面。

2. 本地候选池同步

脚本通过公开作品列表接口维护本地作品候选池。

支持：

• 首次手动全量同步。
• 后续手动增量同步到最新。
• 同步进度展示。
• 同步取消。
• 同步失败后保留旧索引，不会清空本地数据。

全量同步会尽量读取公开列表中的全部作品元数据。增量同步会基于上次成功同步时间，向前保留一定重叠窗口，尽量避免漏掉边界更新。

本地保存的主要是作品元数据，例如：

• 作品 ID
• 标题
• 作者
• 封面
• 简介
• 字数
• 楼层数
• 评论数
• 阅读数
• 创建时间
• 更新时间
• 标签信息（如果接口能获取到）

不会下载作品正文、楼层正文或完整评论内容作为候选池。

3. 组合条件检索

检索条件支持更自由的组合逻辑。

可以把不同类型条件组合在同一棵条件树里，例如：

(标题:东方 OR 标签:幻想乡) AND (标题:罗兰 OR 标签:废墟图书馆)

支持字段：

• 任意文本
• 标题
• 作者
• 简介
• Tag

交互方式：

• 输入关键词后按回车生成一个条件标签。
• 多个未合并条件默认按 OR 逻辑处理。
• 可以选择多个条件合并成 AND。
• 可以选择多个条件合并成 OR。
• 已合并条件可以继续参与合并。
• 已合并条件可以拆分。
• 条件可以随时删除。

4. 负向筛选

正向关键词和负向关键词使用相同的条件结构。

可以排除：

• 不想看的标题关键词
• 不想看的作者
• 不想看的简介文本
• 不想看的 Tag
• 任意文本中的关键词

Tag 筛选依赖站点当前可用接口，结果可能不是绝对完备；界面会提示 Tag 可能漏检。

5. 数据筛选

支持按以下数值范围筛选：

• 字数
• 阅读数
• 评论数
• 楼层数

每个范围都可以填写最小值、最大值，也可以只填一侧。

支持时间筛选：

• 发布时间
• 最后更新时间

时间筛选有两种模式：

• 最近一段时间：例如最近几小时、几天、几周、几个月。
• 起止时间：填写开始时间和结束时间。

6. 收藏与历史记录筛选

登录后，如果用户主动选择对应条件，脚本可以请求站点接口读取用户相关列表。

支持：

• 不限收藏。
• 只看收藏。
• 不看收藏。
• 不限历史记录。
• 只看历史记录内作品。
• 不看历史记录内作品。

当选择“只看历史记录”时，会额外显示“最后浏览时间”相关排序因素。

脚本不会把登录令牌写入本地数据库；令牌只在请求站点接口时临时使用。

7. 排序与随机模式

排序模式支持按以下指标排序：

• 更新时间
• 创建/发布时间
• 最后浏览时间
• 字数
• 阅读数
• 评论数
• 楼层数
• 标题
• 作者

也支持升序/降序切换。

随机推送模式不是全库纯随机，而是在满足当前筛选条件的候选列表内随机：

1. 先执行所有筛选条件。
2. 再对匹配结果进行随机打乱。
3. 翻页时保持同一轮随机顺序。
4. 重新执行随机检索时生成新顺序。

8. 结果展示

作品卡片会展示：

• 封面
• 完整标题
• 作者
• 类型
• 发布时间
• 更新时间
• 简介
• 字数
• 阅读数
• 楼层数
• 评论数
• 标签

指标会用颜色区分量级，帮助快速判断作品体量和热度。

作品链接默认在新页面打开。

三、创作端素材台

适用页面：

• https://create.gululu.world/*
• https://www.gululu.world/* 的部分辅助入口

脚本会提供一个“创作素材台”悬浮窗，用于增强创作端图库、图片插入、模板复用和常用颜色管理。

1. 悬浮窗基础能力

• 可以打开/关闭素材台。
• 可以拖拽移动。
• 可以从四周缩放窗口。
• 支持 UI 字体缩放。
• 记住窗口位置和大小。
• 适配移动端基础布局。
• 素材台优先级较高，避免被离线创作台或网页元素盖住。

2. 图库同步

可以从骨碌碌创作端已有图库同步素材到本地索引。

支持：

• 同步官方图库/相册。
• 尽量保留相册结构。
• 同步当前页面中的图片。
• 从剪贴板导入图片到当前相册。
• 手动同步另一个页面的数据快照。
• 保留本地素材索引，减少反复查找。

同步后的图片主要以本地引用方式组织，不会因为加入多个相册就复制多份图片数据。

3. 相册管理

图片素材按“一级相册 + 二级文件夹/二级相册”组织。

支持：

• 创建新相册。
• 重命名相册。
• 相册搜索。
• 当前相册内搜索图片。
• 一级相册拖拽排序。
• 一级相册移至最前。
• 一级相册侧边栏横向拉伸。
• 二级文件夹自由拖拽排序。
• 二级文件夹重命名。
• 二级文件夹删除。
• 回收站：把相册拖入回收站视为移除。
• 未分类相册。
• 最近使用相册。

图片较多的大相册支持滚动触发追加加载，并在加载时显示“正在加载...”。

4. 图片素材操作

每张图片支持：

• 点击图片直接插入正文。
• 复制图片到剪贴板。
• 重命名。
• 缩放生成新图片。
• 从当前相册移除引用。
• 拖拽复制到目标相册。
• 使用次数统计。
• 最近使用自动记录。

图片展示支持：

• 开关图片下方操作按钮。
• 名称显示模式切换：均显示、只显示图片名、只显示相册名、均不显示。
• 图片名过长时只显示前后部分。
• 相册名过长时只显示前后部分。

5. 图片插入模式

图片插入支持全局模式切换：

• 图片模式
• 头像模式

点击图片插入时，会尽量复用创作端原生编辑器格式，避免只是假插入。

对于本地图片，脚本会尽量通过模拟粘贴上传的方式让创作端接管上传流程；如果站点接口返回不完整，脚本会避免把无效图片插入正文。

6. 图片缩放

图片缩放功能支持：

• 按像素缩放。
• 按原图比例缩放。
• 等比例调整。
• 缩放后的图片作为新图片保存，避免复用原图 ID。

7. 复合模板

复合模板用于保存一段可复用的创作内容。

模板可以包含：

• 格式化文本
• 图片
• 多段混排内容
• 原本的排版结构

支持：

• 保存当前选区为模板。
• 点击模板条直接插入正文。
• 模板 hover 高亮。
• 模板重命名。
• 模板删除。
• 模板使用次数统计。
• 模板文件夹管理。
• 模板文件夹拖拽排序。
• 最近使用模板文件夹。
• 导出模板。

注意：模板复用不会复制原始段落 ID。插入时应让编辑器/服务器生成新的段落结构，避免复用旧稿件 ID。

8. 调色盘

调色盘用于快速给创作端正文文字染色。

支持：

• 选择颜色。
• 添加常用颜色。
• 删除颜色。
• 给颜色添加 10 字以内备注。
• 点击颜色按钮后自动应用到当前选中文字。

不再需要额外点击“应用颜色”按钮。

9. 剪贴板导入

素材台支持从剪贴板导入图片。

支持来源：

• 剪贴板中的图片文件。
• 剪贴板中的图片 URL。
• 剪贴板中的 HTML 图片。

导入目标是当前选中的相册/二级相册，不再强制跳转到旧的“剪贴板导入”相册。

10. 配置导入导出

素材台支持完整导出/导入配置，方便备份和迁移。

可导出的内容包括：

• 图片素材索引
• 相册
• 二级文件夹
• 模板
• 模板文件夹
• 调色盘
• UI 配置
• 使用次数统计
• 其它本地配置

导入支持两种模式：

附加模式

默认模式。

• 不删除现有配置。
• 只把导入包中不重复的内容合并进来。
• 可以勾选要接收哪些二级文件夹。
• 可以选择是否接收模板。
• 可以选择是否接收调色盘数据。

覆盖模式

危险模式。

• 会清空原配置，再加载导入配置。
• 开启覆盖模式后无需再选择导入内容。
• 页面会灰色禁用选项并显示警告。

11. 清除数据

提供清除数据按钮，用于清除脚本保存在本地的素材台相关数据。

使用前请先导出备份，避免误删。

四、离线与恢复辅助

项目中还包含一些本地辅助工具，用于应对站点不稳定或浏览器缓存恢复场景。

包括：

• 本地创作台服务脚本。
• 从浏览器 IndexedDB/缓存中恢复创作端素材快照。
• 恢复官方创作端残留草稿。
• 给不懂代码朋友使用的启动/停止脚本和说明。

这些属于附加工具，不是日常在线使用的核心功能。

五、关于作者

脚本由 Canoe 为骨碌碌阅读和创作流程制作增强。

作者信息页中保留：

• 用户名：Canoe
• 骨碌碌 ID：48037
• 代表作入口：脚本内“关于我们”页面可点击跳转

六、数据与隐私说明

脚本主要使用本地浏览器存储：

• IndexedDB
• chrome.storage.local
• 用户脚本存储

可能访问的站点包括：

• www.gululu.world
• gululu.world
• create.gululu.world
• backend.gululu.world
• image.gululu.world

登录相关：

• 收藏/历史筛选仅在用户主动启用对应功能时读取登录状态。
• 创作端上传/同步素材需要用户在创作端保持登录。
• 脚本不会把登录 token 长期保存到本地数据库。

七、已知限制

• 功能依赖骨碌碌当前网页结构和接口，站点改版后可能需要更新脚本。
• Tag 检索依赖站点接口，不保证绝对完整。
• 评论跳转依赖评论数据、段落索引和页面加载时机，有时可能失效。
• 二级评论、楼中楼评论的定位比普通评论更复杂，脚本会尽力查找和展开，但不保证每次成功。
• 图片上传和插入依赖创作端编辑器行为，如果站点接口异常，可能需要刷新页面或重新登录。
• 全库同步会请求较多分页数据，请不要频繁重复全量同步。

八、推荐使用流程

阅读用户

1. 打开作品页面。
2. 使用增强目录查看楼层标题。
3. 在设置中按喜好调整背景和底纸。
4. 如果担心剧透，可以关闭左侧评论精选。
5. 遇到评论链接时，让脚本尝试自动跳转到对应段落。

找作品用户

1. 打开骨碌碌首页或作品页。
2. 点击“作品检索 / 随机推荐”蓝色按钮。
3. 首次使用先全量同步。
4. 设置关键词、作者、Tag、字数、评论数等筛选条件。
5. 使用排序模式或条件内随机模式浏览结果。
6. 后续只需手动点击“同步到最新”维护候选池。

创作者

1. 打开创作端。
2. 打开创作素材台。
3. 同步图库，把官方图库建立成本地素材索引。
4. 按相册/二级文件夹整理高频图片。
5. 把常用文本和图片混排保存为复合模板。
6. 保存常用颜色到调色盘。
7. 定期导出配置备份，或迁移给另一台设备。