标签： UI

DevLog：2026年1月5日

1、年前对目前的项目进行了盘点，暂定先主要推进ChatWith移动端（已使用Flutter重写）和ChatWith for Mac的开发工作

2、针对ChatWith for Mac，节前要求Cursor进行了微调，以实现“所有网络请求必须在后台线程执行，所有UI更新操作必须在主线程执行”的需求，今天起对应用进行测试，主要看是否还会在切换对话时遇到卡死问题，已经去掉了在对话中切换模型的功能，如果测试没有什么明显的问题就修改设置-关于页面、刷新README文档，并打包，版本号用v0.3

3、对比Chatbox，有几个功能后面还是要加上，比如上传图片、上传文件并由AI进行解读，这两个功能留到后面v0.5时再添加

4、接下来调整一下UI，特别是输入框，目前应用的输入框看不到边框线，且右侧的联网搜索和发送/停止按钮大小不一样，要求Cursor给对话界面的输入框增加灰色边框线，并修改联网搜索按钮，去掉已关闭、已开启的文字，只留图标

5、输入框和按钮的修改基本完成，但总感觉发送/停止按钮和联网搜索按钮大小不一样，且在测试时再次遇到了应用卡死问题，从调试信息来看，对话的输入和输出是正常的，但没有看到UI更新，继续反馈问题给Cursor，修改一次之后卡死问题更加严重，只要打开应用-打开历史对话就会卡死，再次反馈、修改

6、目前打开应用-打开历史对话暂时不会卡死了，但在翻看更早的历史对话消息时又会卡死，要求Cursor添加调试信息来定位问题，同时还询问了豆包，豆包认为所有的耗时操作都不应该放在主线程执行，比如网络请求（之前已经挪到了后台线程）和本地数据读写（涉及DataManager和MessageView等文件），修改之后Cursor指出，虽然Core Data的保存操作必须在主线程执行，但由于使用了异步执行，不会阻塞调用线程

7、再次测试，仍然会出现卡死问题，逐渐失去耐心了，询问豆包，换用 Flutter 完全可以从根源上解决这类卡死问题，且Flutter对「消息列表加载/渲染」的适配性远优于原生Swift，99%的原生卡死场景在Flutter中都能彻底规避；更关键的是，Flutter无需像原生那样做大量「线程切换、异步处理」的繁琐适配，基础写法就自带防卡死能力，开发效率更高

8、开启了一个新对话，决定在新对话中先梳理目前应用的功能，并且用Flutter来重写当前应用，步骤包括创建Flutter项目结构和基础配置、创建数据模型、实现数据层、实现AI服务层、实现视图模型、创建主界面、实现AI对话视图、实现收藏视图、实现设置视图、实现搜索视图、检查并完善所有模型类等等，耗时大概50分钟，中间还中断了一次，点击继续之后Cursor首先查可能了已有文件，了解进度，并逐步完成剩余部分

9、使用Flutter的项目结构包含models-数据模型、services-服务层、viewmodels-视图模型、views-UI视图，之后让Cursor生成了该应用的的macOS平台代码，并且在生成ephemeral文件，并修复编译错误、图标问题后，项目成功构建

10、使用Flutter构建的应用界面稍显简陋，主要的功能板块已经有了，包括对话、收藏、设置三个页面，设置中包含了AI模型管理、外观设置和数据统计，但每个界面右上角都带了一个DEBUG的标志，不知道是干啥用的，先让Cursor去掉它（debugShowCheckedModBanner），同时也问问能否把之前已有的图标文件复制过来一份，继续使用（将Swift版本的图标复制到Flutter版本，并重命名为Flutter所需的文件名格式）

11、修改过程中再次出现了频繁创建.md说明文件的情况，其实我用不到，要求Cusor清理掉

12、目前ChatWith for Mac已经实现了基于Flutter的改写，并且可以成功构建，接下来需要对各个功能进行详细测试和修改，目前已发现的问题包括：

1.在添加和修改模型时，我需要让添加和修改窗口在最前，只有点了取消或确定后才能回到主界面，现在只要一点主界面，添加和修改窗口就会被关闭

2.对话时，点击发送按钮后问题发不出去，没有任何反应

3.设置-外观设置-主题模式中，我需要跟随系统、浅色模式、深色模式三个选项，并且点击选项后可实现对应的主题模式

4.需要增加回收站功能（删除和恢复对话和收藏）和搜索功能（搜索对话和收藏）

5.设置-AI模型管理界面，需要增加删除模型按钮

13、初步修改了一轮之后，发现上面的五个问题里，

