🐛 fix(vscode): 代码阅读跳到参数、导入项、多变量声明里的一个时只闪属性表里那一行，按源码位置判断

docs/superpowers/specs/code-reader/spec.md

@@ -85,7 +85,12 @@
   - 几处定义：先弹挑选框（每项「相对路径:行号」，下面一行是那行源码），挑一处再按上面跳；
   - 没有定义：不动。
   - 和普通编辑器里 ⌘ + 点击一样：目标是否按「预览标签」打开听 `workbench.editor.enablePreview`；`workbench.editor.enablePreviewFromCodeNavigation` 为假（默认）时先把当前预览标签固定住，免得被目标替掉。
-- 滚过去：目标块是显示着定义处那个名字的块（找不到就取包含定义那一行的块）；它的祖先块折叠着就展开，名字在折叠的属性行子行里（参数、导入项）就展开那一行。整块已在视口里不滚，否则滚到视口正中（比视口高就顶部对齐）。然后目标块的边框和底色往聚焦色（`--vscode-focusBorder`）闪三下，共约 1.5 秒后复原；同一块再跳一次从头闪；系统开了「减少动态效果」时改成静止高亮 1.5 秒。
+- 闪哪一处：页面上**就是这处定义**的最具体的那一处，只按源码位置判断（定义提供者给的定义处下标，对上块和属性行带的源码范围），不看属性名文字：
+  1. 定义是块自己的名字（函数名；只声明一个变量时的变量名，解构模式整个算）→ 整块。块的这段范围由扩展端从 facts 取（`BlockView.defines`），和翻译插件无关。
+  2. 定义是属性表里某一行 / 子行讲的东西（参数、导入项、一条语句声明几个变量时的某一个）→ 只闪这一行 / 子行。范围是翻译插件从 facts 取的节点（`PropertyRow.defines`、`PropertyItem.defines`），定义处落在范围里就算（`*args` 的定义在 `args` 上、解构参数里的名字都对得上）。
+  3. 其余（定义在一行译文里，例如循环变量；翻译插件没填 `defines`）→ 显示着定义处那个名字的块，名字在属性行的子行里时展开那一行；页面上找不到这个名字就取包含定义那一行的块。
+  - 同一文件原地跳、跳进另一个文件的预览，规则一样。
+- 滚过去：目标所在块的祖先块折叠着就展开，目标在折叠的属性行子行里（参数、导入项）就展开那一行。目标已在视口里不滚，否则滚到视口正中（比视口高就顶部对齐）。然后目标的边框和底色往聚焦色（`--vscode-focusBorder`）闪三下，共约 1.5 秒后复原；同一处再跳一次从头闪；系统开了「减少动态效果」时改成静止高亮 1.5 秒。目标是属性行 / 子行但块正在编辑（页面上没有属性表）时闪整块。
 - 不按修饰键的点击照旧；⌘ / Ctrl + 点击名字不会触发块的编辑切换、折叠。
 
 ## 通用契约
@@ -97,8 +102,11 @@ export type BlockKind =
   | 'import' | 'function' | 'class' | 'type' | 'field' | 'const' | 'variable'
   | 'if' | 'else' | 'loop' | 'try' | 'catch' | 'finally' | 'return' | 'statement' | 'comment'
 
-/** 源码里的一段，行号从 0 开始，end 为开区间的字节偏移。 */
-export interface SourceSpan { startIndex: number, endIndex: number, startRow: number, endRow: number }
+/** 源码里一段的下标（源码字符串下标），end 为开区间。 */
+export interface SourceRange { startIndex: number, endIndex: number }
+
+/** 源码里的一段，带起止行号（从 0 开始）。 */
+export interface SourceSpan extends SourceRange { startRow: number, endRow: number }
 
 // ── 属性表块的结构化信息（facts）：语言插件从语法树读出，节点都指向源码 ──
 
@@ -175,11 +183,18 @@ export type TokenRole =
  */
 export interface Segment { text: string, role: TokenRole, offset?: number }
 
+/**
+ * 属性表里的一行或一个子行讲的是哪个定义：定义出来的那个名字的节点（取自 facts）在源码里的范围——
+ * 参数名（连 `*` 前缀、整个解构模式）、导入项（名称到别名）、声明的变量名。跳到的定义落在里面就只闪这一行；
+ * 第三方翻译插件可以不填，不填就闪整块。
+ */
+export interface Defines { defines?: SourceRange }
+
 /** 属性表里展开的一个子行：几列对齐的格子。 */
-export interface PropertyItem { cells: Segment[][] }
+export interface PropertyItem extends Defines { cells: Segment[][] }
 
 /** 属性表的一行：属性名、着色的值、展开在下面的子行（输入参数、导入项）。 */
-export interface PropertyRow { label: string, value: Segment[], items?: PropertyItem[] }
+export interface PropertyRow extends Defines { label: string, value: Segment[], items?: PropertyItem[] }
 
 /** 语言插件：语法树 → 代码块树。 */
 export interface LanguageAdapter {
@@ -333,6 +348,7 @@ interface BlockViewBase {
   endLine: number
   code: string             // header 源码，去掉共同缩进
   codeTokens: Segment[]    // 源码着色（拼起来等于 code）
+  defines?: SourceRange    // 块自己的名字（函数名、只声明一个变量时的变量名）在源码里的范围，扩展端从 facts 取；跳到的定义是它时闪整块
   children: BlockView[]
 }
 
@@ -404,7 +420,7 @@ vscode/webview-ui/code-reader.html + src/codeReader/  预览界面（React，Vit
 - 翻译：上面两张样例表逐字一致；属性名不被翻；每个被翻的词单独成段；节点模板嵌套时正确、槽位里照样翻、没命中模板的节点照抄；属性表里的值和一行译文用同一套表和模板。
 - `blockView`：`codeTokens` 拼起来等于 `code`；去缩进正确；函数、导入、常量、变量块只带属性表，其余块只带译文。
 - 行替换：多行块替换后缩进正确。
-- 跳到定义：TS / Python 译文和属性表里的名字、点分模块名每一节、模块字符串带下标且指回源码原文，关键字、运算符、说明词不带（前面有中文注释也对得上）；查到的定义 → 不动 / 原地 / 预览 / 普通编辑器 / 挑选框；webview 里按下标找目标块、要展开的祖先块和属性行，滚动位置。
+- 跳到定义：TS / Python 译文和属性表里的名字、点分模块名每一节、模块字符串带下标且指回源码原文，关键字、运算符、说明词不带（前面有中文注释也对得上）；查到的定义 → 不动 / 原地 / 预览 / 普通编辑器 / 挑选框；webview 里按下标找目标块、要展开的祖先块和属性行，滚动位置。闪哪一处（TS、Python 源码走完整的语言插件 + 翻译插件 + 视图数据）：参数 → 它那个子行，导入项 → 它那一项，多变量声明里的一个 → 它的名称行，函数名 / 单个变量名（含解构模式）→ 整块，循环变量 → 所在的块，翻译插件没填 `defines` → 整块（照样展开属性行）；翻译插件给参数、导入项、声明的变量标的范围指回源码原文；块自己的名字只有函数和单变量声明有。
 - 注册表：注册 / 注销后 `languageIds` 与可选翻译正确；同一语言多个翻译时按 `globalState` 选中。
 
 ## 收尾