月度归档： 2026 年 9 月

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年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年12月24日

1、询问ChatGPT使用Flutter开发的iOS应用，如何打包成用于Mac的版本，ChatGPT指出思路不是把iOS的ipa直接变成Mac版，而是用同一套Flutter代码开启macOS平台支持，然后构建出macOS App（.app），然后再分发，ChatGPT推荐开发一个Flutter macOS桌面端，适配窗口/鼠标/键盘，且同时支持Intel/Apple Silicon两大平台，如果是让iPad App跑在Mac上，仅支持Apple Silicon，且可能会遇到插件/权限的问题

2、若使用ChatGPT推荐的方案，需要开启macOS平台支持，检查插件是否支持macOS，并且需要处理UI/交互的适配，如尽享使用响应式布局，适配鼠标滚轮、右键、hover、快捷键等操作，以及文件选择、拖拽、菜单栏等等

3、以上两点留到后面再修改ChatWith移动端时再看，可以一并询问Cursor能否支持macOS，以及需要做哪些调整

4、今天继续测试修改后的ChatWith for Mac（Swift原生版），上周增加了设置默认模型功能，去掉了自动创建新对话功能，改为提示用户开启新对话，并且新对话直接使用默认模型，还未测试，ChatGPT认为所有网络请求必须在后台线程执行，所有UI更新操作必须在主线程执行，但我没有给它代码，先让Cursor检查下目前是否使用了这种方式

5、Cursor对将AIService.swift进行了两处修改，包括：isLoading和errorMessage的更新现在使用Task { @MainActor in }确保在主线程，stopStreaming()中的isLoading = false现在也在主线程更新，这样整个应用就统一成了网络请求在后台线程执行，UI更新在主线程执行

DevLog：2025年12月19日

1、测试当前版本的ChatWith for Mac，目前已经支持在打开应用后自动开启新对话，并且新对话位于置顶对话下方，之前已经要求应用在开启新对话时默认使用模型列表里的第一个模型，并且在对话过程中也可以点击右上角切换模型，但由于多次遇到切换模型后对话界面卡死的情况（也有可能是在加载历史对话时出现卡死？），决定调整模型切换的逻辑试试

2、首先，在AI模型管理界面，增加“默认模型”设置，按钮放在每个模型的“测试”按钮前面，可以将任何一个模型设置为默认模型，并且在创建新对话时直接使用默认模型，若用户需要使用其他模型，就在AI模型管理界面手动切换默认模型，再去开启新对话，这样也能防止某个对话中积累太多内容

3、另外我还发现现在每次在应用的不同界面间切换时都可能触发“创建新对话”的操作，比如首次启动应用时会创建新对话，看看收藏界面，再回到对话界面，也会创建一个新对话，这样就导致会出现多个空白的新对话，我只需要在首次启动应用时创建新对话，并且如果已经有空的新对话，就不要再自动创建新对话了

4、或者去掉自动创建新对话的机制，但在对话界面增加一个提示，比如请点击开启新对话，与默认模型对话，需要看下这种方式是否和目前的空状态提示有冲突

5、综上，本次修改内容包括：

1.在AI模型管理界面，增加“默认模型”设置，按钮放在每个模型的“测试”按钮前面，可以将任何一个模型设置为默认模型，并且在创建新对话时直接使用默认模型

2.去掉每次打开应用自动创建新对话的机制，在对话界面最右侧栏增加一个提示“请点击右上角开启新对话，若需切换模型，请前往设置中修改默认模型”

6、Cursor的修改内容包括：在DataManager中添加默认模型ID的保存和读取方法（使用UserDefaults）；在AIModelManagementView中添加“默认模型”按钮（放在“测试”按钮前面）；修改AIViewModel的createNewSession方法，使用模型模型而不是第一个模型；修改AIChatView的sendMessage方法，使用默认模型；去掉AIChatSessionListView中的自动创建新对话逻辑；在AIChatView的emptyChatView中添加提示信息，除此之外还增加了一条“更新removeAIConfig方法：删除的模型时默认模型时，清除默认模型设置”

7、测试发现默认模型设置功能已经具备，创建新对话时会直接使用新模型，但对话界面右侧的提示目前有两行，并且内容有重复，于是让Cursor去掉了第一行，只留新添加的一行，并且稍微加大了提示内容的字号

8、本次的修改需求基本达成，发现AI模型管理界面的“数据统计”功能好像没啥用，于是也让Cursor去掉了，至于在使用应用的过程中频繁出现的FSFindFolder failed with error=-43错误提示，Cursor认为这种提示通常出现在CoreData初始化时，系统内部可能使用旧的Carbon API（FSFindFolder）查找Application Support目录，导致出现了-43即“文件未找到”错误，Cursor改成了显式指定Core Data存储位置，使用FileManager的现代API，避免系统使用旧的FSFindFolder API，初步测试暂时未遇到这一错误

9、今天的修改就到这里，接下来测试两天，如果没有什么明显的问题就修改设置-关于页面、刷新README文档，并打包，版本号用v0.3

DevLog：2025年12月17日

1、总结一下当前五个应用的进展和问题：

