Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[Feature] 评估双端日志使用 SQLite 存储与索引检索

オープン
#1,373 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
25/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
sqlite, typescript
領域
backend, databases

調査の方向性

Start by reading the linked PR #1367 and the SQLite references in the issue, then compare the existing file backend with buffered writes and a SQLite prototype on macOS and Windows. Measure the specified write, query, export, cleanup, resource, recovery, and snapshot cases under documented configurations; done means reproducible benchmark results and a documented adopt-or-defer decision with migration scope if SQLite is chosen.

索引モデルが issue の本文から書いたものです。

説明

enhancement issue-form:feature P2 platform:cross-platform review: high
Problem to solve / 要解决的问题

在模块化日志与诊断功能(#1367)的讨论中,提出使用 SQLite 管理日志,并按插件、Git、窗口拆库、定时清理历史记录的建议。

当前 PR 采用按模块、会话分段的文件存储,已有轮转、30 天保留及总量限制,主要服务于近期故障排查和诊断包导出。后续若需要较长时间范围的跨模块检索、分页及统计,应评估 SQLite 是否能改善查询体验并降低维护成本。

本 issue 跟踪后续调研与决策,不预设必须迁移,也不阻塞 #1367。

Proposed solution / 建议方案
  1. 对比当前文件后端、改进缓冲/批量写入后的文件后端,以及 SQLite 原型。在相同事件量、刷新与持久性要求下,测量持续与突发写入、历史筛选、导出和清理的延迟、CPU、内存及磁盘占用;不能以“查表删除比文件追加快”作为迁移依据。
  2. 优先评估由宿主统一接收事件,以模块、scope、插件 ID、窗口 ID、会话 ID、operation ID 等字段组织数据的事件模型。明确数据库与写入队列的进程所有权;只有隔离或实测并发需求成立时才拆库,避免默认每个插件/窗口各建一个库。
  3. 若 SQLite 有明确收益,设计批量事务、索引、并发读取、WAL checkpoint、分批删除及空间回收策略。区分删除记录与实际释放文件空间,并将数据库及 WAL 等辅助文件计入磁盘预算。
  4. 保留现有脱敏、队列背压、诊断有效期、筛选语义、清理范围和冻结预览后导出的行为;明确旧日志兼容、存储故障恢复、目录切换与迁移失败处理方式。
  5. macOS 与 Windows 一起评估并统一事件契约、查询结果、保留规则和用户流程;数据库文件、连接及生命周期由平台 adapter 管理,运行时不得写入发行包或安装目录。

验收要求:

  • 提交两端可复现的基准结果,记录数据规模、索引、批量大小、刷新/持久性配置和环境,并覆盖多窗口及插件并发场景。
  • 给出采用或不采用 SQLite 的结论、适用范围及拆库依据;采用时明确迁移路径,不采用时记录理由。
  • 验证长期运行时磁盘预算、清理期间查询/写入、异常退出恢复和导出快照一致性。
  • 若实施迁移,两端使用共享 fixture 验证查询/保留语义,完成平台运行验证,并更新契约、Agent Note 和功能矩阵。
Target platform / 目标平台

Cross-platform / 跨平台

Area / 模块

Settings / 设置(日志与诊断)

Priority / 优先级

P2 / 后续考虑:目前不着急,可安排到后续版本

Alternatives considered / 已考虑的替代方案
  • 继续使用现有模块化文件后端,优先改善句柄复用、缓冲和批量写入。
  • 保持文件采集,仅在历史检索需求明确后引入可重建查询索引;评估额外存储及一致性成本。
  • 每个插件/窗口独立 SQLite 库:可作为隔离方案比较,但需要证明其收益足以覆盖跨库查询、连接和清理成本。
Additional context / 补充信息

关联 PR:#1367。

SQLite 官方资料:

Checklist / 提交前检查
  • I searched existing issues for duplicates. / 我已搜索现有 Issue,确认没有重复建议。
主要言語
TypeScript
スター
1.8k
フォーク
151
平均マージ
12時間 32分
マージ済み PR(30日)
329

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

1lck/Lithe-IDEA のほかの issue

1lck/Lithe-IDEA の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。