KnowFlick macOS v0.2.0

KnowFlick macOS v0.2.0

发布日期：2026-10-02。最低 macOS 14。

本版变化

• 学习工作台以阅读内容、今日进度和到期复习为主，调整摄影卡片、分类目录、字阶和间距；简化重复说明与装饰性效果。
• 侧栏折叠后 logo 与展开按钮共用位置；图标悬停显示标题和操作说明，移出或点击后隐藏。窄窗口自动收起导航文字。
• 统计图随可用宽度排版，趋势按峰值缩放并补充日期标签；复习说明与实际 1、3、7 天规则保持一致，掌握度标明为估算。
• 搜索条件变化即作废旧任务，卡库修改后刷新结果，关闭后停止提交；检索中阻止打开旧结果，不提前显示空结果。
• 学习计划在跨日、时区或时钟变化、唤醒及恢复前台后刷新；复习日期与统计改为一次聚合并缓存。
• 卡片与设置保存告警分别保留，设置写入失败不再被卡片保存成功清除。
• 汇总前序去 AI 味调整：减少 sparkles、彩色光晕和 emoji 提示，保留内容摄影与表达来源的 AI 标记。

安装与升级

下载 KnowFlick-0.2.0.app.zip，解压后替换原应用。已有卡库继续使用，无需重置。
附件 KnowFlick-0.2.0.app.zip.sha256 用于核对下载完整性。

验证与边界

• 361 项 Swift 测试、46 个套件通过；发布构建、签名校验、资源与启动自检通过。
• 本机已检查首页、复习、知识库、统计、窄窗口及搜索主要状态；自定义侧栏悬停浮层完成编译验证，尚未用自动化重现指针停驻画面。
• 未做性能基准测量，不声明具体耗时降幅。排程算法与 Android 的差异仍保留，本版不迁移旧数据。
• 详细改动与验收范围见 UI 优化记录 与 深入优化记录。

KnowFlick Android v0.10.3

KnowFlick Android v0.10.3

发布日期：2026-10-02。versionCode：23。最低 Android 8.0 / API 26。

本版变化

• 收藏与历史页采用提供选中语义的 Tab 和 Material FilterChip，触控高度至少 48dp；标签改为简洁的功能名称。
• 浅色主题主色加深，提高白字对比度；显式设置 Material 前景和容器颜色，保持纸张主题一致。
• 学习计划与统计缓存纳入日期、时区，监听日期、时钟、时区变化与恢复前台，避免午夜后沿用旧统计。
• 热力图连续天数使用完整活动日期，超过 35 天不再截断；今天尚未活动时保留昨天的连续记录，补充读屏日期文本。
• 计划排程缓存、掌握度取整与边界处理改进；全局媒体入口改为弱引用持有语音控制器，使用中的控制器仍由 ViewModel 持有。
• 汇总前序去 AI 味调整及关闭同步面板时取消同步的修复。

安装与升级

下载 KnowFlick-0.10.3.apk。使用既有发布证书签名，可覆盖安装并保留数据；更新前可导出备份。
附件 KnowFlick-0.10.3.apk.sha256 用于核对下载完整性。

验证与边界

• 269 项 JVM 测试、43 个套件通过；Debug Lint 与 Release/R8 构建、签名及 ZIP 对齐校验通过。
• Lint 无错误，仍有 40 个既存警告和 2 项提示。
• 本机没有连接 Android 设备，未执行设备交互、日期广播和后台语音播控验收。
• 双端排程算法与同步重试的阻塞等待仍需专项处理。详见 深入优化记录。

KnowFlick Android v0.10.2

KnowFlick Android v0.10.2

发布日期：2026-09-25。versionCode：22。最低 Android 8.0 / API 26。

本版变化

• AI 服务与云端语音凭据的保存、删除改为后台协程操作。仍使用同步 commit() 确认落盘结果，因此设置页继续显示成功或失败反馈；Keystore 加密和文件同步不再占用界面线程。
• 保存期间禁用两处保存按钮并显示进度，避免同一时刻并发写入 AI 与语音配置。

