分类： 开发

DevLog：2025年11月4日

1、继续试用ChatWith，发现目前的应用在使用支持深度思考的模型时，思考内容好像限制了显示高度，一旦达到高度限制，就不会随着思考的内容继续自动滚动，Cursor表示思考内容的显示高度的确固定在了400点，且超出之后会出现滚动条，但超过400点后就不会再自动滚动，在修改过程中发现了另一个问题，好像在对话中切换了另一个模型，再提出新问题时应用就会卡死

2、Cursor分析了可能导致应用卡死的几个问题：Core Data并发冲突、通知监听器生命周期、状态读取时序、缺少状态同步，特别是Core Data并发冲突，由于直接在主线程修改Core Data managedobject，如果此时用户立即发送消息，可能造成并发访问冲突，updateAISession可能触发Core Data save操作，与其他操作冲突，明天继续修改这个问题

3、添加其他模型来测试Base URL的填写方法，之前已经要求Cursor将其改为用户手动填写AI服务的跟地址，应用会自动补全路径，比如api.openai.com、openrouter.ai/api，然后针对火山引擎的“应用”（bots）做了特别优化，需要填写完整地址https://ark.cn-beijing.volces.com/api/v3/bots/，测试发现百度云千帆的Base URL填写仍然有问题，比如我填写官网提供的https://qianfan.baidubce.com/v2/chat/completions就会连接失败，删掉v2往后的内容也不行，只填写https://qianfan.baidubce.com也不行，与其设定各种复杂的自动补全规则，倒不如直接要求用户填写完整的Base URL，或者应用内置一些常用的Base URL来的简单

附上常用的几个AI的Base URL：

OpenAI

https://api.openai.com/v1/chat/completions

DeepSeek

https://api.deepseek.com/v1/chat/completions

OpenRouter

https://openrouter.ai/api/v1/chat/completions

硅基流动

https://api.siliconflow.cn/v1/chat/completions

火山方舟

https://ark.cn-beijing.volces.com/api/v3/chat/completions

或

https://ark.cn-beijing.volces.com/api/v3/bots/chat/completions

百度云千帆

https://qianfan.baidubce.com/v2/chat/completions

阿里云百炼

https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions

4、询问Cursor目前应用在Base URL补全方面的规则是怎样的，根据回答内容，规则包括：

1.如果没有http://或https://，就自动添加https://

2.如果URL末尾有斜杠，就自动移除

3.如果已经包含完整路径，就不做任何修改

4.如果包含部分路径，就自动补全，比如补全v1，补全/chat/completions

5.如果只有基础URL，就自动补全/v1/chat/completions

按照这套规则，我填写了完整的百度云千帆的Base URL，应该能正常使用才对，但填写完整地址之后测试仍然提示404

5、问题可能出现在自动补全v1上，也就是在“包含/chat/completions但不包含v1时，会自动添加v1前缀，包含/api/、/bots/、/v3/、/v2/，且不含/chat/时，则添加chat/completions”这里，根据Cursor给出的示例，可能会出现/v1出现在/chat/completions之后的情况

6、目前的规则的确有些复杂，可能用户在填写过程中也会不知道该填写完整的地址还是部分地址，倒不如直接在应用里内置几个常用的、完整的Base URL，由用户自行选择，要求：目前的规则有些复杂，我希望能在添加和编辑AI模型界面，预置几个常用的API平台的完整Base URL，用户只需要填写备注、模型名称、选择模型提供商、填写API Key、填写Tavily API Key即可使用模型

7、Cursor在修改过程中创建了APIProvider枚举，包含10个常用平台（OpenAI、DeepSeek、Anthropic Claude、OpenRouter、Google Gemini、智谱GLM、月之暗面Kimi、百度文心一言、阿里通义千问、腾讯混元、自定义），这样就不再需要配置路径补全规则，用起来也更方便了，先添加几个模型试试，再决定要不要增加或删减APIProvider

8、在修正因为使用中文引号导致构建失败的错误之后，百度云千帆和火山方舟的API都可成功连接，当API提供商选择自定义时，需在“高级设置”的Base URL中填写完整地址，即带有/chat/completions的地址

9、APIProvider需要增加硅基流动、火山方舟、百度云千帆、阿里云百炼，这四个都放在“自定义”前面，另外我发现在选择某个APIProvider之后，模型名称部分也会出现预置的模型名称，但我不需要，改成由用户手动填写模型名称，修改之后测试了几个不同的模型，都可以成功连接了

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进行调整间距和圆角、使用系统颜色、添加悬停效果、优化图标使用等优化