Skip to content

Commit a33e563

Browse files
author
chuck
committed
docs(memory): add SQLite mmap and upstream issue findings to baseline
8.5GB 主 DB 通过 mmap 每进程贡献 134-260MB(IOAccelerator), 关联上游 PR anomalyco#22428、anomalyco#18136 等已知问题。
1 parent 8ec3c90 commit a33e563

1 file changed

Lines changed: 28 additions & 8 deletions

File tree

‎.opencode/memory/project/opencode-memory-footprint-baseline.md‎

Lines changed: 28 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -18,9 +18,10 @@ description: OpenCode 单进程及多进程内存占用归因基线数据。当
1818

1919
| 因素 | 贡献量 | 占比(单进程) | 确信度 |
2020
|------|--------|---------------|--------|
21-
| 二进制/runtime 基线 | 324 MB | 65% | 高 |
22-
| 项目体量 | +18 MB | 4% | 高 |
23-
| session 历史累积 | +157 MB | 31% | 高 |
21+
| 二进制/runtime 基线 | 324 MB | — | 高 |
22+
| **SQLite mmap(8GB 主 DB)** | **134-260 MB** | — | **高** |
23+
| session 历史累积 | +157 MB | — | 高 |
24+
| 项目体量 | +18 MB | — | 高 |
2425
| 多进程重复装载(4 进程 vs 1 进程) | +1750 MB | — | 中 |
2526

2627
## 关键数据点
@@ -36,21 +37,40 @@ description: OpenCode 单进程及多进程内存占用归因基线数据。当
3637
### 内存结构拆分(单进程)
3738

3839
- `__TEXT`(代码段):~422 MB 虚拟 / ~235 MB 驻留,dirty=0,多进程共享同一份物理内存
40+
- `IOAccelerator`(SQLite mmap):每进程 134-260 MB dirty,随 DB 大小增长
3941
- `MALLOC`(Go/native 堆):DefaultMallocZone ALLOCATED 仅 20-23 MB,不是大头
4042
- WebKit malloc:主要膨胀来源,reclaimable 部分高(4 进程合计 ~1.2 GB 可回收但未回收)
4143

44+
### SQLite DB 大小(关键发现)
45+
46+
- 主 DB:`~/.local/share/opencode/opencode.db` = **8.5 GB**
47+
- role DB:stock-analyst 136MB、linghu 198MB
48+
- 4 个 heartbeat 进程都打开同一个 8.5GB 主 DB
49+
- Bun 的 SQLite 默认 mmap 整个 DB,导致 IOAccelerator 区域膨胀
50+
4251
## 可控优化方向
4352

44-
1. **heartbeat 角色定期重启** — 避免长 session 无限膨胀(性价比最高)
45-
2. **超长对话归档/fork** — 限制单 session 历史累积
46-
3. **监控用 footprint 不用 RSS** — 避免被虚高数字误导
53+
1. **SQLite mmap patch**(PR #22428)— 加 `PRAGMA mmap_size = 0`,预计每进程减 134-260 MB
54+
2. **compaction** — 对长 session 主动 compact,减少后续 turn 的历史加载
55+
3. **DB 瘦身** — 归档/清理老 session,VACUUM 压缩
56+
4. **监控用 footprint 不用 RSS** — 避免被虚高数字误导
57+
58+
## 上游已知问题
59+
60+
| Issue | 说明 |
61+
|-------|------|
62+
| #20695 | Memory Megathread,官方集中修 |
63+
| #22429 / PR #22428 | SQLite mmap(OPEN 未合并) |
64+
| #18136 | prompt loop 每步全量加载历史 |
65+
| #22198 | SSE CLOSE_WAIT 泄露 |
4766

4867
## 上游问题(我们改不了)
4968

5069
- 单进程 324 MB runtime floor
5170
- WebKit/Bun/JS heap 保留策略不积极释放
71+
- prompt loop 全量加载历史(#18136)
5272

5373
## 证据
5474

55-
- 原始采样数据:`/tmp/opencode-mem-attrib-20260420/`
56-
- 归因报告:`/tmp/opencode-memory-attribution-report.md`
75+
- 原始采样数据:`.opencode/plans/20260420-memory-footprint-diagnosis/raw-samples/`
76+
- 归因报告:`.opencode/plans/20260420-memory-footprint-diagnosis/report.md`

0 commit comments

Comments
 (0)