1.已解决

2.未解决，发送按钮有时可用有时不可用

3.已解决

4.需要把回收站挪到设置页的数据统计下边，即设置界面共有AI模型管理、外观设置、数据统计、回收站四个功能

5.未解决，AI模型管理界面还是没有删除模型按钮

14、继续修正问题2和问题4，问题2通过添加输入框监听器和_cansend状态变量，已完成修改，问题4主要是在entitlements文件中添加了com.apple.security.network.client权限，允许应用进行网络请求，已完成修改，并且在测试过程中发现之前使用Swift实现的深度思考、流式输出等功能均可正常使用

15、继续修正问题5，通过移除if(config.isCustom)条件判断，改为每个模型后边都会显示删除按钮，解决了问题

16、明天继续修改其他问题，包括：

1.把右上角的搜索按钮挪到最左侧，放在“对话”上面

2.明确对话列表的显示规则，标题直接用用户提出的最后一个问题，下面小字显示最后一次回答的内容，只显示一行

3.对话列表和收藏列表的宽度都固定为300，且不需要拖动调整

4.其他问题视测试情况而定

DevLog：2025年12月2日

1、昨天在引入MarkdownUI替换之前自定义的MarkdownRenderer之后，Cursor未能进行构建测试，虽然也自称检查后未发现语法错误，但今天在Xcode中构建测试发现AI对话核心的文件AIChatView存在多个错误，导致构建失败，先复制给Cursor让它修复下这些错误

2、Cursor在简化了AIChatView的部分代码后构建成功，接下来测试并逐个修改各个模块的问题，先是这两个：

1.添加模型之后，发送消息后收到错误提示：发送消息失败：API错误（404），导致无法正常对话

2.AI模型管理界面缺少对模型的测试机制，需要增加测试机制，点击可测试，确认能正常连接

3、Cursor认为第一个问题是因为缺少URL补全机制导致的，于是修复了URL拼接问题，在用户填写的Base URL后面增加/chat/completions，然后在模型管理界面（包括列表视图、表单视图）添加了测试UI

4、在Xcode中打开发现测试UI工作正常，但我与测试可用的模型对话时，出现AI正在思考中的提示之后，没有收到任何回复，继续让Cursor检查原因并修复

5、Cursor修复了流式解析问题，包括改进流式响应解析逻辑、改进错误处理、增强兼容性等，虽然可以正常构建了，但我测试了两个问题，回答内容都未能完整显示，输出了一部分就停了，并且停止按钮一直未能变成发送按钮（正常的话应该收到所有回答之后停止按钮就会变成发送按钮）

6、Cursor认为问题原因在于流式输出解析顺序和ViewModel中的更新逻辑，前者主要是先检查finish_reason再处理delta，导致最后一块内容可能被跳过，当finish_reason存在时直接break，未处理该条数据中的delta，后者主要是更新频率限制在100ms，可能导致最后的内容未及时更新，同时，为了确保流式输出正确完成，Cursor也做了一些修改，无论finish_reason是否存在，都会在结束时调用onUpdate，即使delta为空，也会更新一次，确保状态正确，isLoading会被正确设置为false，停止按钮会变回发送按钮

7、继续在Xcode中测试了两个问题，这次可以完整显示所有回答内容了，并且停止按钮也会随着输出结束变回发送按钮

8、接下来准备参考ChatWith for Mac添加模型的逻辑，预置一些常用的模型服务提供商供用户选择，包括OpenAI、DeepSeek、Anthropic Claude、OpenRouter、Google Gemini、智谱GLM、月之暗面Kimi、百度文心一言、百度云千帆、阿里通义千问、阿里云百炼、腾讯混元、硅基流动、火山方舟、自定义，然后让Cursor引入RichTextKit，替换目前的备忘录模块

DevLog：2025年10月15日

1、上次修改搜索功能之后，增加了点击搜索结果立刻跳转到应用的对应内容的功能，实测可以跳转到对话的对应位置，但不能跳转到收藏的对应位置，在搜索结果页面，对话和收藏条目下的更新时间显示也有问题，对话内容创建于几天几小时前，收藏内容更新于几天几小时前，统一成创建于年月日，小时分钟，与对话列表和收藏列表条目的时间显示形式一致，让Cursor检查并修正一下

2、修改过程中发现，前者是因为CoreData对象不能直接跨不同的实例传递，需要通过ID来传递和查找Note对象，后者是将相对的时间格式改成绝对的时间格式，修改后测试，时间显示正常了，但点击对话和收藏的搜索结果都无法直接跳转到对应位置

