RoamCat 0.9.0

RoamCat · 随心阅 0.9.0：设置页重新分组，侧栏能直接搜到具体设置；引导页新增「连接模型服务」一步；弹窗、阅读器和网页挂件的版式统一。

• 设置页重新分组：侧栏改为「阅读 / 网站 / 视频与直播 / 模型服务 / 词汇与记录 / 数据与隐私 / 帮助」七组，取消「更多」。阅读组分「查词 / 解构 / 双语翻译 / 伴读猫」四个标签，原词、词注、译文的样式各归各的标签；「任务分配」在「模型服务」下单独成页；「已认识词」不再分内层标签。设置项和已保存的数据都不变，旧的设置链接照常可用。
• 搜索与显示方式：侧栏搜索能匹配每一行设置的名称，点一下跳到那一行并短暂高亮。「双语翻译」标签新增「双语 / 仅译文」，与弹窗和网页左下角的切换是同一项设置。
• 引导页：新增「第 3 步 · 连接模型服务」，打开就检测当前服务能不能用。还没有可用服务时，列出 ChatGPT / Grok / Google 订阅和自备 API Key 四种接入方式，按钮直接打开设置中心；在设置页接好后切回引导页会自动刷新。引导页不收集任何密钥。
• 弹窗与阅读器：弹窗两张卡加了卡名「本页」与「长期设置」，各行统一成同一种排法，按钮同高同宽；页头新增「打开阅读器」，普通网页也能直接进阅读器。阅读器正文行宽收到约 70 个英文字符，目录高亮当前章节。
• 网页挂件：伴读猫竖排工具栏按使用频率排成「双语翻译 → 阅读辅助 → 提炼摘要 │ 设置」，悬停提示写出快捷键 Alt+Shift+T / S / M；词卡、解构卡、状态条等浮层的圆角、关闭按钮和按钮高度统一。
• 修复：「网站」页的「导出规则包」实际导出的是词档案，已移除，导出入口统一在「数据与隐私」；引导页的齿轮和地球图标画错、375px 宽时「跳过引导」一字一行；网页挂件引用了四个未定义的 CSS 变量。连接器出错时只显示一句说明，原始错误代码收进「技术细节」。

本版不新增浏览器权限，数据用途不变，本机连接器没有改动。

安装与升级

1. 下载本页的 roamcat-0.9.0-extension.zip，可用同页 SHA256SUMS 校验。解压后得到 roamcat-0.9.0/，其中包含扩展、本机连接器和安装说明。
2. 新用户打开 chrome://extensions 或 edge://extensions，开启「开发者模式」，选择「加载已解压的扩展」，指向包内的 extension/。
3. 已有用户请把新包内的文件覆盖到原来加载的目录，再重新加载扩展，以保留扩展 ID 和设置。改用新的目录可能改变扩展 ID，原设置不会自动迁移。
4. 连接器：自 0.8.1 起没有改动，已按 0.8.1 更新过连接器的用户不必重装；从更早版本升级、或第一次使用订阅的用户，在保留的安装目录内运行 node connector/install.mjs，需要 Node.js 20+ 和对应的官方 CLI。

验证

18 项完整本地门禁通过，共 941 项带计数的断言，包含 437 项单测、102 项伴读猫检查、195 项界面检查，以及服务认证、站点档案、阅读器、字幕、听写、直播聊天、性能、真实后台审计和生产构建。性能门禁里「阅读器积压时字幕优先拿名额」一项靠固定 150ms 等待判断字幕已排队，整套满载运行时偶尔失败、单独重跑通过；后台调度代码自 0.8.1 起没有改动，这项测试会另行改为按状态等待。

生成测试使用本地假接口；未逐个调用真实付费模型，macOS/Linux 未做实机验证。软件继续通过开发者模式安装，尚未上架扩展商店。

完整更新日志 · 安装与配置 · 隐私政策

RoamCat 0.8.1

RoamCat · 随心阅 0.8.1：改进翻译性能和逐条显示，调整伴读猫与快捷工具栏，并修复连接器、扩展重载及翻译稳定性问题。

