标签： MarkdownUI

DevLog：2025年11月6日

1、让Cursor将当前版本（v0.2）打包，Cursor这次还同步创建了发布说明文档，其中包括版本信息、安装说明、更新内容、系统要求、支持的AI平台、反馈与支持、注意事项等内容，看起来还是挺规范的

2、已经用上了v0.2版本，以后对话时多多使用，修正问题并进一步优化，同时我还询问了Cursor下一个版本的建议，以细节补充和优化为主，Cursor给出了高、中、低三个不同优先级的建议，但我个人还是觉得有些并不着急

3、高优先级建议包括停止生成按钮（发送消息后按钮变成停止生成按钮，可以随时点击停止）、会话重命名/自动命名（其实现在可以重命名，也会自动获取用户的最后一个问题作为会话的名字）、消息复制按钮（已有）、快捷键支持（比如给创建新对话、切换模型、搜索等功能指定快捷键，这个可以有）、错误处理优化（更友好的错误提示、API限流处理、离线模式、崩溃日志等，我暂时不需要）

4、中优先级建议包括重新生成功能、代码块复制（这个可以有）、消息时间显示（我忽略了这一点，现在还真没有）、空状态设计（无对话、无收藏时的引导界面，这个好像也已经有了）、数据导出功能（收藏内容导出成.md还是比较实用的）

5、低优先级建议包括主题色自定义（花里胡哨，不需要）、使用统计（显示使用次数、Token消耗等，后面可以加上）、标签分类（暂不需要）、字体调节（暂不需要）、帮助文档（暂不需要）

6、总结一下，v0.3要增加的功能包括：停止生成按钮、快捷键支持、代码块复制、消息时间显示、数据导出功能、使用统计，也都是一些细节上的补全

7、目前在进行中的开发项目，移动端有ChatWith、NoteWith和DoitWith，Mac端有ChatWith for Mac和NoteWith for Mac，NoteWith for Mac是由移动端NoteWith修改而来，功能上相当于在ChatWith基础上增加了备忘录和待办事项功能，整合的功能比较多，后续可能会考虑删掉待办事项功能，留给DoitWith，且AI对话功能需要重复开发，暂时先搁置，接下来继续开发移动端NoteWith

8、将近三个月没有修改过NoteWith了，甚至都忘了它的功能都有啥，先让Cursor梳理一下目前的项目，都有哪些功能，有哪些优化建议，在梳理过程中，先整理了应用功能与优化建议文档，然后检查发现了重复文件，Cursor建议先清理重复文件（我还发现目前应用文件夹里有多个Trae创建的项目文件备份和.sh文件，也都不需要了，一并清理掉）、清理调试打印和未使用的代码，后面可以考虑更换数据持久化方案为Core Data，然后优化性能、扩展功能等等

9、Cursor直接删掉了15个无用文件（应用能否正常运行还有待验证），然后我删掉了多余的空文件夹，和之前不知道啥时候、由哪个AI工具编写的重构指南文件，以及一个项目初始化脚本setup.sh

10、时隔三个月再次启动了iOS模拟器，iOS 26已经发布，模拟器也换成了iPhone 17 Pro、iOS 26.0，并且部分界面也自动变成了iOS 26的效果，比如底部的AI对话、备忘录、我的三个按钮及其切换效果，决定趁现在应用功能还很简单，结合近期修改ChatWith for Mac的经历，先开启一个新对话，把NoteWith的AI对话和备忘录的数据永久化方式改为Core Data，AI模型、设置等仍然采用UserDefaults

11、Cursor的建议是使用Core Data存储Note、AIChatSession、AIMessage、SearchLink、deletedNotes，仍然使用UserDefaults来保存AIConfig和应用设置，因为Core Data适合结构化数据，支持关系、查询和迁移，UserDefaults适合小量配置，访问频繁但更新不频繁

12、接下来创建Core Data模型文件和相关组件，创建了备忘录、AI对话、AI消息、搜索链接四个实体及对应的扩展类，重构了DataManager，并更新了项目文件，和以往修改数据永久化方式一样，这次Cursor也增加了迁移机制，首次运行时会自动将现有的UserDefaults数据迁移到Core Data，但因为当前应用还没有发布，不需要迁移机制，让Cursor去掉了迁移机制，并且修复了构建错误，具体使用体验怎么样，哪些功能受到了影响，明天再测试，然后引入三方库MarkdownUI和RichTextKit，完善AI问答和备忘录的渲染效果和编辑体验

