标签： macOS

DevLog：2026年1月15日

1、昨天的遗留问题包括：通过command+N在AI对话和备忘录界面新建对话、新建备忘录，和通过拖拽上传图片/文档，再次测试已支持通过拖拽上传图片/文档，但控制台里依然返回了“图片文件不存在”的调试信息，Cursor优化了错误处理，将“图片文件不存在”的提示改为仅在调试模式下打印，并添加说明，再次构建，功能依然正常，调试信息依然是“图片文件不存在”，先不管了，后面会统一去掉所有的调试信息

2、然后是在AI对话界面用command+N新建对话，在笔记界面用command+N新建笔记这两个功能，目前还不是很稳定，比如在AI对话界面，光标停留在AI对话列表页、详情页、输入框等位置时，有时可以用快捷键新建对话，有时不能，而在笔记界面，只有点开一条笔记的编辑模式后，才能通过command+N新建笔记，我的需求是，只要打开了AI对话界面，不管是未选中任何对话，还是打开了一条对话，或者光标停留在输入框，都可以通过command+N新建对话，只要打开了笔记界面，不管是未选中任何笔记，还是打开了一条笔记，或者切换到了编辑模式，都可以通过command+N新建笔记

3、Cursor为Shortcuts添加了autofocus:true和canRequestFocus:true，据称能确保快捷键始终可用，再次构建测试，依然未能实现需求，决定回退一点，在AI对话界面，只有打开对话并且在输入框聚焦时，才能通过command+N新建对话，并且在设置-快捷键的“新建对话”后面增加“（在输入框聚焦时）”说明文字；在笔记界面，只有打开笔记且在编辑模式时，才能通过command+N新建笔记，并且在设置-快捷键的“新建笔记”后面增加“（在编辑模式时）”说明文字

4、再次构建测试，在修正两个文件中括号不匹配的问题之后，可以正常构建，快捷键功能也可正常使用

5、前两天在询问千问时，它有提到可以通过macOS的textutil实现对word文档的解析，Cursor也认为该方案可行，textutil支持.doc和.docx格式，可将word文档转换为纯文本，支持UTF-8编码输出，并且是macOS系统自带的功能，无需额外依赖，可以使用MethodChannel实现（当前的PDF解析实现方式），优点在于性能、稳定性好、实现简单，但仅限于macOS，无法跨平台，无法提取文档中的图片，无法处理某些复杂的word对象，这些在我看来都可以接受

6、要求Cursor直接使用textutil来实现AI对话过程中对word文档的解析，实现方式与现有的PDF解析一致，同时添加文件大小限制，单个word文档不能超过10MB，Cursor创建了新的文件WordTextExtractor.swift并更新了项目文件，新增功能包括文件大小限制、错误处理、与PDF解析一致的实现方式

7、构建测试，发现已经支持上传并解读word文档，通过附件按钮上传、拖拽上传均可，但目前还不支持将图片、文档粘贴到对话框并解读，询问Cursor能否增加对粘贴图片、文档并解读的支持，效果要和通过附件按钮上传、拖拽到对话窗口的效果一致，在修改过程中，Cursor扩展了Swift端剪贴板处理，更新了Dart端粘贴处理，据称实现的效果包括支持粘贴图片、支持粘贴文档、与拖拽和附件上传效果一致，并且自动去重

8、继续构建测试，已经支持粘贴图片和文档，需要更新一下AI对话界面输入框的提示文字，改为“输入消息…（支持拖拽或粘贴文本/图片/文档）”，这种比较小且非常明确的需求，可以先在代码中搜索找到对应的位置，选中所在行并Add to Chat，修改起来会更快

9、在通过命令行进行构建测试的过程中，多次出现对依赖版本的检查，其中12个包有更新版本可用，1个包已被官方弃用，询问ChatGPT后得知这不是错误，不影响编译或运行，且并不是所有的包都建议升级，升级后也可能会导致新的编译问题，其中的flutter_lints、lints、package_info_plus、pointycastle版本号变化较大，后面可以考虑升级，flutter_markdown官方已经不维护了，建议改用flutter_markdown_plus，等后面更熟悉Flutter了再尝试更新

10、刷新一下README.MD和设置-关于ChatWith界面的“近期更新”内容，版本号不变，接下来打包（flutter build macos –release -v）、测试几天，然后下一个版本重点优化笔记板块的功能和界面

