KardLeaf 1.7.0

更新日志

相对 v1.6.0 累计 80 次提交。本期重点是 关系图与双链知识网络、AI 助手与图片标注体系，以及任务提醒通知、编辑器与预览体验、桌面快捷入口等大量打磨。

---

✨ 新功能

笔记关联与知识网络

• 关系图：新增独立全屏关系图页面（已接入导航抽屉），可视化笔记间的关联。
• 双链与反向链接：新增 NoteLinkDao/NoteLinkEntity、数据库迁移与反向链接索引；支持 Wiki 链接点击跳转、双链提示弹窗、反向链接侧边面板与笔记属性面板。
• 思维导图：MarkdownMindMapScreen 重写并新增编辑动作（两轮优化，含 EditorActions 思维导图指令与测试）。

编辑器与 AI

• AI 助手：新增 KardLeafAiAssistant，接入编辑器与设置页，支持 AI 交互（基础能力 + 交互优化两轮）。
• 表格编辑加强并优化：表格渲染与插入命令增强（renderBlockTables），并进一步优化表格编辑体验。
• 编辑工具栏扩展：新增缩进/反缩进、分割线、引用按钮、工具栏二次取消。
• 统一图片查看与标注：新增图片查看页、绘图标注页、图片标注导出、网页图片下载与按元数据按需菜单；移除标注保存主线程大图合成、清理标注导出无用依赖。

导入 / 导出 / 分享

• 网页剪藏导入：新增「网页转 Markdown」对话框，可将网页内容抓取为 Markdown 笔记。
• 基础分享入口：新增系统分享接收（ShareToQuickMemoActivity），可从其他应用分享内容到速记。
• 用户数据导出：新增开发者用存储导出工具（DevStorageExporter）。
• 自动检查更新：新增更新检查器，设置页可检查更新。

任务与快捷入口

• 任务清单分组：任务支持分组，TaskListScreen 重写，新增 TaskDao 分组字段与对应迁移。
• 任务提醒通知加强：新增前台提醒服务（TaskReminderService），重构提醒调度（TaskReminderScheduler）与提醒弹窗；数据库升级到 v18（新增 Migration 18）。
• 桌面插件悬浮编辑：桌面小部件支持悬浮快速编辑、标题隐藏、文件夹选择。
• 控制中心 / 桌面快捷入口：新增「速记」快捷开关（Android Tile）与桌面快捷方式；原「草稿」更名为「速记」。
• 随机视图：新增随机笔记视图，并改用可拖动分组线。

界面与个性化

项目	说明
主题色盘	设置新增主题色盘自定义（KardLeafThemeSettings）
预览主题优化	预览页（preview.html）主题大幅优化，新增预览主题相关设置
文件树界面优化	侧边栏与文件夹管理（AppDrawer/FolderManagementScreen）界面重构优化
图片管理优化	图片管理（NoteImagesScreen/笔记卡片）体验优化，仓库层图片索引增强
侧边栏功能项调整	侧边栏功能入口项调整
安全板块重构	密码锁与隐私设置页面重构
统计与实时字数	新增空闲热力图统计、编辑器实时字数更新
日志导出	支持进度显示与文件树展开控制
头像上传弹窗	界面优化

---

🔧 优化与修复

编辑器与预览体验

• 优化双击进入编辑性能（重建 editor.js 生成产物）。
• 调整默认文字行距与布局。
• 实时预览：光标拖动与选区自动滚动优化；修复右侧滚动条视觉跳动。
• 代码编辑器：移除冗余硬件渲染层（CodeMirror）。

首页与分类导航

• 统一选中项防遮挡滚动逻辑，优化切换到「全部笔记」流畅度。
• 分类导航面板（DashboardFolderNavigationPanel）重写、随机视图优化。
• 修复滑动切换时末尾分类项被遮挡、当前分类项防遮挡异常。
• 修复删除笔记时全部笔记列表短暂空白或闪烁。