• 翻译性能：整页、选段、阅读器、视频字幕和直播聊天按场景排队，遵守所选服务的并发上限；字幕、聊天和选段优先取得空闲名额。机器翻译完成一条即可显示一条，大表格减少重复扫描，流式译文减少重复绘制。
• 界面与操作：双语翻译作为弹窗主模式，阅读辅助作为副模式；伴读猫和贴边快捷工具栏独立摆放，工具栏可拖动并记住位置。「任务分配」集中到模型服务页，右键帮助可直接查词或解释选区。
• 翻译稳定性：修复长段落里的代码重复、标题换行、失败提示撑坏导航和进度播报不准确。阅读器遇到鉴权或额度错误立即停止；换书、切视频后丢弃旧进度；修复机翻限速和并发调整后的超限问题。
• 连接器与设置：修复 Windows 下 CLI 启动、包含 JSON 或换行的参数、超时后的进程回收；支持清空已保存服务的全部密钥并保留服务配置，修复流式响应的用量漏记。
• 扩展重载：修复重载后旧挂件重新挂回网页、叠出多只伴读猫的问题，并加入连续两次真实重载的回归检查。

本版不新增浏览器权限，数据用途不变。生成任务仍由用户选择的模型或机器翻译服务处理。

安装与升级

1. 下载本页的 roamcat-0.8.1-extension.zip，可用同页 SHA256SUMS 校验。解压后得到 roamcat-0.8.1/，其中包含扩展、本机连接器和安装说明。
2. 新用户打开 chrome://extensions 或 edge://extensions，开启「开发者模式」，选择「加载已解压的扩展」，指向包内的 extension/。
3. 已有用户请把新包内的文件覆盖到原来加载的目录，再重新加载扩展，以保留扩展 ID 和设置。改用新的目录可能改变扩展 ID，原设置不会自动迁移。
4. 使用订阅连接器的用户也需更新连接器：在保留的安装目录内运行 node connector/install.mjs，需要 Node.js 20+ 和对应的官方 CLI。本版包含 Windows CLI 与进程回收修复，只更新浏览器扩展不会更新已经安装的连接器。

从旧版一直打开至今的网页，升级后刷新一次，可清理旧脚本遗留的挂件；新脚本已包含重载修复。

验证

18 项完整本地门禁通过，共 906 项带计数的断言，包含 437 项单测、102 项伴读猫检查、162 项界面检查，以及服务认证、阅读器、字幕、听写、直播聊天、性能、真实后台审计和生产构建。另有真实 Grok CLI + 本地假后端的离线锁定检查 8/8 通过。

生成测试使用本地假接口；未逐个调用真实付费模型，macOS/Linux 未做实机验证。软件继续通过开发者模式安装，尚未上架扩展商店。

完整更新日志 · 安装与配置 · 隐私政策

RoamCat 0.8.0

RoamCat · 随心阅 0.8.0：新增 14 种机器翻译服务，可按阅读场景选择引擎；伴读猫的快捷按钮改为常驻竖排工具栏，并修复本轮排查发现的机翻问题。

• 机器翻译：Chrome 本机翻译、DeepL、Google Cloud、Azure、腾讯云、阿里云、百度、火山、有道、小牛、MyMemory、Google 网页、微软 Edge 与 DeepLX 自建。整页、视频字幕、直播聊天、PDF/EPUB 阅读器和选段可分别选择引擎；默认沿用大模型，失败项可选择回退。查词、阅读解构、摘要继续使用大模型。
• 伴读猫：常驻竖排胶囊工具栏、托举小爪和出现动作；靠近屏幕顶部时自动换边，气泡与缩放控件随布局避让。修复猫身尺寸、呼吸动画及放大后的气泡位置。
• 机翻稳定性：后续请求失败时保留已完成译文，仅重试未完成项；按每次请求计算超时，限速等待不消耗下一次请求的时限；修复多句英文原样返回的校验，以及关闭回退时单项错误导致整批结果被拒绝的问题。
• 仓库与文档：项目已迁至 roamcat-dev/roamcat，旧站保留跳转；同步中英文下载说明、版本信息、隐私披露与 SEO 元数据。

云端机翻将原文直接发送给所选服务；DeepL 的单条整页请求还可能包含有限的邻近上下文。Chrome 本机翻译需浏览器支持并由用户准备语言包，原文留在本机。凭据仅保存在扩展本地存储，不进入网页脚本、诊断或导出。本版不新增浏览器权限。

安装与升级

1. 下载 roamcat-0.8.0-extension.zip，可用同页的 SHA256SUMS 校验，解压后得到 roamcat-0.8.0/。

2. 打开 chrome://extensions 或 edge://extensions，开启「开发者模式」，点击「加载已解压的扩展」，选择 roamcat-0.8.0/extension。

3. 可选订阅连接器需要 Node.js 20+ 与对应的官方 CLI。在解压出的 roamcat-0.8.0/ 内运行：

   node connector/install.mjs

