Codex 卡片优化器 v1.14.16

v1.14.16 — 关闭到托盘、轻量进度线与过去一周平均强度（2026-10-31）

继续使用原插件代码 1861343114，包含 v1.14.12 之后的累计界面改进。

• 关闭主窗口可隐藏到系统托盘，继续保持 Anki 运行。点击或双击 YC 图标可恢复，托盘菜单提供“显示主窗口”和“完全退出”；退出沿用 Anki 原生流程，托盘不可用时回退正常关闭。
• 复习时隐藏具体剩余张数，改为贴合操作区域顶部边缘的 2px 柔和细进度线，保留评分按钮和间隔信息。
• 学习强度展示“今天”与“过去 7 天平均”：按前 7 个完整 Anki 学习日的同一 5 分钟窗口取平均，不含今天，无学习的日子也纳入分母。
• 保留 YC 图标、晓晓语音、知识链、分时学习与跨设备任务；升级保留个人配置和学习计划，不增加每日新卡额度，不重排已有卡片或更改复习记录。

验证：进度线完成 12 种 DOM 布局检查，周平均完成 32 项相关测试及 Windows 图例/曲线确认，托盘完成 12 项 Qt 测试并在 Windows 验证关闭后托盘与后台接口继续工作。原生退出路由已测试，未为验收实际结束用户会话；其他平台托盘行为尚未实机验收。

公开包共 108 个文件，3,665,980 字节，不含私人配置、用户资料库、学习计划、运行日志或凭据。

SHA-256：9374c99745d188765737e4d76daa1b645d3a416b2048029164d9169f2c039f5b。

已安装用户可通过 Anki 桌面版“工具 → 插件 → 检查更新”升级，并按 Anki 提示正常重启。普通收藏同步与插件公开发布是不同流程。

历史发布记录

以下说明与校验值仅对应各历史版本。

v1.14.12 — YC 专属图标与 Mac 音效修复（2026-10-22）

继续使用原插件代码 1861343114。

• 新增 1:1 的 YC 个人图标，随插件启动应用到 Qt 应用及窗口；Windows 系统快捷方式图标需按本机设置，其他平台的系统启动器与 Dock 图标尚未实机验证。
• 包含此前未公开发布的 v1.14.11 修复：macOS 评分音效在导入前避开 QtMultimedia，改用独立 afplay 播放进程，保留音量、连续评分替换、静音和退出清理，不占用卡片朗读队列；Mac 仍待实机验证。
• 保留个人配置与用户数据；图标模块不访问集合，不修改卡片、到期日、FSRS 或复习记录。

验证：实际 Qt 图标解码与应用通过；从 v1.14.11 通过原有更新器升级、私有配置和用户文件保留检查通过；Windows 正常启动并在主窗口确认 YC 图标。公开包 105 个文件，不含用户集合、设备身份、私有配置、运行日志或凭据。

SHA-256：cef8e65b70d7af5780c0f50e467f764f540900143b1614d53b946aaa7ee7a1c1。

安装或升级后需正常重启 Anki；跨设备媒体代码分发不等于 AnkiWeb 发布。

历史发布记录

以下说明与校验值仅对应历史版本。

Codex 卡片优化器 v1.14.10

v1.14.10 — 分时学习跨设备统一对账（2026-10-20）

继续使用原插件代码 1861343114。

• 当天各时段的工作量基准通过 Anki 媒体同步共享；离线生成的多个计划以确定规则合并，后打开的电脑不再按剩余卡片重新切一份上午任务。当天已采用的时间和比例也随基准共享，下一学习日的个人设置继续保留。
• 完成量以当前集合真实复习记录为准，计入其他电脑及手机同步回来的学习，不再只统计本机领取过的卡片；同一天同卡多次作答只计一次首次任务。
• 完成记录需要对应复习证据；媒体先到、复习记录后到时不会凭标记冒充完成，撤销相关复习后可以恢复未完成状态。集合同步与媒体下载结束后刷新当前任务显示。
• 保留原生出卡顺序、同日学习/重学步骤、每日限额、既有卡片与 FSRS 排程；共享记录仅含任务所需 ID、估算工作量和完成证据，不含题面、答案、设备身份或凭据。

使用条件：各电脑升级到 v1.14.10 或更新版、正常重启，并完成集合与媒体同步；离线或同步未结束时不承诺即时一致。手机和 AnkiWeb 本身不运行桌面门控。

验证：23 项相关逻辑与实际 SessionManager 集成测试通过，覆盖离线并发、晚开机、手机先完成、重复计数、同步先后、撤销与重启。跨设备用隔离模拟验证，尚无第二台电脑或 Mac 实机验收。公开包共 102 个文件，不含用户集合、私有设置、运行日志、设备身份或凭据。

SHA-256：f2d121313da1296bb5748b6573f8bdeaf3230e4e6f420b6c12c68e5f459e9a89。

历史发布记录

以下分时状态仅本机保存等旧说明只对应历史版本；当前分时同步行为以上文为准。

Codex 卡片优化器 v1.14.9

v1.14.9 — 退出恢复与有限自动重试（2026-10-19）

继续使用原插件代码 1861343114。

• 退出 Anki 或切换用户时，未完成的后台分析会先保存为等待恢复；下次打开可用工作机、完成同步并退出复习后，自动验证笔记 GUID、卡片序号和原内容哈希，再继续处理。退出期间不启动新任务。
• 网络、服务临时故障和执行超时采用持久化退避，最多自动重试 2 次。退出恢复也使用同一上限，反复重启不会重置次数；离线探测本身不消耗执行重试。保留原错误、最近错误、下次时间、各次执行机器与尝试标记，任务表详情可查看。
• 精确迁移旧版“Anki 正在退出，已取消后台 Codex 任务。”失败；内容已变则标为冲突，缺少身份或原快照时不盲目回放。主动取消、鉴权/配置错误、内容冲突及已完成结果不自动重跑。
• 保留单工作任务、租约、内容校验与事件幂等；迟到回调不覆盖新尝试或终态。新增恢复状态不会被旧工作机提前领取；需升级工作机到本版才能执行新恢复队列。
• 保留 v1.14.8 的八列表格、发起/执行机器记录、原计划预测与语音功能，不改变个人模型设置或原有学习排程。