底层与安全性

• WebView 安全收紧：收紧核心页面边界、完善桥接释放；思维导图 WebView 边界同样收紧与释放。
• 数据库迁移：新增 Migration 16（任务分组）、17（双链索引）、18（任务提醒），并补充完整升级链兼容性测试。

问题修复与稳定性

• 修复新建笔记标题冲突 Bug。
• 修复回收站根目录漏扫与同名删除冲突。
• 修复语言切换 Bug（两次修复，含审核发现项）。
• 修复 CodeMirror 图片替换连续撤销异常。
• 修正图片标注导出与撤销顺序。
• 修复任务提醒后台通知弹窗与声音。
• 修正分类切换栏审核发现的问题。
• 其余若干已知问题修复与稳定性提升。

KardLeaf 1.6.0

更新日志

相对 v1.5.0 累计100多次提交。本期重点是 全新Beta 编辑器内核、桌面插件优化，以及一批编辑与界面体感优化。

---

✨ 新增功能

Beta 编辑器内核

• 设置 → 编辑器内核，新增「Beta 编辑器内核」选项

• 针对长文本、大笔记的实时渲染与输入流畅度更好，光标跟随更稳定

• 图片预览开关：在设置中可开启「编辑状态图片预览」，原生内核会在图片语法下方实时显示预览

• 优化光标防遮挡逻辑

• 修复光标错位、文字重叠与文字错位

• 修复复制长文本后光标消失

WebView编辑器优化

• 统一编辑器标题随内容滚动：CodeMirror 与原生内核均支持标题在滑动时自动收起/展开，避免遮挡编辑区域

• 标题背景色跟随编辑器主题，视觉过渡平滑

首页与导航

• 文件树面板新增，并设置为底部工具栏默认选项

• 首页滚动工具栏优化：滚动笔记列表时工具栏自动收起，释放更多可视区域

• 分类入口与侧边栏文件树优化：分类项预渲染性能提升，侧边栏文件树操作更流畅

• 介绍/导航界面改版：首次启动引导流程与导航体验重构

其他

• 调试日志开关（设置内可开启，便于问题排查）

---

🔧 功能改进与问题修复

桌面插件

项目	说明
笔记列表小部件	新增「选择文件夹/目录」配置，支持长列表滚动
任务清单小部件	交互完善，桌面任务输入与布局优化
插件工具栏	统一桌面插件工具栏样式并缩小圆角
添加入口	优化插件添加入口与长按快捷菜单，新增一键固定到桌面（Android 12+）
清理	移除了旧的「快速新建」小部件
修复	笔记插件目录新建、长按快捷菜单等问题

编辑器

• 编辑器快速滑块：支持「整条侧边拖动」，修正输入法弹出时的滚动范围

• WebView 编辑器：重做主题样式，修复打开空白与背景闪烁；顶部布局与编辑器标题滚动适配

• 代码块复制按钮：统一为 ChatGPT 风格样式，修复按钮显示异常及输入法弹出时误触的问题

• 删除体验优化：删除笔记时过渡动画更顺滑

界面与交互

• Toast 提示防遮挡，隐藏构建/Gradle 报错噪声

• 侧边栏滚动条热区收窄，减少长按误触

• 调整编辑器默认设置与部分文本描述

• 优化多页面 UI 细节

问题修复

• 修复删除笔记后列表闪白

• 修复编辑状态搜索面板切换闪烁

• 修复空分类误显示「后台加载中」状态

• 修复首个分类项预渲染卡顿

• 修复原生 Beta 图片预览区域占位不准确的问题

• 修复代码块复制按钮在输入法弹出时的交互误触

• 其余若干已知 bug 修复与稳定性提升（含内部架构拆分、文档补全、构建配置调整等非体感改动）

KardLeaf 1.5.0

KardLeaf 1.5.0 更新内容