11、记录一下在终端中用指令打包的方法，首先cd+空格，打开项目文件夹，直接拖到终端窗口里，就会自动补全路径，然后回车，然后再输入flutter build macos –release -v，接下来等着它完成就行，正常的话会有BUILD SUCCEED、Building macOS application…(completed in 44.6s)，并用绿色对号和加粗的文字提示路径Built build/macOS/Build/Products/Release/chatwith.app，去项目文件夹下这个路径里找就行了，然后把这个.app文件拖到访达的“应用程序”文件夹里，就可以正常使用了

12、再补充一些基础知识，flutter build macos –release -v只能用于打包使用Flutter开发的macOS应用，使用Xcode原生、Electron/Tauri、.NET/Qt/C++开发的应用有各自的打包指令，但如果要正常分发甚至想上架的话，还都需要经过代码签名、公证等步骤，macOS应用如果不公开分发，有.app文件就够了，只是会面临Gatekeeper的拦截

13、了解一下如果把当前这个使用Flutter开发的macOS应用部署到iOS设备上，可能会涉及哪些调整，根据ChatGPT的回复，这会涉及项目结构与构建目标、UI/交互、生命周期与状态管理差异、文件系统与文档上传能力改造、权限与能力声明、依赖/插件、原生集成与性能、发布与合规等方面，在将目前项目的pubspec.yaml复制给ChatGPT后，它指出目前的大多数依赖本身是支持iOS的，如果要将macOS版本迁移到iOS，可能主要会卡在数据库实现、文件选择/文件访问、iOS权限与plist配置以及少量插件的iOS兼容性细节上

14、从现在的情况来看我好像没有必要再单独去修改使用flutter重构的ChatWith移动版了，因为功能上的需求都是一样的，重复开发也只是徒增工作量，后面可以等ChatWith for Mac功能稳定了，直接让Cursor搞一个功能一致的iOS版

15、在测试的这段时间，也筹划一下其他的应用，目前已有的几个半成品项目中，只有DoitWith的功能与其他几个不同，目前是一款使用Swift开发的待办应用，已经具备了常用的添加/修改/删除待办、完成待办、待办分组、重复提醒、数量统计等功能，但不知道下一步该往哪个方向走，将目前已有的功能清单、核心的代码文件和主界面截图发给ChatGPT后，ChatGPT指出目前我已经把一个标准的To-Do App该有的东西几乎都做完了，现在不是“功能不够”，而是“任务本身是死的”，只是起到了“记录我要做什么”的作用，但市面上几乎所有成熟的To-Do App的竞争点已经是“系统如何帮我更容易把事情做完”，所以我才会遇到“我不知道加什么功能，但又不想和别人一样”的典型问题

16、而且ChatGPT还指出了目前应用的几个问题，比如每条待办都是孤立的，没有前后关系/状态演进/行动提示，目前的分组是静态分组，所有的事都会被同等对待，完成一个任务也没有反馈感，ChatGPT不建议再横向加功能（比如子任务、优先级、项目/文件夹、日历视图），而是给出了三个进化路线：让待办变成过程，而不是清单（增加“下一步”功能）；让DoitWith变成节奏型待办（每天只能标记3个重点任务，超过就要替换）；为macOS/iOS原生体验而生（利用Spotlight、菜单栏快速完成、Live Activity/Widget驱动行动、支持快捷指令等macOS/iOS原生能力）

17、这三个建议中的“最小可执行版本”是给任务加一个字段：nextAction或statusNote，UI上显示在标题下，用户完成的是“这一步”，不是整个任务，这样就会让列表变“活”

18、还得再思考思考具体往哪个方向演进，或许也可以结合我的日常工作来调整，做成一款通用性没有苹果的“提醒事项App”那么强的待办App，比如设置项目、稿件、视觉等标签？增加由哪个员工来写，和哪个客户对接等字段？

DevLog：2026年1月13日

1、今天先解决应用签名和打包分发的问题，我对这个也不太了解，只是知道如果想要正常分发、不被macOS的Gatekeeper安全机制拦截，需要签名，Cursor检测后发现当前应用的签名方式为自动签名，可以在Xcode中打开项目，选择左侧栏的Runner，在中间栏的Signing&Capabilities中勾选Automatically manage signing，并选择Team，登录Apple Developer账号，Xcode就会自动处理签名