验证：15 项相关测试通过，覆盖实际生命周期函数、退出/重启、次数与退避、旧失败迁移、重复/迟到事件、租约、内容变化、账户隔离与 Qt 详情；本机正常安装、真实任务闭环及原生任务表格验收通过。跨设备协议使用模拟回归，未在第二台电脑实机验收。

公开包 101 个文件，不含集合、复习历史、私有设置、设备身份、任务日志或凭据。SHA-256：f25a0b8c2abfe3167284e16ffd62fd1fde023f9d36d3b4b002219e66931a9a8e。

已安装用户通过 Anki 桌面版「工具 → 插件 → 检查更新」升级并正常重启；跨设备任务和媒体仍需完成 Anki 原生同步。

历史发布记录

以下说明和校验值只对应各历史版本，当前行为以 v1.14.9 为准。

Codex 卡片优化器 v1.14.8

v1.14.8 — 优化任务表格与执行设备记录（2026-10-19）

继续使用原插件代码 1861343114。

• 优化任务改为八列表格：区分任务发起机器与实际执行机器，记录执行设备 ID、名称和开始时间；支持完整记录滚动、调整列宽、复制详情，每 3 秒刷新。题面按纯文本显示。
• 执行设备信息在成功、失败、写回和换机重试后保留，并通过现有跨设备协议同步。旧任务仅显示可信设备 ID；没有证据的历史设备名称显示未记录，不猜测补填。
• 包含近期原计划预测改进：冻结原计划范围、额度与目标日期，突出原计划预测完成日期及偏移；新增卡片与全部卡片独立预测，主动重订时归档旧计划。
• 保留晓晓语音、新增字符上限 0＝无限、中英文空格与格式修正，以及主窗口知识库入口。已有个人设置继续保留。

验证：本版交付中的 4 组相关测试、本机安装、原生同步及真实 Qt 界面验收已通过；本次仅发布已验收正式包，不重复修改集合或运行任务。跨平台实机效果不据此作额外承诺。

公开包共 100 个文件，仅含代码、默认配置、文档和必要音效，不含个人卡片、复习历史、私有设置、设备身份、队列日志或凭据。SHA-256：45dc99c5ecbc231767a6c6b8d7c0712ebbb9eb0ca2e00f5d56297254bbfffe86。

已安装用户可在 Anki 桌面版「工具 → 插件 → 检查更新」升级，按 Anki 提示重启；普通集合与媒体同步不等于 AnkiWeb 插件更新。

历史发布记录

以下说明、测试数量与校验值仅对应各历史版本，当前版本以上述 v1.14.8 为准。

Codex 卡片优化器 v1.14.1

v1.14.1 — macOS Edge Python 自动识别与自动生成无上限（2026-10-15）

继续使用原插件代码 1861343114。

• 修复 macOS / Apple Silicon 无法找到 Edge 生成运行时。 查找 Anki 自带虚拟环境、Anki.app 框架、AnkiProgramFiles、Apple Silicon Homebrew、Intel Homebrew 和 python.org 安装路径，兼容 Finder 启动时 PATH 不完整。每个候选通过离线实际启动、Python 版本及内置依赖导入检查；系统 Python 3.9 会跳过，现有 Python 3.12 可用。Anki 的 sys.executable 为应用启动器时不再直接当作 Python。
• 新增“Edge Python 路径（可选）”设置：留空自动查找，自定义安装可填写可执行文件完整路径并保存。路径保存在本机 user_files，不进入媒体同步，升级不覆盖，不需要修改插件源码或 pip 安装依赖。已有音频播放不依赖此运行时。
• 当前打包依赖（包括 aiohttp 等）要求 Python 3.10+；不把 edge-tts 自身的最低版本元数据当作整个依赖包兼容要求。探测不联网、不发送卡片内容，实际生成仍用隔离进程及标准输入传递文字。
• 每日自动生成字符上限支持 0＝无上限，新设置默认不限额。已有用户保存的数字限额保留，可在“主机夜间自动生成与预备余量”改为0。不设置每日总字符上限时，仍记录生成量并自动继续后续批次；每批最多25条只控制单批大小。保留主机隔离、03:00、空闲5分钟、使用Anki时暂停、已有缓存复用、网络错误退避和同步确认。手动批量生成的本次上限单独设置。
• 保留 v1.14.0 的完整活跃卡片预备、客户端缺音上报、文字严格匹配的本地晓晓复用；不改变卡片正文、FSRS、到期日或学习记录。

验证：206项相关测试通过，包含新增15项运行时查找、3.9拒绝/3.12接受、路径保存、探测缓存/回退、无上限与有限额度区分、分批续做及真实临时集合排程保留。Windows实际隔离运行时检查与Edge固定示例生成通过，正常重启及新增设置界面验收通过。macOS路径作模拟回归，未远程连接Mac进行实际发声验收；可在该设备升级重启后点击固定示例确认。

公开包94文件，不含个人卡片、任务状态、路径设置或凭据。SHA-256：746b85f0745bdc9607069a30f655bd51a74df95190b4358d13917a548e6f6b8e。

历史版本记录

以下记录的运行时查找及默认预算以 v1.14.1 为准；已保存数字预算可自行改为0。

Codex 卡片优化器 v1.14.0

v1.14.0 — 完整可学习范围预备与跨设备缺音闭环（2026-10-15）

继续使用原插件代码 1861343114。修正旧版预测范围过窄、客户端缺音未上报，以及“完成”统计不能代表全部可学习范围的问题。

