Repository navigation
Releases
WordPaper 2.6.7 · 新词书目录、学习记录与派大星
WordPaper 2.6.7 · 每天一点,慢慢记牢
这次把词书目录、每日学习记录与复习排期一起更新:选书更清楚,练习有记录,下一次复习也有具体时间。
像挑一本词书,选好今天的方向
词库现在按日语、英语和更多语言分组。每本书都有对应的封面颜色、图标与考试标识,名称、用途、词数分行呈现。当前选择固定显示在顶部,点「浏览词条」即可查看和初筛。12 本内置词书之外,仍可用 CSV、Excel、粘贴或本机截图识别建立「我的词库」。浅色、深色、编辑风与动漫风四套界面都适配,键盘也能选择。
每一遍练习,都值得被看见
「今日学习目标」同时显示学习合计、单词背诵与造句次数。你可以按其中任一项设置每天的目标,完成后打卡。同一个词再练一遍会计入,答错、模糊或造句未满分也会记录这次练习。
展开「当天单词与下次复习」,可以按日期看到每个词练了几次、最近一次是什么时候、下一次复习在哪个时间。逐词明细保留最近 90 个自然日;原有打卡和旧版首轮计数继续保留。旧版未保存的复习与造句明细无法追溯,新记录从这次升级开始积累。
下次何时复习,现在就知道
每个词有自己的排期。先回想,再按「不会 / 模糊 / 背过了」作答,词卡会更新下一次复习的具体时间。答错手滑可以撤销,排期和本次计数一同恢复。
到期后还有按本轮实际间隔计算的宽限期,临近降级时会提示剩余时间。超过宽限期,同一次漏复习只降一轮,仍可立即复习;第 1 轮不再降低,完成全部 8 轮的词不降低,已完成的学习次数也保留。已有积压词也从本版起适用;关闭复习提醒不会暂停逾期计时。 这是应用的排期规则,并非对个人遗忘程度的测量。查看详细规则与模型说明。
主窗口关着,练习也能记下来
桌面小词灵、抽查与造句会在动作发生时保存记录,首次学习即时建立下次复习排期。重复轮询、重启或同步重放不会重复计数;撤销的练习不会被旧设备重新加回来。已连接同步账号的设备在离线时排队,恢复联网后合并学习活动。跨设备同步仍需要配置账号服务器,静态演示站只在当前浏览器保存数据。
派大星会散步,也会催你背单词
有待答词时,派大星也能自由走动。鼠标停在身上,它会挥手、出现星光,再展开词卡;移动到词卡上可以继续答题,离开后延迟收起。
连续未学习 0–5 分钟时悠闲散步,5–15 分钟时表情委屈、步子变慢,15 分钟以上会红温、冒蒸汽、跺脚并显示「未学习」计时器。真实背诵、作答或完成造句后重新计时;悬停、拖动、听朗读和系统自动处理逾期都不会误清零。锁屏、睡眠或没有学习任务时暂停,重启后保留已累计时长。
下载与更新
| 你的 Mac | 安装包 |
|---|---|
| Apple 芯片(M 系列) | Apple Silicon 完整版 |
| Intel 芯片 | Intel 完整版 |
| 希望首次从国内镜像获取主运行环境 | Slim 国内加速版 |
- 2.6.2 及以上旧版本用户:在 WordPaper 的「检查更新」中安装;安装完成后会自动重新打开 App。正式版本发布后,App 的例行检查也会发现新版。
- 下载超时怎么办:应用内下载有 5 分钟时限,慢速网络可能提示超时,原 App 和用户数据会保留。可稍后重试,或用浏览器下载上方对应芯片的完整 DMG,下载完成后退出 WordPaper,再把安装盘里的 WordPaper.app 拖入「应用程序」并选择替换,重新打开即可。
- 2.6.1 及更早版本:旧更新器无法替换原生程序,请下载完整 DMG,退出 App 后覆盖「应用程序」中的 WordPaper.app。之后可在 App 内更新。
- 第一次安装:打开 DMG,将 WordPaper 拖入「应用程序」。当前 App 未经过 Apple Developer ID 签名;如果 macOS 拦截,前往「系统设置 → 隐私与安全性 → 仍要打开」。
- 账号、自定义词库、学习记录与设置保存在原用户数据目录,覆盖 App 不会清空它们。可在更新前用顶栏「备份」导出一份自己的数据。
- 三种包均包含语音环境;两个完整版另带主运行环境,Slim 首次打开需要下载。校验文件:SHA256SUMS.txt。
截图由 2.6.7 的真实页面操作生成,使用独立演示账号。图中的 30 次学习、7 天打卡和单词排期均为示例数据。
发布验证:账号与同步测试、复习规则和每日统计浏览器测试、73 项主流程、9 项像素渲染、14 项派大星原生检查,以及 macOS 原生退出重开、真实 DMG 挂载安装与数据保留测试。三个安装包均附带完整文件清单与 SHA256 校验。
WordPaper v2.6.3 · 派大星同步跟读与状态栏音色
让派大星在桌面上陪你读单词和例句,并把音色选择收进紧凑的状态栏菜单。
- 点击题卡旁的派大星,依次朗读当前单词与例句;例句气泡自动出现,朗读结束后收起。
- 例句按真实语音时间逐词高亮;嘴型随音量开合,身体轻摆、点头和挥手持续到读完。
- 顶部状态栏菜单直接选择 Aria、Guy、Sonia、Ryan 四种音色,可独立试听、自动保存;收起菜单会停止试听。
- 安装包内置可搬移的语音运行环境,不依赖用户电脑上的 Homebrew、pip 或开发目录。在线音色需要网络;离线时回退系统声音。
- 新菜单页面和语音组件放入旧版更新器已支持的资源目录,修复从 2.6.2 更新时可能漏装新文件的问题。
安装与更新验证:
- 正式发布后,已从 GitHub 经真实应用内更新完成本机 2.6.2 → 2.6.3,自动重新打开工作区,主服务与小词灵均运行 2.6.3;安装后的 2018 个资源文件及原生程序校验一致。
- 使用已发布的 2.6.2 Apple Silicon DMG 内的原版更新器,实际升级到本次 2.6.3 DMG:静默挂载、校验、完整安装、新原生窗口启动均通过。
- 真实原生更新流程验证旧进程退出、新窗口自动重开,账号、提醒和学习记录保持。
- 升级后四种音色均成功合成音频并返回逐词时间点;Apple Silicon 与 Intel 的四种音色均通过实际合成测试(Intel 在 Rosetta 下测试)。
- Slim 在空运行环境目录中完成首次在线下载、固定 SHA256 校验和 Node/SQLite 启动。
- 全量回归、Mac 安装/重启测试、嘴型/高亮同步、状态栏菜单和试听测试通过;三个 DMG 均附 SHA256 校验。
2.6.2 可直接在 App 内检查更新并安装。2.6.1 及更早版本仍需下载完整 DMG,替换「应用程序」中的 WordPaper。 首次安装需按 macOS 的隐私与安全性提示允许打开。个人数据继续保存在原位置。
提供 Apple Silicon(约 79 MB)、Intel(约 80 MB)和 Slim(约 65 MB)三个安装包。完整包推荐用于稳定安装;Slim 自带双架构语音环境,首次启动仍需下载主 Node 运行环境。
WordPaper v2.6.2 · 文件选择与完整应用更新
修复 Mac App 内「上传照片」无反应,以及应用内更新无法完整更新原生程序的问题。
- 接入系统文件选择器,照片、词库和进度文件可正常选择;取消不会更改原内容。
- 更新校验并安装原生主程序,成功后退出旧进程并自动重新打开同一 App;失败回滚并保持服务在线。
- 更新下载遵循系统代理,处理连接/低速超时;只提示安装包已就绪的正式 Release,GitHub API 限流时回退官方发布页和 SHA256 校验文件。
- 更新静默挂载安装包,不再自动弹出临时目录;重试前重新检查版本。
2.6.1 及更早版本需完整安装此次 DMG。 旧更新器不能替换原生程序;安装 2.6.2 后,之后这类原生程序更新可在 App 内完成。个人账号和学习数据保持原位。
提供 Apple Silicon、Intel、Slim 三种 DMG 和 SHA256SUMS.txt。测试涵盖原生文件选择、安装回滚、更新查询与下载、Mac 启动和重开;已在真实 App 中完成选图和预览验证。
WordPaper v2.6.1 · 桌面入口修复
词卡「记忆本」和菜单「记忆复习本 / 控制面板」现在会唤回同一个 WordPaper App 窗口,修复仍跳转系统浏览器的问题。
- 新启动和复用后台服务都会绑定当前 App 路径及实际端口;旧浏览器页面不能覆盖桌面入口。
- 同端口的 localhost、127.0.0.1、::1 链接保留在 App 内,并沿用当前登录会话。
- Google / 微信授权仍使用系统浏览器;跨电脑同步仍需自行部署账号服务器及配置平台凭据。
- 提供 Apple Silicon、Intel、Slim 三种 DMG,以及 SHA256SUMS.txt。
升级请完整安装新 DMG,替换「应用程序」中的 WordPaper。 本次包含原生程序修复,旧版应用内更新不能替换原生可执行文件。账号数据保留在原数据目录。
验证:完整 npm test、31 项伴侣导航检查、9 组启动器检查、真实原生窗口与同标识多副本导航、Mac 生命周期和安装测试通过。三份 DMG 已挂载核对版本、源码、完整性清单及私密文件排除。
v2.6.0 · 原生桌面 App + Google / 微信账号绑定与同步
原生桌面窗口与同步账号
WordPaper 现在可直接作为 Mac App 使用:双击打开独立窗口,从 Dock 重新唤出,关闭窗口继续运行,⌘Q 退出。无需手动输入 localhost 或启动终端。
- Google / 微信登录,以及原有账号的绑定、更换和解除绑定;账号数据保留,不按相同邮箱自动合并账号。
- App 在系统浏览器完成第三方授权,核对连接码后自动进入同步工作区。网页和多台电脑连接同一账号服务器,共用词库、提醒和学习进度。
- 连续离线编辑排队补同步;小词灵在主窗口关闭时产生的学习记录也进入同步队列。
- 包含此前未发布的小词灵、抽查卡及复习联动改进:长词换行、长释义展开、到期优先、轮次提示和结果写回,并保留远端已有的 Liquid 界面改进。
安装与升级
首次升级到原生桌面窗口,请下载下方 DMG,退出旧版 WordPaper 后拖入「应用程序」覆盖安装。旧版的一键更新不会替换原生主程序,不能仅靠它获得新的主窗口。
- Apple M 系列芯片:
WordPaper-macOS-AppleSilicon.dmg,包含 ARM64 Node 运行时。 - Intel 芯片:
WordPaper-macOS-Intel.dmg,包含 x86_64 Node 运行时。 - Slim:
WordPaper-macOS-Slim.dmg,首次启动自动查找或下载对应芯片的运行时。
用户数据位于 App 包之外,覆盖安装保留原账号和数据。App 尚未完成 Apple 签名/公证;macOS 首次拦截时,请按安装说明前往「系统设置 → 隐私与安全性 → 仍要打开」。
账号服务仍需配置
本次发布包含客户端和服务端实现,不包含已经上线的托管账号服务器。未部署时仍可使用本机账号;真实 Google / 微信登录和跨电脑同步,需要先部署 HTTPS 账号服务器,并完成对应平台配置。密钥只保留在服务器,不包含在 DMG 中。
已有本机账号应先按 README 迁移到新服务器,再绑定 Google / 微信,避免误建独立账号。接入、部署与迁移说明。
验证
账号隔离、绑定安全、模拟 Google / 微信授权、两台 App 与网页同步、浏览器交互和 Mac 原生启动/退出已测试。三种 DMG 校验包内版本、资源清单与 SHA-256;ARM64 本机运行测试不代替 Intel 真机或真实第三方账号的联调。
附 SHA256SUMS.txt,可用于核对三个安装包的完整性。
v2.4.7 · 主题切换整页溶解 + 动效语言统一
主题切换更丝滑 + 动效语言统一
这版没有改功能,把所有"啪一下出现/消失"的表面补成了同一种材质语言(方向参考 Apple Motion 指南)。
更新内容
- 整页主题溶解(约 460ms):切换糖果/校样/Liquid/暗夜时,旧画面整体淡出、新画面(含重绘后的壁纸)一次性合入——渐变、玻璃卡片和预览画布不再各自跳变。主题选择滑块以减速曲线独立滑行,快速连点只保留最后一次选择;捕获失败自动恢复,可继续切换。不支持 View Transitions 的浏览器退回有界颜色过渡。
- 弹窗退场:导入/词书浏览/记忆本/下载四个弹窗关闭时轻微落回(遮罩淡出 + 卡片下沉),不再瞬间消失。
- 实时模式进出场:全屏壁纸进入淡入合拢、退出淡出,与页面动效衔接。
- 登录页分段控件:登录/注册的指示块随选择滑动,表单文字切换轻淡入,错误提示改为短距浮起。
- 尊重系统偏好:开启「减少动态效果」时以上动效全部退化为瞬时切换。
测试与质量
- 新增
npm run test:motion(7 项专项回归:整页溶解、连点去抖、捕获失败恢复、减少动态效果、降级路径、390px 手机布局),在本机 Chrome 与 Playwright WebKit 双引擎通过。 - 端到端 73/73、渲染像素断言 9/9、
npm test162 项全部通过。
升级
- 已装 2.4.4+:菜单栏「词」→ 检查更新 → 一键更新,或网页「支持与反馈」→ 一键更新到 v2.4.7。
- 更早版本或全新安装:下载下方 DMG 覆盖安装(Apple 芯片选 AppleSilicon 版,Intel 选 Intel 版;Slim 版体积最小、首启自动下载运行时)。
App 尚未签名。macOS 首次打开如被拦截,请前往「系统设置 → 隐私与安全性 → 仍要打开」。
附 SHA256SUMS.txt,可用于核对安装包完整性。
v2.4.6 · 更新失败保活 + 生命周期加固(Codex 回测采纳)
来自独立回测的加固(Codex RETEST 报告)
- 更新失败不再退出 App:下载/校验/安装失败后服务保持在线,可原地重试;只有安装成功才重启。
- 菜单栏更新入口常驻:初始即有「检查更新」,每 5 秒与主服务同步;与网页发起的更新互相可见。
- 网页不再误报「更新卡住」:新版本上线后自动检测并刷新(快速重启/断线恢复场景均实测)。
- 孤儿窗口回收加固:父进程校验 + 心跳归属双保险;小词灵脚本与渲染文件按实例分离。
- 重复双击修复:已保存端口上跑着 App 时直接复用,不再选新端口绕过版本闸门。
- 更新完整性:launcher 与 Info.plist 随更新同步(校验+失败回滚),重启旗标原子写入。
升级
菜单栏「词」→ 检查更新 → 一键更新,或网页「支持与反馈」→ 一键更新到 v2.4.6。
v2.4.5 · 双小词灵/跳动修复(孤儿窗口自毁)
双小词灵与界面跳动修复
你报告的「更新后出现两个小词灵、来回跳」已定位并修复:旧伴侣被杀时来不及收自己的小词灵窗口,孤儿窗口与新窗口抢同一份渲染文件。现在小词灵窗口自带归属心跳(伴侣换人或失联 ~16s 自动退出),壁纸互斥锁也加了死进程接管,更新重启后不会再有双窗口。
升级
菜单栏「词」→ 检查更新 → 一键更新,或网页「支持与反馈」→ 一键更新到 v2.4.5。
v2.4.4 · 伴侣启动崩溃修复(2.4.3 回归)
双图标与「点了被盖回」修复
上一版(2.4.2)后个别机器出现两个菜单栏图标、点词后壁纸被旧词盖回——同一根因:机器上意外跑了两份伴侣进程(测试残留/看门狗竞态),各持一份内存状态轮流写桌面。本版加了两道防线,并修掉了幽灵图标的自毁盲区。
更新内容
- 菜单栏图标归属校验:每个伴侣的菜单栏子进程携带自己的 PID,每次刷新核对服务归属,发现自己已经「易主」(被新实例替代)立即摘除图标自杀——不会再有幽灵图标。
- 跨进程壁纸互斥:同一时刻只允许一个伴侣进程推桌面壁纸(锁文件 + 30s 自动过期),双实例不再互相覆盖。误启动的第二实例会在日志提示「双实例保护,跳过」。
- 含 2.4.2 全部内容:菜单栏/快捷键「换一组词」真实翻页、小词灵「书页+轨道」徽记统一、应用内一键更新全链修复。
升级路径
- 从 2.4.1 / 2.4.2:菜单栏「词」→「检查更新」→「一键更新」,或网页「支持与反馈」→「一键更新到 v2.4.3」。
- 从 2.4.0 及更早:请下载 DMG 覆盖安装(旧更新器修不了自己)。
App 尚未签名。macOS 首次打开如被拦截,请前往「系统设置 → 隐私与安全性 → 仍要打开」。
附 SHA256SUMS.txt,可用于核对安装包完整性。
v2.4.3 · 幽灵图标归属校验 + 壁纸互斥 + 伴侣误自杀修复
双图标与「点了被盖回」修复
上一版(2.4.2)后个别机器出现两个菜单栏图标、点词后壁纸被旧词盖回——同一根因:机器上意外跑了两份伴侣进程(测试残留/看门狗竞态),各持一份内存状态轮流写桌面。本版加了两道防线,并修掉了幽灵图标的自毁盲区。
更新内容
- 菜单栏图标归属校验:每个伴侣的菜单栏子进程携带自己的 PID,每次刷新核对服务归属,发现自己已经「易主」(被新实例替代)立即摘除图标自杀——不会再有幽灵图标。
- 跨进程壁纸互斥:同一时刻只允许一个伴侣进程推桌面壁纸(锁文件 + 30s 自动过期),双实例不再互相覆盖。误启动的第二实例会在日志提示「双实例保护,跳过」。
- 含 2.4.2 全部内容:菜单栏/快捷键「换一组词」真实翻页、小词灵「书页+轨道」徽记统一、应用内一键更新全链修复。
升级路径
- 从 2.4.1 / 2.4.2:菜单栏「词」→「检查更新」→「一键更新」,或网页「支持与反馈」→「一键更新到 v2.4.3」。
- 从 2.4.0 及更早:请下载 DMG 覆盖安装(旧更新器修不了自己)。
App 尚未签名。macOS 首次打开如被拦截,请前往「系统设置 → 隐私与安全性 → 仍要打开」。
附 SHA256SUMS.txt,可用于核对安装包完整性。