已有用户应把新包内容覆盖到原来加载的目录，再重新加载扩展，以保留扩展 ID 和设置。若更换加载目录，浏览器可能生成另一个扩展 ID，需要重新注册连接器；原设置不会自动迁移。从 0.7.1 或更早版本升级且使用订阅连接器时，需在保留的原目录内重新运行上述安装命令，以更新双向认证服务。

验证与限制

416 个单测和 18 组本地门禁通过，包含生产构建与真实后台审计；Grok CLI 离线锁定检查 8 项通过。真站检查 15 项通过，4 项因限流或验证页跳过。Google 网页、微软 Edge、MyMemory 已做在线抽测；付费服务使用协议与错误响应夹具验证，未使用真实付费账号逐个测试；未下载真实 Chrome 语言模型。

软件仍通过开发者模式安装，尚未上架扩展商店。服务商费用、额度和地区可用性由各服务决定；Google/Edge 网页接口是非公开接口，可能限流或失效。DeepLX 仅连接用户填写的自建地址。

完整更新日志 · 机器翻译说明 · 隐私政策

RoamCat 0.7.2

RoamCat · 随心阅 0.7.2 —— 扩展和本机常驻服务改为挑战—应答双向认证：扩展先确认对面是真的 RoamCat 服务，再发任何请求。这次扩展和连接器要一起升级。 Chrome / Edge（125+）MV3 阅读扩展：整页双语翻译 + 阅读辅助，本地优先。

安全

• 扩展先确认对面是真的 RoamCat 常驻服务，再发任何请求。 以前扩展把配对令牌原样放进握手，发给 127.0.0.1:47821。服务没运行时，本机其他账户的程序只要先占住这个端口，就能收到令牌和页面文本，还能返回伪造的翻译结果。
  • 现在改成挑战—应答双向认证：双方各出一个随机数，服务先用令牌算出证明；扩展核对通过才回自己的证明，服务核对后才开始收发请求。
  • 令牌只当密钥用，不再出现在连接里。
  • 核对不过时，扩展不发任何数据，改走浏览器连接器，并在诊断里记一条「常驻服务未通过身份核对」。

改进

• 落地页的欢迎页、阅读器、伴读猫摘要卡与查词卡截图换成当前界面。

完整变更见 CHANGELOG。

从 0.7.1 及更早版本升级

扩展和连接器要一起升级。 新扩展遇到旧的常驻服务，或旧扩展遇到新服务，都连不上常驻服务，会自动改走浏览器连接器。翻译、帮助、听写等功能不受影响，只是不走常驻服务那条更快的连接。

1. 把新包里 roamcat-0.7.2/ 下的内容覆盖到你原来加载的那个文件夹（例如 roamcat-0.7.1/），在 chrome://extensions 里点 RoamCat 的「重新加载」。扩展 ID、设置与词档案都保持不变。
2. 用 ChatGPT / Grok / Google 订阅的话，在那个文件夹的上一级目录里重新运行一次连接器安装命令（见下方）。已有登录数据保留，配对令牌会换新。
3. 重装后约 1 分钟内，扩展可能还缓存着旧令牌，会先走浏览器连接器，之后自动改连常驻服务。

如果改从新的文件夹加载，浏览器会把它当成另一个扩展（扩展 ID 按文件夹路径生成），设置不会继承，也要在新目录里重新运行一次连接器安装命令。

安装

1. 下载 roamcat-0.7.2-extension.zip（可用 SHA256SUMS 校验），解压。
2. 打开 chrome://extensions（或 edge://extensions），开启「开发者模式」。
3. 「加载已解压的扩展程序」→ 选择解压出的 roamcat-0.7.2/extension 文件夹。

可选：订阅连接器与常驻服务（ChatGPT / Grok / Google 订阅，需要 Node.js 20+ 与对应的官方 CLI）：在包含 roamcat-0.7.2/ 的目录里运行

node roamcat-0.7.2/connector/install.mjs

已知限制

• 尚未上架商店，只能以开发者模式加载。
• host_permissions 仍为宽泛的 http(s)://*/*。
• 常驻服务固定使用 47821 端口；该端口被其他程序占用时，扩展会继续使用浏览器连接器。
• 云端听写只支持 YouTube，且需要 Google（Antigravity）订阅。

RoamCat 0.7.1

RoamCat · 随心阅 0.7.1 —— 订阅连接器收紧权限：Grok 不再给模型任何工具，Antigravity 不再继承你放宽过的自动批准；后台唤醒不再每次全量对账；文档与落地页按当前代码校正。Chrome / Edge（125+）MV3 阅读扩展：整页双语翻译 + 阅读辅助，本地优先。