• 指定主机预备池覆盖所选牌组内全部未暂停卡片：包括所有可学新卡、未来复习、原牌组归属的过滤学习，以及换日后可能重新出现的临时隐藏卡。优先最近实际遇到、当前学习/到期及已有余量，再处理其余部分。只准备音频，不解锁、取消暂停、解除隐藏、移动或修改排程。保留个人每天字符预算、03:00、主机身份与同步设置。范围上限20,000张。
• 客户端缺音会记录卡片ID，并通过现有Anki媒体同步请求主机准备，按设备分开文件，避免互相覆盖。客户端不自动合成；主动点击“生成晓晓语音”能力保留。自动请求及笔记同步仍等待退出复习后的安全空闲，不在正在复习时强行同步。主机需开机、联网、打开Anki并满足空闲条件。各设备需更新新版及启用媒体同步。
• 自动生成改为每次最多25条的小批次，完成一批后继续处理余量。受预算限制、模板不支持或编辑冲突时明确显示“尚未完成”及剩余数；不再把抽样检查完成说成全部就绪。成功批次不会消耗失败次数，使用Anki/正常退出造成的中断不计作网络失败，保留缓存并允许继续。网络失败仍有退避和尝试上限。
• 复习页区分未备好、音频待媒体下载、媒体同步未开启。夜间与空闲补漏各自保留起止时间、结果、剩余预算和最近30次历史。本机预备结果与媒体上传确认分开记录：需后续笔记同步成功、媒体同步结束、媒体数据库无待上传且新增文件已索引确认，才标记上传。主机上传成功不代表另一台已经下载，接收设备仍需完成媒体同步。
• 新音频引用先到、MP3尚未到达时，优先复用本机已下载且与当前文字严格匹配的晓晓音频，兼容历史语速和文字提取格式。不联网、不重写卡片引用，不使用文字不同的旧录音；没有匹配文件时明确提示媒体状态。完整范围校验也改为优先检查常用语速，并去除逐候选正则编译开销。
• 保留内容指纹、原生AV播放保护、编辑冲突跳过、备份和撤销、显式单卡生成，以及按Anki学习日累计的进度反馈。旧统计升级后标记为历史预测范围，重新核对完整范围。对暂停卡、原生用户录音和不支持模板保持原规则。

验证：191项相关测试通过，新增21项覆盖完整新卡/提前学习、跨设备缺音请求、临时隐藏、分批续做、预算不足、正确完成标记、活动/退出恢复，以及笔记/媒体分别确认、未索引文件和媒体同步关闭提示，并覆盖本地同文字音频复用、错误旧文字拒绝和文件名后缀兼容。真实临时集合的批量绑定保持排程及历史。Windows主机存量音频另作原生AV引用、源文字指纹、逐文件解码和非静音检查；其他电脑的实际下载播放未远程实机验证。网络或媒体下载未完成时仍可能暂用明确标示的本地备用，不能承诺离线时即时生成新内容。

公开包94个文件，不含个人卡片、复习历史、缓存、请求/主机状态或凭据。SHA-256：46619a94c660a3d5a1c7c18d83095d73b754cf44bf591a926eb8c1f92cfdc667。

历史版本记录

以下为历史版本说明；覆盖范围、完成与同步语义以v1.14.0为准。

v1.13.0 — 当前卡片快捷生成晓晓与学习日一致（2026-10-15）

继续使用原插件代码 1861343114。本次改进复习中的语音操作，并修正每日进度反馈的换日起点。

• 复习正反面右下角新增“生成晓晓语音”按钮，已有音频的卡片也显示。不必进入设置或选择牌组，点击后直接为当时那张卡生成问题与核心答案。按钮提示明确说明会联网把这些文本发送到微软 Edge；使用本机保存的语速，无需 Azure 账号或密钥，不调用收费 Azure。
• 生成期间可继续复习；结果只绑定点击时的卡片，不跟随下一张。完成后点“重读”可读取最新保存音频，不需要翻面或重置当前卡。已有匹配文字及语速的完整音频不重复生成；内容缓存仍复用。原生备份、撤销、编辑冲突跳过、独立音频字段与现有媒体同步继续使用。
• 与夜间及批量生成互斥；退出用户时取消，避免跨用户绑定。主动点击可在当前设备生成，自动夜间和空闲补漏仍仅指定主机运行。不自动评分、翻面或播放，不更改正文、卡片 ID、FSRS、每日额度和到期日。模板支持范围与前版相同，不支持的卡片显示原因。
• 每日百分比、人声里程碑和每日反馈统计统一按 Anki 学习日边界累计，读取 sched.day_cutoff，与首页统计一致。零点不再重置；换日时间可自定义，不硬编码四点。进度目标和原有音效保留。
• 旧的自然日缓存不会误导入新口径，首次升级按当前学习日的原生复习记录重建。排除手动重排记录；评分前切换统计日，避免刚写入的回答重复计数；卡片停留跨换日时保留正在进行的计时。

验证：170 项相关测试通过，其中新增 19 项覆盖当前卡绑定、换卡/编辑/退出保护、重复点击、缓存复用、保存后重读，以及午夜、定制换日、旧缓存迁移和评分计数。Windows Anki 已正常重启，实机看到并点击新按钮，验证已有音频不会重复生成；未评分。全新音频生成/绑定及排程保护使用真实临时集合配合模拟语音响应测试，未把该模拟当作本轮现场网络生成。未在其他设备实机验收。

公开包含 94 个文件，不含个人卡片、复习历史、缓存、任务状态或凭据。SHA-256：4dae477e1283052d845189fb89a36b75d3c2d707cf9e7af2d8fc6b1c69baa57c。

历史版本记录

以下为历史说明；当前复习按钮和反馈换日行为以 v1.13.0 为准。

v1.12.0 — 晓晓覆盖补漏与明确的备用语音状态（2026-10-15）

继续使用原插件代码 1861343114。缺少晓晓 MP3 时原系统会使用本地语音；本次增加主机空闲补漏，让自定义学习遇到的缺音卡片进入后续准备范围。

• 保留 03:00—06:30 夜间准备；新增可关闭的主机空闲补漏。仅已启用且匹配同步主机身份的设备运行，其他设备默认停用。Anki 空闲满 5 分钟、先完成笔记与媒体同步后生成，每 30 分钟检查。
• 复习时只记录最近缺音卡片 ID，不在线合成；下一次空闲优先补这些卡片，包括自定义学习实际遇到的卡片，再处理当前到期和预计范围。保留 2 天复习及 20 张新卡余量，不解锁、移动或取消暂停。
• 启用自动主机后，空闲补漏会将问题与核心答案发送到微软 Edge 在线语音。 已有主机升级默认开启补漏，可在原主机设置关闭；其他设备不会因此成为主机。普通复习播放保存的 MP3，其他设备下载媒体后可离线播放。
• 夜间与空闲补漏共享每日新增字符预算，保留个人上限。请求前保守预留，失败或取消不返还当日预留；缓存保留。每批笔记上限及每模式当天最多三次连续失败、至少 30 分钟退避限制保留。开始使用 Anki 时取消任务。
• 当前文字及媒体均有效的音频复用，包括旧语速。没有可用晓晓音频时，复习页明确显示“本地备用语音”。首次遇到范围外卡片、离线、达到预算或不支持的模板仍可能使用备用声音。
• 有引用但媒体文件尚未到达时，暂用本地备用，保留引用；文件到齐后恢复原生播放。
• 只绑定独立音频字段，沿用原生备份、撤销与编辑冲突检查。不改变正文、卡片 ID、FSRS、学习额度、到期日或历史。

