Add userscript documentation

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，再调整选择器。