安全

• Grok 订阅连接器不再给模型任何工具。 以前命令行带 --always-approve，而 Grok CLI 无头模式默认带 23 个内置工具（含运行终端命令、改文件、定时任务），网页里的文字又会进提示词。你主目录里 .agents/skills、.claude、.cursor 的技能、规则和 MCP 也会一并进提示词。
  • 现在去掉了自动批准，用工具白名单加禁用清单关掉全部内置工具，需要批准的调用一律拒绝。
  • 子进程的主目录换成连接器自己的空目录，你的技能不再进提示词。登录态照旧从 Grok 自己的目录读取。
  • 旧版 Grok CLI 不认识这些开关时会提示更新，不会去掉开关重试。
• Antigravity 订阅连接器不再继承你放宽过的自动批准。 你自己的 agy 设置如果是「始终继续」，无头运行以前会原样继承。现在每次会话用 --settings 把批准策略压回 agy 默认值（只对本次会话生效，不改你的设置），需要确认的调用会被拒绝。
  • 真机实测（agy 1.4.12）：翻译和云端听写都正常，听写读取音频不受影响。
  • 你在 agy 里装的 MCP 服务器、插件与 hooks 仍会加载，这次没有收窄。

改进

• 后台被浏览器回收后再次唤醒时，只核对已注册的内容脚本是否与设置一致，不再先撤再注册、也不再逐个已打开的标签页补注入。全量对账只在安装或更新、浏览器启动、站点权限或相关设置变化、订阅登录状态翻转时做。标签页多时，每次唤醒少一轮与标签页数成正比的脚本探测。
• 文档按当前代码校正：
  • README、SPEC、隐私说明、上架清单和品牌 / 设计文档里过期的内容都已改正：消息数、服务商数、版本与发布阶段、内容脚本加载方式、设计配色、设置页路径。
  • 第三方许可声明补上 pdf.js、fflate 和 Silkscreen 字体。
  • 隐私说明补上：选择远程领域识别时，会把标题和正文样本发给你选的服务。
  • README 截图按当前界面重拍。
• 落地页补齐搜索引擎与 AI 助手引用所需的元数据，新增 llms-full.txt、404 页与网站图标，配色改为与扩展一致的暖纸墨。
• 仓库开启了 Discussions 和私密漏洞报告。

修复

• Windows 上，Codex CLI 路径带空格时（例如 C:\Users\Li Lei\…），连接器安装器查 CLI 版本会把路径拆开，报「无法运行官方 Codex CLI」。现在安装器和运行时共用同一套带引号的启动写法。

完整变更见 CHANGELOG。

从 0.7.0 / 0.6.x 升级

这次改动了连接器，用订阅的话需要重装一次。

1. 把新包里 roamcat-0.7.1/ 下的内容覆盖到你原来加载的那个文件夹（例如 roamcat-0.7.0/），在 chrome://extensions 里点 RoamCat 的「重新加载」。扩展 ID、设置与词档案都保持不变。
2. 用 ChatGPT / Grok / Google 订阅的话，在那个文件夹的上一级目录里重新运行一次连接器安装命令（见下方），已有登录数据保留。不重装的话，本机连接器仍是旧版。

如果改从新的文件夹加载，浏览器会把它当成另一个扩展（扩展 ID 按文件夹路径生成），设置不会继承，也要在新目录里重新运行一次连接器安装命令。

安装

1. 下载 roamcat-0.7.1-extension.zip（可用 SHA256SUMS 校验），解压。
2. 打开 chrome://extensions（或 edge://extensions），开启「开发者模式」。
3. 「加载已解压的扩展程序」→ 选择解压出的 roamcat-0.7.1/extension 文件夹。

可选：订阅连接器与常驻服务（ChatGPT / Grok / Google 订阅，需要 Node.js 20+ 与对应的官方 CLI）：在包含 roamcat-0.7.1/ 的目录里运行

node roamcat-0.7.1/connector/install.mjs

已知限制

• 尚未上架商店，只能以开发者模式加载。
• host_permissions 仍为宽泛的 http(s)://*/*。
• 常驻服务固定使用 47821 端口；该端口被其他程序占用时，扩展会继续使用浏览器连接器。
• 云端听写只支持 YouTube，且需要 Google（Antigravity）订阅。

RoamCat 0.7.0

RoamCat · 随心阅 0.7.0 —— 整页翻译可一键切换「双语 / 仅译文」；弹窗说明不再截断、引导页适配窄窗口、跨页面语言同步。Chrome / Edge（125+）MV3 阅读扩展：整页双语翻译 + 阅读辅助，本地优先。

