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年10月11日

1、节前发现的遗留问题如下,今天开始逐步修改:

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

2.联网搜索的触发词有点少,比如“今年”就无法触发搜索,需要进一步扩充,或者增加一个联网搜索按钮,点亮后开启联网搜索,或者改一下逻辑,在添加模型时只要填了Tavily Key,就开启联网搜索,并且在选择模型界面显示是否填写了Tavily Key,如果填写了就显示“联网搜索已开启”

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

2、首先修改上面的问题2,决定先用第三种方案,来解决部分AI模型因为训练数据比较老导致回答内容易出现错误的问题,要求Cursor修改一下联网搜索功能的逻辑,不再通过关键词判定是否开启联网搜索,而是在添加模型时只要填了Tavily Key,就会一直开启联网搜索,并且在选择AI模型界面显示“联网搜索已开启”,未填写Tavily Key的AI模型,则显示“联网搜索未开启”

3、但在这次修改后只要点击发送问题应用就会卡死,结合DEBUG信息,Cursor认为这是因为每次发送消息都会进行联网搜索会阻塞主线程,导致应用卡主,并且会消耗大量API配额、增加不必要的延迟,于是又给我改回了之前的方案1

4、可能方案2会比较合适?尝试让Cursor在发送按钮旁边增加一个“联网搜索已开启/已关闭” 的按钮,需要用户手动开启/关闭,默认是关闭状态,不用关键词来判定是否开启联网搜索,但在发送问题后仍然会让应用卡住,Cursor分析表示虽然代码本身是异步的,但可能存在网络请求没有超时控制(Tavily搜索请求可能长时间等待)、缺少用户反馈(用户不知道搜索正在进行)等问题,于是给TavilySearchService添加了超时控制、给AIService添加了搜索状态反馈,改进了AIViewModel和AIChatView的UI状态显示,但依然没有解决问题,甚至现在即使不打开联网搜索开关,点击发送按钮时应用也会卡死,而且也没有看到Cursor给AIService添加的调试信息

5、近期Cursor频繁更新,先更新一下再重新开启对话来修正这个问题,另外在将电脑系统更新到最新的macOS  Tahoe 26之后,由于整个系统的界面都有变化,ChatWith的一些UI也发生了变化,比如对话界面有些消息的边框看不到了,输入框的边框也看不到了,后面也需要调整下

DevLog:2025年9月30日

1、首先跟Cursor明确了模型切换界面AIModelSelectorView底部的确认和取消按钮的功能,切换模型时,点“确认”确认我对模型的切换,点“取消”则不切换模型,仍然保持打开模型切换界面前的选择,为实现这一功能,Cursor在这个文件里增加了临时选择机制,界面会高亮显示临时选择的模型,只有点确认时才会更新模型选择并关闭界面,在打开界面时,临时选择状态会设置为当前已选择的模型

2、昨天发现Xcode更新了,并且支持了Coding Intelligence功能,可以使用内建的Claude in Xcode(需要登录Claude账号),也可以自己添加模型或调用本地模型,还没有测试,感觉这个功能可能会和Cursor之类的AI IDE比较像,当然了更专注于苹果的应用

3、接下来可以试试用Icon Composer或者Asset Catalog给ChatWith for Mac创建一套图标

4、遗留问题如下,节后再修改:

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

2.联网搜索的触发词有点少,比如“今年”就无法触发搜索,需要进一步扩充,或者增加一个联网搜索按钮,点亮后开启联网搜索,或者改一下逻辑,在添加模型时只要填了Tavily Key,就开启联网搜索,并且在选择模型界面显示是否填写了Tavily Key,如果填写了就显示“联网搜索已开启”

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

DevLog:2025年9月27日

1、结合用户反馈对当前应用进行一些调整,首先优化模型选择界面AIModelSelectorView,在模型列表下方增加一个“添加更多模型”按钮,点击可以直达设置-模型管理界面,然后在模型选择界面底部增加确认、取消按钮,现在需要用ESC键返回至对话界面,不太符合电脑端的操作习惯

2、修改过程中,虽然我指定了文件AIModelSelectorView,但Cursor还是把确认和取消按钮放到了设置-模型管理界面下方,纠正后解决了,后续需测试点击取消,撤销对模型的切换操作,点击确认,确认对模型的切换操作

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

DevLog:2025年9月26日