本次版本从 1.3.1 更新到 1.5.0 ，重点新增任务清单、任务提醒、桌面组件、WebDAV 文件级同步、CodeMirror 实时预览、思维导图和全新主题体系，同时优化首页分类、搜索、编辑器、侧边栏、图片 / 日期视图和大文件使用体验。

新增功能

• 新增任务清单功能，支持快速新增、编辑、完成任务，并可显示或隐藏已完成任务。
• 新增任务提醒功能，支持快捷提醒、指定时间提醒、通知、弹窗和铃声提醒。
• 新增任务清单桌面组件，可在桌面查看和管理待办任务。
• 新增笔记列表桌面组件，可在桌面查看最近笔记，并支持切换显示全部笔记或指定分类笔记。
• 新增快速新建笔记桌面组件，方便从桌面快速记录内容。
• 新增长按应用图标快捷入口，支持搜索、新建笔记、新建草稿和打开设置。
• 新增 WebDAV 文件级云同步，支持同步预览、上传 / 下载差异、冲突处理、实时同步和同步记录查看。
• 新增思维导图功能，可根据 Markdown 标题生成结构视图。
• 新增应用语言切换，支持中文和 English。
• 新增应用图标切换，支持默认图标、绿叶图标和极简图标。

主题、图标与界面样式

• 新增多套主题风格，包括经典主题、圆润主题、清爽列表、极夜主题和霓彩主题。
• 新增浅色 / 深色 / 跟随系统模式切换。
• 新增推荐配色、自定义强调色和自定义背景色。
• 新增全局圆角和首页圆角设置，可调整整体界面圆润程度。
• 默认界面风格调整为更加清爽的列表式视觉，卡片、按钮、面板和工具栏样式整体更新。
• 新增多种侧边栏样式，包括极简文字式、图标盒子式、分组卡片式和数据卡片式。
• 新增侧边栏头像设置，数据卡片式侧边栏支持显示热力图、使用天数、笔记数量和文字数量。

编辑器与 Markdown 体验

• 新增可选 WebView / CodeMirror 编辑器内核，可在设置中固定使用，也可在笔记界面临时切换。
• 新增 CodeMirror 实时预览开关，可根据需要开启或关闭 Markdown 实时预览效果。
• 优化 Markdown 编辑与预览体验，输入、滚动和切换编辑状态时更加稳定。
• 优化大文本打开、预览、搜索和编辑体验，减少大文件使用时的卡顿感。
• 新增编辑器字体设置，支持调整字号、行高、字间距、段落间距和字体。
• 编辑器工具栏新增更多 Markdown 快捷按钮，例如二级标题、三级标题、代码块、表格和已完成待办。
• 思维导图入口加入笔记顶部工具栏，可从笔记内容直接查看结构。
• 顶部工具栏、更多菜单和长按选择工具栏支持更细的显示 / 隐藏配置。

首页、分类、侧边栏与搜索

• 新增首页底部工具栏样式，可替代单一新建按钮。
• 底部工具栏支持自定义功能项、顺序、隐藏项和按钮大小。
• 优化首页分类切换体验，分类浏览和返回更加顺手。
• 优化分类导航面板，支持编辑模式、重命名目录、新建二级 / 三级目录和长按排序。
• 分类导航面板新增分类笔记数量显示，父级分类可统计其子分类下的笔记数量。
• 优化移动笔记面板，移动笔记到其他分类时更加直观。
• 优化全局搜索结果，搜索时显示关键词附近内容，而不是只显示笔记开头。
• 搜索结果支持显示命中范围，例如标题、文件夹、标签或正文。
• 搜索结果支持跳转到正文关键词位置，查找内容更方便。
• 优化笔记详情界面，可在标题上方显示更多基础信息。

图片、日期与文件体验