安装与升级

在本 Release 下载 KnowFlick-0.10.2.apk。使用既有发布证书签名，可覆盖安装并保留本地数据；更新前可在 App 导出备份。
附件 KnowFlick-0.10.2.apk.sha256 用于核对下载完整性。

验证与边界

• tools/build_android.sh：265 项 JVM 单测、Debug Lint、Release/R8、签名与 ZIP 对齐验证通过。
• 新增存储测试验证凭据保存与删除在配置的 IO dispatcher 执行，并检查写入、读取和删除结果。
• 凭据读取与 EncryptedSharedPreferences 初始化仍为同步操作；本版只将设置页的保存和删除路径移出界面线程。加密 API 迁移仍是单独技术债。

KnowFlick v0.1.0

What's Changed

• chore(mac): 版本序列切换——自 v0.1.0 起改用 pre-1.0 序列 by @bitterSmilezzz in #12
• feat(mac): 收藏/统计单一路由化——Cutline 占位页补齐功能，旧面板归档 by @bitterSmilezzz in #13
• fix(mac): 刷卡卡片恢复摄影大图、侧栏 logo 用真图标、折叠态图标去重 by @bitterSmilezzz in #14
• fix(mac): 刷卡卡片摄影底图约束填充区域 by @bitterSmilezzz in #15
• fix(mac): bootstrap 在钥匙串读取前先渲染卡片库 by @bitterSmilezzz in #16
• fix(mac): 折叠态侧栏品牌标居中 by @bitterSmilezzz in #17
• perf(mac): 修侧栏导航与统计页卡顿——消除每帧重复重建 LearningPlan by @bitterSmilezzz in #18
• fix(mac): 修复 perf/sidebar-nav-lag 合并引入的编译错误（漏改 cards.count） by @bitterSmilezzz in #19
• feat(mac): 测验与听书控制台 Cutline 原生化 by @bitterSmilezzz in #20
• fix(mac): 导入笔记 sheet 选择器溢出卡片边界 by @bitterSmilezzz in #21
• style(mac): 剩余视图琥珀主色语义归位 + 顶栏垂直对齐 by @bitterSmilezzz in #22
• style(mac): 导入笔记主按钮条件配色（AI 档琥珀 / 规则档蓝） by @bitterSmilezzz in #23

Full Changelog: v4.6.0...v0.1.0

KnowFlick v4.6.0

What's Changed

• feat(mac): 界面改版第一批——Cutline 风 Insight 体系 by @bitterSmilezzz in #9
• feat(mac): 学习工作台 Cutline 原生化 + 发布 v4.5.0 by @bitterSmilezzz in #10
• perf(android): move credential persistence to IO by @bitterSmilezzz in #8
• feat(mac): 学习地图上线——学科/分支/难度三级范围选择（P2 mac 侧补齐） by @bitterSmilezzz in #11

Full Changelog: v4.4.4...v4.6.0

KnowFlick v4.4.4

KnowFlick macOS v4.4.4

发布日期：2026-09-25。最低 macOS 14。

本版变化

• 网页剪藏提炼出的卡片会将规范网页地址保留在来源列表首位，并移除 AI 同时返回的原始提交地址或规范地址重复项。
• 其他 AI 生成的参考链接及其顺序保持不变。

安装与升级

下载 KnowFlick-4.4.4.app.zip，解压后放入 Applications。已有卡库继续使用，无需重置。
附件 KnowFlick-4.4.4.app.zip.sha256 用于核对下载完整性。

验证与边界

• 本机 ./tools/test.sh --core-only：341 项测试、45 个套件通过；swift build --target KnowFlickCore 通过。
• 完整 SwiftUI 应用构建、签名、资源和启动检查由 GitHub Actions macOS workflow 验证。
• 去重按完整 URL 字符串匹配本次提交地址与抽取出的规范地址。仅有大小写、尾斜杠或查询参数差异的其他地址可能仍会同时显示。