1、询问Cursor如何将当前的应用打包,没想到Cursor竟然直接用Archive命令给我完成了打包,并且创建了ExportOptions.plist配置文件,并使用macOS Developer证书签名,生成了通用的双架构二进制文件,并输出为.app应用程序包,放到了ChatWith_Distribution文件夹下,另有一个名为ChatWith_v1.0_macOS的分发包,应用大小3.5MB(毕竟应用的功能还很简单)

2、找到了第一个用户,直接发了分发包,解压放到Mac的“应用程序”文件夹,但打开时会提示:Apple无法验证ChatWith是否包含可能危害Mac安全或泄露隐私的恶意软件,需要在设置中允许一下,可能是没有签名吧,这个以后再说

3、发现了如下bug:

1.对话界面切换模型按钮无法直达添加模型界面,新用户首次打开应用可能会有点困惑

2.联网搜索的触发词有点少,比如“今年”就无法触发搜索,需要进一步扩充,或者增加一个联网搜索按钮,点亮后开启联网搜索,或者改一下逻辑,在添加模型时只要填了Tavily Key,就开启联网搜索,并且在选择模型界面显示是否填写了Tavily Key,如果填写了就显示联网搜索已开启

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

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月19日

1、决定让Cursor适当美化当前应用,包括调整间距和圆角、使用系统颜色、添加悬停效果、优化图标使用等,Cursor标识已经按照现代macOS设计趋势对ChatWith应用进行了全面的界面优化,主要改进包括:间距和圆角优化、系统颜色使用、悬停效果和动画、图标优化、卡片式设计、侧边栏现代化、设置页面优化、搜索界面优化等,使应用具备了更直观的交互、更舒适的阅读、更现代的外观和更好的可用性(Cursor每次对自己的作品都非常自信)

2、测试发现好像也没有太大的变化,侧边栏图标和间距更大了,AI对话和收藏两个列表的条目增加了卡片效果,选中时的动效和颜色有调整,但选中时的边框太粗了,让Cursor调整了下,选中条目时文字会稍微变大导致稍微有点糊,这种负优化还是要去掉,并且选中置顶的内容时,不要增加蓝色边框,也让Cursor一并调整了

3、然后修改了对话详情页面上方的标题,和AI对话列表的标题保持一致,即我询问AI的最后一个问题,猜测对话详情页对应的文件是AIChatView,选中文件并Add File to Cursor Chat,并直接提出需求,这样就减少了定位问题的复杂度,以后要逐渐深入了解应用的文件结构,修改起来也会比较快

4、设置列表SettingsListView还是略显局促,下周再修改

DevLog:2025年9月18日

1、先测试一下目前这个ChatWith for Mac的功能是否完整,然后考虑在保持简洁的基础上,对UI进行一些美化

2、第一个问题就是在收藏AI对话消息后,收藏的内容没有同步到备忘录中,解决之后发现备忘录没有默认标题,跟Cursor明确备忘录标题默认用“备忘录+收藏时间”,AI对话列表的标题下方添加最近一次AI回答内容的前20个字作为描述

3、目前AI对话列表中的条目仍无法获取最近一次回答内容的前20字作为描述,并且AI对话和备忘录两个界面的中间栏宽度默认好像是400,有点宽了,其实300就够了,但我希望的是默认300,最大400,先让Cursor去掉了AI对话列表中的描述文字,只留标题和更新时间,这样代码和界面就更简洁了

4、多次修改宽度限定和调节/保存机制未果,决定先简化需求,固定宽度为300,不允许调整,然后将“备忘录”改为“收藏”,不再需要编辑和预览的切换,始终显示预览状态就行,再在标题右侧添加一个“复制”按钮,点击可以复制收藏内容到剪贴板。Cursor修改了导航菜单,修改了NotesListView中的标题和文本,添加了复制到剪贴板的功能,移除NoteEditView的编辑功能、自动保存功能、编辑视图等等,至此已经将NoteWith基本修改成了ChatWith

5、然后再次更加了AI对话列表中标题下方显示描述文字的功能,这样对话和收藏两个列表页的样式就保持一致了,然后扫了一遍目前应用中存在的“AI对话”和“备忘录”,统一改成“对话”和“收藏”,涉及的文件包括负责搜索功能的SearchWindowView、负责回收站功能的RecycleBinView、设置页面SettingsDetailView、AI对话视图AIChatView、备忘录视图模型NotesViewModel

