基于 ordureconnoisseur/binge v0.4.0 的中文汉化 + 功能修复分支。当前版本 v0.5.7。
为 Stash 提供的 Instagram 风格社交与发现层：竖屏 Reel、Stories、演员档案、StashDB 驱动的发现功能——全部基于 Stash 既有的 GraphQL API。Web 插件形态。
- 竖屏 Reel — 滑动浏览场景，双击点赞，操作栈（评分、多视图、Scribe、保存、⋯）。
- 首页 Stories + Feed — IG 风格的演员 Stories 行（库内 + StashDB + 可选 Reddit）位于分页场景流上方。批量导入折叠为单个 Pack 卡片。
- 演员档案 — 简介、统计、场景网格、图库网格、社交链接条（Twitter / Instagram / TikTok / Reddit / OnlyFans / Fansly 品牌图标）。库内 + StashDB-only 变体共享布局。
- StashDB 发现 — 首页的 DISCOVER + TRENDING 卡片；关注演员 + 添加你尚未拥有的场景。
- 移动优先 — 底部导航、悬停卡片迷你档案、演员
@mention链接。触屏 + 桌面端一致体验。
- 全部用户可见 UI 字符串翻译为中文（导航、按钮、状态、设置、演员信息、场景信息、错误提示等）
- 日期格式：
YYYY年M月D日（如2024年2月28日） - 相对时间：
刚刚/X分钟前/X小时前/X天前/X周/X个月/X年 - 排序选项：
最近/最多播放/最多高潮/最高评分/最近添加等 - 评分维度：
总体/默契度/美感/制作质量/创意/外形/表现等 - 品牌名保持英文：Stash、StashDB、Reddit、X (Twitter)、PornHub、Cookie、forage、binge-server、HLS、MP4、WebM
v0.4.17 将原硬编码中文迁移为基于 react-i18next 的动态多语言架构：
- 中英双语：内置中文（
zh）和英文（en）两套翻译资源，默认中文，可在设置页切换语言，无需刷新 - 242 个翻译键：按功能域分组，支持
{{interpolation}}插值 - 语言偏好持久化：
localStoragekeybinge.language - 详见 汉化及修复.md
- 合并上游 v0.5.0–v0.5.5（25 个提交，125 文件，+10848/-4909 行）
- Stash 写入容错：
flattenSceneNodes/mapGalleryNodes对paths/cover?.paths/performers加 null guard，部分写入不再让整个 feed 崩溃 - StashDB 缓存健壮性：
readStashDBCache加Array.isArray校验 +age<0防时钟回退 +pruneOldCacheVersions清旧版本缓存避免 quota 溢出 - 保存过滤器修复：
transformObjectFilter对StashIDCriterionInput等无 value 字段的 criterion 不再发送value，修复"近期到达"等过滤器返回空 - 评分四舍五入对齐：
rating100改用 round-half-to-even 匹配 Python 插件，解决预览与实际存储值不一致 - IPv6 安全检查：
isPrivateIPv6()检查，公网 IPv6 daemon 不再传 API key 明文 - 详情卡片滚动：sheet 加
overflow-y: auto，窄屏可滚动查看完整技术信息 - 详情卡片 handle 始终可见：sticky 顶部，与其他 sheet 一致
- 社交 tab 重试按钮：error/empty 态末尾加
⟳ 重试按钮，覆盖网络瞬时失败场景
- StashDB 网络降级：
postStashDB加超时（Stories/Feed 10s、发现页头像 20s）+ 12h 缓存 + 刷新按钮联动清缓存，断网时快速降级不再卡死 - 全屏体验：操作栈全屏按钮、UI 3 秒自动隐藏、水平滑动快进快退、长按 2× 倍速；进入前固定 height 防止 virtualizer 卸载，退出时等
orientationchange完成再scrollToIndex - 移动端容器高度：
100dvh+estimateSize用clientHeight，解决 mobile Chrome 地址栏遮挡 - 字幕：自动加载 Stash sidecar
.srt/.vtt，text-shadow描边替代黑底，位置随object-fit:contain内容区，字体随视频宽度缩放 - binge-server 集成：API Key 认证（query param）、URL 派生、一键安装（docker 优先）、cookies.txt 导入
- UI 细节：移动端地址栏背景色、回到顶部按钮、Stories 头像缩小、顶部导航放大、Lightbox 箭头描边、设置页 max-width 1100px、窄屏断点统一 720px
- 移除 demo 模式 + 隐藏标签：清理 459 行 demoContent +
HIDDEN_TAG_IDS - 导航按钮改用 PluginApi.patch：SPA 重渲染无需重注入，可在 Stash 设置勾选显隐
- 演员分页放宽：
PAGE_SIZE24→60 - 锁定 Prettier 配置：
.prettierrc.json+.prettierignore
- i18n 多语言架构（react-i18next，中英双语，设置页切换）
- 补全 242 个翻译键 + 硬编码中文迁移为
t()调用 - 移除 681 处 fallback 字符串（bundle −17KB）
- 首页图库卡片精简（DOM 简化，−28 行）
- Stash 标签语言联动（切换语言后手动同步标签名）
- 修复演员"又名"不显示别名（
{{aliases}}占位符丢失） - 修复 binge.yml 版本号未同步（Stash 显示旧版本号）
- 修复极窄屏幕下演员详情页影片每行仅显示 1 部（≤380px 强制最少 2 列）
- 修复设置页极窄屏幕排版（≤480px 控件下移、输入框占满宽度）
- README 重排序 + 功能修复大幅精简
- X tab：视频就地播放、保存到 Stash、Referer 403 修复（blob URL 代理）、下载进度条
- 输入法：合成阶段预输入误存 + 确认后保存修复
- 转码：AVI/WMV 快进修复、自动转码不兼容容器
- 封面布局：多处右对齐、3:4/4:3 自适应、图库卡片比例调整
- 合集：默认合集自动创建、tagName 中文化、卡片图标 + 删除保护
- 搜索：历史持久化、输入法兼容
- 播放：自动播放修复、进度条 seek 竞态、静音按钮失效
- 主题：refract 白底白字修复、favicon 主题自适应
- 导航：首页/发现页跳转修复
完整修复记录详见 汉化及修复.md。
所有修改在 TypeScript 源码级别完成（非压缩 JS 补丁），具体见 汉化及修复.md。
- 前往 Releases 页面
- 下载最新版本的
binge-vX.Y.Z.zip - 解压到 Stash 插件目录（zip 内文件直接放在 binge 目录下）：
- Windows:
%USERPROFILE%\.stash\plugins\binge\ - Linux/macOS:
~/.stash/plugins/binge/
- Windows:
- Stash → 设置 → 插件 → 重新加载插件
在 Stash → 设置 → 插件 → 可用插件 → 添加源 中添加以下任一 URL：
推荐（GitHub Pages，需启用 Pages）：
https://k6cc.github.io/stash-plugins/plugins/main/index.yml
备用（raw URL，无需启用 Pages，立即可用）：
https://raw.githubusercontent.com/k6cc/stash-plugins/main/plugins/main/index.yml
启用 Pages 步骤：stash-plugins 仓库 → Settings → Pages → Source:
Deploy from a branch→ Branch:main/(root)→ Save。等待 1-2 分钟后k6cc.github.io/stash-plugins/即可访问。
此 URL 是统一插件源，同时包含 Binge、nfoSceneParser、sceneTranslate 等多个插件，可一并安装。
然后从列表中安装 Binge。Stash 主导航栏会出现一个无穷符号按钮——点击即可。
unzip binge-vX.Y.Z.zip -d ~/.stash/plugins/binge/
# 然后：Stash → 设置 → 插件 → 重新加载插件偏好设置存储在 localStorage 的 binge.* 命名空间下——不会修改 Stash 自身的配置。
打开 binge → ⋯ → 设置（桌面端）或 菜单 → 设置（移动端）。
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 显示性别 | 全部 | 五个开关。驱动发现流 + 发现演员行。 |
| 流媒体类型 | 自动 | 自动 / 直连 / MP4 / WebM / HLS |
| 在动态中显示图库 | 开 | 在首页混入图库 |
| 近期窗口 | 30 天 | "新"的回溯范围。7 / 14 / 30 / 60 / 90 / 180 / 365 |
| 在故事中包含 StashDB 新发布 | 开 | 无 StashDB API 密钥时无效。 |
| 场景混入演员档案 | 关 | 也可在档案场景标题处通过 pill 切换 |
| 在故事中包含 Reddit 帖子 | 开 | 需要 binge-server 可达（否则静默跳过） |
| binge-server URL | http://localhost:7878 |
远程时覆盖 |
| binge-server 配置 | — | 自动检测 Stash API 密钥 + 接受 Reddit cookie。仅在 binge-server 可达时可见。 |
| 跟随 refract 强调色 | 关 | 将 refract 的强调色调色板镜像到 binge |
| 自动滚动 | 关 | 当前场景结束时前进到下一个（reel ⋯ 菜单） |
| 显示调试覆盖层 | 关 | 每个幻灯片的调试 HUD；reel 中按 \ 热键 |
运行时检测——按需安装任一；binge 在缺失时优雅降级。
| 插件 | 增加的功能 |
|---|---|
| Refract | 将 binge 的强调色调整为匹配你的 refract 调色板（可选开关） |
| stash-multiview | 操作栈中的 4 格网格按钮——点击排队，长按打开 |
| stash-advanced-rating | Reel + 档案中的按维度 0–5 评分模态框 |
| stash-scribe | Scribe 铅笔 → LLM 驱动的评价撰写 |
| binge-server | Stories 行中的 Reddit 帖子（独立的 Go 守护进程） |
- Vite + React 19 + TypeScript 打包为单文件 SPA（
dist/index.html），由 Stash 从/plugin/binge/assets/index.html提供。binge.entry.js注入导航按钮。 - 所有 Stash 数据通过 GraphQL（
/graphql，同源 cookie 认证）。binge 自身后端。 - StashDB 直连 — 使用用户的 API 密钥查询
https://stashdb.org/graphql（从 Stash 的 stashbox 配置读取）。12 小时 localStorage 缓存。 - 哈希路由 —
#/home、#/foryou、#/explore、#/following、#/saved、#/settings、#/menu、#/p/<id>、#/sdbp/<id>。支持直接深链 + 浏览器后退。 - 运行时插件检测 — ASR / scribe / multiview / refract 在启动时查询，通过 React Context 门控。
git clone https://github.com/k6cc/binge-cn.git
cd binge-cn
npm install
npm run dev # Vite 开发（仅 SPA — 无 Stash 数据）
npm run build # 产出 dist/index.html技术栈：Vite · React 19 · TypeScript · TanStack Virtual（Reel 虚拟化）。
scripts/i18n/ 下提供 6 个 Node.js 脚本辅助翻译键维护（详见 scripts/i18n/README.md）：
| 脚本 | 用途 |
|---|---|
scan_missing_keys.cjs |
扫描 t() 调用，找出 zh.ts / en.ts 中缺失的键 |
find_hardcoded_chinese.cjs |
扫描未用 t() 包裹的硬编码中文字符串 |
sync_en_from_source.cjs |
英文源码升级后，同步 en.ts 的大小写/空格/标点 |
validate_en.cjs |
校验 en.ts 的空值、中文残留、{{*}} 残留 |
remove_fallbacks.cjs |
批量移除 t() 调用中的冗余 fallback 字符串 |
analyze_bundle.cjs |
分析 i18n bundle 体积构成 |
node scripts/i18n/scan_missing_keys.cjs # 新增组件后检查缺失键
node scripts/i18n/find_hardcoded_chinese.cjs # 检查遗漏的硬编码中文
node scripts/i18n/sync_en_from_source.cjs # 英文源码升级后同步 en.tsAGPL-3.0. See LICENSE.（与 Stash 自身许可证一致。）
- 原项目：ordureconnoisseur/binge
- 汉化及修复详见 汉化及修复.md