✨ feat(vscode): 代码阅读侧栏跟着当前文件走，目录链接在侧栏树上定位

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

@@ -59,6 +59,10 @@
 - 树节点用 `resourceUri`，图标跟随用户的文件图标主题，git 改动颜色（M / U）由 VS Code 自动加上，外观与自带资源管理器一致。
 - 视图标题栏：选工单（见「审查工单」）、刷新、全部折叠（`showCollapseAll`）。文件变化时自动刷新（防抖）。
 - 点文件：语言受支持 → 用「代码阅读预览」自定义编辑器打开；否则 `vscode.open`。
+- 侧栏跟着当前文件走，规则同 VS Code 资源管理器：激活的标签页换成一个文件时，树展开到它并选中（`TreeView.reveal`，`select: true`、`focus: false`，焦点留在编辑器）。点仓库链接、⌘ / Ctrl + 点击跳到定义、在标签栏切换、侧栏点开都走这一条（`explorer/treeLocator.ts` 盯着 `window.tabGroups` 的变化）。文本编辑器、代码阅读预览取它开的文件，对比编辑器取改后那边，路径页（问文件夹的预览）取它问的文件夹（文件夹顺带展开）；同一个标签页别的变化（改了没保存）不重新定位。
+  - `explorer.autoReveal`：`false` 不跟；`focusNoScroll`（选中但不滚动）当作开着——插件的 `TreeView.reveal` 选中就会滚过去，做不到不滚动。`explorer.autoRevealExclude` 命中它自己或路上任何一层目录的（默认 `node_modules`、`bower_components`）不跟。
+  - 只在代码阅读这棵树露着时跟，不把侧栏抢过来；树再露出来时补上当前文件。
+  - 树上没有的不动：工作区外的、`files.exclude` 藏了的目录里的。开着「未提交的更改」「审查」时只在摆出来的文件里找：在就定位，同一个文件摆在两组里（暂存的、没暂存的）取最先摆的那行；不在就不动，不退出筛选。
 - 鼠标停在目录 / 文件行上，行尾一排按钮（`view/item/context` 的 `inline` 组）：先「复制」，再「添加注释 / 编辑注释」（见下两节）。工作区根节点没有。
 
 ### 复制
@@ -462,7 +466,7 @@
 - 原文：翻译插件去掉注释符号（`#`、`//`、`/*` `*/` 和每行开头的 `*`）、引号和中文名记号（`SourceDocument.markers`，见「中文名」），再去掉行尾空白、首尾空行和共同缩进，保留换行，不做别的转换。一个注释节点（块注释、docstring）的第一行紧跟在注释符号 / 引号后面，不参与算共同缩进（同 PEP 257）；几条行注释连成的一块每行地位相同，第一行也算，缩进四格的代码块才留得住。
 - 渲染：webview 用 markdown-it（`html: false`、`linkify: true`），CommonMark 加 GFM 的表格、删除线：段落、强调、行内代码（含双反引号）、代码块（围栏、缩进四格）、列表、链接、标题、引用、表格。段内单个换行是软换行，空行分段。同一段文字只渲染一次（缓存最近 500 段）。
 - 安全：源码里的 HTML 当文字显示；链接认 http / https / mailto，带协议的网址和邮箱自动成链接（`sample.py` 这种不带协议的不算），别的写法（`javascript:`、`command:`、`./`、`..`、绝对路径、盘符）照原文显示。http / https / mailto 由 VS Code 的 webview 自己拦下、交给宿主在外部打开，不用另发消息。http / https 图片不渲染（webview 的 CSP 不放行外部图片），`![alt](url)` 显示成 `!` 加链接。仓库内图片按原图比例显示，点了打开原图，没有就写「找不到图片」和路径。