DevLog：2025年9月23日

1、突然发现Cursor的DashBoard统计竟然正常了，又能看到近期修改、建议、接受的代码量了

2、先让Cursor结合当前应用的功能更新了一下README文档，主要的变化除了将备忘录改成收藏之外，还有数据持久化方案由UserDefaults变成了Core Data，Markdown渲染由自定义解析器改为MarkdownUI等等

3、接下来优化上周遗留的设置列表显示局促的问题，直接将SettingsListView添加到对话，并要求Cursor优化一下这个设置列表文件，目前显示有点局促，看它能否理解，Cursor调整了间距、布局，增加了卡片式设计和选中指示器，但总觉的跟另外两个界面的风格不是很搭，设置列表左右两侧和上方有明显的空白

4、统一调整了设置列表SettingsListView、收藏列表NotesListView、对话列表AIChatSessionListView三个文件的选中状态，不再使用圆角，因为圆角会导致出现一些小的空白，反而不够美观，然后调整了设置列表的点击区域和底色，点击区域扩大到整行而非文字部分，至于底色，多次修改并让Cursor对比文件后，发现是因为设置列表使用的是List容器，而收藏列表使用的是ScrollView+LazyVStack容器，List容器有自己的默认背景色和样式，于是也将设置列表改成了收藏列表一致的容器，问题解决

5、然后调整了数据统计、回收站的细节，还是之前调整备忘录和AI对话顺序后的后遗症

6、下一步清理当前应用中的调试信息，AI对话部分调试信息很多，可能也会影响应用的性能，Cursor一次清理了8个文件中的67行调试信息，并且处理了一个警告信息，明天再测试当前应用的功能，规划下一步修改，并尽快打包当前应用，实机安装、测试

DevLog：2025年9月12日