新增

• 整页翻译一键切换「双语 / 仅译文」：网页出现译文后，左下角会出现切换按钮（清除翻译后消失）；弹窗「本页双语翻译」里也有同样的分段按钮，还没开始翻译时可以先选好。选择会记住，并同步到其他正在显示译文的标签页。
  • 仅译文不删改网页自己的内容：标题保留原来的粗细，列表圆点和序号照常对齐译文，段距与行宽不变；译文被网页重新渲染掉时原文自动回来，不会出现空白段落。
  • 导航栏与侧栏、纯链接、带图片或表单控件、含嵌套列表的段落，以及没翻完或翻译失败的段落，仍保留原文对照。
  • 正文里夹着的链接在仅译文时点不到，需要时切回双语。

改进

• 弹窗里的状态说明完整换行，服务告警原因不再截断；底栏上沿加渐隐，看得出下面还能滚动。
• 「顶部释义」的短注浮在单词正上方，不再把句子撑开（以前是「uses an index to」）。
• 设置页「模型服务」卡片的名称完整换行、描述最多两行，悬停显示完整内容。
• 阅读器远程文档加载失败时按原因给入口：只有 401/403、网络错误或解析失败才提供「使用网站登录状态重试」；404、5xx 提示链接可能失效，主按钮改为「在浏览器中查看原文档」。
• 快捷键或右键菜单失败时（工具栏图标挂红色「!」），打开弹窗会在顶部说明「上一次操作没有完成」与具体原因。

修复

• 引导页在分屏、小屏笔记本等窄窗口下不再横向溢出。
• 在阅读器、引导页等扩展页切换界面语言后，开着的设置页、弹窗与阅读器跟着换语言，不再中英混杂。
• 本机连接器「未找到 / 没能启动」的原因按当前界面语言显示。
• 伴读猫的「阅读辅助」按钮按本页实际状态显示，首次点击不再反向关掉，从弹窗或快捷键切换后同步更新。
• 工具栏的红色「!」在标签页打开新页面（含单页应用换路由）后自动撤掉。

完整变更见 CHANGELOG。

从 0.6.x 升级

本次没有改动连接器。推荐把新包里 roamcat-0.7.0/ 下的内容覆盖到你原来加载的那个文件夹（例如 roamcat-0.6.1/），再在 chrome://extensions 里点 RoamCat 的「重新加载」：扩展 ID、设置与词档案都保持不变，连接器也不用重装。

如果改从新的文件夹加载，浏览器会把它当成另一个扩展（扩展 ID 按文件夹路径生成），设置不会继承，还需要在新目录里重新运行一次连接器安装命令（见下方）。

安装

1. 下载 roamcat-0.7.0-extension.zip（可用 SHA256SUMS 校验），解压。
2. 打开 chrome://extensions（或 edge://extensions），开启「开发者模式」。
3. 「加载已解压的扩展程序」→ 选择解压出的 roamcat-0.7.0/extension 文件夹。

可选：订阅连接器与常驻服务（ChatGPT / Grok / Google 订阅，需要 Node.js 20.11+ 与对应的官方 CLI）：在包含 roamcat-0.7.0/ 的目录里运行

node roamcat-0.7.0/connector/install.mjs

换到新的解压目录后重新运行一次这条命令即可，已有登录数据保留。

已知限制

• 尚未上架商店，只能以开发者模式加载。
• host_permissions 仍为宽泛的 http(s)://*/*。
• 常驻服务固定使用 47821 端口；该端口被其他程序占用时，扩展会继续使用浏览器连接器。
• 云端听写只支持 YouTube，且需要 Google（Antigravity）订阅。

RoamCat 0.6.1

RoamCat · 随心阅 0.6.1 —— 修改 Jev 接口域名时保护已保存的密钥；修复并发保存设置、旧版 Chrome 读取 PDF、带命名空间的 EPUB 与快捷键页布局。Chrome / Edge（125+）MV3 阅读扩展：整页双语翻译 + 阅读辅助，本地优先。

安全

• 修改 Jev 接口域名时必须重新填写密钥：此前把 Jev 接口地址改到另一个网站时，会自动沿用原来保存的密钥，等于把密钥发给新域名。现在换到不同网站必须重新填写；同一网站只改路径时仍可沿用已保存的密钥。

修复

