标签： 火山方舟

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

1、今天还是修正BUG的一天，先处理昨天的遗留问题：1.AI回答内容里的“.”都显示成了“。”，网址和代码都受此影响；2.思考内容虽然支持流式输出，但始终只能看到两行，看不到全部思考内容；3.提出问题后，只有主动滑动一下才能看到底部的“AI正在思考中”的提示
2、开启了一个新对话，先修正英文句号都被替换成中文句号的问题，Cursor添加了一些调试信息来帮助定位问题，在开启新对话并测试的过程中发现这个问题竟然已经被解决了，我一直在看之前存在错误的对话内容，竟然没有变成正常的渲染结果？先保留调试信息，便于以后再测试其它
3、接下来修正第二个问题，在和支持深度思考的模型对话时，思考内容虽然支持流式输出，但始终只能看到两行，看不到全部思考内容，在修正这个问题之后，我添加了火山方舟的bot，填写了完整的Base URL（https://ark.cn-beijing.volces.com/api/v3/bots/），但对话时收到404错误信息，看来是之前的URL处理逻辑存在问题，Cursor修改了判断逻辑，如果是完整路径就直接使用，如果只有部分路径就自动添加前缀，如果包含api、bots、v3、v2，就直接使用，不添加额外路径，如果是基础路径就自动补全，再多次测试后发现火山方舟的bot路径依然需要应用自动补全后面的/chat/completions，这下常用的模型路径基本都OK了
4、接下来是昨天遗留的第三个问题：提出问题后，只有主动滑动一下才能看到底部的“AI正在思考中”的提示，Cursor改进滚动目标判断、优化滚动时机、增强加载状态处理、改进滚动锚点之后，在发送消息后界面即可自动滚动到底部，显示“AI正在思考中”的提示，搞定
5、继续，这次设置一下打开新对话时的默认模型，直接用模型列表里的第一个模型，“选择AI模型”界面，去掉右上方的“管理模型”按钮，在未打开任何AI对话时，界面右上角不显示“选择模型”
6、接下来修改一下AI对话列表和备忘录列表，两个列表中的条目点击区域都需要加大，整个横条都可以点击；两个列表都需要增加右键菜单，AI对话列表的右键菜单包含置顶/取消置顶（底色有所区别，带pin.fill图标）、修改（弹出对话框修改标题）、删除，备忘录列表的右键菜单包含置顶/取消置顶（置顶后底色有所区别，带pin.fill图标）、删除，Cursor在修改过程中先实现了AI列表页的邮件菜单，但备忘录列表页不支持，提示Cursor对比两个列表的右键菜单实现方式，并去掉了多余的NoteRowView定义，到这里右键菜单和点击区域都搞定了
7、发现刚刚删除的AI对话内容没有出现在设置-回收站里，让Cursor修复回收站相关功能，需求是：目前设置中已有回收站管理入口，但我删除的内容没有出现在回收站里，需要修复一下回收站功能，将回收站分为备忘录回收站和AI对话回收站两部分，可分别管理被删除的备忘录和AI对话，可清空回收站、永久删除、还原到对应的列表中
8、修改过程中虽然Cursor添加了多处调试信息，但测试时我点击设置-回收站，都没有出现调试信息，后来发现其实有两处回收站管理入口，一处是设置-回收站，一处是设置-快速操作-管理回收站，上一步Cursor添加的回收站管理功能都对应第二个入口，但我需要的是第一个入口，于是让Cursor进行了修改，Cursor同时去掉了原有的RecycleBinManagementView（简单界面且功能不完整）
9、Cursor在修改过程中机械地将RecycleBinView嵌入到了SettingsView里，就像把一个弹窗直接放进了界面里一样，不仅丑而且还有单独的标题和关闭按钮，于是让Cursor对回收站界面稍作优化，这次移除了冗余的标题栏，优化了标签页设计，改进了空状态提示，并且优化了列表项设计，风格与应用整体保持统一
10、其它功能规划：1.给AI模型添加界面增加一个测试按钮，添加新模型时先试一下能不能正常响应 2.可以选择AI对话内容中的部分文字并进行复制等操作 3.设置界面已经有数据管理功能，就不需要“设置概览”这个界面了 4.在设置中增加导入/导出功能，支持将外部内容导入到备忘录，支持将备忘录导出成txt或md，当然这些都是小改动，后面还想把Todo功能加进来，让应用功能更丰富一些
11、之前iOS版的DoitWith已经具备了一些核心功能，我询问Cursor能否将这一应用的功能整合进来，并且复用已有的文件和代码，Cursor回复可以，需要提供核心视图文件、数据名、关键功能和其它特殊需求，但由于DoitWith使用的是UserDefaults而非Core Data，Curs建议迁移到Core Data，与备忘录和AI对话使用统一的数据层，并给出了“基础功能整合（创建Todo数据类型、实现基本的GRUD操作、添加导航入口）-功能完善（添加优先级、分类、截止日期、实现搜索和筛选、添加回收站支持）-高级功能（AI助手集成、提醒功能、数据导入导出）”的分阶段实施步骤
12、虽然Cursor觉得可以这样操作，但我还是决定重新创建Todo功能，后续再详细规划需求，分布执行，这样应用就变成了NoteWith-Note/Chat/Doit, all in One