2、在这里还需要填写Bundle Identifier，这里默认的是com.example.chatwith，ChatGPT建议这里用反向域名+产品名（全局唯一），并且要和未来在App Store Connect/证书体系里用的一致，格式可以是com.<公司或个人>.<应用名>，且且只能用字母/数字/连字符，通常全小写更稳妥，但不要用Flutter的默认值（中间的公司或个人默认是example）

3、然后就是反复进行Archive并在ChatGPT的帮助下排查问题，比如要Enable Hardened Runtime，在账户设置中Manage Certificates——+Developer ID Application，然后Archieve——Direct Distribution上传到Notary——等待公证结果——Ready for distribution，但在等待公证结果时等了比较长的时间，ChatGPT认为一般1到5分钟，偶尔5到15分钟，极少数高峰期可能需要20到30分钟，即使失败，也能看到具体原因并进行针对性的修复

4、继续等待公证，大概两个小时依然在in progress，运行ChatGPT提供的在终端中用notarytool查看真实状态的指令

xcrun notarytool history –apple-id “<你的AppleID邮箱>” –team-id “<你的TeamID>” –password “<app专用密码>”

xcrun notarytool info <submission-id> –apple-id “<邮箱>” –team-id “<TeamID>” –password “<app专用密码>”

之后，得知并不是UI端卡住，而是确实在in progress，这种情况要么继续等待，要么重新提交一次，我选择继续等待

5、查看Archieve路径下的文件，竟然有600多M，但询问Cursor后得知当前应用打包分发后安装包大小可能在40-60M之间，比Swift版本要大很多的原因在于其中包含了FlutterMacOS.framework，即Flutter框架核心，占用了超过一半的大小，并且当前应用同时支持Intel和Apple Silicon架构，即通用二进制（Universal Binary）

6、跟ChatGPT确认了下即使在等待Notary的过程中也能修改代码，不影响继续开发，但在Xcode中构建时发现，由于之前在Xcode中其中了Hardened Runtime，禁用了JIT，但Flutter的Dart VM需要JIT编译来运行，特别是在Debug模式下，导致构建失败，于是添加了必要的权限，并重新生成了缺失的文件，构建成功，继续测试并增加功能

7、由于过往对话数据已经被清空，打开应用之后可以看到所有界面的空状态提示，其中在“选择AI模型”界面，昨天已经新增了“添加更多模型”卡片，点击可以跳转到设置-AI模型管理界面，我需要在未添加任何模型时，“选择AI模型”界面也显示“添加更多模型”卡片，并且点击可以跳转到设置-AI模型管理界面，不再显示“还没有配置模型，请前往设置中添加”的提示文字

8、修改后的效果是，没有模型时只显示“添加更多模型”卡片，有模型时在模型列表最后显示“添加更多模型”卡片，并且都可以点击跳转到设置-AI模型管理界面

9、然后添加模型，一个支持深度思考的DeepSeek官方的Reasoner，一个不支持深度思考的OpenRouter的Claude 3.7 Sonnet，用于测试后续新增的功能，首先要增加的就是上传和解读文档功能，在现有的上传图片功能上增加：

1.在AI模型管理界面，点击测试按钮时同步测试是否支持文档，测试结果和目前的“支持图片/不支持图片”在同一行显示

2.在选择AI模型界面，根据测试结果，每个模型下方的支持图片/不支持图片后面加上是否支持文档

3.消息框右边的别针图标，鼠标划过时的提示文字由“上传图片”改为“上传图片或文档”

4.点击别针图标，可通过文件选择器选择图片或文档，在支持现有的图片格式的基础上，增加对word、excel、ppt、txt、pdf等常见文档格式的支持

10、修改过程中涉及数据模型、AI模型管理界面、选择AI模型界面和消息框文件选择器，扩展了文件选择器支持格式，包括doc、docx、xls、xlsx、ppt、pptx、txt、pdf，重新在Xcode中构建，经过测试，claude 3.7模型就支持文档，但在对话中选择并上传文档后，浮窗上仍然显示“已选择图片”，并且图标显示也不正常，Xcode中出现了DB Error: 1 “table ai_messages has no column named image_paths”等错误信息，我需要将浮窗中的“已选择图片”改为“已选择附件”，如果附件是图片就显示缩略图，如果附件是文档就显示文档的扩展名，另外我在点击发送消息后，对话窗口中看不到任何内容，即使只是简单的“你好”，也收不到任何回复