验证：151 项相关测试通过，涵盖主机隔离、空闲阻断、夜间/补漏状态隔离、最近自定义学习优先级、旧语速复用、预算及排程保护。真实批量音频另检查内容指纹、原生 AV 引用与 MP3 非静音解码；未对所有音节逐字人工听审，未完成其他设备实机同步播放或真实凌晨触发验收。

公开包 93 个文件，不含用户卡片、复习历史、主机身份、缓存或凭据。SHA-256：a09deeac00044df09da7e3a8b17c0dade4b8f4bcb8a79db8711073cc86c5ba1b。

历史版本记录

以下说明只对应历史版本；自动联网范围与预算以上述 v1.12.0 为准。

v1.11.1 — 修复拆卡音频继承与朗读文字一致性（2026-10-15）

继续使用原插件代码 1861343114。修复已有晓晓音频在拆卡/修改文字后可能与当前题干、核心答案不一致的问题。

• 新拆出的卡片不再复制原卡的晓晓音频字段。 普通字段继承方式保留，新卡按原知识链规则进入，不把原卡录音当作新卡的语音。
• 编辑、AI 优化或复制写入前，按音频内容指纹核对当前题干/核心答案，只清除变更一面的旧晓晓引用；详情、标签和兼容的旧语速不会误清除。用户自行添加的录音与其它插件音频保留。
• 原生复习播放前再次过滤过期晓晓引用，并隐藏对应过期播放入口；缺少有效音频时使用当前可见文字的本地朗读。复习时不自动联网合成。没有安装此插件的设备需先同步主机更新后的笔记与媒体。
• 提取文字不做同义改写。 行内加粗/链接不再被强插空格；段落与换行仍有分隔。移除成对 Markdown 加粗和行内代码标记，保留实际字词及数学运算符。仍只提取问题和明确标记的核心答案，不发送折叠详情或来源。
• 生成仍使用内容缓存键。已有且匹配文字的旧版音频兼容；新生成使用改进后的文字提取结果。桌面主机可主动重新生成受影响音频，完成 Anki 笔记和媒体同步后其它设备离线播放。
• 保留主机凌晨 03:00、空闲 5 分钟、2 天复习及 20 张新卡余量、预算与停止规则；个人上限与语速设置不覆盖。不修改题干/答案正文、卡片 ID、FSRS、到期日或复习历史。

验证：141 项相关测试通过，新增 18 项覆盖真实临时集合写入钩子/撤销、拆卡字段复制、单面失效、详情编辑、历史缓存、过期播放过滤和行内格式提取。Windows Anki 26.9.2 正常重启，现有音频完成原生 AV 引用、当前源文字指纹、MP3 解码及非静音检查。没有对每段合成语音逐字人工听审；其它系统与设备尚未实机验证。

公开包包含 93 个文件，不含用户卡片、复习记录、缓存、任务状态或凭据。SHA-256：d3c898aa19f84bb6097bc226842d27bf85256f16567c4ccd2e9ea7723b5c8a91。

历史版本记录

以下版本说明仅对应当时实现；文字一致性保护以上述 v1.11.1 为准。

v1.11.0 — 主机凌晨生成与自定义加学余量（2026-10-14）

仍使用原插件代码 1861343114。新增可选的主机夜间生成，保留 Edge/Azure 手动生成、本地朗读、AI 优化、学习看板、分时学习及字体修正。

• 入口：控制中心 → 语音与反馈 → 语音设置 → 晓晓与同步音频 → 主机夜间自动生成与预备余量。所有设备默认停用；只在选定主机点击“将本机设为语音主机并保存”。本机启用状态按用户独立保存，匿名主机标记通过 Anki 媒体同步；升级不会让其它电脑自动成为主机。
• 默认本地时间 凌晨 03:00 开始，03:00—06:30 内 Anki 空闲至少 5 分钟且不在复习、模态窗口或同步时执行。准备的是接下来白天的卡片，遵守 Anki 换日时间。主机必须开机、联网并打开 Anki；不会唤醒休眠电脑或自行启动应用，错过窗口等待次夜。
• 默认预备目标学习日及之后 2 天的到期/学习卡，并在正常每日新卡额度之外再准备 20 张新卡。可调整为 0—14 天及 0—200 张；遵守父牌组额度，优先目标日，再处理余量。这些只改变音频范围，不改变每日新卡额度、不自动解锁、不取消暂停、不改 FSRS 或到期日。
• 未来评分、随机新卡顺序、临时解锁和任意自定义学习无法精确预测。过滤牌组及暂停/锁定卡不自动发送。范围外继续使用原有本地朗读，或主动为当前卡片生成；有限余量不代表全库都有晓晓。
• 夜间任务先请求现有空闲同步，确认最新笔记和主机标记下载完成，再本地预览、生成缺失音频。完成后请求同一空闲同步流程；其它设备下载媒体后由 Anki 原生离线播放。需开启现有空闲/跨设备自动同步、登录 AnkiWeb 并启用媒体同步。
• 启用后会自动联网，使用无需账号/密钥的 Edge 晓晓；把所选问题与核心答案发送到微软在线语音服务，不发送折叠详情、来源或凭据。夜间不自动调用收费 Azure；语速使用本机保存值。Edge 社区接口可能限流或变化。
• 默认每晚最多更新 300 条笔记、新增 50,000 文本字符，可调上限。内容、语速、引用和媒体均完整时跳过；变化或缺失才生成。失败保留缓存、在夜间窗口间隔至少 30 分钟重试，最多 3 次合成尝试。退出、开始使用 Anki 或主机身份变化会取消后台合成；设置页可停用或停止。
• 写入沿用原生备份、独立音频字段、编辑冲突跳过及撤销。首次增加音频字段可能需要手动完整同步；不会替用户选择上传/下载。需先完成主机同步，再同步其它设备。移交主机时先同步旧机，在新机认领后同步，再同步旧机；不要把主机的 user_files 复制给其它电脑。