3、通过反复的添加调试信息、反馈调试信息定位并解决了问题，并且适当缩短了等待时间，目前点击搜索结果中的对话内容可以直接跳转到对话所在位置，点击收藏内容可以直接打开对应的收藏条目，已经基本实现了优化搜索页面的需求

4、上次修改应用时，我想到可能需要按照macOS 26的最新设计规范来调整一下ChatWith for Mac的界面，于是询问Cursor“你熟悉最新的macOS Tahoe应用设计规范吗？如果要对当前的应用的UI做一些针对macOS Tahoe的优化，你有什么建议？在进行这些修改后，还能否兼容macOS Tahoe之前的系统？”Cursor的回答很诚实：我需要先确认一下您提到的 macOS 版本。根据我的知识（截止到2024年4月），Apple 的最新版本是 macOS Sonoma (14.x) 和 macOS Sequoia (15.x)。我没有关于”macOS Tahoe”的具体信息。

5、不过Cursor也给了一些既适用于macOS 14.0 Sonoma，也能保持向后兼容的UI优化建议，包括材质和视觉层次、增大圆角和边距、使用Typography排版、增加hover效果等交互反馈、使用多色SF Symbols等等，这些都是锦上添花的东西，不急，还是继续优化功能更要紧

6、下一步计划增加上传图片和文档的功能，在对话界面的联网搜索和发送按钮之间增加附件按钮，点击可以上传本地的图片或文件（主要是文档格式），上传之后不直接发送给 AI，可以在输入框补充一些文字需求，一并提交

DevLog：2025年10月13日

1、在上周给对话界面增加联网搜索开关功能之后，出现了点击发送问题应用便会卡死的问题，且看不到Cursor增加的搜索状态提示，在Cursor中开启新对话，排查一下问题出在哪里

2、Cursor在排查之后指出可能是TavilySearchService在执行网络请求时使用了await MainActor.run，导致网络请求在主线程上等待响应，但网络请求通常需要数秒时间，在主线程上等待会导致UI完全卡死，于是修改了TavilySearchService、AIService和AIViewModel三个文件，再次测试发现问题已经解决，可以看到搜索状态和思考状态提示，思考内容、回答内容、参考链接的展示也都正常，回答结束后状态提示也会消失

3、接下来解决之前用户反馈的其它问题，包括：

1.当前搜索页面缺少返回按钮，实际上搜索功能目前还不全，搜完能看到关键词所在的对话/收藏，但点击不会跳转到对应条目，还得再完善下

2.问题太长时，对话界面上方的标题可能会断行，需要限制一下字数

4、先解决第二个问题，让Cursor限制一下对话界面顶部标题的显示字数，这里涉及到了AIChatView，目前直接显示了完整的用户问题内容，没有长度限制，改成了完整显示前20个字符，之后则用省略号

5、然后完善搜索功能，搜索界面需要增加返回按钮，另外在输入关键词、呈现搜索结果后，点击搜索结果就应该跳转到对应的对话内容所在位置或对应的收藏内容，已要求Cursor修改，包括添加返回按钮、实现搜索结果跳转功能、UI的改进等，但未实际测试

6、还有一些需要优化的地方，比如将系统更新到macOS Tahoe 26.0.1之后，AI对话的提问和回答都没有边框了，可能是因为系统更新之后一些UI有了变化导致的，但不清楚Cursor是否了解最新的开发规范，后面再试

DevLog：2025年8月5日