6、让Cursor去掉了我现在暂时还不需要的导入数据和导出数据功能,以后如果需要,并且想好了要怎么用这两个功能时,再添加

7、突发奇想,想看看目前这个应用的界面有没有什么可以优化的地方,直接问Cursor:结合近年来macOS端应用的趋势,你觉得现在这个应用的界面有没有可以优化的地方?Cursor给列举了非常多趋势和建议,高优先级优化包括侧边栏现代化、列表项卡片化、颜色系统优化,中优先级优化包括间距和布局、交互反馈、搜索体验,以及几项我看起来没啥用的低优先级优化,决定明天先让Cursor进行调整间距和圆角、使用系统颜色、添加悬停效果、优化图标使用等优化

DevLog:2025年9月17日

1、昨天已经基本实现了模型添加、AI对话的基础功能,今天继续完善,首先是添加多个模型并在对话时切换模型,首先在添加两个模型之后,发现设置-可用模型的模型列表里,两个模型之间有两条分割线,而且创建新模型时,无法保存我填写的新API密钥和基础URL,而是沿用了我添加的第一个模型的API密钥和基础URL

2、首先更新了AIModel结构体,添加了apiKey和baseURL字段,移除了isDefault字段,修复了ModelEditView的保存逻辑,更新了模型测试逻辑和对话配置逻辑,使用模型自己的API配置进行对话,而不是使用全局的API配置(早就应该这样了),然后移除了modelRow函数中的Divider():,去掉了多余的分割线,再次测试,两个问题成功解决

3、但AI对话窗口里又出现了回答在上、问题在下的情况,另外切换模型的弹窗显示也有问题,先修复切换模型的弹窗的显示效果,同时修复一下AI对话列表的选中状态,目前根本看不出来选中了哪个对话,修改后仍然不能在对话列表中标示出当前选中的对话,还需要再修改

4、先用硅基流动的DeepSeek R1 API测试了一个需要联网获取最新信息的问题,发现目前思考过程没有展示、AI回答内容没有经Markdown渲染、看不到Tavily提供的资料链接,决定让Cursor同时修复这些问题,并明确要求使用MarkdownUI来进行Markdown渲染,其实之前已经有了一部分支持这些功能的代码,但功能不完整,Cursor列出了Todo,一步步修改,稍后一并给Cursor反馈问题

5、Cursor一次修改了思考过程展示/折叠和展开、Markdown渲染、Tavily资料链接显示等功能,其中在Markdown渲染上,先创建了一个新的文件MarkdownView,但没有添加到项目里,提示构建失败,于是又重新启用现有的MarkdownRenderer,并且引入了MarkdownUI,同时还保留了自定义AttributedString实现作为备选方案,原因貌似是MarkdownUI只支持14.0以上的macOS,我觉得没有必要保留备选方案,之前修改NoteWith时已经验证了MarkdownUI的渲染效果,于是要求Cursor去掉了自定义实现相关代码,使用MarkdownUI作为唯一的渲染方案,MarkdownRenderer代码更加简洁了

6、接下来测试一下思考过程、Markdown渲染、Tavily链接的显示效果,先把AI对话内容的显示顺序搞定,然后处理了一下点击AI对话右上角无法切换模型的问题(原因是ChatView的模型选择回调中代码被注释掉了,没有实际实现模型切换功能,而且每个对话都显示第一个可用模型,而不是用户选择的模型,模型切换没有保存到对话中,我需要为每个对话独立保存选择的模型),Cursor自称目前已经实现如下目标:新对话默认使用第一个可用模型、点击右上角的模型名称选择其它模型、选择的模型立即保存到该对话中、每个对话都有自己独立的模型选择、重启应用后每个对话仍然使用之前选择的模型

7、模型可以正常切换了,但试了几个问题,发现无法触发应用通过Tavily获取最新信息,Cursor分析发现虽然Tavily密钥已经存储在模型中,但实际的消息发送逻辑中没有使用Tavily服务,需要实现Tavily集成,创建了一个新的Tavily服务类TavilyService,并修改了OpenAIService,表示当提问时应用会自动通过Tavily获取最新信息

