✨ feat(vscode): 代码阅读的词可以讲源码里别处的名字（Segment.refers）：FastAPI 路径里的 {user_id} 讲函数的参数，单击参数时跟着高亮，⌘ + 点击跳到参数

vscode/src/codeReader/rules/fastapi.test.ts

@@ -95,9 +95,12 @@ describe('fastapi 库规则：接口卡片', () => {
     const rows = properties(await route(ROUTES, 'update_user', known({ Forbidden: '403' })))
     const request = rows.find(row => row.label === '请求')
     const [url, method] = request?.items ?? []
-    expect(flatSegments(url.cells[1]).map(piece => [piece.text, piece.role])).toEqual([['/users', 'string'], ['/', 'string'], ['{user_id}', 'variable']])
+    expect(flatSegments(url.cells[1]).map(piece => [piece.text, piece.role])).toEqual([['/users', 'string'], ['/', 'string'], ['{', 'variable'], ['user_id', 'variable'], ['}', 'variable']])
     for (const piece of flatSegments(url.cells[1]))
       expect(ROUTES.slice(piece.offset, (piece.offset ?? 0) + piece.text.length)).toBe(piece.text)
+    // 路径里的 user_id 讲的是 update_user 的参数 user_id：高亮参数的各处出现时跟着亮，⌘ + 点击跳到参数
+    const param = ROUTES.indexOf('user_id: Int4Path', ROUTES.indexOf('def update_user'))
+    expect(flatSegments(url.cells[1]).find(piece => piece.text === 'user_id')?.refers).toEqual({ startIndex: param, endIndex: param + 'user_id'.length })
     expect(method.cells[1]).toEqual([{ text: 'PUT', role: 'keyword', color: { dark: '#fca130', light: '#b35f00' } }])
     const [ok, forbidden, validation] = rows.find(row => row.label === '响应')?.items ?? []
     expect(ok.cells[0]).toEqual([{ text: '200', role: 'number', color: { dark: '#2ea043', light: '#1a7f37' } }])