11、Cursor在修改过程中，修复了数据库问题，更新了变量名，调整了界面显示并添加了文件图标（根据扩展名返回对应图标），再次测试，普通文字消息可以正常回复，图片可以正常上传、解读，文档可以正常上传，但会回复我“错误：访问被拒绝，请检查API Key权限”，但这个模型在测试时是支持文档的，调试信息中出现了这些内容：flutter: 图片加载失败: /Users/jinlei.wu/Library/Containers/com.jinleiwu.chatwith/Data/Documents/chat_images/1768290385014_文档解读测试.docx, 错误: Exception: Invalid image data，另外，我发送带有附件（图片或文档）的消息之后，消息中包含一行文字“[包含1张图片]”需要改为“[包含1个附件]”

12、本轮修改涉及数据库问题修复、文档处理逻辑（仅支持读取TXT格式的文本内容并添加到消息中，其他格式暂时先提示用户当前版本暂不支持自动提取内容）、消息显示文本更新、消息界面显示和变量名更新，Cursor指出大多数AI API不支持支持上传文档文件，如果需要支持更多文档格式，可以使用文档解析库或支持文件上传的API（如OpenAI的Assistants API）

13、先测试一下TXT格式的附件，再次遇到错误，可能是因为这个TXT的编码不是UTF-8导致的？Cursor再次修改ai_service以支持更多编码，修改后，会首先尝试UTF-8编码，如果失败就读取字节并检测BOM，如果再失败就使用Latin1作为后备，但它也指出对于GBK/GB2312等中文编码，可能会出现乱码，可以添加charset_convert或encoding包来处理GBK编码，先试试同一个附件，再看要不要添加新的包

14、测试后果然遇到了“由于您提供的文档内容是乱码，我无法直接提炼要点。这可能是因为文档编码格式不兼容导致的。”的回答，那既然要添加新的包，就让Cursor同时添加支持word文档、pdf文档和更多编码的txt文档的解析库，一通操作之后只添加了charset_converter包，可以支持多种编码格式，但针对PDF和word文档，由于Flutter生态中缺少合适的免费包，暂时只能等用户上传后提示用户手动输入内容，再次测试TXT文档已经可以正常解读

15、继续修复一些小问题，比如我在收藏消息到笔记时，目前的规则是以用户提问作为标题，以AI回答作为正文，但用户提问中如果包含附件，笔记标题就会有“[包含1个附件]”，我不需要“[包含1个附件]”，只用用户提问的纯文本作为标题就好，Cursor在收藏按钮的onPressed回调中，添加了清理附件标记的逻辑，使用纯文本作为笔记标题，再次测试问题已解决

16、针对PDF文档，Cursor在前边的修改中有建议到使用syncfusion_flutter_pdf（可能需要商业授权）或使用macOS原生的API，询问ChatGPT后了解到macOS有提供PDFKit，可以用于解读非扫描版PDF，如果是扫描版PDF，则需要使用PDFKit+Vision OCR，比较复杂，这次先让Cursor整合macOS的PDFKit，以实现对非扫描版PDF文档的解读功能

17、修改过程包含：创建PDFTextExtractor.swift（使用macOS的PDFKit框架提取PDF文本）、注册方法通道、更新Flutter代码和Xcode项目，修改后，当用户上传PDF文档时，系统会自动调用macOS PDFKit提取文本，如果成功，文本内容会被添加到消息中，如果失败（比如遇到扫描版PDF）会提示用户，测试发现已经可以解读非扫描版PDF，并且速度也挺快

18、结合目前的应用功能刷新一下README.md，其中现有的版本历史部分增加一条“支持文档输入（目前支持TXT和非扫描版PDF）”，放到“支持图片输入（多图片支持）”下面，然后在设置-关于ChatWith里，近期更新内容和README.md的版本历史部分保持一致，但需要分别匹配emoji，再次构建测试，设置-关于ChatWith页面已修改完成，但Archive的Notary依然in progress，服了，另外明天再问问Cursor能否使用macOS的textutil实现对word文档的解析（来自千问的建议）

