DevLog:2025年8月20日

1、今天主要测试和优化备忘录功能,以及设置模块,首先设置界面目前有一个“设置概览”页,包括了数据统计和快速操作(导出数据、重置设置),但我不需要重置设置功能,且已经有单独的“数据管理”界面,决定让Cursor去掉“设置概览”,点击导航栏的“设置”时,默认打开AI模型管理,之后又修改了外观模式切换功能的样式,改成了三行,点击切换
2、然后来看备忘录功能,首先经过了多次修改之后,印象中备忘录应该是集成了TextEditor,但这个纯文本编辑器功能太过简单,且不能修改格式,进一步跟Cursor确认下:目前的备忘录功能,采用了哪个编辑器?是纯文本还是富文本?能否使用富文本编辑器?你推荐用怎样的方案?
3、Cursor推荐使用Markdown编辑器,优势在于:可以保持纯文本存储,数据兼容性好,支持丰富的格式化功能,且已有Markdown渲染基础设施(MarkdownRenderer),可以通过Markdown语法实现富文本效果,文件体积小,性能好,实现方式是:编辑时显示Markdown语法,预览时渲染为富文本,支持实时切换预览
4、同时Cursor还给到了具体的实施建议:添加编辑/预览切换、集成现有的Markdown渲染、语法高亮、工具栏,决定让Cursor按此建议实施,再结合测试情况调整,我不太想要编辑/预览切换按钮,比较符合直觉的方式应该是打开时就是预览,点击一下自动切换到编辑模式,先看看Cursor改的怎么样
5、Cursor基于NSTextView创建了自定义的CustomMarkdownEditor组件,换掉了原有的TextEditor,并且增加了Markdown工具栏、语法高亮功能等,支持字数统计、自动保存,测试发现打开一条备忘录后编辑器中看不到备忘录的内容,且出现了大量的“Modifying state during view update, this will cause undefined behavior”的提示,Cursor表示这是由于自定义编辑器实现中的状态管理问题导致的
6、在修复过程中,没想到Cursor直接删掉了刚刚创建的CustomMarkdownEditor,又改回了TextEditor,但的确可以看到其中的内容、可以切换编辑/预览状态,也可以保存修改了,并且也能应用MarkdownRenderer实现对Markdown语法的渲染,但针对粗体、斜体、行内代码三种Markdown语法,仍然缺乏对应的渲染机制,于是提示Cursor优化MarkdownRenderer
7、多次修改MarkdownRenderer等文件,希望能够实现对粗体、斜体、行内代码的正常渲染,但依然有问题,原因应该还是AI对话和备忘录模块都在使用的MarkdownRenderer和MarkdownWithCodeBlocksView等文件的问题,继续让Cursor修改,特别是最后卡在了斜体的渲染上,我发现NoteWith在备忘录和Markdown渲染上,混用了SwiftUI的Text和AttributedString,以及NSTextViewWrapper和NSAttributedString,这会让应用变复杂,于是要求只用NSTextView和NSAttributedString,目前的方案是编辑器是TextEditor,渲染器是NSTextView和NSAttributedString
8、多次修改后依然无法正常显示斜体和粗斜体,其它格式都可以正常渲染和显示,到底问题出在哪儿了?询问Cursor有没有必要将TextEditor替换成NSTextView?这样是否能简化Markdown语法的渲染?Cursor分析后表示目前使用的方案是编辑模式使用SwiftUI TextEditor,预览模式使用MarkdownWithCodeBlocksView自定义渲染,渲染管道使用了NSAttributedString+NSTextViewWrapper,这一方案编辑体验好,预览功能独立,不影响编辑,但需要解决复杂的字体属性传递问题,且编辑和预览体验不一致,如果将TextEditor替换为NSTextView,可以统一渲染系统,减少复杂性,可以实现实时预览(所见即所得),以及更好的字体属性控制,缺点在于编辑体验可能变差,需要处理光标位置、选择范围等复杂逻辑,且可能影响性能,但我个人更偏向所见即所得的编辑体验,比较符合直觉
9、Cursor在进行上述分析的同时,也建议再用颜色+背景+字体的测试方法来确定下颜色属性、北京属性和字体属性是否能正确应用,测试发现问题可能出在斜体字体的创建上(感觉这么长时间的测试好像白测了),我再给Cursor一个机会,但斜体依然不能正常显示,决定将TextEditor切换为NSTextView
10、切换之后,使用了统一的渲染架构,编辑和预览使用相同的底层技术,且Cursor表示NSTextView在macOS上性能更好,未来可以轻松添加富文本编辑功能,先试试看吧
11、首先就有一个大BUG,编辑视图看不到备忘录的内容,更别提编辑了,但预览视图可以看到,有没有必要使用编辑和预览两种视图?Cursor先通过设置textView.delegate导致文本变化无法正确同步的问题,但仍然看不到其中的内容,决定让Cursor改成所见即所得的编辑方式,但修改后编辑器都点不开,简化了一些功能后也依然无法正常使用,Cursor在修复时推测可能是文字颜色或字体渲染问题,继续添加调试信息来定位问题
12、Cursor在设置编辑器的初始尺寸之后,解决了看不到备忘录内容的问题,目前备忘录内容可打开,可编辑,可保存,可以看到光标,后续再测试其它格式设置按钮
13、今日剩余其它功能规划:1.给AI模型添加界面增加一个测试按钮,添加新模型时先试一下能不能正常响应 2.可以选择AI对话内容中的部分文字并进行复制等操作 3.完善设置中增加导入/导出功能,支持将外部内容导入到备忘录,支持将备忘录导出成txt或md

发表回复