diff --git a/Chaturbate/README.md b/Chaturbate/README.md new file mode 100644 index 0000000..3112f1f --- /dev/null +++ b/Chaturbate/README.md @@ -0,0 +1,82 @@ +# Chaturbate 缩略图自定义缩放 + +这个油猴脚本用于自定义调整 Chaturbate 页面中的缩略图和房间卡片尺寸,让首页、关注页、发现页、频道页相关推荐、关注下拉和悬停预览在大屏上更容易浏览。 + +## 安装地址 + +[https://gitea.jackadam.top/jack/Tampermonkey_scripts/raw/branch/main/Chaturbate/chaturbate-thumbnails-custom.user.js](https://gitea.jackadam.top/jack/Tampermonkey_scripts/raw/branch/main/Chaturbate/chaturbate-thumbnails-custom.user.js) + +脚本元信息中的 `@updateURL` 和 `@downloadURL` 都指向上面的 Gitea raw 地址,因此安装后可以通过 Tampermonkey 自动更新。 + +## 主要功能 + +- 自定义放大首页和关注页房间列表。 +- 自定义放大发现页横向轮播区域。 +- 自定义放大频道页“更多这样的直播间”。 +- 自定义放大顶部“关注”下拉弹层中的预览卡片。 +- 修正关注下拉弹层放大后可能超出屏幕左侧的问题。 +- 翻译 `tags` 页面中以 `#` 开头的主题标签。 +- 在页面右下角提供缩放控制面板。 +- 可选自动隐藏频道页直播画面上方的小聊天浮窗。 + +## 页面控制项 + +脚本加载后会在页面右下角显示控制面板: + +| 控制项 | 作用 | +| --- | --- | +| 响应式 | 用于首页、关注页、频道页相关推荐等需要跟随浏览器宽度自动换列的区域。 | +| 固定式 | 用于关注下拉、悬停预览等固定尺寸弹层。 | +| 隐藏聊天窗 | 只隐藏频道页直播画面上方的小聊天浮窗,不隐藏主直播画面。 | +| 恢复原始尺寸 | 将响应式和固定式倍率恢复为 `1.0`。 | + +倍率支持小数点后一位。设置会保存到浏览器 `localStorage`,下次打开页面继续生效。 + +## 放大逻辑 + +脚本尽量保留网站原有响应式布局,只改变尺寸倍率: + +- 响应式列表不固定列数,而是提高卡片的最小宽度,让浏览器按窗口宽度自动决定列数。 +- 缩略图宽高按倍率放大,避免只改宽度导致比例失衡。 +- 卡片整体高度使用自动布局,避免文字区被强行拉高或压扁。 +- 固定弹层只在必要时调整位置,弹层放大后如果超出屏幕左侧,才向右移动到可见范围内。 + +## 适用页面 + +- `https://chaturbate.com/*` +- `https://*.chaturbate.com/*` + +常用中文页面包括: + +- `https://zh-hans.chaturbate.com/` +- `https://zh-hans.chaturbate.com/followed-cams/` +- `https://zh-hans.chaturbate.com/discover/` +- `https://zh-hans.chaturbate.com/tags/` +- `https://zh-hans.chaturbate.com/tags/female/` +- 各主播频道页,例如 `https://zh-hans.chaturbate.com/example_room/` + +## 调试 + +脚本保留控制台调试入口: + +```js +tmThumbScaleDebug() +tmThumbScaleInspectRecommendations() +tmThumbScaleInspectRoomChat() +tmThumbScaleSetScales(1.8, 1.5) +``` + +如果页面布局异常,可以先在控制台执行 `tmThumbScaleDebug()`,查看当前页面识别到的区域、CSS 变量和脚本版本。 + +## 本地验证 + +```powershell +node --check .\Chaturbate\chaturbate-thumbnails-custom.user.js +node .\tests\followed-dropdown-css.test.js +``` + +## 维护注意 + +- 修改脚本名或文件名时,同步更新 `@updateURL`、`@downloadURL`、根目录 README 和测试文件路径。 +- 不要把本机 `127.0.0.1` 调试地址写进 `@updateURL` 或 `@downloadURL`。 +- 若 Chaturbate 页面结构变更,应优先在浏览器中检查真实 DOM,再调整选择器。 diff --git a/README.md b/README.md new file mode 100644 index 0000000..94f25cd --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +# Tampermonkey Scripts + +个人维护的油猴脚本集合。当前主要脚本用于改造 Chaturbate 页面展示,方便在较大屏幕上浏览房间列表、发现页轮播、关注下拉和频道页相关推荐。 + +## 脚本列表 + +| 脚本 | 说明 | 安装 / 更新 | +| --- | --- | --- | +| [Chaturbate 缩略图自定义缩放](./Chaturbate/README.md) | 自定义放大 Chaturbate 缩略图和房间卡片,支持页面控制面板、标签中文化、频道页小聊天窗隐藏。 | [安装地址](https://gitea.jackadam.top/jack/Tampermonkey_scripts/raw/branch/main/Chaturbate/chaturbate-thumbnails-custom.user.js) | + +## 使用方式 + +1. 安装 Tampermonkey 或兼容的用户脚本管理器。 +2. 打开上表中的安装地址。 +3. 在 Tampermonkey 安装页确认安装。 +4. 后续脚本会通过 `@updateURL` 从本仓库自动检查更新。 + +## 开发与测试 + +当前脚本为纯 JavaScript userscript,不需要构建步骤。 + +```powershell +node --check .\Chaturbate\chaturbate-thumbnails-custom.user.js +node .\tests\followed-dropdown-css.test.js +``` + +## 维护约定 + +- 脚本文件放在对应站点目录下。 +- 每个脚本目录应包含自己的 `README.md`,说明功能、安装地址和主要行为。 +- 发布前确认 `@updateURL` 和 `@downloadURL` 指向可公开访问的 raw 地址,而不是本机调试地址。 diff --git a/Readme.md b/Readme.md deleted file mode 100644 index 1f6b905..0000000 --- a/Readme.md +++ /dev/null @@ -1 +0,0 @@ -油猴脚本 \ No newline at end of file