验证：123 项相关测试通过，包括 21 项夜间换日、主机身份/迁移、同步等待、父牌组额度、加学余量、缓存、预算与真实临时集合排程保留测试；Windows Anki 26.9.2 已正常重启并验收实际设置界面的 03:00、2 天、20 张及主机状态。尚未等待真实夜间触发或完成其它设备实机同步播放；这些不冒充已验收。

公开包 92 个文件，不含用户卡片、复习记录、主机身份/启用状态、任务状态、缓存或凭据。SHA-256：2499e5ced6db7b5b9007812d23054368027c6872ea0431dfad08d4ca552ca46d。

历史版本记录

以下 v1.10.0 的“仅点击时联网”指手动模式；启用夜间自动生成后的行为以上述说明为准。旧版本的包大小、测试数和哈希仅属于对应历史版本。

v1.10.0 — 免 Azure 账号的晓晓语音、生成与跨设备播放（2026-10-14）

继续使用同一个插件代码 1861343114，无需另装业务插件。包含 v1.8.0 以来的字体修正、Azure 接入，以及默认 Edge 在线晓晓；AI 卡片优化、分时学习、学习看板、知识链与游戏反馈继续保留。

晓晓语音怎么使用

• 入口：工具 → Codex：控制中心… → 语音与反馈 → 语音设置 → 晓晓与同步音频（Edge / Azure）。未配置 Azure 资源的新用户默认 Edge；已有 Azure 配置保留。
• Edge 在线晓晓不需要 Azure 账号、绑卡或密钥。 可先播放固定示例，再选择牌组与范围预览。默认范围是当天到期卡片和最多 20 张未暂停新卡；这是音频生成范围，不改变每日额度或分时开放规则。
• 生成需要联网。 仅在主动点击试听或生成时访问微软在线语音服务；生成时发送所选问题与核心答案。预览、启动、普通复习与同步不会自动调用在线生成。不上传折叠详情、来源或隐藏答案提示。
• 复习时播放已保存的 MP3，不会每次重新联网合成。 主电脑生成后，MP3 与笔记音频引用通过 Anki 同步。其他电脑、AnkiDroid 和 AnkiMobile 下载完媒体即可离线播放，不需要生成器、密钥或本地语音模型。
• 支持范围预览、预计新增文本字符数、本次字符上限、缓存复用、停止生成与缓存重试。文字、语速或服务变化会使用不同缓存键；Edge 与 Azure 缓存分开。
• 首次生成会先创建 Anki 原生备份，再增加两个独立音频字段和对应模板引用，避免背面重复朗读问题。原有问题/答案正文、卡片 ID、FSRS、到期日和学习记录保留。首次笔记类型变动可能要求完整同步；请先完成主电脑同步，再同步其他设备。
• 预览后笔记或模板被编辑会跳过，避免覆盖新操作；支持 Anki 撤销。当前支持带正面/背面字段的单方向普通问答卡；挖空、反向/多卡模板、已有其他录音、无明确核心答案的富文本及超长文本会跳过。
• 音频自动播放由 Anki 牌组选项控制。文字修改后需要在主电脑重新生成并同步。升级插件不会自动为全库生成语音。

本地朗读与 Azure 可选项

原有本地备用朗读继续保留：Windows 使用 SAPI，macOS 使用系统 say，需安装对应语言语音；本地默认 1.5 快速档、120 毫秒启动等待不变。macOS 已有适配代码，但尚未实机验收；不保证所有系统语音均可被 say 调用。

Azure Speech 仍可在服务下拉框选择，需要用户自己的资源区域与密钥，可能计费。Windows 密钥使用 DPAPI 在本机加密保存，不同步到卡片或公开包。Edge 使用社区项目 edge-tts，接口可能限流或变化，不提供 Azure 官方 API 的可用性承诺。依赖源码、固定版本和许可证随插件携带并隔离运行，无需自行 pip 安装，不替换 Anki 依赖。

字体与验证范围

统一 Qt 界面调整中文字体优先级和正文大小，改善高分屏中文显示；保留原生缩放与深浅色偏好。提前学习入口仍在分时设置主区，不移到首页或工具一级菜单。

本轮 102 项相关自动测试通过，覆盖语音、缓存、取消、凭据保护、临时真实集合中的音频绑定/撤销/排程保留及 Qt 控件。Windows 上已实测 Edge 晓晓中文/中英混合固定示例生成和 MP3 解码。最终 Windows 应用内点击试听的自动验收因窗口工具故障未完成；macOS 及其他设备实际同步播放未作实机验证。Azure 未做真实资源调用。

公开包包含 89 个代码、默认配置、文档、必要音效与语音依赖源码文件，不含个人卡片、复习记录、任务状态、缓存、密钥或登录凭据。

本包 SHA-256：518291649f44bf94bcff7384a6de1949e5927f4bded329a13e694e1c8e666a0c

历史版本说明

以下为旧版本发布记录；其中“不上传”的语音说明仅指当时的本地朗读模式。最新版在线生成的行为以上述说明为准。

v1.8.0 — 统一视觉与学习助手控制中心（2026-10-14）

仍使用插件代码 1861343114，不需要第二个插件。这是可关闭的统一视觉层和菜单整理，不是重写整个 Anki，也不修改 Anki 本体文件。

