SuperAPI AI 工具集

android-report-tables

通用与其它

查看项目

更新于 10-16 08:04

技能介绍

用途:为 Android 报表界面提供强制性的 UI 规则,当报表数据可能超过 25 行时,必须渲染为表格而非卡片列表,以避免滚动疲劳并保持业务数据的可扫读性。适用于报表、分析列表、财务汇总、库存报表、审计日志等可能超过 25 行的数据集;不适用于不超过 25 行的小数据集或卡片更能表达状态的强视觉化摘要。

主要能力:项目提供可复用的 ReportTable<T> 组件(位于 core/ui/components/ReportTable.kt),支持 TableColumn<T> 定义(表头、权重、取值 lambda)、内置客户端分页(默认每页 25 行)、表头行使用 surfaceVariant 背景、Modifier.weight() 按比例分配列宽、空状态使用字符串资源。日期必须显示为人类可读格式 d MMM yyyy(如 14 Feb 2026),API 传输用的 yyyy-MM-dd 不得直接展示;图表坐标轴可用 MMM d。竖屏建议最多 3-4 列并缩写表头,使用权重比例控制列宽;5 列以上可包裹 horizontalScroll。表头文本必须使用 stringResource(R.string.report_col_*)。所有展示报表或统计的屏幕必须支持下拉刷新,使用 PullToRefreshBox,ViewModel 需暴露 reload()/refresh()。报表屏幕应使用可滚动 Column 而非 LazyColumn,因为 ReportTable 不是惰性组件。

使用方式:按决策矩阵判断——可能超过 25 行、分销商/产品/发票/债务人列表、Top 100 排名等必须用表格;保证不超过 25 行、DPC(5-20 项)、7 天日报等可用卡片。分页默认客户端处理,数百行以内由 ReportTable 内部处理;1000 行以上改用服务端 offset/limit 分页。

限制:该技能已被 mobile-report-tables 取代,后者同时覆盖 Android 与 iOS,应改用后者。使用本技能时要求 Superpowers 插件处于激活状态。资料未提供安装命令、收费或价格信息。