「会话攒到几百个以后,一打开应用就堆内存耗尽,肯定是列表把全部历史都加载了。」 这个推断看似合理,但讨论中的调查者随后明确纠正了这一点:普通会话卡片列表并不通向完整日志的冷读取。
排查时,常见的误判主要有六类:
- 把堆分配失败当成某个组件泄漏的直接证据;
- 看到崩溃发生在启动附近,就断定是列表读了全量日志;
- 把投影缓存和全文搜索索引当成同一份数据;
- 以为串行读取就等于内存有界;
- 把配置里的
:memory:当成崩溃原因的证明; - 把讨论里的工程建议当成已发布的修复。
先记住这一点:卡片、可搜索历史、完整加载的会话是三种不同产物,需要的原始数据完全不同。 站内基础版可参考启动时会话投影导致堆内存耗尽怎么查。
一、先分清三个产物
这三类数据常被笼统地称为「会话数据」,但它们的读取路径完全不同。
投影缓存:为视图准备的派生值
会话投影参考描述的是把事件折叠为完整当前值的注册表,以及可选的持久缓存。
其中有两点值得关注:列表可以依据会话头读取匹配的缓存快照而不读取日志;而这些值可能过期。也就是说,卡片上看到的标题、时间、状态,是可以不碰日志就拿到的。
内容搜索索引:来自事件的另一份产物
调查者指出:搜索文档来自事件,不是来自头信息。
这也说明,「改成只读头信息就能省内存」的想法并不成立——若把搜索协调改为仅读取头信息,内容索引就会为空。用户提出的仅加载头信息方案是建议,不是已证实的修复。
冷日志读取:真正的全量入口
冷快照接口由调用方提供完整日志,并可通过有效缓存行跳过已折叠前缀。
这里需要注意:有有效缓存时能跳过已折叠的部分,但没有记录时会真的读。这是后面内存问题的落点。
一张对照表
| 产物 | 取数来源 | 能否只靠头信息 | 过期的后果 |
|---|---|---|---|
| 卡片投影缓存 | 会话头 + 缓存快照 | 可以 | 列表值可能陈旧 |
| 内容搜索索引 | 事件(搜索文档) | 不可以 | 索引为空或落后 |
| 完整会话加载 | 完整连续日志 | 不可以 | 内容不完整 |
阅读这张表时,可以重点看第二列——它回答的是「这个东西绕不绕得开日志」,而不是「哪个更占内存」。
二、社区报告说了什么,又被纠正了什么
讨论 #10182里,一位用户报告 Windows 桌面宿主反复耗尽 JavaScript 堆并被父进程重启。
报告环境是 @deepseek-ai/dsh-desktop 0.2.1-rc.2、Electron 44.7.0 和 Node 24.21.0,错误原文包含 FATAL ERROR: CALL_AND_RETRY_LAST Allocation failed - JavaScript heap out of memory。用户把现象与积累的会话历史及启动时冷投影联系起来。
调查者的说明
讨论中的后续调查针对该版本进行了追踪,并修正了最初的归因:
- 普通会话卡片列表通过面向头信息的持久化列表和缓存投影取值;
- 调查者没有发现卡片列表通向完整日志冷读取的路径;
- 相关的 SQLite 协调流程由会话内容搜索进入。
因此,排查时更合适的问题是:不是「会话多所以列表读得多」,而是「谁在启动附近发起了内容搜索」。
三个需要谨慎解读的结论
- 这是针对特定版本的调查,不证明所有堆耗尽都有相同原因;
- 错误签名本身不能指出分配来源;
- 同期有症状不等于同根因——讨论里另一位用户补充了
0.2.1-rc.3的类似堆错误,但触发阶段是运行中而非已确认的启动阶段,且没有观察到显式启用的搜索插件,该用户也明确表示不确定是否同根因。
另一条 0.2.1-rc.3 回复附带了堆分析数据(约 900 MB 归于 structuredClone),并称数据与此前分析一致。错误文本相同值得进一步对照,但不能把两次事件合并成同一故障。
三、一次协调为什么会吃掉内存
谁会被读
调查发现,SQLite 协调循环会对非实时、且存储 revision 与索引行不同的会话调用 readColdSessionLog,而这个辅助函数读取完整连续日志。
两条推论很关键:
- 索引没有记录时,许多会话都可能符合条件;
- 已有索引且版本一致时,则可以跳过未变化的会话。
这解释了为什么同一个版本在不同人那里表现差别很大——取决于索引是冷是热。
串行不等于有界
调查描述读取是串行的,但协调事务期间仍保留数据。
因此,串行读取本身不能保证总保留内存有界。 单条读得再小,只要事务里攒着,峰值照样会上去。
一份日志会变成几份
针对调查版本,回复列出了四类表示:完整事件、分离副本、提取的搜索文档,以及用于指纹的序列化表示。
多个表示可能让内存占用远高于压缩日志大小。 但报告没有给出通用倍数或安全历史大小——所以别把「日志 200MB 所以内存最多 200MB」这类换算当真。
冷热的来源在配置里
回复提到,所查的基础和 Web 配置行使用 :memory: 索引及 openAt: never,实验性搜索行使用 openAt: first-search。
这里需要明确一条边界:内存索引随进程重启消失。在所报告场景中,使用该索引启用搜索,可能让每次启动后的首次搜索重新构建冷索引。
不过,这只是所查配置的行为。不要假定这些设置就是自己安装环境的配置——要检查实际 profile 和版本。
四、怎么收集证据:五步
- 记录精确版本与错误原文。 桌面端版本、运行时版本、操作系统、崩溃时间都写下来,并注明崩溃发生在输入之前、首次搜索时,还是其他阶段。
- 找出所选 profile 及搜索相关插件、覆盖项。 检查内容搜索是否启用、索引何时打开、存储是持久的还是内存中的。修改前保留原配置。
- 把实际事件与报告对照。 是否真的发出内容搜索请求?调用栈是否进入 SQLite 协调或冷读取?如果证据指向其他路径,就沿着实际路径调查,不要强套社区解释。
- 测量两个维度。 会话历史总量与最大单条日志要分别记录,同时记下可用内存和索引是冷是热。不要公开会话正文。
- 整理脱敏诊断。 核对已安装版本对应的文档与问题当前状态,只在合适环境复现,并保护备份、准备恢复方案。
为什么两个维度都要
讨论还明确指出:一个特别大的会话和大量较小会话是不同负载形态。
- 只有总历史大小、没有最大日志大小——判断不出瞬时分配更值得查还是批量保留更值得查;
- 只有最大日志大小、不知道要重建多少会话——解释不了整个协调过程。
一个时间线细节
回复还指出:普通搜索框在输入非空内容之后才发出搜索。
因此,如果崩溃发生在输入之前,就应检查已安装组合里是否有其他组件发起了搜索。带时间的请求轨迹,比根据当前界面猜测内存来源更有说服力。
五、讨论里的缓解建议,以及它们的边界
调查者建议为搜索索引使用持久路径并设置 openAt: first-search,让后续启动可以跳过版本未变化的会话。
这是针对所查代码路径的建议,并不保证恢复:首次构建仍可能出现同样的内存峰值。
回复还提出了几条工程方向:
- 按字节或会话数限制一次协调的规模;
- 保存进度,并接受暂时不完整的搜索结果;
- 减少重复的完整日志物化。
这些属于讨论中的工程建议,不代表某个已发布版本已经实现。
改配置之前要确认的四件事
- 对应产品版本和支持流程;
- 关闭或延迟搜索会改变可用功能——功能代价要提前算;
- 持久索引占用磁盘,也可能包含敏感的可搜索内容;
- 不要为了启动就删除会话日志或索引。
还要注意:持久索引建议只有在部署确实使用了所调查的协调行为时才有针对性。 采纳之前应确认保存位置、备份方法、其中包含的内容,以及修改后怎样验证搜索行为。
讨论并未提供适用于所有 profile 的通用复制粘贴配置。
六、限制与安全边界
- 错误签名无法单独确定根因,讨论也不构成通用容量规划指南。
- 不能推断普通卡片列表总会加载全部事件:调查针对的是特定版本,且结论与之相反。
- 不能推断每次首次搜索都必然失败:能否跳过取决于索引是否已经与存储版本一致。
- 不能把某项配置修改当成正式修复:讨论里的是建议,不是发布说明。
- 当前投影文档与特定版本的社区报告描述的是相关但不同的机制,解读时不要互相代入。
- 会话日志、索引、路径和诊断信息可能暴露私人消息及工具结果:保护副本,分享前脱敏,不要编辑正在使用的存储。
- 如果恢复服务需要重启,先与负责人员协调并评估会被中断的工作。
- 排查记录要注明索引状态是推断还是直接证据:配置显示索引在内存中,并不能直接证明崩溃前确实进入了搜索协调,还需要请求记录或调用栈。
- 反过来也一样:调用栈落在其他组件时,即使会话历史很大,也不能只凭体积断言搜索是原因。
- 把已观察事实和待验证假设分开记录,后续升级或配置变更后的比较才有意义。
七、术语速查
- 冷索引:没有相关会话已有索引版本的搜索索引。
- 协调:搜索后端使索引记录与观察到的会话保持一致的过程。
- 投影缓存:为视图保存的派生会话值,与全文搜索索引不同。
- 堆耗尽:JavaScript 进程分配失败,错误本身不能指出分配来源。
- Revision:报告中索引比较使用的已存变更标记。
相关阅读
本文依据 DeepSeek Harness 官方会话投影参考与社区讨论 #10182 整理,由 DSH Plugin 社区(dsh-plugin.com)维护者撰写,首发于阿里云开发者社区。
原文地址:https://dsh-plugin.com/zh/blog/session-projection-startup-memory-exhaustion
插件与文档收录于:https://dsh-plugin.com/zh/blog