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错误信息,明天再修改

发表回复