| name | find-component-entry |
| description | 从界面操作路径反查「怎么点进某个 Vue/React 组件所在页面」;用户问进入方式、菜单路径、路由入口、如何打开某页面时使用。 |
查找组件在界面上的进入方式
这个 Skill 是干什么的
当你拿着源码里的某个组件文件(例如 src/views/xxx.vue、src/components/xxx.vue),想知道在真实产品界面上要点哪些菜单、Tab、按钮才能进到用这个组件的页面——就用本 Skill。
产出物应是可照做的点击路径(必要时带上测试环境可点的 hash 链接),而不是只贴一行路由配置。
用户一般怎么问
- 「这个组件从哪进?」「菜单路径是什么?」
- 「怎么在测试环境打开这个页面?」
- 「帮我找
xxx.vue 的入口」
- 用户提供文件相对路径,说“给我页面入口/找到页面入口”
你需要用户提供什么
组件路径,例如:
src/views/stutentManage.vue
分析步骤(AI 照着做)
1. 找谁引用了这个组件
全仓库搜 import / 动态 import。必须同时尝试两种写法:
写法 A:带扩展名
from '@/views/stutentManage.vue'
import('@/views/stutentManage.vue')
写法 B:省略 .vue(很常见,漏搜会找不到)
from '@/views/stutentManage'
import('@/\views/stutentManage')
许多人不写 .vue,编辑器「查找引用」可能不完整,所以两种都要搜。
2. 锁定父级页面
- 看
src/views/**、src/pages/** 里谁 import 了它
- 若有
router-view、异步组件,再往上追到「页面级」Vue 文件
3. 对齐路由
- 查
src/router/**、src/routes/** 等
- 把「页面组件」对应到
path / name
- 理清侧栏层级:一级菜单 → 二级 → …(以实际路由/菜单配置为准)
4. 找菜单/侧栏文案
- 路由或菜单配置里的
label、meta.title 等
- 若项目有
.docs/routes/** 可辅助对照
5. 核对路由是不是「真在用」(重要)
全仓库再搜该路由是否被引用,避免告诉用户一条已废弃的路:
router.push('/path')
this.$router.push({ name: 'routeName' })
<router-link to="/path">
redirect: '/path'
{ path: '/path', label: '某某菜单' }
@click="$router.push('/path')"
判断表:
| 菜单上能看见 | 代码里有人跳这段路由 | 建议标注 | 输出时注意 |
|---|
| 是 | 是 | 正常 | 菜单路径 + 其它跳转入口都可写 |
| 是 | 否 | 主要走菜单 | 说明主要从侧栏进 |
| 否 | 是 | 跳转入口 | 说明从哪个页的哪个按钮/链接进 |
| 否 | 否 | ⚠️ 可能已废弃 | 提醒用户向业务/后端确认是否还在用 |
若 sidebarShow: false(或没有菜单)且完全搜不到 push / router-link / redirect / 菜单配置,优先标「可能已废弃」。
输出格式(建议)
用 Markdown,至少包含:
- 进入方式(简要):
一级 → 二级 → Tab → … 一句话
- 路由跳转链接(如需要):测试环境前缀 + path(见下节)
- 进入方式(详细):按真实点击顺序写:点哪个菜单、切换到哪个 Tab、点哪个按钮;按钮/Tab 文案与线上保持一致
- 组件在页里干什么(一句话,可选)
模板示例(内容替换成真实分析结果即可):
## 进入方式(简要)
教师管理 -> 教师详情 -> 基础信息Tab
## 进入方式(详细)
**菜单路径**:教师管理 -> 教师详情 -> 基础信息Tab
**具体操作**:
1. 左侧进入 教师管理
2. 点 列表的编辑
4. 进入页面后默认第一个 Tab **「基础信息」**,对应该组件
| 操作 | 路径 | 场景 |
|------|------|------|
| 新建企业 | `/student/create` | 新建 |
| 编辑 | `.../student/edit` | 编辑 |
**组件功能**:……(一句话)
测试环境链接前缀
拼完整 URL 时在 hash 前使用(通过项目配置找到url前缀):
注意事项
- 写的是用户怎么点,不是只贴
routes.js。
- 每一步应对应真实 UI:菜单名 / Tab 名 / 按钮文案要与界面一致。
- 有 Tab 切换要写清楚 Tab 名称;有「新建/编辑」两条路要分开写。
- 顶部保留简要路径方便复制给同事。
- 务必排查废弃路由,避免把人带到已经不再使用的页面。
描述粒度(必须达到)
每条路径里应体现:
- 菜单:一级 → 二级(如有)
- Tab:点 「某某」 Tab(如有)
- 按钮/链接:点 「某某」 按钮或链接
- 结果动作:新建 / 编辑 / 查看 等
规则:每一个 → 都必须对应界面上看得见、点对点的名字(菜单 / Tab / 按钮 / 链接)。