DevLog:2026年1月8日

1、昨天在引入flutter_quill之后未做测试,今天首次测试又遇到了The sandbox is not in sync with the Podfile.lock. Run ‘pod install’ or update your CocoaPods installation.的错误提示,这是CocoaPods同步问题,通常发生在添加新依赖后,需要运行pod install以同步Podfile.lock,并且flutter_quill在macOS上需要原生桥接库(quill_native_bridge_macos),Cursor还提醒我如果后续添加新的原生依赖,记得在macos/目录下运行pod install

2、把这条也添加到了Cursor的User Rules里,并且也跟Cursor明确了这个要求,完整的说法应该是“以后在Flutter macOS项目中添加新依赖后,会自动在macos/目录下运行pod install以同步CocoaPods依赖”,看看以后是否还会出现类似问题

3、测试发现编辑模式无法正常使用,切换到编辑模式后,提示“UnimplementedError:FlutterQuillLocalizations instance in required and could not found. Add the delegate ’FlutterQuillLocalizations.delegate’ to your widget app (e.g., MaterialApp) to fix.”

4、原因在于flutter_quill需要FlutterQuillLocalizations.delegate来提供本地化字符串,Cursor在修改过程中添加了flutter_localizations依赖,在MaterialApp中添加了本地化支持,再次测试可正常启用编辑模式,其中的格式按钮也基本都可正常使用,但是我自己创建的笔记在预览状态下只能显示纯文本,即使我添加了Markdown语法标记也看不到Markdown渲染的效果,然后也看不到使用富文本编辑器编辑后的所有效果(试了几个不同的格式,只有斜体可以在预览状态下看到),并且所有的文字内容都没有左对齐,像是每一行前面都有很多空白

5、Cursor认为原因在于之前使用了toPlainText()保存,会丢失所有格式,改成了保存Delta JSON格式,保留所有富文本格式(粗体、斜体、列表、代码块等),关于预览模式的显示,对于富文本内容使用QuillEditor只读模式显示,可显示所有格式,对于纯文本/Markdown内容使用MarkdownBody显示,支持Markdown语法渲染,并且可以自动检测内容格式,选择合适的显示方式,关于左对齐的问题,移除了可能导致对齐问题的外层滚动视图,使用Padding直接包裹编辑器,确保内容左对齐

6、测试发现基本实现了上面所说的效果,富文本内容和Markdown内容都可以在预览界面正常显示了,但在过程中反复出现了构建失败-反馈错误-Cursor修改的过程,最后原因是前面修改功能后出现了语法错误,比如括号匹配问题、readOnly参数使用问题,修复后可以正常构建,于是要求Cursor以后在修改文件后先检查有没有语法错误,再总结具体都修改了哪些,这样也能减少一些反复测试、反馈、修改的工作量

7、Cursor回复:已记录该工作流程,新的工作流程是

1.修改代码

2.立即检查语法错误(运行flutter analyze检查分析错误、使用read_lints检查linter错误、修复所有语法和编译错误)

3.确认无误后,再总结修改内容

8、继续丰富功能,目前比较刚需的功能是上传和解读图片功能,需要加高消息输入框,并在消息输入框右侧的联网搜索按钮上方增加一个附件按钮,点击可以打开系统的文件浏览器选择图片,需要支持常见的图片格式,并且在选择-上传图片之后,不立即发送给AI,而是在输入框上方以浮窗形式显示缩略图,需要用户输入文字形式的指令,并点击发送按钮,才能发送给AI,看下Cursor对这种比较复杂的指令的理解和实现程度如何

9、修改过程包括添加依赖(file_picker文件选择和image图片处理)、修改输入框(加高、添加_selectedImages列表存储选中的图片)、添加附件按钮、实现图片选择功能(使用FilePicker.platform.pickFiles打开系统文件浏览器,支持jpg/jpeg/png/gif/webp/bmp,且支持多选)、实现图片预览浮窗(显示80*80的缩略图、每张图片右上角有删除按钮、提供清除按钮清除所有图片、仅在选中图片时显示)、修改发送逻辑、修改ViewModel、修改AI Service,实现的功能包括图片选择、图片预览、延迟发送、组合发送、图片管理

10、构建应用并测试一下图片上传功能,首先点击新增的附件按钮就出现了选择图片失败的提示,Invalid argument(allowedExtensions),并且上传附件的按钮样式,和联网搜索、发送按钮的样式区别也比较大,也需要调整一下

11、反馈后,Cursor修复了图片选择错误,原因在于FileType.image与allowedExtensions不能同时使用,将FileType.image改为FileType.custom,同时修改了附件按钮的样式为Icons.attach_file_outlined和Icons.attach_file

