Add userscript documentation
This commit is contained in:
82
Chaturbate/README.md
Normal file
82
Chaturbate/README.md
Normal file
@@ -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，再调整选择器。
|
||||
31
README.md
Normal file
31
README.md
Normal file
@@ -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 地址，而不是本机调试地址。
|
||||
Reference in New Issue
Block a user