• 为 Anki 拥有的原生 Qt 主窗口和弹窗统一字体、按钮、输入框、列表/表头、页签与菜单，支持原生深浅色模式。增加明确键盘焦点、可读对比度和控件无障碍名称。
• 工具菜单保留「Codex：每日分时学习设置…」直接入口，其余散落操作收纳到「Codex：更多操作」，按卡片与任务、学习与声音、知识链、诊断与同步分区。
• 新增「工具 → Codex：控制中心…」，按学习节奏、语音与反馈、卡片与任务、知识链与系统分类组织已有功能，给操作补充简短说明。复用原 QAction，保留快捷键、实时开关、禁用状态、业务回调和动态任务信息。打开控制中心不自动运行优化、解锁或评分。
• 重排分时与语音窗口：清晰标题、说明、留白与主按钮，减少空表区。提前学习仍在分时设置主区，保留默认否的确认，不在首页增加后续任务提醒。
• 复习底部操作栏补充统一样式，不改变评分命令。卡片问题/答案、编辑器正文、原生统计图与操作系统标题栏保留原生实现；没有全量替换 Anki 的编辑和统计流程。
• 控制中心可关闭「统一现代主题」，恢复原有窗口样式，菜单整理仍保留。不切换用户的 Anki 深浅色偏好，不改变语音设置、分时进度、每日额度、FSRS、到期日或复习历史。保留 5 分钟曲线与新卡完成预估。

验证：202 项逻辑、原生调度、真实 Qt/DOM 回归测试通过，包括菜单对象/快捷键/回调保留、开关与禁用状态、重复注册防护、视觉层关闭恢复、深浅色配色和文字对比度。Windows Anki 26.9.2 实机验收主窗口、控制中心、语音、分时与原生浏览窗口；其余内建窗口复用统一主题，未逐一工作流验收。未在实机触发优化、解锁或评分。其他平台未作实机验证。公开包不含个人卡片、学习记录、任务状态或凭据。

v1.7.0 — 细粒度平滑曲线与新卡完成预估（2026-10-14）

仍使用插件代码 1861343114，所有功能集成在同一个插件。

• 学习强度统计从每 30 分钟细化到每 5 分钟。曲线使用经过真实数据点的受限三次连接，不平滑或篡改统计值，不产生超调峰值；悬停查看每个时间窗实际用时。曲线连线并非连续实测，也不是疲劳或记忆效果评分。
• 今天只画到当前统计时刻，不预测未来强度；昨天完整日曲线仍可参照，指标和同进度对比口径不变。当前未结束时间窗明确提示。
• 看板下方新增默认折叠的「新卡学习进度与完成预估」，不会主动暴露积压数或催促继续学习。范围为配置中的知识库及子牌组，过滤牌组按原牌组归属，不重复计数。
• 显示尚未初学的新卡数、知识链待解锁数，以及按每日额度、按最近 7 个完整学习日实际初学进度推算的天数和日期。当天剩余额度读取原生牌组计数，而非分时队列快照；支持当天临时额度。
• 手动暂停、保护或不自动解锁的新卡单列，不计入日期；存在此类卡片时明确标注“全部新卡完成日期暂不可确定”。
• 日期只估计完成首次学习，不代表长期掌握或所有复习结束。计划估算假设每天用满额度、子牌组无额外限流且前置知识及时掌握解锁；近期外推包含未学习的日子，均为条件估计而非保证。
• 全部统计与预估只读，不读取卡片正文，不自动解锁或取消暂停，不改变 FSRS、到期日、学习记录、语音设置和每日新卡额度。保留 v1.6.1 的快速朗读、主区提前学习和现代首页。

验证：179 项逻辑、原生调度与 Qt/DOM 回归测试通过，覆盖曲线不超调、数据总量守恒、跨午夜日期、零额度、无历史、暂停分类、当天额度覆盖和过滤牌组原归属。已在 Windows Anki 26.9.2 正常重启并验收实际曲线与预估折叠区；其他平台未作实机验证。公开包不含个人卡片、复习记录、任务状态或凭据。

历史版本记录

v1.6.1 — 更快朗读、直接操作与现代首页（2026-10-14）

仍使用插件代码 1861343114，无需安装第二个插件。

• 本地朗读默认语速从 1.0 调为 1.5 快速档，启动等待从 350 缩短到 120 毫秒；语速可调范围 0.6～2.0。系统档位并非精确倍速，音色仍取决于本机系统语音，并非云端神经语音。旧默认设置只迁移一次；已有非默认语速和其它个人设置保留。
• 「提前学习下一时段…」移到「工具 → Codex：每日分时学习设置…」主操作区，无需展开更多选项。首页、完成页和工具一级菜单仍不增加提前学习入口或后续积压提示；无可开放时段时按钮禁用。打开设置不会自动解锁，确认默认仍为“否”。
• 重构牌组首页与概览：当前时段、牌组列表、学习节奏统计分区；统一排版、留白、对比度和深浅色主题。完成状态使用短标签，不重复堆叠下一开放时间；支持窄窗口与键盘设置操作。
• 保留原生牌组链接、折叠、设置和同步操作；原生复习界面和卡片模板不改。保留学习看板、知识链、游戏反馈与 AI 卡片优化。
• 保留 07:00 / 13:30、60:40 分时任务、当天主动开放状态及每日新卡额度；不更改卡片到期日、FSRS 或复习历史。翻面、换卡和退出仍即时取消旧朗读。

验证：129 项逻辑、原生调度、真实 Qt 控件及 DOM 测试通过，另完成深浅色主题的 8 个窗口宽度组合测试、Windows Anki 26.9.2 重启加载和实际设置界面检查。公开包不含个人卡片、复习历史、任务状态、登录信息或凭据；语音无需上传卡片。

历史版本说明（以下入口与默认参数以当时版本为准）

v1.5.2 — 藏在设置中的主动提前学习（2026-10-14）

仍使用插件代码 1861343114，无需第二个插件。

• 入口在「工具 → Codex：每日分时学习设置… → 更多选项 → 提前学习下一时段…」。更多选项默认折叠，首页、完成页、工具一级菜单不增加入口或剩余数量提醒。
• 打开设置或展开更多选项不会解锁；必须主动点击并确认，确认框默认选择“否”。当前时段首次任务完成后，才可以提前开放下一个时段。
• 只影响今天，次日按 Anki 学习日切换自动恢复原定时段。当天重启保留提前开放状态，不把用户重新锁回上午。
• 多个时段逐个开放，不一键开放整天。确认时再次校验学习日与目标，避免跨越自动开放时刻后意外开放更晚时段。
• 不增加新卡额度，不修改固定时间、比例、到期日或 FSRS；不伪造学习完成记录。确认后进入当前牌组概览，不自动评分。
• 保留 v1.5.1 安心休息完成页、v1.5.0 本地语音、首页看板、知识链与 AI 卡片优化。

