用途:生成设计系统采用报告,把三个常被混淆的指标分开:覆盖度(系统满足团队界面需求的程度,属供给)、触达(拥有系统访问权的团队,如已安装 npm 包、启用 Figma 库、完成入驻)、采用(实际用系统交付产品工作的团队,属使用)。也可分开统计设计侧采用(设计师是否使用 Figma 库)与工程侧采用(代码是否消费系统),两者独立,一侧高另一侧低属于特定问题。报告顶部须声明定义,避免与其他工具把“coverage”用于屏幕实例占比的用法混淆。
主要能力:按配置读取 .ds-ops-config.yml,支持 npm(下载趋势方向:上升/持平/下降,私服通常无数据)、Figma(Library Analytics API 仅企业版,含 detach 率)、GitHub(导入系统包的仓库、贡献活动、近 6 个月无导入提示)、文档平台(Zeroheight、Supernova 页面浏览量,如有搜索日志可发现未返回结果的搜索词)。提供周期对比:覆盖度变化、触达 ±团队、采用 ±团队(设计/工程分开)、新增与恢复的风险团队、阻塞类别;连续 3 次以上出现的阻塞类别标记为系统性问题。单团队按阶段评估:Aware/Installed/Consuming/Contributing/Advocating 或 Not reached,并记录设计采用(Active/Partial/None)、工程采用、使用指标与参与信号。工程侧可用代码测量:用 rg -l "from '@org/ds" --glob '*.{ts,tsx,js,jsx,vue}' 判断触达;统计系统组件实例相对本地重复组件(react-scanner、Omlet 可为 React 提供占比);token 引用占比;报告任何团队为 None 前须做正向对照。
使用方式:先确认 frontmatter 中 references 路径均存在,缺失则提示按 1-INSTALL.md 重装并在安装根运行 verify-install.sh;用户明确要求才可无参考材料继续并在输出中说明。随后收集或确认在范围内的团队、可用数据、报告周期、是否有上期报告可比较、受众(系统团队看团队级,领导层看系统级汇总)。先盘点信号可用性与可靠性(直接信号:npm 下载、Figma 库分析、代码导入数、文档平台分析、支持工单量;间接信号:近期提交中的组件、已发布产品 vs 实验分支、设计文件存量、PR 活动、访谈或问卷)。若没有任何团队有实测信号则停止,不要用估算填表,改为输出数据收集计划。
适用场景:设计系统团队定期向工程或领导层汇报采用情况、识别风险团队与阻塞根因。
限制:无来源化的成熟度基准,只能对照成熟阶段定性解读;npm 下载只表示方向,不代表采用团队数;Figma 分析不能归属到团队,需用户提供文件归属;若仅一种信号,采用评估基于有限数据可能不完整;低覆盖是供给问题(需构建),覆盖良好而低采用是需求问题(需了解团队为何不用)。
未提供:具体价格、安装步骤细节、除上述之外的平台支持。