12、再次测试,点击添加附件按钮出现了如下调试信息,Cursor认为这是macOS沙盒权限的问题

Unable to obtain a task name port right for pid 601: (os/kern) failure (0x5)

Unable to display open panel: your app is missing the User Selected File Read app sandbox entitlement. Please ensure that your app’s target capabilities include the proper entitlements.

13、于是在两个entitlements文件(DebugProfile.entitlements-DEBUG和Profile构建配置、Release.entitlements-Release构建配置)中添加了必要的权限:启用应用沙盒、允许读取用户通过文件选择器选择的文件、允许网络请求,之后Clean Build Folder,继续测试

14、重新生成Flutter ephemeral文件后,可以正常构建,可以选择图片、上传图片、发送图片及问题,但发送之后看不到缩略图,需要优化下,即使发送图片之后,也要在对话界面看到缩略图,可以和文字消息合并到一起

15、另外发图片给DeepSeek系列模型的API后才发现它不支持多模态输入输出,会报错HTTP 400,Invalid content type.image_url is only supported by certain models,看样子在模型管理界面还需要识别并标示一下哪个模型支持读取图片,比如点击测试按钮即可同步测试连通性以及是否支持图片及附件,并在模型列表中标示

16、以上两个问题同时反馈给Cursor,修改过程包括消息显示优化(支持图片缩略图)、数据模型扩展(支持图片路径)、数据库升级(添加图片路径字段)、发送消息逻辑(保存图片路径)、模型管理界面(图片支持测试,如果模型支持图片,显示“支持图片标识”)、模型配置扩展(图片支持标识)

17、测试修改效果,支持图片的模型可以看到蓝色的“支持图片”的标识,我需要给测试之后不支持图片的模型加上“不支持图片”的标识,但颜色上要有所区别,比如不支持图片的标识和文字用红色,同时,是否支持图片的标识也需要在AI对话的模型选择界面显示,方便用户选择模型,另外,虽然Claude Sonnet 4支持读取图片,但给它发图之后依然收到了不支持图片的Invalid content type.image_url is only supported by certain models错误提示

18、修改后再次测试发现,虽然在测试时可以看到“不支持图片”的红色标识,但这个红色标识并不会像“支持图片”的蓝色标识一样会一直存在,并且在AI对话的模型选择页面里,也看不到“不支持图片”的红色标识,只能看到“支持图片”的蓝色标识,另外,AI对话的模型选择页面需要优化一下显示效果,使用类似“设置-数据统计”页面的卡片形式,继续让Cursor修改

19、Cursor添加了imageSupportTested字段,修复模型管理界面的标识持久化,并优化了模型选择界面,再次测试功能正常

20、然后就是上面提到的,虽然Claude Sonnet 4的API支持读取图片,但给它发图之后依然返回了“Invalid content type.image_url is only supported by certain models”错误提示,Cursor认为这是因为Claude API使用了与OpenAI不同的图片格式,导致发送图片时出现这种错误提示,在修改过程中添加了_isClaudeAPI()方法,检测是否为Claude API(通过baseURL、模型名称或备注判断),并且进行了图片格式适配、请求头适配、请求体适配、流式响应处理等操作,再次测试,遇到了新BUG,上传图片后看不到缩略图了,并且还有同样的HTTP 400错误信息,明天再修改

DevLog:2025年8月12日

