Repository navigation
OrcaBox 1.3.8
OrcaBox 1.3.8 发行说明
发布日期：2026-10-21
本版本聚焦台词工作台的字幕断句质量（英文按词排版、碎片合并、时间轴贴合语音）、全屏播放的自动隐现控件，并修复 4K 视频无法播放与网络视频下载器的进度、入口、目录选择问题。
新增功能
- 英文字幕按单词数断行：台词工作台的行宽预算按字幕实际使用的文字切换。中文、日文、韩文仍按可见字符数计算（默认每行 18 字），英文等拉丁文字改为按单词数计算（默认每行 8 词，可调 3–16 词），同时受约 42 字符的单行上限约束。面板右上角「每行 ≤ 字 / 词」两个输入框分别对应两套预算，当前字幕使用哪一套会高亮，另一套淡化。入口：台词工作台 → 拆分提示词面板。
- 拆分提示词升级到 v4：新默认提示词按拉丁文字规则重写（每行单词/字符上限、不得以冠词/介词/连词/助动词结尾、不留单词尾巴、不改写原文），并迁移到独立存储键。旧版内置提示词会被新默认替换，用户自行修改过的提示词原样保留，不会被升级覆盖。
- HTML 预览复制排版（含图片）：HTML 预览工具栏新增「复制排版」按钮，按当前显示效果把整篇文章复制为富文本，可直接粘贴到公众号、知乎、Notion 等编辑器的正文中。段落、字号、颜色、间距与圆角等排版随正文一起带入；同一目录下的本地图片自动内嵌到剪贴板，无需逐张上传，宽图按等比缩放到适合正文的宽度（最大 1280 像素宽、单张 24 MB），透明图片保留透明。排版按预览当前宽度计算，切换手机宽度后再复制即得窄版。复制只读取源文件，不修改也不写入资料库；无法内嵌的图片会在完成提示中单独计数，远程图片保持原网址交由目标编辑器处理。入口：HTML 预览工具栏 → 复制排版。
- Pinterest 以图搜图（内置插件）：在资料库选中一张图片，点工具栏「Pinterest 识图」或资产右键菜单，独立面板会用这张图自动发起 Pinterest Lens 识图，结果以瀑布流展示，滚动自动加载更多相似图。每张图可单独下载或勾选批量，「全部导入」一次把当前结果存进资料库。首次使用需在面板内登录一次 Pinterest（内嵌登录窗口，登录成功自动关闭；登录状态保存在 OrcaBox 自己的独立会话，不读取、不修改系统浏览器中的登录），之后点插件即可直接识图。Pinterest 在部分网络需要代理，OrcaBox 使用「设置 → 网络」的导入代理。入口：工具栏「Pinterest 识图」/ 资产右键菜单。
- Pinterest 看板浏览与关键词搜索：面板标题栏可切换「识图 / 看板 / 搜索」三个数据源。看板页列出你账号里的看板（可搜索、滚动加载更多），点任意看板以瀑布流浏览其中图片，下载会按看板名称自动分类到资料库的
Imports/Pinterest/<看板名>/；搜索页输入关键词回车即搜，最近 8 条搜索词保存在本机，点击即可重搜。看板与搜索均为只读，OrcaBox 不会往你的 Pinterest 账号写入任何数据。 - 大图缩放与相似推荐：点开任意一张图，左侧为大图、右侧为「更多像这样的」相似图瀑布流，点击右栏图片直接切换查看。大图支持滚轮缩放（以光标为中心）、放大后拖动平移、双击在 1×/2× 间切换，底部有缩放工具条；右侧相似面板的左缘可拖动调整宽度，列数随宽度自动增减，宽度会记住偏好。Esc 在放大时先复位缩放，再按一次才关闭大图。
- 应用级账号登录（小红书 / 抖音）：设置 → 网络新增「账号登录」分区。登录小红书后，笔记导入改以账号身份读取桌面版页面，保存无水印 WB 原图（未登录只能拿到移动端分享页的公开数据，图片为平台预合成水印的版本，任何工具都无法从图片中去除，OrcaBox 也不会用转码抹水印），私密或仅登录可见的笔记因此可导入；登录抖音后，视频下载可解锁仅登录可见的内容与更高清晰度档位。登录在应用内嵌窗口完成，成功后自动关窗；登录态保存在 OrcaBox 自己的独立持久化分区（每平台一个），不读取、不修改系统浏览器中的登录，「退出登录」一键清空对应平台站点数据。
优化改进
- 字幕碎片合并：窗口化语音识别按发声段切窗，连续英文常被切出「This is Oppo's」「brand new Find X」这类 2–3 词碎片，每条停留不到一秒。识别后处理现在先用同一套行宽预算把这些碎片合并，再交给文本模型按语义断句；只有语音识别产生的字幕参与合并，导入的屏幕字幕一条一镜不会被拼接。
- 边界回摆：合并后再做一次边界调整——上一行停在介词、冠词或连词上，或下一行只剩一两个词时，把一个词连同其时间一起挪过去，避免机械按字数切断。
- 时间轴贴合语音：字幕边界吸附到波形上检测到的实际停顿（±260 毫秒内取最安静点）；过短字幕向后延展到可读时长，英文约 20 字符/秒、中文约 9 字符/秒，最短 1 秒、最长 7 秒；检测不到语音的位置不生成字幕。
- 「短句合并」一键修复旧字幕：工具栏的合并动作现在同时完成去重与碎片重排，此前识别好的字幕可以直接修复，不必重新识别。
- 来源目录选择器改为增量加载：原先为每个来源根重建整棵递归目录树，26 个根 / 11.7 万文件首次打开实测 24.4 秒（8,027 个目录逐个同步 stat，exFAT 约 2.4 毫秒/次）。现在只读当前层级、展开时加载下一层，最大根根层查询实测 9 毫秒；目录顺序与侧栏一致（置顶、自定义名称、排序方式），缺失目录清理改为每 10 分钟最多一次全量扫描，不再阻塞打开。
- 全屏播放沉浸模式：视频全屏播放时，标题栏、工具栏与底部进度条统一跟随同一个空闲计时器——播放开始后控件一起渐隐，随后画面平滑铺满整窗；控件唤回时画面立即让位、控件再淡入，全程无跳变。浏览器可直接播放的格式（H.264/HEVC MP4、WebM 等）画面恒定满窗、控件悬浮在画面上，顶部标题栏改为渐进模糊：模糊随画面内容向下融散，配合连续羽化的暗部渐变，标题栏与画面之间没有接缝线，控件淡出时模糊层同步淡出。原生格式（ProRes、相机 PCM 原片、MKV 等）的解码面绘制在系统级视图上，保持控件让位布局，控件隐去后画面扩展铺满。画面四周保持纯黑，宽画幅（如 2:1 电影比例）上下留出的黑边由预览舞台的纯黑底色补足，侧边栏、素材网格与详情面板不会从黑边里透出来。移动鼠标立即唤回控件，持续移动保持可见，停手约 2 秒后再次淡出；暂停、拖动进度、打开音量或更多菜单、缓冲加载与播放失败时控件不会消失，避免操作中途控件从指针下消失。原生播放画在系统级视图上，网页收不到该区域的鼠标事件，因此全屏时按固定频率读取系统光标位置判定移动，两种播放后端手感一致。中间预览（未全屏）不做隐现，保持原有布局与常驻进度条，Esc 与原有快捷键照旧可用。
问题修复
- 4K 视频（VP9 + Opus）无法播放（重要）：YouTube 4K 经 yt-dlp 下载为 MP4 容器内的 VP9 视频 + Opus 音频，而播放路由只把 MP4 家族中的 AAC/MP3 视为可播音频，整类文件被降级为「仅元数据」——没有预览、双击也播不了。现将 Opus 纳入 MP4/QuickTime 音频白名单，并让路由判定、内嵌播放器判定、原生失败后的浏览器回退三处保持一致；VP9/AV1 等免版税编码仍直接交给浏览器解码，不会被推到为 H.264/HEVC 准备的硬件解码规则上。PCM 等无法解复用的音频照旧走原生播放。
- 下载编码偏好调整：分辨率仍是第一排序键（4K 不会为兼容降级到 1080p），其下优先
vcodec:avc1、acodec:aac与直连 HTTPS，避免为同一分辨率去拉码率更高的 HLS 变体。 - YouTube 下载停在 0%：下载命令同时使用
--print与--progress-template，而 yt-dlp 在--print模式下默认静音，进度模板一条不输出（实测：不带--print62 行进度，带上后 0 行）。恢复显式--progress后进度流完整，队列卡片重新显示百分比、已下载字节与 ETA。 - 旧版 yt-dlp 导致媒体请求 403：系统 PATH 中的引擎即使过期也一直被优先使用，它能解析元数据但媒体请求一律 403，卡片永远停在「准备中」。现在优先使用插件目录内已播种的引擎，系统引擎超过 60 天视为过期；失败特征指向过期引擎（403、无法解析签名等）时自动刷新引擎并重试一次，登录墙、私享视频与普通网络错误不重试。
- 队列新增「重新获取链接并下载」：保留沿用当前解析结果的直接下载，另提供重新解析链接后再下载的入口，适用于链接过期或解析结果失效。
- 网络视频下载点击无反应：插件公开 API 白名单收敛时误删了独立窗口入口，插件能激活、工具栏动作也注册成功，但点击时才调用该缺失方法并抛错，异常只留在控制台。已恢复入口，并新增插件动作错误上报——失败时弹出提示，不再静默失败。
- 小红书笔记链接可整篇批量导入：小红书收紧网页端访问后，匿名桌面请求打开笔记页会被直接跳转到登录页，而批量导入的页面探测在标准笔记页（
/explore/、/discovery/item/链接）上仍用桌面请求，拿到的是没有笔记数据的登录页，批量路径放弃后跌回单图兜底——一篇 12 张图的笔记只导入 1 张。现在标准笔记页与短链一样先用移动端请求读取页面（无需登录即可拿到完整笔记数据），「网页导入方式」为「批量」时会导入整篇笔记的全部图片与 Live 图。多条路径互为兜底：移动端解析不出笔记（私密/受限笔记）时退回桌面会话再探一次（走代理时带上小红书登录态）；批量路径整体失败时仍落到单图导入。代理环境下页面抓取体积上限与直连对齐（2 MB），超长笔记页不再被截断。
变更范围
src/shared/transcript-cues.ts、src/main/services/transcript-recognize-service.ts、src/renderer/plugins/builtin/transcript-workbench/index.tsxsrc/main/services/media-playback-routing.ts、media-support.ts、preview-service.ts、src/renderer/components/preview/video-preview-player-state.tssrc/main/services/network-video-download-service.tssrc/renderer/components/preview/VideoPreviewPlayer.tsx、preview-immersive-chrome.ts、src/renderer/components/layout/AssetPreviewStage.tsx、AppLayout.tsx、src/renderer/globals.css、src/main/ipc-handlers.ts、native/macos-avplayer/src/addon.mm（全屏沉浸控件；原生画面垫底通道随本版验证结果保留代码但默认停用）src/shared/pinterest-visual-search.ts、src/main/services/pinterest-visual-search-service.ts、src/main/windows/pinterest-visual-search-window.ts、src/renderer/plugins/builtin/pinterest-visual-search/index.tsx（Pinterest 以图搜图插件）src/main/services/browser-extension-service.ts（小红书笔记批量导入修复：移动端探测优先、桌面会话兜底、代理抓取上限对齐；账号登录态接入——小红书桌面优先拿无水印图、抖音页面抓取带账号会话）src/main/services/account-session-service.ts、src/shared/account-sessions.ts（应用级账号登录：小红书 / 抖音持久化分区、内嵌登录窗口、登录态广播）- 新增测试：VP9+Opus 播放路由、字幕按词排版与碎片合并、下载格式排序、全屏沉浸控件显隐判定、Pinterest 插件注册与权限门控、小红书标准笔记页移动探测与登录态兜底、账号会话平台注册表与登录态桌面优先
获取更新
| 平台 | 安装包 |
|---|---|
| macOS Apple Silicon | DMG |
| macOS Intel | DMG |
| Windows x64 | 安装器 / 免安装版 |
平台与自动更新说明
- macOS 的 DMG 用于人工安装；架构匹配的 Apple Silicon / Intel ZIP 是应用内自动更新载荷，不是普通安装包。
- Windows 自动更新使用 NSIS Setup 安装器与 blockmap；Portable 仅用于手动运行。
- 保留差量下载与 CNB 单范围请求配置；下载需要用户确认，不在应用退出时自动安装。
- 字幕按词排版、碎片合并与时长规则在 macOS 与 Windows 使用同一套共享实现；本版播放路由修复对两个平台的浏览器回退路径同时生效。
- 全屏沉浸控件按画面承载方式分两条路径：浏览器可直接播放的格式画面在页面内，控件悬浮满窗画面之上，顶部用渐进模糊融入画面；原生格式（ProRes、相机 PCM 原片、MKV 等）的解码面在 macOS 与 Windows 都绘制在网页之上，保持「控件让位」模型。开发期间曾尝试在 macOS 通过原生插件把解码视图插到窗口内容视图之下以统一两条路径（含 AVPlayer/libVLC/mpv/QuickLook 四个后端），实测 Electron 43 下宿主视图仍绘制在网页内容之上、黑边会透出底层工作区，因此该通道保留代码但默认停用，后续验证可行后再启用。两平台均已完成静态验证；开发实例实测以 2:1 宽画幅视频确认原生路径黑边不再透出，浏览器直连顶部已实测渐进模糊层与羽化渐变生效（产生接缝的双渐变截断已移除）。打包后真机手感仍需验收。
- 本批打包和原生升级验收的完成情况单独记录于发布审查，不以静态测试或交叉打包代替真实升级验证。