ChatWith移动端：已使用Flutter重写，仍在测试与补充功能阶段，需要尽快完善功能并打包，通过TestFlight上线测试版

NoteWith移动端：使用原生Swift编写，已经引入MarkdownUI和RichTextKit来解决AI对话内容渲染和备忘录模块的富文本编辑器功能，仍在测试与补充功能阶段

ChatWith Mac端：使用原生Swift，由ChatWith移动端改写（或者是NoteWith移动端改写？记不清了）改写，目前功能基本达成需求，并且已经打包两个版本，主要问题在于在不同对话间切换/在对话中切换模型时偶发应用卡死的问题

NoteWith Mac端：使用原生Swift，和ChatWith类似，由NoteWith移动端改写，仍在测试与补充功能阶段

DoitWith移动版：只有Todo相关的功能，比较简单，仍在测试与补充功能阶段

2、ChatWith移动端的核心功能跟NoteWith移动端其实是基本一致的，ChatWith Mac端和NoteWith Mac端的核心功能也基本一致，重复开发和测试增加了不小的工作量，且目前没有想好要怎样实现NoteWith双端的AI对话和备忘录两个模块间的联动，至于DoitWith，同类型的应用非常多，还没有想到能有什么创新点，先暂时搁置，集中精力推进ChatWith移动端和ChatWith Mac端的开发工作

DevLog：2025年12月15日

1、继续测试深度思考功能是否正常，换不同的问题问一下支持深度思考的模型，以及对话的置顶/修改/删除功能（已有按钮，和之前使用Swift的ChatWith操作方式一致，但按钮的样式变了，可能是安卓原生的按钮？）

2、测试发现未能显示深度思考内容，且即使在问题中增加了“最新”这样的提示词，也未能联网获取最新信息，对话的三个操作按钮中，置顶/取消置顶功能正常，修改标题后在列表中仍然显示原标题，删除后可正常进入回收站，也能从回收站中恢复到对话列表，且在回收站里的对话会显示为修改后的标题

3、除了要修正上面的问题外，还需要补充的功能包括触发联网搜索、显示联网搜索的参考链接、测试模型是否可用，继续对Cursor提出需求如下：

1.只要是与支持深度思考的模型对话，就在对话最上方显示思考内容，默认展开，可在回答结束后折叠

2.只要我在模型设置中填写了Tavily Key，在回答时就调用Tavily的联网搜索能力，并且在回答内容下方显示参考链接，样式需要与回答内容有所区别

3.在添加/编辑模型页底部增加测试按钮，点击测试模型是否可正常使用，如果不能正常使用需要给出错误信息

4.在对话上左滑修改对话标题后，对话列表里仍然显示为原标题，但在回收站里的对话会显示为修改后的标题

5.对话列表里，只能看到最后一个问题，看不到最后一次回答，我需要在每个对话的标题下方显示一行最后一次回答的内容

4、修改完成后测试上述功能，发现：

1.与支持深度思考的模型对话时，仍然未能看到思考内容，又添加了另一个支持深度思考的模型（DeepSeek官方的deepseek-reasoner），也看不到思考内容，但是回答的速度还是挺快的

2.联网搜索功能已实现，点击参考链接不会直接打开，而是可以看到完整链接，并且可以选中、复制，可能改成点击直接跳转至默认浏览器打开链接会比较合适

3.模型测试功能已实现

4.已实现需求，对话列表里可以看到修改后的标题，但不是我最后一次提出的问题

5.创建新的对话，已经可以在列表里看到最后一次回答的内容，可能已经改好了？

5、基于上述测试结果，继续提出修改需求：

1.对于联网搜索的参考链接，我需要点击后直接在默认浏览器中打开

2.在对话列表中，我需要对话的标题默认显示我提出的最后一个问题，如果我修改了标题，则一直显示为修改后的标题

3.AI回答的内容下方，除了收藏按钮之外，还需要增加一个复制按钮，点击可将回答内容（不含参考链接）复制到剪贴板，并且在点击收藏和复制按钮时，要分别有收藏成功、复制成功的toast提示

6、修改过程中，对于上述第一个需求，出现了/Users/jinlei.wu/Documents/GitHub/ChatWith/chatwith_flutter/ios/Runner/GeneratedPluginRegistrant.m:24:9 Module ‘url_launcher_ios’ not found的错误提示，无法构建，Cursor认为这是在添加url_launcher后，iOS项目需要更新CocoaPods依赖，修改之后可以正常构建并在模拟器中运行应用，并且上述三个需求均已实现

7、仍有如下需求未能实现，后面在Cursor中开启新对话时再看能否实现：

对话页、收藏页、设置页三个页面的标题仍然是居中显示（第二次修改无效），看不到支持深度思考的模型的思考内容（第三次修改无效）

8、还需要处理一下目前Xcode中出现的警告信息：/Users/jinlei.wu/.pub-cache/hosted/pub.dev/url_launcher_ios-6.3.6/ios/url_launcher_ios/Sources/url_launcher_ios/URLLauncherPlugin.swift:22:26 ‘keyWindow’ was deprecated in iOS 13.0: Should not be used for applications that support multiple scenes as it returns a key window across all connected scenes，看样子还是刚刚添加的url_launcher导致的问题