用途:为设计系统的代码库预计算并生成机器可读索引,消除 AI 智能体或开发者每次都要从零探索代码库的需要。索引由三部分组成:组件清单、关系图、汇总统计。
主要能力:
- 检测框架与结构(React、Vue、Svelte、Astro、Angular、Web Components 或混合),识别组件目录、分类模型与样式方案。
- 构建组件清单:提取名称、路径、分类、元数据状态、导出类型和组件样式引用的设计令牌。
- 构建关系图:解析导入并验证实际渲染,记录 uses 与 usedBy 双向关系,支持深层依赖链、命名空间导入、Vue kebab-case 与插槽实例计数处理。
- 生成汇总统计:组件总数、有元数据数量、关系边数、分类分布、无仓库内消费者、被依赖最多、扇出最高、元数据覆盖率、平均实例数。
使用方式:在添加或移除组件后运行,输出三个文件到项目根目录 .ai/index/:component-inventory.yml、component-relationships.yml、query-protocols.md,并建议随代码提交、纳入 CI、从 AGENTS.md 链接。可读取 .ds-ops-config.yml 获取框架、组件路径、分类模型、集成与增量配置;支持 Figma MCP、Storybook、GitHub 可选集成,用于设计-代码交叉比对、组件发现和 PR 活跃度信号。
限制:若未找到任何组件文件会停止并要求指定位置,不写空索引;索引可能过时,需比对 meta.commit 与 git rev-parse --short HEAD;无仓库内消费者不等于未使用,因为仓库外产品仓库未检查。安装前置校验失败时应重新安装并运行 verify-install.sh。具体收费、价格、平台支持等信息暂未提供。