HarmonyOS应用实战-启示散页-79-首页统计别信局部计数：用 SummaryService 从仓储重算

HarmonyOS 应用实战 79：首页统计别信局部计数：用 SummaryService 从仓储重算

首页如果自己维护牌组数、答案数和收藏数，删除或导入后很容易不同步。这个问题不能只靠页面上补一个提示解决，因为真正的断点在libraryHSP/src/main/ets/services/DeckService.ets、状态字段和服务 owner 之间。下面按现有工程事实展开：先看源码，再说明风险链路，最后给出可以落地的补强方式。

这篇解决什么：首页统计

对首页统计来说，这张表先把边界固定住：当前事实来自libraryHSP/src/main/ets/services/DeckService.ets，风险落在统计应该从服务层快照派生，页面只订阅更新时间戳并重新读取。，补强方案只围绕DashboardSummary展开，不把问题扩散成泛泛的 HarmonyOS 状态管理讨论。

现有代码锚点：首页统计 对应 libraryHSP/src/main/ets/services/DeckService.ets

下面这段来自The_Book_of_Answers当前工程，锚点是async list。它不是装饰性引用，而是判断这篇文章能不能落地的依据。

0025}from'@app/common';0026import{hilog}from'@kit.PerformanceAnalysisKit';00270028constDOMAIN:number=0xAB02;0029constTAG:string='DeckService';00300031classDeckServiceImpl{0032/** 列出所有题库摘要（按 updatedAt 倒序，但默认题库永远置顶） */0033asynclist():Promise<DeckSummary[]>{0034constall:Deck[]=awaitDeckRepository.loadAll();0035constsummaries:DeckSummary[]=all.map((d:Deck):DeckSummary=>{0036constsummary:DeckSummary={0037id:d.id,0038name:d.name,0039count:d.answers.length,0040builtIn:d.builtIn,0041colorKey:d.colorKey,

这段代码说明：DeckService.list 会从仓储读取所有牌组，并把每副牌转换为 DeckSummary。 所以后续补强不能绕开这个事实；如果把首页统计直接写成页面局部变量，第一次交互可能看起来没问题，跨页面、重进或发布回归时就会暴露。

失败链路：问题通常不是突然出现

首页如果自己维护牌组数、答案数和收藏数，删除或导入后很容易不同步。

这张断点表是给首页统计做回归时用的。先复现触发点，再检查统计应该从服务层快照派生，页面只订阅更新时间戳并重新读取。是否存在，最后看用户能不能从首页数字不变这种现象里得到下一步动作。

先排除误区：首页统计 不是页面补丁

遇到首页统计，最容易犯的错是先在页面里加一个局部状态，让当前场景看起来正常。这个做法短期能遮住现象，但不会处理首页数字不变这类断点。

functionunsafeHandleArticle79(reason:string):void{if(!reason){return;}promptAction.showToast({message:reason});// 只提示不收口，下一次进入仍可能遇到同一个 首页统计 问题。}

这段反例的目的不是讲语法，而是提醒边界：首页统计的根因要回到统计服务并行读取 DeckService.list 和 FavoriteService.list，再返回不可编辑快照。，页面只能表达反馈，不能替服务层决定数据是否已经可靠。

按照图里的顺序看，真正要拦住的是这一句：统计应该从服务层快照派生，页面只订阅更新时间戳并重新读取。 只要这个点没有收口，用户看到的现象就会在刷新、保存、返回、导入或发布时反复变化。

责任边界：首页统计 不该由谁兜底

DeckService/FavoriteService 提供数据，首页聚合成只读 DashboardSummary。

排查首页统计时先问 owner，再问信号，最后才看样式。像首页数字不变，通常不是单纯的 UI 细节，而是没有订阅更新时间戳没被服务层收住。

状态模型：DashboardSummary

建议把这件事压成一个明确模型。下面代码是建议补强，不表示当前工程已经存在同名接口。

interfaceDashboardSummary{deckCount:number;// 牌组数量customDeckCount:number;// 自建牌组数量answerCount:number;// 全部答案数量favoriteCount:number;// 收藏数量}functioncreateDashboardSummary(input:Partial<DashboardSummary>):DashboardSummary{return{deckCount:typeofinput.deckCount==='number'?input.deckCount:0,customDeckCount:typeofinput.customDeckCount==='number'?input.customDeckCount:0,answerCount:typeofinput.answerCount==='number'?input.answerCount:0,favoriteCount:typeofinput.favoriteCount==='number'?input.favoriteCount:0,};}

DashboardSummary至少要能回答三个问题：输入从哪里来、失败怎么表达、成功之后谁刷新。字段少一点没关系，但不能让页面靠猜来决定首页只展示 summary，不缓存可变计数。。

提交顺序：首页统计 要先有提交点

把状态模型写出来以后，还要约束提交顺序。否则接口名字很好看，实际调用仍可能在页面、服务和仓储之间来回绕。

1. 页面先收集用户动作，只生成DashboardSummary或等价输入。
2. 服务读取必要的当前状态，执行统计服务并行读取 DeckService.list 和 FavoriteService.list，再返回不可编辑快照。。
3. 通过边界后再写仓储、Preferences 或运行时信号。
4. 页面根据结果展示成功、失败、刷新或恢复入口。

asyncfunctionsubmitArticle79(state:DashboardSummary):Promise<void>{constresult:DashboardSummaryResult=awaitcommitDashboardSummary(state);if(!result.ok){DashboardSummaryNotice(result.reason);return;}AppStorage.setOrCreate('article79ChangedAt',result.changedAt);}

这个顺序的价值在失败分支。只要首页统计没通过服务闸门，就不应该提前写入运行时信号，也不应该让页面表现得像已经保存成功。

服务闸门：先判断能不能提交

首页统计的服务层应该先判断边界，再执行写入或刷新。下面的写法把reason返回给页面，是为了让答案数不准能被解释，而不是只弹一个“失败”。

interfaceDashboardSummaryResult{ok:boolean;reason:string;changedAt:number;}functionexplainDashboardSummary(state:DashboardSummary):string{if(state.deckCount<=0){return'deckCount 需要有效时间或计数';}return'';}asyncfunctioncommitDashboardSummary(state:DashboardSummary):Promise<DashboardSummaryResult>{constreason:string=explainDashboardSummary(state);if(reason){return{ok:false,reason,changedAt:Date.now()};}return{ok:true,reason:'ready',changedAt:Date.now()};}

这里的关键是：首页统计不满足边界时不要写仓储，也不要悄悄修改运行时状态。先返回原因，页面再决定展示刷新、重试、回退还是放弃入口。

页面接入：提示可以清楚，规则不要搬到 UI

页面要做的是把用户动作表达清楚。比如首页只展示 summary，不缓存可变计数。，这类信息适合放到 UI；但真正的校验和写入顺序仍然应该在服务层。

@BuilderfunctionDashboardSummaryNotice(reason:string){if(reason){Column({space:8}){Text('首页统计').fontSize(16).fontWeight(FontWeight.Medium)Text(reason).fontSize(13).fontColor(AppColor.danger)}.padding(12).border({width:1,color:AppColor.danger}).borderRadius(AppRadius.md)}}

这种接入方式对首页统计有一个好处：页面可以保持轻量，服务仍然是规则 owner。以后再加列表页、设置页、恢复页或发布回归，也不用围绕DashboardSummary复制判断条件。

结构收口：从源码到验证只走一条线

首页统计的结构图要能互相对应：源码锚点证明当前事实，DashboardSummary描述新增边界，服务规则决定提交方式，验证点证明删除一副自建牌组后，deckCount 和 answerCount 同时减少。没有被吞掉。

验证路径：成功和失败都要跑

Write-Host"查看 首页统计 的源码锚点"rg-n"async\ list|DashboardSummary""D:\ProgramData\huawei\lesson\The_Book_of_Answers\libraryHSP\src\main\ets\services\DeckService.ets"Write-Host"查看相关状态字段"rg-n"deckCount|customDeckCount|answerCount|AppStorageKey|AppPrefKey|StorageLink|updatedAt""D:\ProgramData\huawei\lesson\The_Book_of_Answers"

这些命令只能检查首页统计的源码落点和关键字段，不代表已经完成真机交互。涉及删除一副自建牌组后，deckCount 和 answerCount 同时减少。这种场景时，还需要在 DevEco/设备侧补完整流程验证。

负向回归：首页统计 要故意跑坏一次

只跑成功路径很容易误判。首页统计至少要准备一组负向样本，让服务层证明它会拒绝错误输入，而不是靠页面刚好没有触发问题。

asyncfunctionrunNegativeArticle79(state:DashboardSummary):Promise<string>{constresult:DashboardSummaryResult=awaitcommitDashboardSummary(state);if(result.ok){return'unexpected success';}returnresult.reason;}

这组负向样本能把首页统计从“看起来能用”推进到“失败时也能解释”。写文章时把这部分放出来，读者才能按自己的工程复现。

常见问题：先定位断点

遇到首页统计的异常时不要先改样式。先确认是哪一层没有交接：页面是否保留deckCount，服务是否统一处理规则，仓储或配置是否留下旧值，运行时信号是否发出。

落地顺序：先最小闭环，再补体验

1. 在libraryHSP/src/main/ets/services/DeckService.ets附近确认当前链路，避免改错文件。
2. 增加DashboardSummary或等价状态模型，字段只保留能解释失败的部分。
3. 把首页统计的规则放到服务层，页面只展示原因和下一步动作。
4. 跑成功路径和失败路径，特别是删除一副自建牌组后，deckCount 和 answerCount 同时减少。。

constregressionForArticle79:string[]=['删除一副自建牌组后，deckCount 和 answerCount 同时减少。','收藏变化后，只 favoriteCount 变化。','内置牌组恢复后，统计不出现负数或空 id。'];

收口

首页统计 的处理方法可以压成一句话：DeckService/FavoriteService 提供数据，首页聚合成只读 DashboardSummary。 当前工程已经有可依赖的源码基础，文章里的新增接口和函数属于建议补强；真正落地时，优先保持 owner 清楚，再补页面反馈。