1、继续修改备忘录模块，目前已经应用了MarkdownUI，但仍然没有实现我希望的所见即所得的效果，仍然需要点击编辑按钮才能修改内容，修改之后变成了点击备忘录内容区域就能进入编辑模式，在编辑模式下使用TextEditor进行纯文本编辑，在预览模式下显示MarkdownUI渲染的效果，并且支持文本选择
2、接下来尝试用MarkdownUI优化AI回答内容的渲染效果，先用MarkdownUI优化除代码块和表格之外的内容的渲染效果，因为代码块和表格已经有单独的文件在渲染，Cursor通过在UnifiedMarkdownView中添加import MarkdownUI，并将.text组件的渲染从简单的Text替换为Markdown(text)，实现了这一需求
3、然后用MarkdownUI渲染了AI回答中的表格，让普通文本和表格渲染效果一致，再将MarkdownUI用到代码块的渲染中，我发现在这个过程中Cursor修改的文件是UnifiedMarkdownView，并不是专门用于渲染代码块的CodeBlockView和MarkdownWithCodeBlocksView，以及专门用于渲染表格的TableView和MarkdownWithTablesView，询问后Cursor表示这些文件目前没有被使用，于是删除并修改了项目文件，移除对这些文件的引用，之后测试了一个新的问题，删除这四个文件的确对AI回答的渲染没有任何影响，现在AI问答中所有的Markdown内容都通过MarkdownUI进行统一渲染
4、真真切切感受到了使用成熟的三方库给应用开发带来的效率提升，之前为了实现对代码块和表格的渲染不知道修改了多少次代码才让这两个模块的显示效果基本可用
5、但现在还有CodeBlockParser、TableParser、MarkdownTableCell 三个文件，不知道是否还在使用，询问Cursor后得到的答复是只有TableParser还在使用，它定义了TableRow结构体，是UnifiedMarkdownView中表格解析的核心数据结构，所以仍然保留了这个文件，另外两个文件已经不再使用，直接删除并修改了项目文件，实测对目前的AI回答内容渲染效果无影响
6、发现在AI对话列表里，有部分对话只显示了标题，没有显示摘要，这和我之前的规划不符，再次明确标题默认是我在这个对话中提出的最后一个问题，下面小字默认是最后一个回答内容的前50字
7、由于近期对应用的修改较为频繁，猜测可能还有部分文件也没有被使用，但依然存在于文件目录中，于是直接让Cursor检查目前还有哪个文件未被使用，并明确“先检查下，不要直接删除”防止像上面第3步那样直接删除多个文件，虽然没有什么实际影响
8、检查发现MarkdownTextView、MarkdownRenderer都已被MarkdownUI取代，还有多余的DataManger，以及前边经过分析认为有用的TableParser，都可以删除，决定让Cursor逐个删除并测试构建，确认没有依赖关系，在将这些文件删除，并且将原本在TableParser中定义的TableRow结构体移到了UnifiedMarkdownView中之后，构建成功，并且AI问答和备忘录的渲染依然正常，今天一共删除了大概9个文件，这下项目更干净了，且功能没受影响
9、AI问答的内容，与消息气泡的边缘的距离有些太近了，需要适当增加一点边距，询问Cursor了解当前的边距设定之后，将用户消息和AI消息的下边距统一由4增加到8，现在看来稍微好些了
10、发现不知道从啥时候开始，在AI对话、备忘录和待办事项三个界面，第二栏和第三栏之间无法通过拖动分割线调整比例了，我记得之前已经将这三个界面的第二栏和第三栏统一用HSplitView，并且设置了最大宽度、最小宽度和理想宽度，检查后发现AIChatSessionView、NotesListView和TodoListView都设置了固定的宽度300，会阻止用户通过拖动分割线调整比例，并且待办事项列表页也设置了最小宽度，也会影响待办事项列表（分组）的宽度
11、在修改过程中，我提出希望Cursor能够保存用户通过拖动调节的宽度值，Cursor创建了新的InterfaceSettings数据模型和ResizableHSplitView组件，前者用于持久化保存宽度设置，后者用于监听用户拖动分割线时的宽度变化，多次修改后默认宽度依然是400，虽然可以通过拖动分割线调整宽度，但调整后的宽度不会被保存，切换到其它界面再切回来，宽度依然是400，后续再修改
12、突然想看看最近Trae多次更新之后水平有没有什么提升，于是复制了一份ChatWith，改名为ChatWith for Mac，让Trae把这个iOS应用改成Mac应用，经历了修改项目文件、Info.plist、ContentView、ConversationListView、ChatWith、MessageViews等等文件，以移除iOS特有、在macOS上不适用的代码，接下来就是漫长的构建失败-查找原因-修改-继续构建失败-清理缓存-继续构建失败的过程，在这一过程中遇到了6次“模型思考次数已达上限”的提示，即使经历了如此漫长的修改，仍然构建失败，没想到Trae的Auto模式还是这么难用，第七次提示模型思考次数已达上限之后终于还是没耐心了
13、由Cursor接手继续修改，指令“这是一个由iOS应用改成的macOS应用，但在修改过程中反复出现构建错误，看一下原因”，Cursor在构建一次之后直接定位了问题所在，于是创建了任务列表来修复错误，只用了几分钟就构建成功，为什么Trae连快速定位问题都做不到呢？
14、而且Trae在修改过程中，还在项目文件夹里创建了很多个扩展名为.o的文件，Cursor表示这是编译过程中的中间产物，包含机器码，但通常应该在DerivedData目录下，而不是在源代码目录，于是让Cursor直接删掉了这些文件
15、然后让Cursor评估是否还需要原本iOS应用的启动画面文件SplashView，macOS应用通常直接显示主界面，不需要启动画面，删除此文件后Cursor同步从项目文件中移除了SplashView的引用
16、测试发现应用可以打开，但在Dock栏没有图标，且打开的应用没有直接出现在所有窗口最前，让Cursor修改之后解决了应用未显示在所有窗口最前的问题，但应用的图标不是macOS应用默认的图标，接下来让Cursor排查目前未被使用的文件，包括了由Trae创建的测试文件TestFile.swift，以及Package.swift(Swift Package Manager文件，但项目使用的Xcode项目，又是一个Trae的迷之操作)，果断删掉了这两个文件，然后在Xcode中重新打开项目所在文件夹，图标问题解决了
17、接下来可以测试和完善功能了，首先就是设置界面和AI对话界面弹窗太小的问题，完全看不到其中的内容（可能macOS上不太适合这种弹窗sheet的交互方式吧），Cursor同步修改了对话列表界面的弹窗、AI对话界面的模型选择器、设置界面的模型编辑弹窗、收藏界面的弹窗，但修改效果不佳
18、发现Cursor在最近更新后，修改过程中会标出哪个操作使用了用户的习惯或规则
19、接下来，优先把应用的数据存储方式由UserDefaults改成User Defaults和Core Data混用

DevLog：2025年9月10日