1、今天先继续优化NoteWith的AI对话使用体验,发现两个小问题:1.提交问题之后,“AI正在思考中”显示的位置有点靠下,需要手动滑动一下屏幕才能看到,在回答结束后,“回答完成”和时间的显示位置也有点靠下,也需要手动滑动屏幕才能看到 2.为什么即使我用的是deepseek r1这种支持深度思考的模型,在对话时也看不到思考过程?
2、Cursor在修改时专门添加了对DeepSeek模型的deepseek_thinking字段支持,现在可以正确显示思考过程了,并且也优化了滚动体验,解决了上述两个问题,看样子在给Cursor下需求时还是要尽量详细,之前多次反馈看不到思考内容,但没有点名deepseek r1
3、但是深度思考内容的样式需要调整一下,现在使用了和回答内容一样的字体和颜色,需要在文字上做一些区分,要求Cursor将思考内容的字号缩小一点,并且使用稍浅色的字体,和回答内容有所区分
4、但第一次修改后未能生效,回想起我之前给MarkdownRenderer限定了所有文本的字体样式,可能是受此影响,于是让Cursor修改了AIChatView,让思考内容部分直接使用纯文本,不使用MarkdownRenderer,这下思考和回答内容有了明显的区别,有点理解为什么会有人说改过去的代码和改别人的代码有多痛苦了
5、发现在备忘录列表页,点击星号时列表中条目的时间会变,我的需求是:这个时间只有我在添加收藏和编辑收藏内容时才变,不能因为加星和取消星号就变,Cursor修复了DataManager和NotesDataService中的toggleFavorite方法,实现了这一需求
6、再次细化需求:在保证点星号时间戳不发生变化,只有真正编辑备忘录内容时时间戳才会更新 的基础上,我还需要点亮星号后让这条收藏置顶显示,未点亮星号的收藏按照更新时间排序,Cursor优化了NotesViewModel的排序逻辑,搞定
7、继续优化细节,发现在AI对话列表里,可以通过滑动触发删除操作,在这里增加一个“编辑”按钮,点击可以编辑这条对话的标题,并把“Delete”改成“删除”;然后也把备忘录列表滑动菜单里的“Delete”也改成“删除”,需求很快达成
8、发现在Cursor中开启一个新对话后,原本提醒Cursor的一些注意事项会失效,比如我之前已经提示了不止一次,代码修改完之后只需要构建一下就行,不需要帮我启动应用,但每次开启新对话,修改代码后就会构建并且想要启动应用,还得手动skip一下
9、决定把AI对话列表这种滑动的交互方式应用到AI模型管理界面,在条目上滑动时出现编辑、删除按钮,点编辑可以进入AI模型编辑界面,点删除可以删除当前这个模型,Cursor修改了AIModelManagementView,将原来的菜单按钮改为滑动操作
10、接下来多试试不同的AI应用,看看有没有其它比较高频同时又不太复杂(不知道实现起来会不会复杂)的功能可以增加到NoteWith里,以及找一个更好用的富文本编辑器,之前使用了UITextView,但体验一直不是很好,问了下火山引擎提供的DoubaoPro,有哪些比较容易集成的富文本编辑器,它也推荐UITextView,再结合NSAttributedString处理富文本属性,优点在于稳定性好,性能开销小,上手容易,缺点在于功能相对有限,且样式设置较为繁琐,看看先增加一个tab来测试富文本编辑器,没问题了就删掉现有的Markdown编辑器

DevLog:2025年8月1日

1、我发现在备忘录界面中添加文字时就会一直出现报错信息,Cursor表示这些错误信息主要来自输入法系统,表明在文本输入过程中出现了问题,Cursor对NoteEditView的代码进行了优化,并且优化NoteEditView的主要逻辑,减少不必要的更新
2、Cursor修复完成后再次测试,问题仍然存在,于是要求Cursor评判是否是昨天添加的设置对齐方式的功能,或者限定备忘录默认字体产生的影响
3、Cursor不仅没能修复大量出现的错误,还产生了新的问题:一是创建新备忘录/编辑备忘录时标题栏不显示了,二是创建的新备忘录没有出现在备忘录列表里,先让它把这两个问题解决掉
4、Cursor用添加调试信息的方法快速解决了上面第二个问题,于是让它用类似的方法,添加调试信息,看看能不能解决在添加文字、调整对齐方式时大量出现的错误信息,多次修改之后终于解决了大量报错和应用崩溃的问题
5、在测试其它的格式设置按钮时发现,粗体、斜体、下划线、删除线等格式,一旦设置后就很难取消,正常的话应该再点一次就能取消格式设置,但现在需要点击多次才能取消,在修改过程中还遇到了设置格式时有时会生效有时不生效的问题 ,Cursor表示是格式检查逻辑和UI更新实际的问题,但多次修改后无果
6、决定先简化备忘录的格式设置工具栏,只保留加粗、斜体、下划线、删除线 四个按钮,其它的按钮及相关功能先删掉,但多次修改后仍然不能正常使用格式设置功能
7、决定将目前备忘录编辑界面的富文本编辑器改为Markdown编辑器,并且给这个编辑器添加和AI对话界面相同的Markdown渲染机制,之后再让Cursor移除了底部的工具栏,增加了常驻的字数统计功能,发现Cursor在一些设计细节上做的还是很好的,比如字数统计功能的位置、字体、颜色、对齐、背景、内边距等,都能尽量做到美观
8、之后让Cursor结合应用目前的功能刷新一下README,NoteWith至此暂时结束,下一步优化ChatWith,比如流式输出、Markdown渲染、深色模式等功能同样也可以加到ChatWith里,另外尝试一下增加多模型设置和切换功能
9、最近Cursor更新属实有些频繁,这几天基本一天一更新了,界面和交互上有一些小变化,别的变化暂时没发现