Files

Misaka 883f98065a refactor(logger): optimize logging architecture with 6 improvements

1. Extract shared module: consolidate getLogDir() and isProduction()
   into shared.ts, eliminate duplication across logger modules
2. Make retention config effective: delay file transport creation
   until config is loaded, apply appRetention/auditRetention from config.yaml
3. Add before-quit log flush: close logger and audit logger on
   app exit to prevent log loss
4. Unify logError entry point: remove duplicate logError from index.ts,
   re-export from error-utils.ts with richer error context
5. Renderer log level filtering: add client-side level check in preload
   to skip IPC for filtered-out messages
6. Child logger cache + audit cleanup: cache child loggers in IPC
   handler for performance, remove redundant timestamp format in audit logger

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-04-03 20:53:53 +08:00

data-flow.md

docs: add developer architecture handbook

2026-03-21 20:25:45 +08:00

decision-log.md

docs: add developer architecture handbook

2026-03-21 20:25:45 +08:00

file-map.md

docs: add developer architecture handbook

2026-03-21 20:25:45 +08:00

overview.md

docs: add developer architecture handbook

2026-03-21 20:25:45 +08:00

README.md

refactor(logger): optimize logging architecture with 6 improvements

2026-04-03 20:53:53 +08:00

runtime-architecture.md

docs: add developer architecture handbook

2026-03-21 20:25:45 +08:00

README.md

架构文档索引

本目录收录项目的架构层文档，主要用于帮助开发者建立系统级认知。

如果 modules/ 关注“某个业务模块怎么工作”，guides/ 关注“具体开发时怎么做”，那么 architecture/ 关注的是：

项目整体长什么样
运行时是怎么分层的
关键数据流怎么走
核心文件分布在哪里
过去为什么做出某些架构决策

架构层导航图

graph TD
    Architecture[architecture/]
    Overview[overview.md]
    Runtime[runtime-architecture.md]
    DataFlow[data-flow.md]
    FileMap[file-map.md]
    Decisions[decision-log.md]

    Architecture --> Overview
    Architecture --> Runtime
    Architecture --> DataFlow
    Architecture --> FileMap
    Architecture --> Decisions

文档职责一览

文档	主要回答的问题
`overview.md`	这个项目整体是什么、做什么、核心目录和主链路是什么
`runtime-architecture.md`	`main / preload / renderer` 如何协作
`data-flow.md`	核心业务数据如何在各层之间流动
`file-map.md`	关键文件在哪里、应该先看哪些入口
`decision-log.md`	最近几轮重要重构和架构决策是什么

按问题选择阅读路径

flowchart TD
    Question[当前问题]
    Whole[我想先理解整个项目]
    RuntimeQ[我想知道进程分层和调用边界]
    FlowQ[我想知道数据怎么流]
    FileQ[我想快速定位该看哪些文件]
    HistoryQ[我想知道为什么现在是这个结构]

    Question --> Whole
    Question --> RuntimeQ
    Question --> FlowQ
    Question --> FileQ
    Question --> HistoryQ

    Whole --> OverviewDoc[overview.md]
    RuntimeQ --> RuntimeDoc[runtime-architecture.md]
    FlowQ --> FlowDoc[data-flow.md]
    FileQ --> FileDoc[file-map.md]
    HistoryQ --> DecisionDoc[decision-log.md]

与其他目录的关系

graph LR
    Architecture[architecture/]
    Modules[modules/]
    Guides[guides/]

    Architecture --> Modules
    Modules --> Guides

理解方式：

先通过 architecture/ 建立系统级认知
再进入 modules/ 深入业务模块
最后通过 guides/ 落到开发动作

使用建议

如果准备改动较大的功能，先看架构层文档再下手
如果遇到“代码都看到了，但不知道该从哪里改”，优先看 file-map.md
如果遇到“现在为什么这样设计”，优先看 decision-log.md

后续如果新增新的架构层文档，也建议同步更新这份索引页。

README.md

架构文档索引

推荐阅读顺序

架构层导航图

文档职责一览

按问题选择阅读路径

与其他目录的关系

使用建议