• 同时保存多项设置时按最新状态校验和合并，伴读猫等嵌套设置不再丢失，当前 API 服务也不会再指向已删除的服务。
• PDF 阅读器在 Chrome 125 等较旧版本上可以正常打开文档（改用 PDF.js 兼容构建）。
• 需要登录的远程 PDF / EPUB 加载失败后，可以点「使用网站登录状态重试」（只在你点击后才带网站登录信息，且不跟随重定向），或「在浏览器中查看原文档」。
• 带命名空间前缀的 EPUB（包结构、元数据、目录与正文）可以正常解析。
• 流式返回的用量统计保留已知的输入量，不再被只含输出量的更新清零。
• 设置页「快捷键」：侧栏展开时，操作清单的说明不再被挤成一字一行的竖排，各行说明对齐成一列；分组标签栏不再冒出多余的滚动条。

完整变更见 CHANGELOG。

从 0.6.0 升级

本次没有改动连接器。推荐把新包里 roamcat-0.6.1/ 下的内容覆盖到你原来加载的那个文件夹（例如 roamcat-0.6.0/），再在 chrome://extensions 里点 RoamCat 的「重新加载」：扩展 ID、设置与词档案都保持不变，连接器也不用重装。

如果改从新的文件夹加载，浏览器会把它当成另一个扩展（扩展 ID 按文件夹路径生成），设置不会继承，还需要在新目录里重新运行一次连接器安装命令（见下方）。从 0.6.0 之前的版本升级且要用云端听写时，同样需要重装连接器。

安装

1. 下载 roamcat-0.6.1-extension.zip（可用 SHA256SUMS 校验），解压。
2. 打开 chrome://extensions（或 edge://extensions），开启「开发者模式」。
3. 「加载已解压的扩展程序」→ 选择解压出的 roamcat-0.6.1/extension 文件夹。

可选：订阅连接器与常驻服务（ChatGPT / Grok / Google 订阅，需要 Node.js 20.11+ 与对应的官方 CLI）：在包含 roamcat-0.6.1/ 的目录里运行

node roamcat-0.6.1/connector/install.mjs

换到新的解压目录后重新运行一次这条命令即可，已有登录数据保留。

已知限制

• 尚未上架商店，只能以开发者模式加载。
• host_permissions 仍为宽泛的 http(s)://*/*。
• 常驻服务固定使用 47821 端口；该端口被其他程序占用时，扩展会继续使用浏览器连接器。
• 云端听写只支持 YouTube，且需要 Google（Antigravity）订阅。

RoamCat 0.6.0

RoamCat · 随心阅 0.6.0 —— 无字幕 YouTube 视频的云端听写；设置页新增「视频与直播」；阅读器、字幕与界面一致性的一批修复。Chrome / Edge（125+）MV3 阅读扩展：整页双语翻译 + 阅读辅助，本地优先。

新增

• 无字幕视频的云端听写（默认关闭，仅 YouTube）：连自动字幕都没有的视频，可在播放器字幕设置里点「开始云端听写」。扩展只取视频本身的音轨（不用麦克风），约 20 秒一段交给你已登录的 Google（Antigravity）订阅中的 Gemini 模型，一次返回原文与简体中文译文，按视频时间轴显示为双语字幕；不需要 API 密钥，会消耗订阅额度。听写中字幕整体延迟显示，停止后按原时间轴回看，也可在原文稿里查看、导出。拖动进度、改倍速、换视频、出现广告或关掉「双语」时自动停止；播到结尾时会取消 YouTube 的自动连播倒计时，等最后一段听写完成。音频片段只在连接器的隔离目录里临时存放，调用结束即删除。

改进

• 设置页新增「视频与直播」：YouTube 播放器入口、自动双语、字幕显示方式与外观（带实时预览）、云端听写的条件与会发送的数据、Twitch 直播聊天翻译，集中在一处。
• PDF/EPUB 阅读器分页呈现长文档，目录跳转与已生成的译文可跨页使用；EPUB 在独立线程里解析，换书时取消旧解析。普通网页按需加载阅读引擎，后台闲置时可休眠。
• Twitch 直播聊天：排队中的消息只在末尾放一个淡色小圆点，不再另起一行；出错或到达每分钟上限时「译」按钮上方弹出提示。伴读猫落进右侧聊天栏时自动挪到聊天栏左边。
• 界面一致性：引导页、设置页与弹窗统一叫法（解释卡片 / 顶部释义、辅助方式 / 查词显示方式、阅读解构）；引导页演示词卡与真实卡片一致，底部只留「保存偏好并关闭引导」「跳过，不保存」；设置项说明完整换行；英文界面下拉框不再截断；阅读记录改为同页显示统计、记录与设置；窄窗口下设置页改为顶部导航；伴读猫关闭时页内卡片也按网页本身的明暗显示。
• 亮色主题的 logo 底板改为粉 → 淡紫 → 天蓝的晨光渐变。