验证：72 项逻辑、原生调度与真实 Qt 控件测试通过（Windows Anki 26.9.2），覆盖折叠隐藏、取消确认、二次校验、重启保留、学习日失效，以及提前学完后全天新卡仍为 20 张。实机已加载，并验证主动提前开放与用户复习进度保留。公开发布包不含个人卡片、复习历史、任务状态或凭据。

v1.5.1 — 完成后安心休息，不再显示未开放积压（2026-10-14）

仍是同一个插件 1861343114，保留语音、分时任务、知识链、首页看板及 AI 优化功能。

• 非最后时段完成后，牌组行不再显示全天剩余新卡/复习数，改成「本时段已完成 · 下一时段自动开放」。默认下一时段为 13:30。
• 弱化完成牌组的颜色与选中背景；保留牌组链接、设置和折叠功能。
• 当前没有可继续任务时，牌组概览不再显示「开始当前时段」按钮，明确提示可以休息，无需反复点击检查。
• 当前选中牌组确有后端允许的当天学习/重学步骤时，单独显示步骤数量和继续入口；不混入下午尚未开放的首次任务。
• 开放时间到达后自动刷新，恢复原生数字；不强行进入复习页。支持多个时段及深浅色主题。
• 仅改 HTML 展示，不降低后端额度，不把隐藏任务标为完成，不修改到期日、FSRS 或复习历史。

验证：49 项显示逻辑与原生 Anki 调度回归测试通过（Windows Anki 26.9.2）；完成深浅色实际数据渲染检查、实机首页/概览加载及重启验证。公开包不包含个人卡片、统计、任务状态或凭据。

v1.5.0 — 本地语音读卡（2026-10-14）

语音朗读也整合进原插件 1861343114，无需第二个插件。

• 复习页右下角增加「朗读：开/关」与「重读」；工具菜单提供同一个开关，状态保存在本机。
• 默认朗读问题，翻面后朗读核心答案；不自动读详情、来源或隐藏提示。可设置自动朗读哪一面、语言与语速。
• 从已渲染的可见卡片提取文本，挖空题正面不读取原始字段答案。翻面、换卡、评分和退出会取消旧语音及延迟回调。
• Windows 使用本地 SAPI，macOS 使用系统 say；Linux 需已安装支持对应语言的 espeak-ng/espeak。缺少本地语音会提示，不阻断复习。当前 Windows 中文发声和即时停止已验证，其他平台未作实机验证。
• 语音引擎独立于原生音频；有原生音频的面不重复自动朗读，可手动重读。
• 不上传卡片，不记录卡片朗读文本，不改卡片、FSRS、到期日、每日新卡额度或分时规则；保留首页看板和已有功能。

验证：29 项开关、生命周期与排程安全测试 + 8 项真实 QtWebEngine 文本提取测试通过，另完成 Windows 本地中文语音及停止测试。升级后需重启 Anki。移动端不运行桌面插件；本功能不宣称在 AnkiMobile/AnkiDroid 上执行。

v1.4.0 — 首页学习节奏看板（2026-10-14）

打开 Anki 桌面端的牌组首页，即可在顶部显眼位置看到今日学习统计，无需新增插件。插件代码仍为 1861343114。

• 今日有效学习用时、作答次数、去重后的已学卡片数，以及已完成的新卡初学数。
• 每 30 分钟累计作答用时曲线：今天为实线，昨天为虚线，今天只画到当前统计时刻。
• 昨日环比、上周同日与去年同比，按相同学习日进度对比；没有同期记录或用时基线为零时不伪造增长率。
• 支持深浅色主题及窄窗口，全部图形在本地生成，无外部图表库或网络服务。
• 按 Anki 学习日切换时刻统计，不把应用打开时间当作有效学习时间；不会展示尚未开放时段的待学积压。
• 只查询四个指定日期窗口的复习记录，缓存短期结果，作答、同步或切换用户后失效；统计异常不会阻断牌组首页。
• 保留 v1.3.1 的每日 20 张额度修复及 07:00 / 13:30、60:40 分时任务机制，不修改卡片内容、到期日、FSRS 参数或复习记录。

有效用时是 Anki 每次作答计时的累加，不含闲置，并受原有计时上限影响；强度表示时段内作答用时，不是脑力疲劳或记忆效果评分。

验证：22 项统计、原生数据库只读、首页注入及错误隔离测试通过（Windows Anki 26.9.2），完成深浅色界面检查。公开发布包不含个人卡片、复习历史、统计数据或凭据。

v1.3.1 — 修复每日新卡任务被二次拆分（2026-10-14）

• 修复其他分时插件先筛选上午队列、统一插件再将其误当全天队列拆分的问题。
• 全日规划及出卡读取 Anki 后端原生队列；保持原生每日额度、队列顺序和学习步骤，不把每天 20 张额度变成全天 12 张。
• 声明与 daily_study_segments、daily_session_gate 冲突，避免两个分时门控叠加。
• 对旧的部分队列规划进行一次校正，保留已完成任务及学习进度；不重新算作首次任务。
• 时段仍默认 07:00 / 13:30，60:40。相同耗时的 20 张新卡可拆为上午 12 张、后段 8 张；混合复习任务仍按历史耗时规划，实际分配不保证固定张数。
• 不提高原生额度、不修改到期日或 FSRS 参数，不暂停、不移动卡片。

验证：24 项分时逻辑及原生调度回归测试通过（Windows Anki 26.9.2），覆盖双门控、20 张两段完整学习、进度保留和原生低额度边界。公开包不含个人卡片、复习历史、任务状态或凭据。

v1.3.0 — 单插件整合：每日分时学习（2026-10-13）

插件代码仍为 1861343114。每日分时学习现在直接包含在 Codex 卡片优化器中，不需要额外安装 daily_session_gate；原有 AI 卡片优化、知识链、游戏化复习反馈、声音反馈和媒体同步代码更新功能继续保留。

自动拆分每天的学习任务