DevLog：2026年1月6日

1、继续测试使用Flutter重写的ChatWith for Mac，还有很多问题需要修改，先修改这几处：

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

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

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

4.应用最顶部标题栏的chatwith改成ChatWith

2、上述问题1、2、3均已修改，问题4仍未修改，而且还存在如下问题，继续修改

1.顶部居中显示的ChatWith没有用，可以去掉

2.每次打开应用时窗口大小都会回到初始值，没有保存上次打开时对窗口大小的调整，还需要手动调整一下

3.简化一下设置界面，第三列即设置详情的顶部，需要去掉AI模型管理、外观设置、数据统计、回收站这些标题

4.添加和修改模型时，底部的高级设置展开后显示不全，并且有一条多余的分割线，可以去掉

3、继续修改一些界面上的小问题，之后重点测试对话流程，比如切换模型对话、联网搜索功能等等

1、左上角搜索按钮，鼠标划过时不需要显示提示，并且划过时的背景大小要和下面的对话、收藏、设置按钮背景大小一致，在搜索按钮下方增加“搜索”二字，与其他三个按钮样式保持一致

2.去掉对话列表顶部的“新建对话”按钮，去掉收藏列表顶部的“新建收藏”按钮

3.About chatwith界面的应用名是哪里规定的？可否改成ChatWith？

4.每条AI回答内容的底部除现有的收藏、复制按钮外，增加一个删除按钮

4、Cursor修改之后，上面2、3、4都已经OK，但是1鼠标在划过时显示成了方形的背景，而非划过对话、收藏、设置按钮时的圆角矩形按钮，继续修改，并且给最左侧导航栏顶部添加了8像素的间距，不再紧贴顶部

5、收藏界面打开一条收藏后，列表顶部的分割线和收藏详情顶部的分割线没有对齐，让Cursor把收藏详情顶部的“编辑”和“复制”按钮改成和对话详情顶部的“新建对话”按钮一致的样式，虽然仍然没有完全对齐，但相比之前已经美观很多了

6、继续修改对话和收藏页，首次打开应用时对话界面虽然有空状态提示，但没有新建对话按钮，还需要把刚才删掉的对话列表顶部的“新建对话”按钮加回来，同时右侧详情页顶部的模型切换按钮、新建对话按钮，即使未打开任何对话，也要一直显示；针对收藏页，收藏列表顶部的“新建收藏”按钮也加回来，如果没有打开任何一条收藏，右侧详情页顶部就只显示一个“新建收藏”按钮，如果打开了任何一条收藏，右侧详情页顶部就显示“编辑”和“复制”按钮，这样修改之后对话和收藏页面的列表、详情页分割线就对齐了

7、接下来给收藏详情页底部增加一行信息栏，打开一条收藏后，可显示该条收藏的添加时间、修改时间（最后一次修改的时间）、字数统计三个信息；然后在对话详情页，需要给每条消息增加时间信息，显示在消息下方，Cursor先使用了比较复杂的相对时间（近期）+完整日期时间（较早的日期）的方式，今天的时间只显示时分，昨天的时间显示为昨天+时分，一周内的时间显示为几天前，更早的显示为完整日期时间，貌似这也是苹果设备上的应用比较常用的时间显示方式

8、然后把回收站的收藏和对话换个顺序，左边是已删除的对话，右边是已删除的收藏，到此，对于应用界面的首轮修改就差不多了，备份了之前使用Swift写的ChatWith for Mac，然后清理了对应的文件、刷新了README.md文档

9、接下来开始对各项功能进行测试和完善，在对话过程中发现如下问题，先集中修改一波：

1.新建对话时，有时会出现这样的问题：新对话在列表里会显示和上一个对话一样的标题和副标题，再次新建对话才会以“新对话”为标题

2.启用联网搜索功能后，联网搜索结果的显示需要优化，我只需要看到标题-网站名和来源链接，不需要从中摘取的内容，并且这些链接我需要可以点击，点击后直接用默认浏览器打开

3.对话列表的置顶功能有问题，比如我将对话A和B都置顶，再取消对话A的置顶，这时应该只有对话B置顶，但实际使用时却是对话A置顶，对话B被取消了置顶，并且置顶的对话应该有个区别于非置顶对话的底色，可以对比下收藏列表的置顶功能，收藏列表的置顶功能正常