-- 仓库路径链接（`[名字](从仓库根起的路径)`，可带 `#类名` 或 `#类名.成员`）能点，点了打开文件并跳到符号。
+- 仓库路径链接（`[名字](从仓库根起的路径)`，可带 `#类名` 或 `#类名.成员`）能点，点了打开文件并跳到符号。指到目录的在代码阅读侧栏的树上定位（展开并选中，和侧栏跟着当前文件走是同一个定位；侧栏没露着时亮出来），不切到 VS Code 资源管理器；树上没有（开着筛选时没摆它）时提示「侧栏的树上没有 …」，不退出筛选。
 - 样子：正文用界面字体（`--vscode-font-family`、`--vscode-font-size`）、comment 色、行高 20px，一行注释和一行译文一样高；行内代码用编辑器字体、`--vscode-textCodeBlock-background` 底；围栏代码块用编辑器字体和字号、同样的底，长行折行；段落、列表、代码块、表格之间 6px；标题只比正文稍大（h1 1.15em、h2 1.08em，其余同正文，加粗）；链接 `--vscode-textLink-foreground`；引用左边 3px `--vscode-textBlockQuote-border` 竖线、`--vscode-textBlockQuote-background` 底；表格 1px 细线。
 - 「编辑」状态照旧是源码，编辑写回不变；Markdown 里的名字不能点，不参与跳到定义。
 
@@ -2054,7 +2058,7 @@ vscode/src/codeReader/
   translators/pythonZh.ts           Python 表（含注解位置的判断）
   translators/bashZh.ts             Shell 表：节点读法（展开、特殊变量、条件、通配、&& / ||、管道、遍历、分情况）、开关的叫法
   translators/dockerfileZh.ts       Dockerfile 表：各条指令的读法（RUN 问嵌着的 shell 读出来的样子）、并块的读法（COPY、LABEL）、解析指令的叫法
-  explorer/fileTree.ts   侧栏文件树（FileTreeDecorator：给行添信息的接口；showChanges：审查工单时只摆 PR 改过的文件）
+  explorer/fileTree.ts   侧栏文件树（FileTreeDecorator：给行添信息的接口；showChanges：审查工单时只摆 PR 改过的文件；nodeOf / getParent：按 Uri 找树上那一行、找上一层）
   explorer/copyText.ts   复制菜单的命令和复制出什么（纯函数）
   explorer/copyCommands.ts  复制命令：写剪贴板、状态栏提示
   review/changedFiles.ts    改动状态 → M / A / D、颜色，PR 改过的文件 → 按目录分好的树（纯函数）
@@ -2067,6 +2071,8 @@ vscode/src/codeReader/
   review/reviewMode.ts      ReviewMode：选工单弹框、进出审查、刷新、按工作区记住，审查时预览对比什么（diffBase）
   uncommitted/uncommittedMode.ts  UncommittedMode：「未提交的更改」进出、盯 git 状态重摆，开着时预览对比上一次提交（diffBase）；纯函数在 uncommittedFiles.ts
   explorer/treeFilters.ts   TreeFilters：侧栏的几种筛选同时只开一种，开着的那种定预览对比什么，换了筛选、基准变了通知预览
+  explorer/treeLocator.ts   TreeLocator：侧栏的树定位到某个文件 / 目录（跟着当前文件走、目录链接），按 FileTreeProvider 的 nodeOf、getParent 找行
+  explorer/treeReveal.ts    定位用到的判断：树上一行和要找的路径什么关系、explorer.autoReveal / autoRevealExclude 怎么认（纯函数）
   diff/diffBase.ts          DiffBase：对比基准（文案、旧内容怎么取、缓存用的 key、基准里没有这个文件时的说明）
   diff/blockDiff.ts         两棵块树比：兄弟块对齐（名字 / 最长公共子序列 / 相似度）、新增修改删除、删掉的块放哪、统计（纯函数）
   diff/viewDiff.ts          一块卡片里的内容比：属性表按属性名、子行按第一列、着色的词逐截、Markdown 逐词；删掉的块只留自己的内容、去掉源码下标（纯函数）