8、测试发现即使是不支持深度思考的模型,回答内容里也会出现思考过程区域,而且回答内容没有经过Markdown渲染,也看不到Tavily的资料链接,在用MarkdownUI来实现Markdown渲染效果的过程中,Cursor多次创建和删除Package文件(因为一直没有真正引入MarkdownUI),多次用命令行修改MarkdownRenderer,多次尝试不使用MarkdownUI,而是换用SwiftUI的原生功能来实现基本的Markdown渲染,不知道为啥今天反复出现这种“退步”的操作,我多次打断,反复强调要用MarkdownUI来渲染

9、已经有部分文字可以呈现渲染后的效果,但表格还是无法正常显示,参考NoteWith,可能要对表格和代码块的显示进行单独的优化,猜测上面重复同样的操作可能是因为这个对话的上下文太长了导致的,后面在Cursor里开一个新对话再修改这些内容

10、又遇到了刚刚进行的问答没有被保存到对话里的问题,在修改ChatWith,将用户消息和AI消息更新后都调用onUpdate将其保存到Core Data后,问题解决

11、在修改MarkdownRenderer以支持对表格和代码块的渲染优化时,Cursor反复检查MarkdownUI的版本、添加MarkdownUI默认的表格和代码块渲染样式、添加自定义的表格和代码块渲染样式,然后删除这些内容,多次操作后相当于没有做任何的修改

12、决定试试让Cursor创建单独的文件来处理表格和代码块的渲染,并且使用MarkdownUI,Cursor创建了TableRenderer和CodeBlockRenderer,并将新文件添加到项目,但多次尝试后,即使已经将这两个新文件集成到AssistantMessageView之后,仍然未能实现对表格的正常渲染

13、由于目前的ChatWith是由iOS应用修改而来,且在修改过程中对代码和架构进行了大量的调整,怀疑目前有部分文件功能是重复的,让Cursor列举结构和分工后发现ChatWrapper是多余的、ChatView过于庞大、且组件职责不清晰,比如ChatMessageListSection和ChatMessageListView功能重复、ChatInputSection和ChatInputView功能重复,Cursor建议简化架构、删除冗余文件、重新组织文件结构,决定让Cursor实施这些优化

14、修改完成后架构更清晰(每个文件职责单一,易于维护,减少了不必要的中间层),代码更简洁(ChatView从436行减少到约280行,移除了重复的组件子定义),维护性更好(组件独立,便于单独测试和修改,文件结构更符合SwiftUI最佳实践),当然每次Cursor在修改完后都会这么说,还是要实际测试一下修改成果

15、继续测试具体的功能,首先发现在与支持深度思考的DeepSeek R1模型对话时,思考内容和回答内容混在了一起,未能像之前规划的那样分成两块,并且思考内容要可以折叠,可以展开,Cursor在分析后修改了OpenAIService中的seperateThinkAndAnswer函数,以正确解析思考内容,但仍然没有解决问题

16、我现在觉得可能将iOS版的ChatWith修改成Mac版,再逐个测试、恢复功能,可能是做了大量的重复工作,既然之前NoteWith for Mac已经基本可用了,那其实可以对它进行简化,实现我对ChatWith for Mac的一系列需求,于是复制了一份NoteWith for Mac的源文件,并要求Cursor将应用的名字改成ChatWith,这一过程包括将应用名称由NoteWith改为ChatWith、更新XCode项目文件中的名称引用、更新Swift文件中的名称引用、更新Info.plist文件、重命名相关文件夹和文件等

17、Cursor很快完成了修改,并且按照我的反馈替换掉了一些漏网之鱼,接下来就是去掉待办事项模块、测试功能了,后面可能还要把备忘录替换为收藏,去掉待办事项模块及相关功能包括了分析待办事项模块的组件和依赖、移除待办事项相关的数据模型、移除待办事项相关的视图、移除待办事项相关的视图模型、从DataManager中移除待办事项相关代码、从导航中移除待办事项相关项目、从项目文件中移除待办事项相关文件等步骤,并且根据我的反馈删掉了两处遗留的待办事项相关功能

18、构建成功后,整理了文件结构,特别是Views文件夹下既有AIChat和Notes两个文件夹来存放AI对话和备忘录相关的视图文件,又有大量视图文件散落在Views文件夹下,ViewModels文件夹也有类似问题,移动文件并更新project.pbxproj中的路径后,问题解决,结构清晰了一些