• 优化图片视图和图片预览体验，界面样式与新主题更加统一。
• 优化日期视图显示效果，按日期浏览笔记更加清晰。
• 优化外部 Markdown 文件定位和大文件夹加载体验，打开笔记、列表刷新和搜索更加轻量。
• 插入图片时增加大小保护，减少超大图片导致的卡顿或失败。
• 优化首页列表、分类列表和桌面组件的数据读取方式，减少不必要的完整正文加载。
• 优化自定义排序体验。

历史版本

• 新增历史版本内容长按复制功能，可直接复制某一段历史内容。

KardLeaf 1.3.1

KardLeaf 1.3.1

本次版本从 1.2.2 更新到 1.3.1，重点优化打开/返回动画、大笔记加载体验、历史版本对比界面、自定义拖动笔记排序全新布局。

更新内容

1. 大幅优化首页进入编辑界面速度。
2. 优化大笔记打开链路，减少加载过程中正文迟迟不显示、进度状态提前结束等问题。
3. 优化历史版本界面，支持更流畅的左右手势切换对比。
4. 调整历史版本面板和子面板样式，让界面更贴合 KardLeaf 默认蓝白主题。
5. 优化历史版本和备注记录列表，显示更紧凑，并支持点击跳转到对应笔记。
6. 修复超大笔记打开历史版本时可能卡死的问题。
7. 优化首页滑动、目录切换和自定义排序相关体验，减少列表突然跳动。
8. 修复草稿分类中新建笔记逻辑，现在草稿页会创建临时草稿，不会错误创建正式笔记。
9. 优化草稿页卡片显示，草稿分类下不再受普通笔记标题显示设置干扰。

重点说明

• KardLeaf 仍然保持本地 Markdown / TXT 文件优先的结构。
• Room 数据库主要用于索引、缓存和状态管理，正文仍保存在真实文件中。
• 本版本继续优化长文本、大笔记、历史版本和首页动画体验。

KardLeaf 1.2.2

KardLeaf 1.2.2

本次版本从 1.0.8 更新到 1.2.2，主要新增绘图功能和编辑器顶部工具栏自定义，并修复多处使用体验问题。

更新内容

1. 新增绘图功能，支持在笔记中创建和保存绘图内容。
2. 新增笔记详情界面顶部工具栏自定义位置功能。
3. 设置中新增侧滑面板弹出方式切换。
4. 优化打开笔记的动画效果。
5. 优化 Toast 提示样式，并修复部分提示不会自动消失的问题。
6. 优化文件夹管理面板。
7. 优化搜索替换面板。
8. 优化首页添加文件夹的操作逻辑。
9. 回收站新增删除时间显示，并优化删除日期样式。
10. 优化历史版本记录和备注记录显示，列表更紧凑。
11. 修复历史版本记录、备注记录点击后无法跳转到对应笔记的问题。
12. 修复复制副本后滚动条没有置顶的问题。
13. 修复删除大型文件时可能卡死的问题。

安装说明

下载下方 APK 文件后安装即可。

KardLeaf 1.0.8

KardLeaf 1.0.8

这是 KardLeaf 从 1.0.0 到 1.0.8 的累计更新版本，包含正式版发布后的功能新增、长文本优化、首页优化、文件夹管理、自定义排序、快速滚动条、统计面板和大量交互细节修复。

主要更新

正式版基础调整

• 版本号更新到 1.0.8
• 优化首次使用介绍界面
• 优化设置界面分类和功能项位置
• 删除部分首次启动时不必要的提示文案
• 优化大字体环境下的界面适配
• 优化关于面板，添加 GitHub 仓库地址

长笔记与超大文本优化

• 新增超大型笔记保护逻辑
• 超大笔记默认进入快速预览，避免直接进入编辑器导致卡死
• 优化笔记打开流程，减少打开大笔记时白屏、卡死、闪退问题
• 优化 Room 查询方式，避免打开大笔记时一次性读取完整正文
• 超大型 Markdown 预览超过限制时改为纯文本快速预览
• Markdown 预览失败时自动回退为纯文本显示
• 打开长笔记时先显示“正在加载正文”，避免先闪一下首页预览内容再显示正文
• 正文加载完成后再进入编辑或预览状态，减少空内容、预览内容误进入编辑器的问题