@@ -2159,6 +2165,7 @@ vscode/webview-ui/code-reader.html + src/codeReader/  预览界面（React，Vit
 - 筛选：块的属性（TS、TSX 有抽象、仅类型，JavaScript / JSX 没有这两个属性、属性表也没有这两行，Python 有访问级别、异步）；语言插件自己报的属性叠上去、盖过推出来的，kind 不变；文件里出现过的属性按契约顺序排、语言的排后面，值按第一次出现排、带所有层的块数，名字取翻译插件的、没有的显示 id，中文直译的名字和属性表一致；下拉框只给两种以上值的属性（或一种值正被去掉的），按钮上的字；全选 / 取消全选只动这份文件里的值、别的文件的去掉状态和别的属性不动、取消全选藏掉有这个属性的块（整棵子树）、再全选全回来；同一属性内「或」、不同属性「且」、没有这个属性不受影响、藏整棵子树、「已隐藏」只数直接筛掉的；筛选记在 `workspaceState`、新实例读得回来、所有订阅的预览收到、形状不对的当没有；跳到被筛掉的块临时露出路径、目标的子块照常筛、文档刷新只留正在编辑的。
 - 文件注释：键相对工作区文件夹、`/` 分隔，根和外面的路径没有键，手写的 `./`、结尾 `/` 规范掉；保存去空白、清空即删；文件改名、目录挪位置里面各层一起走、名字只是前缀相同的不动、跨工作区文件夹先取出再放进去；删目录连带里面的；读写：文件缺失 / 解析失败 / 不是对象返回空表、跳过不合法条目、建 `.spx`、键排序、删光留 `{}`；有注释 / 没注释的行的描述、悬停提示（Markdown 转义）、contextValue，和 `package.json` 里菜单的 when 子句对得上。
 - 侧栏行上的菜单（`explorer/rowMenus.test.ts`，读 `package.json`）：行尾按钮先「复制」子菜单再注释，有没有注释换「添加 / 编辑注释」，工作区根都没有；「复制」子菜单带 `$(copy)`，注释图标 `$(note)` / `$(edit)`；子菜单和右键菜单里文件四项、目录三项（有没有注释一样）、菜单上的字；复制命令都登记了、和代码里的命令表一致、命令面板里藏起来。
+- 侧栏定位：树上一行和要找的路径的关系（自己、上层目录、名字开头相同的兄弟目录不算、别的协议不算）；`explorer.autoReveal` 的 `true` / `false` / `focusNoScroll` / 没读到；`autoRevealExclude` 命中路上任何一层都不跟（`explorer/treeReveal.test.ts`）。树的数据源（`explorer/fileTree.test.ts`，假的 vscode 和磁盘）：多层目录 `getParent` 交回 `getChildren` 给过的同一个对象、根的上一层没有；`nodeOf` 找到文件、目录，顺着 `getParent` 走回根；工作区外、`files.exclude` 藏了的、盘上没有的找不到；只摆改动的文件时在就找到、上一层一直走到分组行，没摆的找不到，同一文件在两组里取最先摆的，分组没名字时根在最上面。
 - 审查工单：
   - 改动的文件树（`review/changedFiles.test.ts`）：原型那 6 个文件加一个改名的，目录层级照留、每层只有通往改过的文件的目录，文件带改动和相对仓库根的路径，目录没有改动；排法同普通的树；文件换成同名目录两项都留着；没有文件时根下面是空的。状态 `added` → A、`deleted` → D、别的都是 M，三种颜色是 git 装饰色、删掉的提示「PR 里删掉了」。
   - 选工单弹框（`review/pickList.test.ts`）：一项的字（有 / 没有工作副本、正在读、读不到、没有 PR）；一打开就摆出各项、有 PR 的在读、在转圈，读到一个只换那一项（别的项是同一个对象、次序不变），都读完（没读到也算）停止转圈，没 PR 的、没有工单的一开始就不转；按列分组：先「审查」再「进行中」、每组前一行列名、没有工单的列不出标题、换掉一项后分组不变；工单从哪来：看板这次加载过用它、没加载过用存下的快照（JSON 里字符串的 PR 号认得，只留「审查」列和有 PR 的「进行中」列的 Gitea 工单）、都没有或快照坏了是 undefined。