KnowFlick v4.4.3

KnowFlick macOS v4.4.3

发布日期：2026-09-24。最低 macOS 14。

本版变化

• 新增网页剪藏入口：可从学习工作台、知识库和「文件 → 从网页剪藏…」打开，快捷键为 ⌥⌘I。
• 抓取后先显示正文预览；页面只匿名读取，不发送 Cookie。用户点击「AI 提炼成卡片」后，才将正文发送到已配置的 AI 服务。
• AI 结果可逐张勾选确认导入，可选择置顶到待刷卡堆；每张新卡均以导入来源保存，并把原网页链接放在来源列表第一项。

安装与升级

下载 KnowFlick-4.4.3.app.zip，解压后放入 Applications。已有卡库继续使用，无需重置。
附件 KnowFlick-4.4.3.app.zip.sha256 用于核对下载完整性。

验证与边界

• 本机 ./tools/test.sh --core-only：341 项测试、45 个套件通过；新增来源链接首位与去重断言。
• swift build --target KnowFlickCore、SwiftUI 源文件语法解析、Shell 变量 lint、学科契约检查及 MCP 工具测试（23 项）通过。
• 完整 SwiftUI 应用构建、签名、资源和启动检查由 GitHub Actions macOS workflow 验证。
• 网页抓取沿用既有匿名静态 HTML 解析能力；需要登录或主要依赖脚本渲染的页面可能无法提取正文。AI 不会在用户点击提炼前收到网页正文。

KnowFlick Android v0.10.1

KnowFlick Android v0.10.1

发布日期：2026-09-25。versionCode：21。最低 Android 8.0 / API 26。

本版变化

• 网页剪藏提炼出的卡片会将规范网页地址保留在来源列表首位，并移除 AI 同时返回的原始提交地址或规范地址重复项。
• 其他 AI 生成的参考链接及其顺序保持不变。

安装与升级

在本 Release 下载 KnowFlick-0.10.1.apk。使用既有发布证书签名，可覆盖安装并保留本地数据；更新前可在 App 导出备份。
附件 KnowFlick-0.10.1.apk.sha256 用于核对下载完整性。

验证与边界

• tools/build_android.sh 通过：264 项 JVM 单测、Debug Lint、Release/R8、签名校验及 ZIP 对齐检查。
• APK 校验和文件匹配，且 APK ZIP 完整性检查通过。
• 去重按完整 URL 字符串匹配本次提交地址与抽取出的规范地址。仅有大小写、尾斜杠或查询参数差异的其他地址可能仍会同时显示。

KnowFlick v4.4.2

本版变化

• 网页剪藏改用 URLSession.AsyncBytes 增量读取响应，正文最多读取 4 MiB 加 1 个探测字节；超限后取消请求并保留截断标记，避免完整大响应进入内存。
• 对非成功 HTTP 状态或不支持的响应类型，在读取正文前结束请求。

验证

• 本机 KnowFlickCore 测试：340 项、45 个套件通过；swift build --target KnowFlickCore 通过。
• Shell 变量 lint、共享学科契约检查与 MCP 工具测试通过。
• GitHub macOS tag workflow 成功：全量 Swift 测试、应用打包、资源与启动自检、签名校验及 Release 附件上传均通过。
• 下载包 SHA-256 与校验文件及 GitHub 附件摘要一致，ZIP 完整性检查通过。

边界与安装

• 超限行为使用离线异步字节流测试；本版没有请求真实网页。
• 下载 KnowFlick-4.4.2.app.zip，解压后将应用放入 Applications。已有卡库会保留；.sha256 附件可用于校验下载完整性。

详见 macOS v4.4.2 发布记录 与 PR #5。

KnowFlick v4.4.1

What's Changed

• fix(mac): route system pause separately by @bitterSmilezzz in #4

Full Changelog: v4.4.0...v4.4.1