右侧快速滚动条

• 新增笔记详情页右侧快速滚动条
• 支持编辑状态和预览状态使用快速滚动
• 支持长笔记快速定位内容
• 优化滚动条高度比例，长笔记下显示更自然
• 优化滚动条触摸区域，方便手指拖动
• 优化滚动条与右侧侧滑面板的手势关系，减少误触
• 预览 WebView 和原生编辑器都接入快速滚动位置计算
• 增加滚动条触觉反馈
• 优化滚动条显示时机，长笔记打开后不再默认显示，只在滚动或快滑时显示
• 修复快速滚动条残留、重复显示或显示异常的问题

首页显示与图片加载优化

• 新增首页显示修改日期功能
• 支持在宽松卡片布局右下角显示笔记修改时间
• 新增首页是否显示文件名/标题的设置
• 新增是否显示纯日期文件名的设置
• 支持隐藏日期格式标题，例如 2026.06.24.051810
• 新增自定义隐藏文件名规则
• 支持隐藏日期副本文件名，例如 yyyy.MM.dd.HHmmss~副本
• 关闭“显示文件名”后，相关隐藏文件名设置会自动隐藏
• 优化首页卡片标题显示逻辑
• 优化首页图片缩略图加载和缓存
• 快速上下滑动时暂停未缓存图片加载，减少滑动卡顿
• 当前目录停止滚动后再加载图片，降低大量图片笔记对首页流畅度的影响
• 优化 Markdown 预览文本清理规则，减少首页卡片重复解析开销
• 优化首页图片卡片显示稳定性，减少卡片跳动

自定义排序

• 新增文件排序方式：自定义
• 支持单独对某个文件夹设置自定义排序
• 新增“调整自定义顺序”入口
• 新增自定义排序弹窗
• 支持长按拖动笔记调整顺序
• 自定义排序界面显示标题和正文预览
• 自定义排序只作用于当前文件夹，不影响其他文件夹
• 优化递归目录和全局排序逻辑，避免影响首页整体性能
• 优化自定义排序下未排序笔记的兜底排序
• 优化自定义排序路径标准化，减少路径不一致导致的顺序匹配失败
• 增强自定义排序日志，方便排查副本、新建笔记、目录切换时的顺序问题

新建笔记与复制副本

• 新增长按笔记后的“复制”功能入口
• 长按选择栏新增复制图标
• 复制功能支持将选中的笔记复制为副本
• 优化“复制为副本”在自定义排序下的位置逻辑
• 在自定义排序文件夹中，复制出的副本会插入到原笔记后面
• 修复副本有时出现在目录最前方或最下方的问题
• 优化复制多个笔记时的顺序记录
• 自定义排序文件夹中新建笔记会插入到目录顶部
• 修复部分情况下新建笔记没有进入自定义排序记录的问题

文件夹管理

• 侧边栏“文件”功能项升级为独立文件夹管理界面
• 支持查看当前层级下的子文件夹
• 支持进入子文件夹层级
• 支持返回上一级文件夹
• 支持新建文件夹
• 支持重命名文件夹
• 支持移动文件夹
• 支持删除空文件夹
• 支持调整同级文件夹显示顺序
• 新增文件夹显示顺序保存逻辑
• 文件夹顺序按父级目录分别保存，避免不同层级互相影响
• 侧边栏不再直接展开复杂文件树，界面更清晰

长按选择栏自定义

• 新增长按选择栏功能项自定义
• 支持调整长按选择后顶部按钮和“更多”菜单里的功能项
• 支持长按拖动调整功能项顺序
• 支持将功能项在顶部展示区和更多选项区之间移动
• 优化长按选择栏按钮显示逻辑