修复

• 阅读器：超过 4000 字符的正文不再漏翻（按句末或单词边界分片后合并）；英文弯引号不再显示成全角；PDF 以 s 开头或结尾的词之间补回空格；EPUB 支持转义路径、异常实体不再中断整本书；翻译失败会显示错误，连续失败时停止。
• YouTube 字幕：原文稿面板不再被标题和频道栏盖住；直播时说明「只实时显示、没有可回看的原文稿」，不再在句与句之间弹「没有字幕」；关闭双语期间返回的译文重开后可用；YouTube 自动翻译的字幕不再覆盖原文缓存；字幕外观按操作顺序保存，失败只撤销对应修改。
• 设置页已保存的长难句/公式开关与字幕外观，网页上现在会立刻生效，普通状态刷新也不再把字幕样式重置成默认值。
• 阅读解构卡在深色下的成分标签看得清了；开关关闭态在白色卡片上也能一眼认出；伴读猫贴边时缩放按钮不再被裁掉。
• Google 订阅翻译 Twitch 直播聊天时，所选 Gemini 系列有 low 档就改用 low 档（默认的 high 档先思考，跟不上聊天）。

完整变更见 CHANGELOG。

从 0.5.x 升级

要用云端听写，解压新包后在新目录里重新运行一次连接器安装命令（见下方），旧连接器会提示版本过旧；已有登录数据保留。不用云端听写的话，旧连接器其他功能照常工作。

安装

1. 下载 roamcat-0.6.0-extension.zip（可用 SHA256SUMS 校验），解压。
2. 打开 chrome://extensions（或 edge://extensions），开启「开发者模式」。
3. 「加载已解压的扩展程序」→ 选择解压出的 roamcat-0.6.0/extension 文件夹。

可选：订阅连接器与常驻服务（ChatGPT / Grok / Google 订阅，需要 Node.js 20.11+ 与对应的官方 CLI）：在包含 roamcat-0.6.0/ 的目录里运行

node roamcat-0.6.0/connector/install.mjs

换到新的解压目录后重新运行一次这条命令即可，已有登录数据保留。

已知限制

• 尚未上架商店，只能以开发者模式加载。
• host_permissions 仍为宽泛的 http(s)://*/*，计划改为按需申请。
• 常驻服务固定使用 47821 端口；该端口被其他程序占用时，扩展会继续使用浏览器连接器。
• 云端听写只支持 YouTube，且需要 Google（Antigravity）订阅。

RoamCat 0.5.0

RoamCat · 随心阅 0.5.0 —— Twitch 直播聊天实时翻译；本机常驻连接服务改为配对令牌认证。Chrome / Edge（125+）MV3 阅读扩展：整页双语翻译 + 阅读辅助，本地优先。

新增

• Twitch 直播聊天实时翻译（默认关闭）：在 Twitch 聊天输入区点「译」，或在设置页「显示与解构」里打开，新消息下方会补一行简体中文译文。表情、单个词的梗、刷屏和中文消息不翻；刚打开时只补最后几条，不翻历史聊天，也不写阅读记录。
• 用 API 服务翻译直播聊天时，每个标签页每分钟至多发 12 次请求（约 96 条消息），超出时暂停片刻再接着翻，「译」按钮的提示里会说明；订阅通道不受此限。

安全

• 本机常驻连接服务改为配对令牌认证：此前握手只校验本机地址与扩展来源，而来源头能被本机任何进程伪造，多用户电脑上其他系统账户可以借此用你的 ChatGPT / Grok / Google 订阅。现在安装命令每次都会生成一个只有当前用户读得到的随机令牌，扩展经浏览器连接器取得后在握手时带上，缺失或不符一律拒绝。

修复

• 伴读猫：鼠标移到快捷按钮上时，提示气泡（以及进行中的忙碌气泡）会被立刻清掉，现在能正常显示。
• 扩展安装或更新前就开着的网页，补注入阅读脚本时漏了文案运行时、长难句与公式保护模块：页内界面会显示原始键名、公式会被当成正文送去翻译；现在与网页正常加载时一致。开着的 Twitch 页面也会补上直播聊天翻译，无需刷新。
• ChatGPT 订阅连接器：npm 全局安装的 codex.cmd 所在路径含空格（如用户名带空格）时无法启动，现在能正常拉起。
• 网页内容脚本无法直接访问存储时，现在能读到已保存的界面语言，首次加载即使用你选的语言。
• 设置页「模型服务」列表按纯文本显示自建服务的名称、模型名和地址，含 < 等字符时不再弄乱列表。
• Twitch 直播聊天：翻译途中关掉「译」，再打开时那几条消息不会再卡在「已翻译但不显示」。