4.对话列表和收藏列表，都应当支持用户修改标题（点击标题后面的三个圆点，菜单里需要有置顶/取消置顶、修改、删除三个功能，在在现在的基础上增加“修改”功能），如果用户修改了标题，就一直用用户修改的标题，如果没有修改，就沿用之前的标题获取逻辑

10、修改后测试，构建失败，问题：The sandbox is not in sync with the Podfile.lock. Run ‘pod install’ or update your CocoaPods installation.原因在于刚刚为了实现参考链接可点击的功能，添加了url_launcher依赖，需要重新安装Pods以包含新的macOS插件（url_launcher_macos），否则就会出现Podfile.lock与实际的Pods目录不同步的问题，修改之后解决

11、再次测试，其他问题基本都已修正，还需要继续进行一些优化：对话列表可能存在刷新机制的问题，对标题进行修改、置顶/取消置顶、新建对话等操作后，列表有时不会立即刷新；联网搜索功能参考的链接需要增加到10个，5个链接可能参考性不足；AI回答内容背景的灰色太深了，需要浅一些

12、再次测试，发现对话列表的刷新机制还是有点问题，比如AI正在回答时，对话列表就会频繁刷新，其实不需要，让Cursor改成了回答结束后刷新对话列表，但发现在联网搜索过程中和回答过程中还是在频繁刷新，于是和Cursor明确：在联网搜索过程中也不要频繁刷新，只有回答结束后、置顶/取消置顶后、修改标题后、创建新对话后 这几种情况下才触发对话列表的刷新操作，再次修改后对话列表仍然会在AI回答过程中频繁刷新，这个问题后面再开一个新对话再修改

13、继续测试应用的功能，接下来是收藏模块，首先收藏的内容比较长时，收藏详情底部会出现“BOTTOM OVERFLOWED BY XXX PIXELS”这种提示，并且无法滚动查看，只有在点击编辑后才能滚动查看，修改过程中将非编辑模式下的MarkdownBody包裹在SingleChildScrollView中，使内容可滚动，问题已解决

14、发现新问题，有些回答内容中就会带一些文字形式的链接，但只显示为蓝色文字，无法打开，我需要让这些链接也像Tavily提供的参考链接那样可以直接点开，在回答内容、收藏内容都是如此，都要点击可以直接点开，为实现这一需求，针对AI回答内容中的链接，Cursor给MarkdownBody添加了onTapLink回调，点击链接时使用url_launcher在默认浏览器中打开，并且添加了链接样式，针对收藏内容中的链接，Cursor导入了url_launcher包，并为MarkdownBody添加了onTapLink回调，实测问题已解决

15、对话和收藏删除之后，回收站里第一条内容和分割线之间没有任何间距，需要稍微增加一点间距（可以用第一条和第二条之间的间距），视觉上更好一些，针对这一问题，Cursor给第一条删除的内容和TabBar分割线之间增加了8像素的间距，与列表项之间的间距一致，视觉上更统一了

16、还有，数据统计界面的收藏、对话、模型三个图标颜色有些突兀，需要改一下，针对这种比较模糊的需求，Cursor将Colors.red、Colors.blue和Colors.purple改成了Colors.pink.shade300、Colors.blue.shade300和Colors.grey.shade300，认为这些颜色比较柔和，与界面更协调，再次构建看效果，的确比之前要好些了

17、AI模型管理界面，每个模型卡片的整体高度需要稍微缩减一下，稍微紧凑一点点，现在每个卡片的高度都比较高，默认窗口大小的情况下只能显示两三个模型，Cursor同步修改了卡片内边距、标题字体大小、垂直间距、文字大小、按钮尺寸等等，显示效果好多了

18、然后调整数据统计界面的卡片间距，之前间距过大，要求统一成8，但视觉上还是很大，可能每个卡片上下各有8的间距？另外还需要增加已删除的对话、已删除的收藏 两个数据统计卡片，图标颜色用灰色，整体顺序用：AI模型数量、对话数量、已删除对话数量、收藏数量、已删除收藏数量，再次构建测试，需求已达成，今天到此结束

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

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

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

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

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