1、关于Markdown渲染三方库，Cursor之前建议了SwiftUI-Markdown和MarkdownUI，但追问之后它更建议使用MarkdownUI，原因在于它完全基于SwiftUI构建，与项目架构完美匹配，且渲染性能更好，维护活跃，API简洁，支持表格、代码块、链接等所有常用的Markdown功能，说的这么好，实际用起来如何还得测试一下
2、除了AI问答之外，我还希望能将MarkdownUI用在备忘录模块，并且实现所见即所得的渲染，不再使用预览和编辑双视图，Cursor表示完全可以，并且所见即所得的渲染正是MarkdownUI的优势之一，优势包括：内容变化时自动重新渲染、可以只显示渲染后的效果，无需双视图、渲染流畅、支持所有Markdown语法、可以自定义样式和主题
3、Cursor还给出了三种实现方案，纯预览模式（类似Notion）、混合模式（小区域显示原始Markdown代码）、编辑模式，个人比较倾向于第一种，希望能够解决这段时间一直没能解决的AI对话、备忘录对Markdown语法的渲染问题
4、先修改备忘录模块，这次Cursor创建了一个使用MarkdownUI的备忘录编辑器组件MarkdownEditorView，并且修改了其它关联文件来使用这个组件，移除不再需要的工具栏和预览切换功能，因为MarkdownEditorView已经内置了这些功能，然后通过Swift Package Manager添加了MarkdownUI库，据称已经实现了真正的所见即所得编辑体验
5、测试发现备忘录界面有一行多余的“备忘录编辑器”，另外备忘录的内容显示有问题，当切换到不同备忘录时，内容没有正确更新，然后我还发现在打开某条备忘录，并且在列表中右键删除这条备忘录时，右侧应该显示“选择一个备忘录开始编辑”的界面，而不是仍然能看到已经删除的备忘录，Cursor移除了MarkdownEditView中的if !isEditing的条件判断，确保当外部内容改变时，编辑内容总是会更新，然后移除了NoteEditView工具栏中的“备忘录编辑器”文字（但现在仍然还有多余的修改时间，也需要删掉），并且修改了NotesListView来监听备忘录列表的变化
6、然后优化了备忘录页面的标题显示，备忘录列表顶部固定显示“备忘录”三个字，备忘录详情顶部根据我选中的备忘录标题而变化，未选中任何备忘录时则显示“备忘录”三个字
7、我其实不需要现在的编辑按钮，更倾向于直接点击备忘录内容区域就能编辑，所见即所得，并实时保存修改，类似Notion，明天看看Cursor能否在继续使用MarkdownUI的前提下实现这一功能

DevLog：2025年9月9日

1、继续昨天的修改，昨天为了实现对表格较好的渲染效果，拆分出了UnifiedMarkdownView，用于渲染普通文本，表格和代码块都已有专用的文件来渲染，但UnifiedMarkdownView使用了简单的Text组件，丢失了Markdown渲染效果，还是需要换成NSTextView，以实现良好的Markdown渲染效果、文字选择、右键菜单等功能
2、为了实现除表格和代码块之外的文本内容的渲染效果，Cursor创建了新的文件MarkdownTextView，至此明确了组件的职责，MarkdownTextView专门渲染普通文本，TableView专门渲染表格内容，CodeBlockView专门渲染代码块内容，UnifiedMarkdownView统一协调各个组件
3、接下来又是漫长的添加调试信息、定位问题的过程，在此过程中出现了应用卡死、文本不显示等问题，一直没能实现用NSTextView来渲染AI问答的文本内容，目前还是用的Text，可以正常显示文本、选择并复制文本，但没能搞定用AttributedString来解析Markdown，暂时搁置
4、先修改表格的样式，发现目前的表格第二行显示了一堆分隔符，而非正常的表格内容，而且Cursor给表格增加了最大高度限制和滚动功能，我也用不到，让Cursor修改下，Cursor创建了MarkdownTableCell组件来渲染表格单元格，但导致了应用卡死，在恢复到简单的Text组件后暂时不会卡死了，但表格里还是混合了Markdown语法标记，尤其是加粗标记
5、先保存粗体处理试试看，目前测试过的两个表格，都是粗体字比较常见，没想到只想使用这一个功能，也会导致应用卡死，只能先撤销了这一步修改，接下来准备试试Cursor建议的第三方Markdown库，比如SwiftUI-Markdown或MarkdownUI，如果可以的话，应该可以搞定AI对话中的文本、表格，以及备忘录的Markdown渲染