改进

• 网页内容脚本改用瘦身词典（约 40KB，原先每个网页都要加载约 226KB 的全量词典），伴读猫也不再重复注入渲染层与语录库。
• 浏览器连接器改为第一条真正的请求到达时才启动 Codex / Grok / agy。

完整变更见 CHANGELOG。

从 0.4.x 升级

用了本机订阅连接器的话，解压新包后在新目录里重新运行一次连接器安装命令（见下方），配对令牌才会启用；已有登录数据保留。没重装之前服务与扩展照旧工作，只是不带令牌认证。

安装

1. 下载 roamcat-0.5.0-extension.zip（可用 SHA256SUMS 校验），解压。
2. 打开 chrome://extensions（或 edge://extensions），开启「开发者模式」。
3. 「加载已解压的扩展程序」→ 选择解压出的 roamcat-0.5.0/extension 文件夹。

可选：订阅连接器与常驻服务（ChatGPT / Grok / Google 订阅，需要 Node.js 20.11+ 与对应的官方 CLI）：在包含 roamcat-0.5.0/ 的目录里运行

node roamcat-0.5.0/connector/install.mjs

换到新的解压目录后重新运行一次这条命令即可，已有登录数据保留。

已知限制

• 尚未上架商店，只能以开发者模式加载。
• host_permissions 仍为宽泛的 http(s)://*/*，计划改为按需申请。
• 常驻服务固定使用 47821 端口；该端口被其他程序占用时，扩展会继续使用浏览器连接器。

RoamCat 0.4.0

RoamCat · 随心阅 0.4.0 —— 思考等级按模型显示官方档位。Chrome / Edge（125+）MV3 阅读扩展：整页双语翻译 + 阅读辅助，本地优先。

这一版改进

• 思考等级按模型显示：设置页「模型服务」里的「思考等级」不再按服务商固定成几档，而是按所选模型列出官方实际支持的档位，并沿用官方名称，中文界面附中文说明：
  • 能调强度的模型显示官方档位，如 DeepSeek-V4 的 low / high / max、MiniMax-M3.1-Flash 的 low / medium / high / xhigh / max、豆包 Seed 2.x 的 low / medium / high；
  • 只有开关的模型（如 GLM-4.7、Kimi K2.6、小米 MiMo）只显示「关闭 / 开启」，MiniMax-M3 显示 adaptive，豆包 Seed 1.6（250615）显示 auto；
  • 阿里云百炼、SiliconFlow 等用思考预算的模型显示「1024 / 4096 tokens / 不限预算」；
  • GLM-5.3、Kimi K3 等不可关闭思考的模型不再报错，而是标明「不可关闭」并默认使用官方默认档。
• 换模型或接口通道时档位列表随之更新；已选档位不适用就回到该模型的默认档。没有思考参数的模型（如商汤 U1.5、商汤大装置通道）不显示此项；未收录的模型照旧关闭思考。
• 涉及智谱 GLM、DeepSeek、Kimi、腾讯 TokenHub、百度千帆、商汤日日新、火山方舟（豆包）、MiniMax、阿里云百炼、SiliconFlow、小米 MiMo；各模型档位与官方依据见源码 extension/thinking-levels.mjs 文件头。

完整变更见 CHANGELOG。

安装

1. 下载 roamcat-0.4.0-extension.zip（可用 SHA256SUMS 校验），解压。
2. 打开 chrome://extensions（或 edge://extensions），开启「开发者模式」。
3. 「加载已解压的扩展程序」→ 选择解压出的 roamcat-0.4.0/extension 文件夹。

可选：订阅连接器与常驻服务（ChatGPT / Grok / Google 订阅，需要 Node.js 20.11+ 与对应的官方 CLI）：在解压目录里运行

node roamcat-0.4.0/connector/install.mjs

换到新的解压目录后重新运行一次这条命令即可，已有登录数据保留。

已知限制

• 尚未上架商店，只能以开发者模式加载。
• host_permissions 仍为宽泛的 http(s)://*/*，计划改为按需申请。
• 常驻服务固定使用 47821 端口；该端口被其他程序占用时，扩展会继续使用浏览器连接器。