2.9 KiB
2.9 KiB
原始代码映射：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 结构时保持概念一致。