Update nexus wiki content

This commit is contained in:
2026-05-03 05:42:06 +08:00
parent 90f3811b83
commit 111bc65b7b
707 changed files with 32306 additions and 7289 deletions

View File

@@ -0,0 +1,52 @@
---
title: "ThreeTierExplanation"
type: concept
tags: []
last_updated: 2026-05-02
---
## Definition
Three-Tier Explanation三层解释法是代码库分析和 onboarding 输出的一种分层叙事结构,从极高层次到极深层次渐进展开,帮助不同需求的受众快速获取所需信息。
## Three Tiers
### Tier 1: One-Line Summary一句话概述
- **Purpose**: 快速建立代码库是什么的基线认知
- **Length**: 1 句话
- **Audience**: 需要快速判断是否关注此代码库的人
### Tier 2: Five-Minute Explanation五分钟高层解释
- **Purpose**: 构建完整的系统工作方式高层理解
- **Content**:
- Primary tasks: 代码做什么
- Primary inputs: 主输入HTTP请求、CLI参数、消息、文件、函数参数
- Primary outputs: 主输出响应、数据库写入、文件、事件、渲染UI
- Key files: 关键文件及其职责
- Main code paths: 主代码路径(入口 → 编排 → 核心逻辑 → 输出)
- **Audience**: 需要了解系统如何运作的开发者
### Tier 3: Deep Dive深度代码流分析
- **Purpose**: 支撑精确的技术决策和问题定位
- **Content**:
- Type: 系统类型web app/API/monorepo/CLI/library/hybrid
- Primary runtimes: 主运行时环境
- Entry points: 所有入口点及重要性说明
- Top-level structure: 顶层结构表
- Key boundaries: 关键边界(展示层/应用层/持久层/跨领域)
- Responsibilities by file: 文件级职责映射
- Detailed code flows: 详细代码流步骤
- Files inspected: 已检查文件清单
- **Audience**: 需要进行具体实现或调试的开发者
## Usage Context
- [[CodebaseOnboarding]] 的核心输出格式
- [[ExecutionTracing]] 的结果呈现
- 新代码库探索的标准化报告结构
## Related Concepts
- [[CodebaseOnboarding]] — 代码库 onboarding 方法论
- [[ExecutionTracing]] — 执行路径追踪
- [[MentalModel]] — 心智模型构建