31 lines
2.9 KiB
Markdown
31 lines
2.9 KiB
Markdown
# 原始代码映射：UI 与扩展设计
|
||
|
||
> 交叉引用：详见《UI 与扩展设计》总览文档中的模块分层、命名约定与扩展边界说明。
|
||
|
||
## .NET 类型 → 原始 TypeScript 源文件映射
|
||
|
||
| .NET 类型/模块 | 原始 TypeScript 源文件 | 对应关系说明 |
|
||
|---|---|---|
|
||
| TerminalApp | `../../../src/screens/REPL.tsx` + `../../../src/components/` | 对应终端主入口与交互循环；UI 逻辑主要集中在 REPL 屏幕，配套的 Ink/React 组件负责局部渲染与交互。 |
|
||
| REPLScreen | `../../../src/screens/REPL.tsx` | 直接对应 REPL 主屏幕实现，是终端 UI 的核心承载层。 |
|
||
| PermissionDialog | `../../../src/components/` | 对应权限确认类对话框组件，属于终端 UI 中的交互式弹窗/提示层。 |
|
||
| CompanionSpriteView | `../../../src/components/` | 对应陪伴角色/装饰性展示组件，通常作为界面中的独立视图单元实现。 |
|
||
| ISkillLoader | `../../../src/skills/` | 对应技能加载抽象接口，用于定义技能发现、解析与装载能力。 |
|
||
| SkillDefinition | `../../../src/skills/` | 对应技能定义模型，承载技能元数据、入口与执行相关描述。 |
|
||
| SkillHooks | `../../../src/skills/` | 对应技能生命周期钩子集合，用于扩展技能执行流程。 |
|
||
| SkillLoader | `../../../src/skills/` | 对应技能加载器实现，负责读取并实例化技能配置。 |
|
||
| IPluginManager | `../../../src/plugins/` | 对应插件管理抽象接口，定义插件注册、启用与调度能力。 |
|
||
| PluginLoadContext | `../../../src/plugins/` | 对应插件加载上下文，封装插件初始化与运行时依赖。 |
|
||
| PluginManager | `../../../src/plugins/` | 对应插件管理器实现，负责插件生命周期管理。 |
|
||
| LoadedPlugin | `../../../src/plugins/` | 对应已加载插件实例模型，表示运行时插件对象。 |
|
||
| PluginManifest | `../../../src/plugins/` | 对应插件清单/描述文件模型，保存插件名称、版本、入口等信息。 |
|
||
| FeatureFlags | `scripts/build.ts` 的 `feature()` + 运行时 GrowthBook | 对应构建期特性开关与运行时实验能力的统一抽象。 |
|
||
| IFeatureFlagService | `scripts/build.ts` 的 `feature()` + 运行时 GrowthBook | 对应特性开关服务接口，既覆盖编译期注入，也覆盖运行时读取。 |
|
||
| FeatureFlagService | `scripts/build.ts` 的 `feature()` + 运行时 GrowthBook | 对应特性开关服务实现，负责聚合构建时与运行时的开关结果。 |
|
||
|
||
## .NET 命名约定说明
|
||
|
||
- `.NET 类型/模块` 列优先使用 C# 语义化命名，表示面向对象层的抽象、服务或模型。
|
||
- `原始 TypeScript 源文件` 列仅记录最接近的源代码位置；当实现分散时，用 `+` 标明多个来源。
|
||
- `对应关系说明` 以职责映射为准，不强求 1:1 文件对应，便于后续从 TypeScript 迁移到 .NET 结构时保持概念一致。
|