Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto
  • ¿Algo no está bien?
#1,373 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
5/5
Tiempo estimado
Más de una semana
Aptitud para principiantes
25/100
Tipo de issue
Nueva funcionalidad
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
sqlite, typescript
Área
backend, databases

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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，确认没有重复建议。
Lenguaje dominante
TypeScript
Estrellas
1.8k
Forks
151
Merge medio
12 h 54 min
PR fusionados (30 d)
337

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de 1lck/Lithe-IDEA

Todos los issues de 1lck/Lithe-IDEA

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.