一、拆分对象是真实巨型页面拆分结果仍是规划当前MainFrame同时持有听读播放、TTS、媒体会话、后台任务、地图缩放、人物与事件选择、收藏笔记、主题和多端布局状态文件已超过五千行。大量 Builder 与业务函数共用同一组页面字段修改一个区域时很容易触碰另一个区域的生命周期。这能证明“需要拆”不能证明“已经拆完”。本文规划把听读、地图和人物三个领域移出主框架同时让MainFrame退回到导航、主题和页面组合层。迁移期间必须保持现有行为可回滚尤其不能因为整理代码破坏后台朗读、地图手势或本地数据。当前集中职责目标所有者MainFrame 保留TTS、进度、媒体会话、后台任务AudioFeature选中入口与页面装配年份、阵营、缩放、全屏地图MapFeature导航到地图区域人物选择、标签、关联跳转PeopleFeature跨模块路由协调收藏、笔记、主题Shared / AppShell主题与顶层生命周期二、模块边界按状态所有权划分拆文件不是把 Builder 剪切到三个目录。每个模块必须拥有自己的状态、命令和持久化端口。听读模块拥有播放意图和媒体资源地图模块拥有视口变换人物模块拥有选择与内容投影。跨模块只传稳定 id 和事件不共享对方内部对象。export interface FeatureModuleState, Command, Event { snapshot(): State dispatch(command: Command): Promisevoid subscribe(listener: (state: State) void): () void onEvent(listener: (event: Event) void): () void activate(): Promisevoid deactivate(): Promisevoid } export interface FeatureRoute { feature: audio | map | people targetId?: string source: home | search | related | favorite }激活和停用是显式生命周期。切走人物页只解除 UI 订阅切走听读页时是否继续播放由播放策略决定不能随着组件销毁被动停止。三、听读模块先隔离意图再搬迁平台资源听读是风险最高的模块因为它同时连接 TTS、AVSession、后台任务、定时器和应用生命周期。第一阶段不移动平台对象只提取AudioState、AudioCommand和 reducer让现有方法通过命令更新状态。状态稳定后再把媒体会话与 TTS 放入 runtime adapter。export interface AudioState { selectedId?: string phase: idle | preparing | playing | paused | failed progressSeconds: number durationSeconds: number loopMode: list | single | once backgroundActive: boolean errorCode?: string } export type AudioCommand | { type: select; audioId: string } | { type: play } | { type: pause } | { type: seek; seconds: number } | { type: next } | { type: lifecycle; state: foreground | background } export interface AudioRuntime { prepare(text: string): Promisenumber play(fromSeconds: number): Promisevoid pause(): Promisevoid release(): Promisevoid }迁移阶段允许变化必须保持提取状态与命令调用入口变为 dispatch播放、暂停、进度表现提取 runtime adapter平台对象移出页面AVSession 与后台行为提取页面组件Builder 独立手机和平板布局四、地图模块把视口变换与业务选择分开地图的年份、阵营属于业务选择缩放与偏移属于视口状态。两者混在一起时切换年份可能意外沿用不适合新地图的偏移。地图模块应让业务模型决定可见区域让视口控制器负责夹取比例、手势增量和复位。export interface MapSelection { year: string factionId: string } export interface MapViewport { scale: number offsetX: number offsetY: number fullscreen: boolean } export interface MapController { selectYear(year: string): void selectFaction(factionId: string): void applyPinch(scaleDelta: number, centerX: number, centerY: number): void applyPan(deltaX: number, deltaY: number): void resetViewport(): void snapshot(): { selection: MapSelection; viewport: MapViewport } }年份变化后如果地图资源尺寸或可见阵营集合变化视口回到安全默认值仅打开全屏时保留当前中心点。手势算法通过纯函数测试不依赖完整页面渲染。五、人物模块通过 id 建立跨域链接人物详情会跳到相关人物、事件或阵营。模块间不能互相 import 页面状态而是发布领域事件由 AppShell 解析为路由。人物模块只知道personId事件模块只知道eventId共享目录服务负责名称到 id 的解析和不存在时的降级。export type PeopleEvent | { type: open_person; personId: string } | { type: open_event; eventId: string } | { type: open_faction; factionId: string } | { type: play_person_audio; personId: string } export interface PeopleState { selectedPersonId: string selectedTab: 生平 | 关系 | 评价 textMode: 原文 | 译文 relatedPersonIds: string[] } export interface HistoricalDirectory { personById(id: string): Person | undefined eventById(id: string): HistoryEvent | undefined factionById(id: string): Faction | undefined }找不到关联对象时保持当前页面并显示行内提示不能跳到默认人物制造错觉。播放人物内容通过事件交给听读模块人物模块不持有 TTS 实例。六、AppShell 只做装配和跨模块协调目标MainFrame只保留当前主标签、主题、多端布局、模块装配和事件路由。它不再计算听读进度、不再夹取地图坐标也不直接读写人物收藏。共享的 Preferences 端口由依赖注入传给各 Repository模块之间通过事件总线或显式协调器通信。交互事件来源协调结果人物页点击朗读PeopleEventAudioFeature 选择对应内容地图点击阵营MapEventPeopleFeature 打开阵营人物收藏中打开人物FavoriteEventAppShell 切页并传 personId应用进入后台生命周期AudioFeature 决定继续或暂停这种结构允许手机底部导航和平板侧栏复用同一模块状态只替换页面组合不复制业务逻辑。七、迁移失败必须可以按模块回退一次性改写五千行风险过高。每个模块都通过 feature flag 控制新旧实现状态序列化格式暂时保持兼容。新模块启动失败时回到旧 Builder持久化迁移失败时只读旧数据不覆盖听读 runtime 初始化失败时退回文本阅读地图资源缺失时退回列表视图。迁移期间最危险的是双写。首阶段只让旧实现写、新实现读影子状态比对稳定后切为新实现单写。任何时刻都不能让两个播放器同时占用媒体会话也不能让新旧地图控制器同时处理手势。八、实施顺序和验收门槛顺序建议为先建立共享类型与模块合同再提取人物模块因为平台依赖最少随后提取地图纯状态和手势最后处理听读状态、runtime 与后台生命周期三个模块稳定后再缩减 AppShell并删除旧路径。验收必须比较拆分前后的行为冷启动与主题切换一致人物、事件、阵营互跳不丢目标地图缩放、全屏和年份切换可预测朗读播放、暂停、拖动、后台继续和回前台恢复一致收藏笔记不丢失手机与平板入口一致模块停用后订阅、定时器和平台资源都释放。证据计划包括新旧路径录屏、状态快照对比、媒体会话日志、内存和资源释放检查。没有这些结果前文章保持设计定位。参考HarmonyOS ArkTS MVVM 开发指导。九、总结巨型页面的拆分单位不是视觉区块而是状态所有权和生命周期。听读、地图、人物各自拥有状态与平台端口AppShell 只负责装配和路由才能真正降低修改半径。以可回滚的阶段迁移替代一次性重写也能让后台播放和本地数据这些高风险能力在结构调整中保持可验证。
企业数字化 ERP 产品动态
相关推荐
如何5分钟搞定多平台抢票:智能抢票助手终极指南 如何5分钟搞定多平台抢票:智能抢票助手终极指南 【免费下载链接】damaihelper 支持大麦网,淘票票、缤玩岛等多个平台,演唱会演出抢票脚本 项目地址: https://gitcode.com/gh_mirrors/dam/damaihelper
你是否曾经因为热门演唱会门票秒光… · 2026/9/26 17:41:25
Prompt优化实战:从日志分析到效果提升 1. 项目背景与核心价值在AI交互领域,Prompt(提示词)的质量直接影响着大语言模型的输出效果。过去半年里,我收集了超过3000条实际使用中的Prompt样本,发现一个关键问题:大多数用户编写Prompt时存在明显的模式… · 2026/9/26 18:09:57
5分钟极速安装:Mac Boot Camp驱动自动获取完整指南 5分钟极速安装:Mac Boot Camp驱动自动获取完整指南 【免费下载链接】brigadier Fetch and install Boot Camp ESDs with ease. 项目地址: https://gitcode.com/gh_mirrors/bri/brigadier
还在为Mac安装Windows系统后找不到合适驱动而烦恼吗?Briga… · 2026/9/26 18:08:34
工地太忙根本没时间复习考试?宿州高低压电工证通过率揭秘 工地太忙根本没时间复习考试?宿州高低压电工证通过率揭秘 工地太忙根本没时间复习考试?别急,宿州高低压电工证考试虽然看着门槛高,但如果你掌握了关键信息,通过率其实并不低。尤其是对于一线电工来说,这张证不仅是就业门槛,更是职业发展的跳板。本文从… · 2026/11/19 18:42:01
电工证卡片有效期多久拿证怎么处理 电工证卡片有效期多久拿证怎么处理 证书过期了不知道怎么复审延期,这是很多持证人最头疼的问题。尤其是电工证卡片有效期这个问题,很多人以为只要考了就能一劳永逸,其实不然,很多从业者都因为不了解有效期和复审流程,导致证书过期、工作受限,甚至被单位… · 2026/11/19 18:42:01
电工作业都包含什么怎么考 考前押题帮你稳过实操考试 电工作业都包含什么怎么考 考前押题帮你稳过实操考试 实操考试心里没底怕挂科,这是很多准备考电工证的学员最真实的感受。特别是第一次报考的新人,对流程、题型、操作项目都不熟悉,心里直打鼓。其实, 考前押题… · 2026/11/19 18:42:01
宿州高低压电工证值不值得考?选错机构真的会被坑 宿州高低压电工证值不值得考?选错机构真的会被坑 你是不是也遇到过这种情况:听说要考个【宿州高低压电工证】才能上岗,但不知道该去哪报名,一问就被各种中介忽悠,搞得云里雾里?别急,今天咱们就来聊一聊这个证到底 值不值得考… · 2026/11/19 18:42:01
花都新华报考电工证保姆级教程:实操考试心里没底怕挂科?看完这篇稳过! 花都新华报考电工证保姆级教程:实操考试心里没底怕挂科?看完这篇稳过! 实操考试心里没底怕挂科?你不是一个人。特别是在花都新华地区报考电工证的小伙伴们,很多人第一次接触这类考试,担心自己不会操作、怕出错、怕挂科。其实,只要方法得当、复习到位,… · 2026/11/19 18:42:01
30秒搞懂全国特种工证件查询,别再被中介骗了 30秒搞懂全国特种工证件查询,别再被中介骗了 你是不是也遇到过这种情况?明明想考个全国通用的特种作业证,结果在培训机构跑了七八家,价格参差不齐,证书真假难辨?现在网上一搜“全国特种工证件查询”,信息五花八门,让人真假难辨。别急,今天就从开封… · 2026/11/19 18:41:00
长春初级电工证怎么考?通过率揭秘全在这里 长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/19 16:06:02
国内电工证报考条件与考试时间 低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/19 17:40:37
电工作业时如何断电?电子证书到底能不能全国通用? 电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/19 17:50:07
姑苏区哪里考电工证好考前押题怎么找 姑苏区哪里考电工证好考前押题怎么找 工地太忙根本没时间复习考试,电工证考前还总找不到靠谱的 考前押题 资源,真让人头疼。如果你也是在苏州姑苏区从事建筑或电力行业的,那这些建议你一定要看完。 为什么姑苏区考电工证的人这么多?… · 2026/11/19 0:00:12
罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 罗定能考电工证吗?外省证转过来流程全解析+郑州报考避坑指南 之前考的证在外省能不能转过来?这几乎是每个特种作业证书持有者都会遇到的问题,特别是像你这样已经在外地工作多年,想回老家罗定发展或者重新规划职业路径的人。别急,今天就给你一条清晰的路… · 2026/11/19 0:00:12
罗定能考电工证吗 电工证含金量到底有多少? 罗定能考电工证吗 电工证含金量到底有多少? 之前考的证在外省能不能转过来,这几乎是每个准备考电工证的朋友最先想到的问题。特别是在罗定这样的地方,很多人的电工证都是在外地考的,现在想在当地继续使用,但不知道怎么办。实际上,电工证的 含金量… · 2026/11/19 0:00:12
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:25
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 6:33:32
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案 /* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/19 0:22:38