属性面板与文本统计

• 重做笔记统计逻辑
• 新增字符数统计
• 新增词数统计
• 新增词数（不带标点）统计
• 新增行数统计
• 新增段落数统计
• 首页长按笔记属性面板支持显示完整统计
• 笔记详情右侧属性面板支持显示完整统计
• 统计时自动跳过 Front Matter 元数据
• 优化超长文本统计方式，统计从文件流读取，避免一次性加载全文
• 右侧属性面板只有真正展开后才触发统计，避免进入笔记时提前统计导致卡顿
• 拖动侧边栏过程中不立即统计，减少拖动卡顿
• 将“不带标点符号的词数”统一改名为“词数（不带标点）”

预览、编辑与交互优化

• 优化预览双击进入编辑状态时的光标定位
• 双击预览内容时，尽量将编辑光标定位到双击附近位置
• 优化预览页面 Markdown 源文本偏移计算
• 优化编辑状态和预览状态切换稳定性
• 优化部分图片预览边框和阴影显示
• 优化笔记详情页属性与备注侧滑面板布局
• 缩短部分字段名称，例如将 KardLeaf ID 简化为 ID
• 调整属性面板字段左右列宽，减少 ID、创建时间、修改时间换行问题

返回手势与菜单修复

• 优化标签结果页返回逻辑，减少直接返回首页的问题
• 优化首页更多菜单的焦点处理
• 优化长按选择状态下“移动”和“更多”菜单的焦点处理
• 优化日期页面筛选菜单的焦点处理
• 优化编辑器顶部菜单、标签菜单、标题菜单、数学公式菜单等弹窗焦点处理
• 优化排序菜单的返回手势表现
• 减少部分菜单打开后返回手势无效或层级不自然的问题
• 降低弹窗菜单和系统返回手势之间的冲突

返回首页与滚动位置优化

• 移除关闭编辑器时强制触发首页滚动到顶部的逻辑
• 优化新建笔记、打开笔记后返回首页的滚动位置体验
• 修复保存新笔记时部分情况下 currentNote 更新条件不够准确的问题
• 减少从编辑页返回首页时列表位置突然跳动的问题

总结

1.0.0 到 1.0.8 主要围绕正式版稳定性、长笔记体验、首页流畅性、文件管理、自定义排序和属性统计进行了持续优化。这个版本更适合日常使用，尤其是长笔记浏览、快速滚动、文件夹管理和大量笔记场景。

下载

请在下方 Assets 中下载 APK 安装包。

KardLeaf 1.0.0

KardLeaf 1.0.0

这是 KardLeaf 的第一个公开发布版本。

KardLeaf 是一款轻量、简洁、支持 Markdown 的 Android 本地笔记应用。它以本地文件为核心，支持 Markdown 编辑、预览、文件夹管理、搜索、收藏、置顶、归档、回收站、历史版本和本地目录同步等功能。

主要功能

• 支持 Markdown / TXT 本地笔记管理
• 支持选择本地文件夹作为笔记目录
• 支持 Markdown 编辑与预览
• 支持常用 Markdown 工具栏
• 支持 KaTeX 数学公式预览
• 支持本地图片引用预览
• 支持搜索、排序、收藏和置顶
• 支持文件夹分类和多级目录
• 支持归档、回收站和历史版本
• 支持笔记提醒和系统通知
• 支持外部文件变更同步

安装说明

下载下方的 APK 文件后，在 Android 设备上安装即可。

如果系统提示“禁止安装未知来源应用”，请在系统设置中允许当前浏览器或文件管理器安装未知来源应用。

注意事项

KardLeaf 目前仍处于持续开发阶段，可能仍存在未完善的细节。建议在使用前做好重要笔记的备份。

Full Changelog: https://github.com/waikr/KardLeaf/commits/v1.0.0