1、今天先处理一下ChatWith在使用深度思考模型时的显示效果问题，目标是如果模型支持深度思考，那就在对话过程中先展现思考过程，思考过程结束后折叠思考内容，继续展现回答内容，整个过程都需要流式输出，且能随着输出过程自动向下滚动
2、Cursor在修改过程中，根据我提供的调试信息再次添加了更详细的调试信息，再次测试时发现1.虽然可以看到思考过程，但却是在回答结束后才发现在回答内容上方有思考过程，应该先让我看到思考过程，思考结束后再呈现回答内容 2.思考过程显示不全，只能看到一部分 3.一旦折叠或展开思考过程，就会自动跳到对话界面的底部，体验也不是很好，最好是我在折叠或展开思考过程时，仍然停留在当前位置
3、这三个问题还没有解决，又发现在AI输出过程中，CPU占用率可以飙升到100%，且回答内容越长应用就会越卡顿，一旦回答完成或点击返回到对话列表后CPU占用率立即下降到0%，Cursor认为这种性能问题是由于存在多个重复的滚动监听器，并且每次流式输出都会触发频繁的UI更新，优化后性能有了明显的改善
4、多次修改后仍然不能完美解决思考过程的展现，决定暂时简化掉这一功能，去掉对深度思考过程的展现，直接流式输出回答内容，已实现
5、然后测试时发现MarkdownRenderer需要再完善一下，比如AI回答的内容里如果有链接，还会显示成带有Markdown语法的形式，不会直接显示成链接，另外还需要优化一下对话界面，在发送问题之后，发送按钮变为停止按钮，点击可以打断AI的回答，已实现
6、目前的对话列表中，长按对话可在菜单中选择置顶，但置顶后的对话和其它对话在样式上没有区别，让Cursor优化一下显示效果，Cursor优化的效果还不错，比如加上了与启动界面颜色一致的细边框、PIN图标、置顶标识、渐变背景等等，之后又边测试边让Cursor处理了无法取消置顶、对话列表不按最后对话时间排序、对话时间只显示小时和分钟等问题，并且去掉了多余的置顶和模型图标
7、出于好奇，询问了Cursor有没有必要将对话列表和收藏列表拆分成单独的视图，Cursor表示强烈建议拆分，目前这两个列表均在ChatView内，而ChatView已经有1300多行代码，包含了太多不同的功能模块，违反了单一职责原则，且代码组织混乱、状态管理复杂，建议拆分除单独的ConversationListView、FavoritesView、SearchView，并创建一个ConversationManager数据管理器来处理共享状态
8、Cursor还给出了分步骤的实施建议，先创建新文件结构，拆分独立文件，再优化数据管理，创建ConversationManager，减少重复代码，之后再组件化，提取可复用组件并创建Components目录，以提高代码复用性
9、虽然现在应用功能并不多，但拆分过程中也容易出现各种错误，比如已经拆分为单独文件的视图和原有的代码并存导致冲突，需要边修改边构建，之后再详细测试每一个功能确保应用功能正常，Cursor在拆分完成后表示，现在应用有了更好的架构基础，便于未来的功能扩展和维护
10、在Xcode模拟器中测试调整架构后的应用，发现如下问题，可能是拆分单独的视图之后导致的功能丢失：对话内容无法通过长按复制/收藏；发送问题之后会出现错误提示“请先配置API密钥”，但我已经配置了模型信息；“设置”界面左上角需要添加“返回”按钮；收藏列表需要以对话列表的样式显示，每条收藏在列表中仅显示两行文字即可
11、在修复上述问题的过程中遇到了对话长度超限的问题，不得已开启了新对话，在修复几处错误之后，Cursor试图开启模拟器帮我测试应用，我更习惯自己在模拟器中测试，回复“以后我自己”（其实还没有打完就点了发送），Cursor竟然理解了我的意思，回复说“好的，我理解您想要自己处理后续的操作”
12、再次测试，发现这些问题：新收藏的对话内容没有出现在收藏列表里；发送问题之后没有“AI正在思考中”的提示；回答过程中会同时出现两条一样的回答内容，回答结束后仅显示一条
13、Cursor没能一次解决上述问题，测试发现还有新问题：发送问题之后仍然没有“AI正在思考中”的提示；我需要以流式输出显示回答内容，不要一次跳出全部回复内容；对话界面需要跟随流式输出向下滚动，始终显示最新的回答内容；收藏列表需要按收藏时间倒序排列
14、在修改过程中，Cursor建议将ChatView的body结构拆分为更小的组件，比如消息列表、输入框、头部等分别提取为独立组件，以减少嵌套和条件判断，但多次修改后仍然频繁出现错误，比如问题提交之后应用就会卡死、新建对话后原有的对话会消失、同时输出两条一样的回答内容、对话中只能看到最早的一个问题，其它的内容都不显示 等等问题，猜测可能是在将ChatView拆分成多个文件之后，在拆分组件时，出现了功能上的重复和冲突，于是让Cursor继续检查ChatView和Views目录下的文件有没有功能重复的情况
15、目前在对话界面提交问题后应用还是会卡死，也没有了“AI正在思考中”的状态提示，明天让Cursor继续拆分ChatView，检查有无功能重复，并添加调试信息定位问题，还有另一个问题也明天处理：目前的ChatWith用StoryBoard作为启动页面，NoteWith和DoitWith则是用SplashView作为启动页，这两种形式有啥区别？
16、最近Cursor在更新之后添加了一个Context Usage的提示，以后注意时刻关注这个用量提示，如果要对应用做比较大的改动，但用量快到顶了，就开启一个新对话，虽然可以选择参考上次的对话内容，但好像参考的效果不太行