• 默认 07:00 / 13:30，60:40；按近 30 天卡片每日总复习耗时估算任务量，而不是单纯按张数或倒计时。
• 早段任务完成后，暂不展示后段的首次任务，到开放时间自动继续；未完成或跳过的任务自动结转，已完成的首次任务不重复计数。
• 保持 Anki 原生队列顺序、每日限额、学习及重学步骤。短期重复仍由 Anki 原调度决定，因此实际学习时间可能超出估计。
• 不修改卡片到期日或 FSRS 参数，不暂停、不移动卡片，不以过滤牌组实现门控。
• 入口：工具 → Codex：每日分时学习设置…，可设置两个或更多时段及其时间、比例。时段改动从下一个 Anki 学习日生效。

安装与跨电脑使用

新电脑只需安装本插件 1861343114；已安装者在「工具 → 插件 → 检查更新」升级。普通 Anki 收藏同步不会自动安装 Python 插件。原有媒体同步代码更新机制仍保留。

本机旧独立分时插件的设置和任务状态自动迁移；声明与 daily_session_gate 冲突，避免两个门控同时运行。升级会保留原有插件个人设置。

分时门控仅在安装本插件的 Anki 桌面端执行。分时配置和任务状态目前保存在本机，不通过普通 AnkiWeb 收藏同步；正常复习记录仍按 Anki 原生机制同步。手机端和 AnkiWeb 不执行此门控。

本次验证与隐私

新增与整合验证共 25 项通过。原生调度实机验证环境为 Windows Anki 26.9.2；保留旧版 Card 接口回退，不宣称所有旧版本均经过实机测试。发布包仅包含代码、默认配置、文档和必要音频，不包含个人卡片、复习历史、任务状态、登录信息或凭据。

既有功能说明与历史更新记录

以下为旧版发布时的说明，旧版测试数量与校验值属于历史记录，不是 v1.3.0 的新增测试结果或安装包校验值。

v1.2.6 历史说明

一个插件代码获得完整桌面功能：把 Anki 复习中的“卡住”转化为可持续处理的 AI 优化任务，并整合连击反馈、知识链解锁、提前学习新旧混合和跨电脑任务处理。

最低支持 Anki 25.09.4。最高版本不设封顶；已验证 Windows Anki 25.09.4，以及 Anki 26.08.1 的官方 aqt/anki API、Hook 与离屏 UI 交互。

v1.2.6 更新

• 修复 macOS 正在复习时被误判为空闲并触发同步。
• 复习状态现在是自动同步的硬阻断；卡片仍显示时，普通同步和跨设备轮询都不会启动。
• 翻面、显示下一题、作答和离开复习都会刷新活动时间，兼容 macOS WebView 不完整上报键鼠事件的情况。
• 等待中的跨设备任务不会丢失；退出复习并达到安全空闲窗口后会继续同步。

v1.2.5 更新

• 修复 B 与 Anki“浏览卡片”全局快捷键的冲突，移除 B 方案。
• “没想起”备用键改为靠近空格键的 M；数字 1 继续保留。
• 插件在复习状态只注册一个 M：答案面执行 Again，问题面继续打开 Anki 原有“更多”菜单，避免重复快捷键竞争。
• 已通过 Windows Anki 25.09.4 的真实 Qt/Hook 交互冒烟测试。

v1.2.4 更新

• “没想起”新增靠近空格键的 B 备用快捷键，原有数字 1 保持不变。
• B 仅在答案面且焦点不在输入框时生效，执行与 Again 完全相同的排程、连击和反馈流程。
• 新增快捷键回归测试，并完成完整验证部署。

v1.2.3 更新

• 补全跨设备自动闭环：桌面 Anki 即使没有本地待上传修改，也会定期拉取 AnkiWeb 的集合与媒体变更。
• 装有 Codex 的工作机在 Anki 空闲 15 秒后开始自动同步，此后默认每 5 分钟轮询远端任务。
• 新任务、领取状态和优化完成结果会请求快速安全同步，不再受原先最长约一小时的同步冷却影响。
• 结果仍用卡片内容哈希防止覆盖其他设备的新编辑；网络失败继续自动退避重试。
• 完整上传或下载冲突不会自动选择方向，仍会提示用户处理。

主要功能

• 复习页右键直接选择具体卡住原因；支持复杂模型自定义优化及核心答案专项优化。
• 按“完成、进行、待处理、失败”统一记录手动优化、右键优化、超时反馈和自动诊断。
• 普通更新完成后安全写入；拆分卡只在退出复习后创建，并默认暂停。
• “想起来了”使用随连续成功次数变化的多音连击音效和同步视觉特效。
• 知识链分层解锁默认每天 20 张；“自定义学习”默认选择“提前学习新旧混合”。

跨设备 AI 队列

1. 任务随 Anki 集合与媒体同步进入 AnkiWeb。
2. 保持 Anki 打开的桌面工作机会自动拉取任务。
3. 检测到本机 Codex 后自动领取并处理。
4. 优化结果和任务状态自动同步回 AnkiWeb，其他设备下次同步后获得结果。

任务带有租约和内容哈希；工作机异常退出后可以恢复，卡片内容已变化时不会覆盖新编辑。

标准 AnkiMobile/AnkiDroid 不运行桌面 Python 插件，因此手机本身不能执行 Codex。只要待优化任务已经进入 AnkiWeb，桌面工作机即可自动处理；手机仍需使用 Anki 自带同步上传请求和下载结果。

模型路由

• 简单答案优化、问题设计：gpt-5.6-luna / low。
• 重复超时全面诊断：gpt-5.6-terra / low。
• 陌生术语、缺少前置知识、自定义指令、事实修正及核心答案专项：gpt-5.6-terra / medium。
• 默认不使用 gpt-5.6-sol。

安装与升级

在 Anki 桌面版打开“工具 → 插件 → 获取插件”，输入插件代码 1861343114，安装后重启 Anki。多台电脑应登录同一个 AnkiWeb 账号；工作机需安装并登录 Codex。

升级不会打包或覆盖个人配置与任务历史。

隐私与验证

• 安装包不包含 API Key、Codex/ChatGPT 登录、个人卡片或复习历史。
• 跨设备任务事件不包含卡片正面、背面或复习记录。
• 单元与契约测试：150/150 通过。
• Anki 25.09.4 / 26.08.1 双版本 UI 交互冒烟：通过。
• 本机验证部署：hashVerification: passed。
• 发布包 SHA-256：2413FAA39AE70DEBACF3F2CDD3F669A5BD5B04405D83F7442B7D3460BFB63EF7