Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
refactor(workdir-browse): 按维护者要求拆分——「显示被忽略的目录」开关移出本 PR
Zhang Yunjin0db87bbbc725
diff --git a/apps/desktop/src/main/file-browser/__tests__/deviceOp.test.ts b/apps/desktop/src/main/file-browser/__tests__/deviceOp.test.tsindex 4707d3517f..9c7606f6ef 100644--- a/apps/desktop/src/main/file-browser/__tests__/deviceOp.test.ts+++ b/apps/desktop/src/main/file-browser/__tests__/deviceOp.test.ts@@ -577,7 +577,6 @@ describe('file-browser device-op', () => {docMode: undefined,includeIgnored: true,maxEntries: 2000,- showIgnoredDirs: false,});});@@ -598,7 +597,6 @@ describe('file-browser device-op', () => {relPath: '',hideMetaFiles: true,docMode: undefined,- showIgnoredDirs: false,});},);@@ -632,7 +630,6 @@ describe('file-browser device-op', () => {relPath: '',hideMetaFiles: true,docMode: undefined,- showIgnoredDirs: false,});const condition = dbWhereMock.mock.calls.at(-1)?.[0];expect(hasDeepValue(condition, '/remote/home/user/proj')).toBe(true);@@ -689,7 +686,6 @@ describe('file-browser device-op', () => {expect(sshRequestMock).toHaveBeenCalledWith('host-1', 'watchStart', {workdir: sshWorkdir,hideMetaFiles: true,- consumerId: 'device-link',});onFsWatchReleased(sshWorkdir);});@@ -766,7 +762,6 @@ describe('file-browser device-op', () => {expect(sshRequestMock).toHaveBeenCalledWith('host-1', 'watchStart', {workdir: sshWorkdir,hideMetaFiles: true,- consumerId: 'device-link',});});onFsWatchReleased(sshWorkdir);@@ -775,7 +770,6 @@ describe('file-browser device-op', () => {expect(sshRequestMock).toHaveBeenCalledWith('host-1', 'watchStop', {workdir: sshWorkdir,- consumerId: 'device-link',});});@@ -888,7 +882,6 @@ describe('file-browser device-op', () => {});expect(sshRequestMock).toHaveBeenCalledWith('host-1', 'watchStop', {workdir: sshWorkdir,- consumerId: 'device-link',});onFsWatchReleased(sshWorkdir);});@@ -1064,7 +1057,6 @@ describe('file-browser device-op', () => {});expect(sshRequestMock).toHaveBeenCalledWith('host-1', 'watchStop', {workdir: sshWorkdir,- consumerId: 'device-link',});const event = {event: 'fileTree',@@ -1078,68 +1070,6 @@ describe('file-browser device-op', () => {onFsWatchReleased(sshWorkdir);});- /**- * 评审 P1:device-link 订阅的是**隐藏态**视图,而 daemon 的 watcher 用的是与- * desktop 文件树(可能开着「显示被忽略的目录」)并集后的 matcher —— dist / build- * 这类目录内部的事件也会发过来。转发前必须按 device-link 自己的可见性滤一道,- * 否则一次构建会把成千上万条控制器根本不会显示的帧推过 relay。- */- it('watch: SSH 转发前按 device-link 的隐藏态可见性过滤被忽略目录事件', async () => {- const sshWorkdir = '/remote/home/user/reveal-union-watch';- guardMock.mockResolvedValue({ allowed: false, reason: 'not-found' });- dbRowsMock.mockReturnValue([{ remoteHostId: 'host-1' }]);- sshRequestMock.mockImplementation(() => Promise.resolve({ ok: true }));-- await onFsWatchSubscribed(sshWorkdir);- const handler = sshListenerState.hostEventHandlers.at(-1);-- // 隐藏态不可见的目录内部事件:一律丢弃(一级与嵌套层都要管)。- handler?.({- event: 'fileTree',- data: { workdir: sshWorkdir, type: 'change', relPath: 'dist/bundle.js' },- });- handler?.({- event: 'fileTree',- data: { workdir: sshWorkdir, type: 'add', relPath: 'packages/foo/build/out.map' },- });- // 大小写变体同样按不可见处理:matcher 的 ignorecase 默认让 DIST 与 dist 同义,- // 事件不该继续推过 relay(评审 P2)。- handler?.({- event: 'fileTree',- data: { workdir: sshWorkdir, type: 'change', relPath: 'DIST/bundle.js' },- });- // 名单本身是混合大小写(Library / Temp / Logs),段比较折叠后仍要命中。- handler?.({- event: 'fileTree',- data: { workdir: sshWorkdir, type: 'change', relPath: 'remote/Library/x.dat' },- });- expect(pushSpy).not.toHaveBeenCalled();-- // 普通路径照常转发。- const visible = {- event: 'fileTree',- data: { workdir: sshWorkdir, type: 'change', relPath: 'src/app.ts' },- };- handler?.(visible);- expect(pushSpy).toHaveBeenCalledWith(FILE_BROWSER_EVENT_CHANNEL, visible.data, {- dataOwnerId: 'owner-a',- ownerGeneration: 7,- });-- // 与忽略目录同名的**普通文件**(叶子段)不算内部:listDir 会列出它,事件也必须转发- // (否则它的行陈旧到手动刷新)—— 忽略名单是目录规则,只判祖先段。- const sameNameFile = {- event: 'fileTree',- data: { workdir: sshWorkdir, type: 'change', relPath: 'dist' },- };- handler?.(sameNameFile);- expect(pushSpy).toHaveBeenCalledWith(FILE_BROWSER_EVENT_CHANNEL, sameNameFile.data, {- dataOwnerId: 'owner-a',- ownerGeneration: 7,- });- onFsWatchReleased(sshWorkdir);- });-it('watch: a second release cancels an already scheduled SSH reconcile', async () => {const sshWorkdir = '/remote/home/user/cancel-retry-watch';guardMock.mockResolvedValue({ allowed: false, reason: 'not-found' });@@ -1170,19 +1100,17 @@ describe('file-browser device-op', () => {// ── gzip(应用层压缩)────────────────────────────────────────────────────- it('caps op advertises gzip + showIgnoredDirs; unknown op stays a deterministic negative signal', async () => {+ it('caps op advertises gzip; unknown op stays a deterministic negative signal', async () => {// caps 与 workdir 无关,guard 之前处理——guard 拒绝也不影响探测。- // 控制端用 showIgnoredDirs 决定「显示被忽略的目录」开关是可点还是禁用+升级提示。expect(await handleRemoteOp({ op: 'caps', workdir })).toEqual({ok: true,gzip: true,- showIgnoredDirs: true,completeDirectoryListing: true,fileRead: true,dirExport: true,folderAttachment: true,});- // 控制端把 unknown op 当"老端不支持压缩/开关"的确定性负信号,形状不能漂。+ // 控制端把 unknown op 当"老端不支持压缩"的确定性负信号,形状不能漂。expect(await handleRemoteOp({ op: 'nope', workdir })).toEqual({ok: false,message: 'unknown op: nope',diff --git a/apps/desktop/src/main/file-browser/__tests__/remoteWatch.test.ts b/apps/desktop/src/main/file-browser/__tests__/remoteWatch.test.tsdeleted file mode 100644index 41de80851a..0000000000--- a/apps/desktop/src/main/file-browser/__tests__/remoteWatch.test.ts+++ /dev/null@@ -1,158 +0,0 @@-/**- * remote-watch.test.ts — SSH 会话 watch 注册表的失败清理回归。- *- * 锁的不变量:切「显示被忽略的目录」会在同一个 key 上 stop→start,而两个- * watchStart 请求都是异步的。旧请求迟到 reject 时只能回收**它自己装上的**- * 注册,不能顺手删掉同 key 上的替换注册 —— 否则新注册变成孤儿:后续 stop()- * 提前返回、事件 / 重连 listener 泄漏,daemon 侧 watch 也不会停,反复切换- * 会累积重复订阅。- */-import { describe, expect, it, vi } from 'vitest';-import type { BrowserWindow } from 'electron';--import type { RemoteFileBrowserManager } from '../remote.js';--vi.mock('../../logger', () => ({- createLogger: () => ({ debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() }),-}));--import { RemoteWatchRegistry } from '../remote-watch';--function makeWindow(id = 1): BrowserWindow {- return { id, isDestroyed: () => false, once: vi.fn() } as unknown as BrowserWindow;-}--function deferred<T = void>() {- let resolve!: (value: T) => void;- let reject!: (err: unknown) => void;- const promise = new Promise<T>((res, rej) => {- resolve = res;- reject = rej;- });- return { promise, resolve, reject };-}--function setup() {- const request = vi.fn(async (): Promise<unknown> => undefined);- // 每次订阅返回独立的退订 spy:断言必须分清「哪次 start 装上的 listener 被拆了」。- const eventOffs: Array<ReturnType<typeof vi.fn>> = [];- const reconnectOffs: Array<ReturnType<typeof vi.fn>> = [];- const mgr = {- request,- onHostEvent: vi.fn(() => {- const off = vi.fn();- eventOffs.push(off);- return off;- }),- onHostConnected: vi.fn(() => {- const off = vi.fn();- reconnectOffs.push(off);- return off;- }),- } as unknown as RemoteFileBrowserManager;- return { registry: new RemoteWatchRegistry(mgr), request, eventOffs, reconnectOffs };-}--describe('RemoteWatchRegistry 失败清理', () => {- it('旧 watchStart 迟到失败不回收同 key 上的替换注册', async () => {- const { registry, request, eventOffs, reconnectOffs } = setup();- const win = makeWindow();- const first = deferred();- request.mockImplementationOnce(() => first.promise);-- const oldStart = registry.start(win, 'host-1', '/repo', { showIgnoredDirs: false }, vi.fn());- // 开关切换:先停旧注册,再用新选项装一份替换注册(同一 key)。- await registry.stop(win.id, 'host-1', '/repo');- await registry.start(win, 'host-1', '/repo', { showIgnoredDirs: true }, vi.fn());- expect(eventOffs).toHaveLength(2);-- first.reject(new Error('host unreachable'));- await expect(oldStart).rejects.toThrow('host unreachable');-- // 替换注册仍在册:stop 能拆掉它,并给 daemon 发 watchStop。- await registry.stop(win.id, 'host-1', '/repo');- expect(request).toHaveBeenCalledWith('host-1', 'watchStop', {- workdir: '/repo',- consumerId: 'desktop-tree',- });- // 旧注册自己装的那对 listener:stop 拆一次 + 迟到失败清理一次。- expect(eventOffs[0]).toHaveBeenCalledTimes(2);- expect(reconnectOffs[0]).toHaveBeenCalledTimes(2);- // 替换注册的那对:由最后的 stop 拆掉(旧 catch 不能替它做主)。- expect(eventOffs[1]).toHaveBeenCalledTimes(1);- expect(reconnectOffs[1]).toHaveBeenCalledTimes(1);- });-- it('启动失败且没有替换注册:注册被回收,后续 stop 是 no-op', async () => {- const { registry, request, eventOffs, reconnectOffs } = setup();- const win = makeWindow();- request.mockRejectedValueOnce(new Error('boom'));-- await expect(registry.start(win, 'host-1', '/repo', {}, vi.fn())).rejects.toThrow('boom');- expect(eventOffs[0]).toHaveBeenCalledTimes(1);- expect(reconnectOffs[0]).toHaveBeenCalledTimes(1);-- request.mockClear();- await registry.stop(win.id, 'host-1', '/repo');- expect(request).not.toHaveBeenCalled();- });-- /**- * 评审 P1:同 (host, workdir) 的多个窗口共用一个 consumerId,而 stop 侧有引用- * 计数(还有别窗在 watch 就不发 watchStop)。两个替换 start 同时失败时,本地- * 条目全被删、daemon 侧却会留着注册与重建出来的 watcher(没有客户端再 stop- * 它)。必须由**最后一个**失败者撤回。- */- it('同 workdir 两个窗口的 start 都失败:最后一个失败者撤回 daemon 注册', async () => {- const { registry, request } = setup();- const w1 = makeWindow(1);- const w2 = makeWindow(2);- const first = deferred();- const second = deferred();- request.mockImplementationOnce(() => first.promise);- request.mockImplementationOnce(() => second.promise);-- const start1 = registry.start(w1, 'host-1', '/repo', { showIgnoredDirs: true }, vi.fn());- const start2 = registry.start(w2, 'host-1', '/repo', { showIgnoredDirs: true }, vi.fn());-- // 先失败的窗口还看到另一个本地条目 → 不能撤(对方可能站起来)。- first.reject(new Error('boom-1'));- await expect(start1).rejects.toThrow('boom-1');- expect(request).not.toHaveBeenCalledWith('host-1', 'watchStop', expect.anything());-- // 最后一个失败者:本地再无同 (host, workdir) 条目 → 撤注册。- second.reject(new Error('boom-2'));- await expect(start2).rejects.toThrow('boom-2');- expect(request).toHaveBeenCalledWith('host-1', 'watchStop', {- workdir: '/repo',- consumerId: 'desktop-tree',- });- });-- /**- * 评审 P1:workdir 是合法 POSIX 路径,可以包含 `::`(如 `/srv/foo::bar`)。旧实现- * 把引用计数扫描建立在 `${windowId}::${hostId}::${workdir}` 的字符串拆分上 ——- * 拆分会把路径截断,于是认不出另一个窗口在看同一 workdir,停一个窗口会误发- * watchStop 把另一个也停掉。现在 hostId / workdir 结构化存在 entry 上。- */- it('workdir 含 :: 时引用计数仍准确:停一个窗口不误发 watchStop', async () => {- const { registry, request } = setup();- const w1 = makeWindow(1);- const w2 = makeWindow(2);- const workdir = '/srv/foo::bar';-- await registry.start(w1, 'host-1', workdir, {}, vi.fn());- await registry.start(w2, 'host-1', workdir, {}, vi.fn());- request.mockClear();-- await registry.stop(w1.id, 'host-1', workdir);- // 另一个窗口还在看 → 不能发 watchStop。- expect(request).not.toHaveBeenCalledWith('host-1', 'watchStop', expect.anything());-- await registry.stop(w2.id, 'host-1', workdir);- expect(request).toHaveBeenCalledWith('host-1', 'watchStop', {- workdir,- consumerId: 'desktop-tree',- });- });-});diff --git a/apps/desktop/src/main/file-browser/__tests__/watcher.test.ts b/apps/desktop/src/main/file-browser/__tests__/watcher.test.tsindex 5304cc96b0..f94b413194 100644--- a/apps/desktop/src/main/file-browser/__tests__/watcher.test.ts+++ b/apps/desktop/src/main/file-browser/__tests__/watcher.test.ts@@ -20,15 +20,10 @@ const h = vi.hoisted(() => ({matcherIgnores: vi.fn((_rel: string, _isDir: boolean) => false),}));-vi.mock('@cindy/file-browser-core', async (importOriginal) => {- const actual = await importOriginal<typeof import('@cindy/file-browser-core')>();- return {- XDT_TMP_SUFFIX: actual.XDT_TMP_SUFFIX,- // 预过滤名单的真名单(单源),loadIgnoreMatcher 太真(要读盘)才被替换。- WATCH_ALWAYS_IGNORE: actual.WATCH_ALWAYS_IGNORE,- loadIgnoreMatcher: vi.fn(async () => ({ ignores: h.matcherIgnores })),- };-});+vi.mock('@cindy/file-browser-core', () => ({+ XDT_TMP_SUFFIX: '.xdt-tmp',+ loadIgnoreMatcher: vi.fn(async () => ({ ignores: h.matcherIgnores })),+}));import { WatcherManager, type WatcherSubscribeFn } from '../watcher';import type { WatchedFsEvent } from '../../watcher-host/protocol';@@ -159,106 +154,6 @@ describe('WatcherManager stop 宽限期', () => {expect(subscribeFn).toHaveBeenCalledTimes(2);});- it('showIgnoredDirs 变化同样触发重建,相同则复用', async () => {- const { manager, subscribeFn, unsubscribe } = setup();- const win = makeWindow();- await manager.start(win, 'D:/repo', { showIgnoredDirs: false }, vi.fn());- // 同值重复 start:仍在宽限内,直接复用不重建。- await manager.start(win, 'D:/repo', { showIgnoredDirs: false }, vi.fn());- expect(subscribeFn).toHaveBeenCalledTimes(1);- expect(unsubscribe).not.toHaveBeenCalled();-- await manager.start(win, 'D:/repo', { showIgnoredDirs: true }, vi.fn());- expect(unsubscribe).toHaveBeenCalledTimes(1);- expect(subscribeFn).toHaveBeenCalledTimes(2);- });-- /**- * 预过滤名单的「时机」回归:parcel 的 ignore 只在 subscribe 那一刻生效一次。- * node_modules / Library 经常在会话开始后才出现(npm install / Unity 导入),- * 当时不存在就漏掉 → 开关打开后这些目录被 matcher 放行,内部每个生成路径都- * 变成一条事件推过 watcher-host + IPC。ALWAYS 名单必须无条件注册。- */- it('ALWAYS 目录当前不存在也进 ignore 名单(开关打开时)', async () => {- const { manager, calls } = setup();- const workdir = path.join(path.sep, 'no-such-workdir-reveal');- await manager.start(makeWindow(), workdir, { showIgnoredDirs: true }, vi.fn());- expect(calls[0].ignore).toEqual(- expect.arrayContaining([- '**/[nN][oO][dD][eE]_[mM][oO][dD][uU][lL][eE][sS]/*',- '**/[nN][oO][dD][eE]_[mM][oO][dD][uU][lL][eE][sS]/**/*',- '**/[lL][iI][bB][rR][aA][rR][yY]/*',- '**/[lL][iI][bB][rR][aA][rR][yY]/**/*',- '**/.[gG][iI][tT]/*',- '**/.[gG][iI][tT]/**/*',- ]),- );- // 开关打开时 REVEALABLE 不预过滤 —— 它们本来就该推事件。- expect(calls[0].ignore).not.toContain('**/[dD][iI][sS][tT]/*');- });-- it('开关关闭时同样无条件带上 ALWAYS(目录稍后才出现也不漏)', async () => {- const { manager, calls } = setup();- const workdir = path.join(path.sep, 'no-such-workdir-hidden');- await manager.start(makeWindow(), workdir, { showIgnoredDirs: false }, vi.fn());- expect(calls[0].ignore).toEqual(- expect.arrayContaining([- '**/[nN][oO][dD][eE]_[mM][oO][dD][uU][lL][eE][sS]/*',- '**/[nN][oO][dD][eE]_[mM][oO][dD][uU][lL][eE][sS]/**/*',- '**/[lL][iI][bB][rR][aA][rR][yY]/*',- '**/[lL][iI][bB][rR][aA][rR][yY]/**/*',- '**/[dD][iI][sS][tT]/*',- '**/[dD][iI][sS][tT]/**/*',- ]),- );- });-- /**- * 预过滤名单的形态回归:两个约束必须同时成立。- * 1. 层级:必须发 glob,不能发根级绝对路径 —— @parcel/watcher 对非 glob 项- * 走 `ignorePaths` 前缀比较,`nested/node_modules/x` 不是- * `/workdir/node_modules` 的后代,monorepo / 嵌套 Unity 工程整目录漏过去。- * 2. 自身:`**\/<name>/**` 会把**目录自身**的事件也吞掉(探针实测 2.5.6/win32:- * mkdir node_modules 一条事件都没有),开关打开时新建 / 删除 / 改名都看不到。- * 拆成一级内容与深层内容两条形态(目录自身不匹配)后,事件保留、- * 两级内容仍都忽略。- */- it('预过滤用 glob 覆盖任意层级,且不吞目录自身事件', async () => {- const { manager, calls } = setup();- await manager.start(makeWindow(), 'D:/repo', { showIgnoredDirs: false }, vi.fn());- expect(calls[0].ignore).toContain('**/[nN][oO][dD][eE]_[mM][oO][dD][uU][lL][eE][sS]/*');- expect(calls[0].ignore).toContain('**/[nN][oO][dD][eE]_[mM][oO][dD][uU][lL][eE][sS]/**/*');- expect(calls[0].ignore).toContain('**/[lL][iI][bB][rR][aA][rR][yY]/*');- expect(calls[0].ignore).toContain('**/[lL][iI][bB][rR][aA][rR][yY]/**/*');- // 旧形态(吞目录自身事件)不得回潮。- expect(calls[0].ignore).not.toContain('**/node_modules/**');- expect(calls[0].ignore).not.toContain(path.join('D:/repo', 'node_modules'));- });-- /**- * 评审 P1(PR #4398 轮八):parcel 的 ignore glob 走 picomatch 默认选项- * (`@parcel/watcher/wrapper.js` 只传 `dot` / `windows`,**无 nocase**),而- * matcher 用的 `ignore` 包默认 `ignorecase=true` —— 大小写不敏感卷上- * `NODE_MODULES` / `Library` 与名单同名,matcher 判忽略、预过滤却匹配不到:- * 开关打开时这些目录被 matcher 放行,整棵依赖树的事件都会推过 watcher-host + IPC。- * 名字段必须折叠大小写(字符类),区分大小写的原名形态不得回潮。- */- it('预过滤 glob 折叠大小写:变体目录名同样命中', async () => {- const { manager, calls } = setup();- await manager.start(makeWindow(), 'D:/repo', { showIgnoredDirs: true }, vi.fn());- const ignore = calls[0].ignore;- for (const name of [- '[nN][oO][dD][eE]_[mM][oO][dD][uU][lL][eE][sS]',- '[lL][iI][bB][rR][aA][rR][yY]',- ]) {- expect(ignore).toContain(`**/${name}/*`);- expect(ignore).toContain(`**/${name}/**/*`);- }- // 区分大小写的原名形态不得回潮(大小写不敏感卷上会漏掉变体目录)。- expect(ignore).not.toContain('**/node_modules/*');- expect(ignore).not.toContain('**/Library/*');- });-it('不同 window 同 workdir 互不干扰(key 维度 window×workdir)', async () => {const { manager, subscribeFn, unsubscribe } = setup();await manager.start(makeWindow(1), 'D:/repo', {}, vi.fn());diff --git a/apps/desktop/src/main/file-browser/device-op.ts b/apps/desktop/src/main/file-browser/device-op.tsindex 50387861d1..781748df2a 100644--- a/apps/desktop/src/main/file-browser/device-op.ts+++ b/apps/desktop/src/main/file-browser/device-op.ts@@ -58,7 +58,6 @@ import {parseFsWatchTopic,type PushOwnerStamp,} from '@cindy/device-link';-import { REVEALABLE_IGNORE_DIR_NAMES } from '../../shared/ignoreNames';import { WorkdirWatchManager } from '@cindy/remote-file-service';import type { FsRpcMethods } from '@cindy/remote-file-service/protocol';@@ -169,13 +168,6 @@ interface RemoteOpArgs {includeIgnored?: boolean;maxEntries?: number;docMode?: boolean;- /**- * 「显示被忽略的目录」开关(控制端下发的视图偏好)。listDir 生效;- * device-link 的 watch 不走本 op(控制端订阅 topic 触发),那边仍是- * hideMetaFiles:true 的默认过滤 —— 打开开关后这些目录在被控端可见,- * 但内部改动不会有实时事件(手动刷新可见)。- */- showIgnoredDirs?: boolean;cap?: number;query?: string;caseSensitive?: boolean;@@ -429,16 +421,11 @@ async function handleRemoteOp(args: RemoteOpArgs): Promise<unknown> {: null;// 能力探测:与 workdir 无关、零 fs 访问,放在 guard 之前。老被控端没有// 这个分支,会走到 default 返回 `unknown op: caps`——控制端把它当确定性- // 的"能力全无"信号(见 fileBrowserTransport 的 caps 缓存)。- //- // gzip / completeDirectoryListing / fileRead:上游已落地的能力位;- // showIgnoredDirs:listDir 支持「显示被忽略的目录」开关(控制端据此决定- // 标题行的开关是可点还是禁用+升级提示;老端会静默忽略该字段)。+ // 的"不支持压缩"信号(见 fileBrowserTransport 的 caps 缓存)。if (args.op === 'caps') {return {ok: true as const,gzip: true as const,- showIgnoredDirs: true as const,completeDirectoryListing: true as const,fileRead: true as const,dirExport: true as const,@@ -540,7 +527,6 @@ async function handleRemoteOp(args: RemoteOpArgs): Promise<unknown> {relPath: args.relPath ?? '',hideMetaFiles: args.hideMetaFiles ?? true,docMode: args.docMode,- showIgnoredDirs: args.showIgnoredDirs === true,includeIgnored: args.includeIgnored,maxEntries: args.maxEntries,});@@ -642,15 +628,12 @@ async function handleRemoteOp(args: RemoteOpArgs): Promise<unknown> {return { ok: true, url: url.toString(), size: st.size, mtimeMs: st.mtimeMs };}case 'listDir': {- // includeIgnored 是完全绕过展示过滤(手机 HTML 快照枚举用);- // showIgnoredDirs 只放行可放行层(依赖 / 构建产物 / 缓存),VCS / OS 垃圾仍隐藏。const matcher =args.includeIgnored === true? null: await loadIgnoreMatcher(workdir, {hideMetaFiles: args.hideMetaFiles ?? true,honorVcsIgnore: false,- showIgnoredDirs: args.showIgnoredDirs === true,});return listDir(workdir, args.relPath ?? '', matcher, {docMode: args.includeIgnored === true ? false : args.docMode,@@ -917,27 +900,6 @@ async function startFsWatchIfDesired(workdir: string): Promise<void> {}}-/** relPath 是否落在「隐藏态不可见、只有开着『显示被忽略的目录』才看得见」的- * 目录**内部**。用于 device-link 转发前按自己的可见性过滤 daemon 的并集事件流。- *- * 只判**祖先段**:忽略名单是**目录**规则,同名普通文件(`dist` / `build` /- * `.cache` 这种没有扩展名的构建脚本、配置文件)在 listDir 里是照常显示的 ——- * 把叶子段也判进去会让这些文件的 add/change/unlink 事件被丢掉,行陈旧到手动- * 刷新(评审 P1)。- *- * 代价:被忽略目录**自身**的事件(`relPath='node_modules'`)也会转发给隐藏态- * 客户端。事件流不携带类型、同名普通文件必须放行,两者无法从路径区分;转发后- * 在隐藏态树里是 no-op(该目录不在 entries),只是每次目录级变更多一条无效 IPC。- * 这层本来就是粗粒度预过滤,精确判据在 renderer(queueEventRefresh)。- *- * 段比较折叠大小写:matcher 用的 `ignore` 包默认 `ignorecase=true`(大小写不敏感- * 卷上 `DIST` 与 `dist` 是同一个目录),不折叠会把变体目录内部的事件继续推过- * relay(评审 P2)。 */-function isInsideRevealableIgnoreDir(relPath: string): boolean {- const segments = relPath.split('/');- return segments.slice(0, -1).some((segment) => REVEALABLE_IGNORE_DIR_NAMES.has(segment.toLowerCase()));-}-function scheduleFsWatchReconcile(workdir: string): void {const timer = setTimeout(() => {// timer 排队后可能再次 release;reconcile 只消费当前意图,绝不重新@@ -1019,18 +981,9 @@ async function onFsWatchSubscribedInner(workdir: string, token: symbol): Promiseconst hostId = exec.hostId;const offEvent = mgr.onHostEvent(hostId, (evt) => {if (evt.event !== 'fileTree') return;- const data = evt.data as { workdir: string; relPath?: string };+ const data = evt.data as { workdir: string };if (data.workdir !== workdir) return;if (!fsWatchDesired.has(workdir)) return;- // device-link 订阅的是**隐藏态**视图,而 daemon 侧的 watcher 用的是与 desktop- // 文件树(可能开着「显示被忽略的目录」)并集后的 matcher —— dist / build / Temp- // 这类目录内部的事件也会发过来。不在这里按 device-link 自己的可见性再滤一道,- // 一次构建就会把成千上万条控制器根本不会显示的事件推过共享 relay(聚合背压- // → 断连)(评审 P1)。- // 注:恒真忽略(BUILTIN_IGNORE_ALWAYS)与「不 watch 内部」(node_modules /- // Library)两层 daemon 自己就不发;`.gitignore` 自定义条目要在 daemon 侧才有- // matcher,这里判不了,不在本层职责。- if (typeof data.relPath === 'string' && isInsideRevealableIgnoreDir(data.relPath)) return;pushToTopicSubscribers(FILE_BROWSER_EVENT_CHANNEL, evt.data, ownerStamp);});let listenersDisposed = false;@@ -1043,9 +996,7 @@ async function onFsWatchSubscribedInner(workdir: string, token: symbol): Promise};const stopWatch = (): void => {disposeListeners();- void mgr- .request(hostId, 'watchStop', { workdir, consumerId: 'device-link' })- .catch(() => undefined);+ void mgr.request(hostId, 'watchStop', { workdir }).catch(() => undefined);};const isRegistered = (): boolean => sshWatchOffs.get(workdir) === stopWatch;const disposeStaleWatch = (): void => {@@ -1076,14 +1027,7 @@ async function onFsWatchSubscribedInner(workdir: string, token: symbol): Promisereturn false;}try {- // consumerId:daemon 把这里的隐藏态需求与 desktop 文件树(可能开着「显示- // 被忽略的目录」)的需求分开登记、取可见性并集 —— 否则后到的一方会把对方- // 的 matcher 覆盖掉,desktop 仍列着 build / dist 却收不到它们的事件。- await mgr.request(hostId, 'watchStart', {- workdir,- hideMetaFiles: true,- consumerId: 'device-link',- });+ await mgr.request(hostId, 'watchStart', { workdir, hideMetaFiles: true });} catch (err) {if (!isCurrent()) disposeStaleWatch();throw err;diff --git a/apps/desktop/src/main/file-browser/index.ts b/apps/desktop/src/main/file-browser/index.tsindex 1796b0375a..bb80994d92 100644--- a/apps/desktop/src/main/file-browser/index.ts+++ b/apps/desktop/src/main/file-browser/index.ts@@ -144,8 +144,6 @@ interface ListDirArgs extends RemoteRoutedArgs {hideMetaFiles?: boolean;/** Doc mode: only `.md` files + dirs that contain `.md` descendants. */docMode?: boolean;- /** 用户开关「显示被忽略的目录」——列出依赖 / 构建产物 / 缓存目录。默认 false。 */- showIgnoredDirs?: boolean;}interface ReadFileArgs extends RemoteRoutedArgs {@@ -178,8 +176,6 @@ interface StatArgs extends RemoteRoutedArgs {interface WatchArgs extends RemoteRoutedArgs {workdir: string;hideMetaFiles?: boolean;- /** 与 listDir 同源:开关变了要带新 matcher 重建 watcher。 */- showIgnoredDirs?: boolean;}/**@@ -782,7 +778,6 @@ export function registerFileBrowserIpc(): void {hideMetaFiles: args.hideMetaFiles ?? true,docMode: args.docMode,includeIgnored: args.includeIgnored,- showIgnoredDirs: args.showIgnoredDirs === true,});return entries;} catch (err) {@@ -790,15 +785,12 @@ export function registerFileBrowserIpc(): void {throwRemoteFsIpcError(err);}}- // includeIgnored 是完全绕过展示过滤(手机 HTML 快照枚举用);showIgnoredDirs- // 只放行可放行层(依赖 / 构建产物 / 缓存),VCS / OS 垃圾仍隐藏。前者优先。const matcher =args.includeIgnored === true? null: await loadIgnoreMatcher(args.workdir, {hideMetaFiles: args.hideMetaFiles ?? true,honorVcsIgnore: false,- showIgnoredDirs: args.showIgnoredDirs === true,});return listDir(args.workdir, args.relPath ?? '', matcher, {docMode: args.includeIgnored === true ? false : args.docMode,@@ -982,7 +974,7 @@ export function registerFileBrowserIpc(): void {window,args.remoteHostId,args.workdir,- { hideMetaFiles: args.hideMetaFiles ?? true, showIgnoredDirs: args.showIgnoredDirs === true },+ { hideMetaFiles: args.hideMetaFiles ?? true },(fsEvent) => {if (window.isDestroyed()) return;window.webContents.send(FILE_BROWSER_PUSH.EVENT, fsEvent);@@ -996,7 +988,7 @@ export function registerFileBrowserIpc(): void {await watcherManager.start(window,args.workdir,- { hideMetaFiles: args.hideMetaFiles ?? true, showIgnoredDirs: args.showIgnoredDirs === true },+ { hideMetaFiles: args.hideMetaFiles ?? true },(fsEvent: FileTreeEvent) => {if (window.isDestroyed()) return;window.webContents.send(FILE_BROWSER_PUSH.EVENT, fsEvent);diff --git a/apps/desktop/src/main/file-browser/remote-watch.ts b/apps/desktop/src/main/file-browser/remote-watch.tsindex 4bda42a8c1..0292d7c200 100644--- a/apps/desktop/src/main/file-browser/remote-watch.ts+++ b/apps/desktop/src/main/file-browser/remote-watch.ts@@ -21,20 +21,7 @@ import type { FileTreeEvent } from './watcher.js';const log = createLogger('file-browser/remote-watch');-/**- * daemon 侧的消费者身份。同一 (host, workdir) 会被 device-link 的 fs-watch 同时- * 订阅(被控端把它转发给控制端);两边各自登记过滤需求,daemon 取可见性并集,- * 而不是后到的 watchStart 把先到的 matcher 覆盖掉。- */-const WATCH_CONSUMER_ID = 'desktop-tree';-interface RegistryEntry {- /** 结构化保存 host / workdir:引用计数扫描不再拆 `${windowId}::${host}::${workdir}`- * —— workdir 里合法出现 `::` 时(如 `/srv/foo::bar`),拆分会截断路径,扫描就- * 认不出另一个窗口在看同一 workdir,停一个窗口会误发 watchStop 把另一个也停掉- * (评审 P1)。 */- hostId: string;- workdir: string;offEvent: () => void;offReconnect: () => void;}@@ -56,21 +43,12 @@ export class RemoteWatchRegistry {window: BrowserWindow,hostId: string,workdir: string,- opts: { hideMetaFiles?: boolean; showIgnoredDirs?: boolean },+ opts: { hideMetaFiles?: boolean },onEvent: (event: FileTreeEvent) => void,): Promise<void> {const k = this.key(window.id, hostId, workdir);if (this.entries.has(k)) return;- // daemon 侧 watchStart 拿的是同一组过滤开关:开关变了由 renderer 的 store- // 重建驱动 stop→start(daemon 自身也会在选项变化时重建 matcher)。- const watchOpts = {- workdir,- hideMetaFiles: opts.hideMetaFiles ?? true,- showIgnoredDirs: opts.showIgnoredDirs === true,- consumerId: WATCH_CONSUMER_ID,- };-const offEvent = this.mgr.onHostEvent(hostId, (evt) => {if (evt.event !== 'fileTree') return;const data = evt.data as FileTreeEvent;@@ -81,46 +59,26 @@ export class RemoteWatchRegistry {// daemon 断链重建后 watch 状态随进程消失;重连成功即重放 watchStart。const offReconnect = this.mgr.onHostConnected(hostId, () => {void this.mgr- .request(hostId, 'watchStart', watchOpts)+ .request(hostId, 'watchStart', { workdir, hideMetaFiles: opts.hideMetaFiles ?? true }).catch((err) => log.warn('watch replay failed', { hostId, workdir, error: String(err) }));});- const entry: RegistryEntry = { hostId, workdir, offEvent, offReconnect };- this.entries.set(k, entry);+ this.entries.set(k, { offEvent, offReconnect });window.once('closed', () => {void this.stop(window.id, hostId, workdir);});try {- await this.mgr.request(hostId, 'watchStart', watchOpts);+ await this.mgr.request(hostId, 'watchStart', {+ workdir,+ hideMetaFiles: opts.hideMetaFiles ?? true,+ });log.info('remote watch started', { hostId, workdir, windowId: window.id });} catch (err) {- // 启动失败(host 不可达等):清掉本次注册,renderer 靠聚焦刷新兜底。- //- // 只回收**本次 start 装上的那条**:切「显示被忽略的目录」会在同一个 key- // 上 stop→start,而两个 RPC 都是异步的。旧 start 若在新 start 装上替换- // 注册之后才 reject,无条件 delete 会把新注册变成孤儿 —— 之后 stop() 直接- // 提前返回,新注册的事件/重连 listener 泄漏,daemon 侧 watch 也不会停,- // 反复切换会累积重复订阅。- if (this.entries.get(k) === entry) this.entries.delete(k);+ // 启动失败(host 不可达等):清掉注册,renderer 靠聚焦刷新兜底。+ this.entries.delete(k);offEvent();offReconnect();- // 本地最后一个订阅者也没能站起来:撤回 daemon 侧的 consumer 注册。- //- // 为什么必须补这一发:同 (host, workdir) 的多个窗口共用一个 consumerId,- // 而 stop 侧有引用计数(还有别窗在 watch 就不发 watchStop)。两个替换 start- // 同时失败时,本地条目全被删、daemon 侧却留着注册与重建出来的 watcher ——- // 没有任何客户端再去 stop 它(评审 P1),它还会抬高 device-link 的可见性- // 并集。只在确认本地再无同 (host, workdir) 条目时才发:还有别的窗口在- // watch(或它的 start 正在飞,条目已先入表)时不能撤。- const stillLocal = [...this.entries.values()].some(- (e) => e.hostId === hostId && e.workdir === workdir,- );- if (!stillLocal) {- void this.mgr- .request(hostId, 'watchStop', { workdir, consumerId: WATCH_CONSUMER_ID })- .catch(() => undefined);- }throw err;}}@@ -134,12 +92,13 @@ export class RemoteWatchRegistry {entry.offReconnect();// 同 host 其它 window/workdir 还在 watch 时不能全局 watchStop;仅当这是该// (host, workdir) 的最后一个订阅者才让 daemon 停 watch。- const stillWatching = [...this.entries.values()].some(- (e) => e.hostId === hostId && e.workdir === workdir,- );+ const stillWatching = [...this.entries.keys()].some((key) => {+ const [, h, w] = key.split('::');+ return h === hostId && w === workdir;+ });if (!stillWatching) {await this.mgr- .request(hostId, 'watchStop', { workdir, consumerId: WATCH_CONSUMER_ID })+ .request(hostId, 'watchStop', { workdir }).catch(() => undefined); // 通道断了 daemon 也没了,无孤儿}log.info('remote watch stopped', { hostId, workdir, windowId });diff --git a/apps/desktop/src/main/file-browser/watcher.ts b/apps/desktop/src/main/file-browser/watcher.tsindex d0e4b3df57..c85478fc5a 100644--- a/apps/desktop/src/main/file-browser/watcher.ts+++ b/apps/desktop/src/main/file-browser/watcher.ts@@ -28,26 +28,16 @@* 复杂 glob (e.g. *.log, build-*) — 与 listDir 路径共享同一份 matcher* 保证一致性。*- * 与「显示被忽略的目录」(showIgnoredDirs)开关的关系:开关控制的是**是否把内置- * 隐藏目录当普通目录对待**。打开后 matcher 不再躲藏 dist / build / Temp 这类目录,- * 并且第 1 层预过滤也只保留 PREFILTER_ALWAYS(依赖与 Unity 资源缓存:原生 watch- * 这些目录的代价是另一个量级,而且没有实时性需求)—— 即开关打开后,绝大部分被- * 忽略目录里的改动会推事件;只有 node_modules / Library 内部仍不推。- ** Event mapping: parcel's create/update/delete → 旧的 add/change/unlink。* 下游 (useFileTree / useFileContent) 不区分 file vs dir, 所以 'addDir' /* 'unlinkDir' 这两个旧 type 保留在 union 里但不再发出。*/import path from 'node:path';+import * as fs from 'node:fs';import type { BrowserWindow } from 'electron';-import {- loadIgnoreMatcher,- WATCH_ALWAYS_IGNORE,- XDT_TMP_SUFFIX,- type Matcher,-} from '@cindy/file-browser-core';+import { loadIgnoreMatcher, XDT_TMP_SUFFIX, type Matcher } from '@cindy/file-browser-core';import { createLogger } from '../logger.js';import type { WatchedFsEvent } from '../watcher-host/protocol.js';@@ -102,8 +92,6 @@ interface WatcherEntry {handle: WatcherHostSubscription | null;matcher: Matcher;hideMetaFiles: boolean;- /** 建订阅时生效的「显示被忽略的目录」开关;变了走完整重建。 */- showIgnoredDirs: boolean;/*** 间接引用:订阅回调通过此字段路由事件,宽限期复活时 start() 更新引用* 即可让新组件实例收到事件,无需触碰 native 订阅。@@ -117,23 +105,17 @@ interface WatcherEntry {/*** 预过滤目录 — 这些目录名一旦出现在路径里, OS watcher 直接跳过,不再向- * callback 推任何事件。和 ignore.ts 的 BUILTIN_IGNORE 思路一致。比靠- * callback 内过滤省一次 IPC + 一次 matcher 调用。+ * callback 推任何事件。和 ignore.ts 的 BUILTIN_IGNORE 思路一致, 但 parcel+ * 的 ignore 接受的是路径(不是 glob), 所以这里用绝对路径 + 工作区内常见命中+ * 位置一次性穷举。比靠 callback 内过滤省一次 IPC + 一次 matcher 调用。** 注意: 这里只剪"目录名命中" 的 case; *.log / build-* 这种 glob 仍由* callback 内的 matcher 兜底。- *- * ALWAYS 是"即使开关打开也不看"的目录:.git 与 OS 垃圾之外,只有- * node_modules / Library —— 它们要么条目数十万、要么需要真正的依赖分析,- * 原生递归 watch 的代价与收益不成比例(开关打开时它们会出现在文件树里,但- * 内部改动不推事件,手动刷新可见)。其余目录随「显示被忽略的目录」放行。- *- * node_modules / Library 的名单单源在 file-browser-core 的 WATCH_ALWAYS_IGNORE- * ——远端 daemon 的事件过滤吃同一份,两侧不会各自漂移。*/-const PREFILTER_ALWAYS: string[] = ['.git', '.svn', '.hg', ...WATCH_ALWAYS_IGNORE];--const PREFILTER_REVEALABLE = [+const PREFILTER_DIRS = [+ '.git',+ 'node_modules',+ 'Library', // Unity'Temp', // Unity'Logs', // Unity'obj', // .NET@@ -147,54 +129,19 @@ const PREFILTER_REVEALABLE = [];/**- * 名单 → parcel ignore glob。- *- * @parcel/watcher 的 ignore 数组吃两种形态:非 glob 走 `ignorePaths`(相对- * workdir resolve 成绝对路径,**前缀**比较),glob 走 picomatch 正则。前缀形态- * 只认“工作区根下直接命中”—— 实测(2.5.6, win32)`nested/node_modules/x` 不是- * `/workdir/node_modules` 的后代,一条事件都拦不住,monorepo- * (`packages/foo/node_modules`)与嵌套 Unity 工程(`client/Library`)全量漏过去。- * 所以统一发 glob。- *- * 每个目录发**两条**`**\/<name>/*` 与 `**\/<name>/**\/*`,而不是一条- * `**\/<name>/**` —— 后者把**目录自身**的事件也吞掉(实测:mkdir node_modules- * 一条事件都没有),于是开关打开时新建 / 删除 / 改名 node_modules / Library 都- * 不会让 renderer refetch 父目录,那一行缺失或陈旧到手动刷新(评审 P1;daemon- * 侧同一裁决见 watch.ts 的 isInsideAlwaysIgnoredDir)。两条形态下:目录自身不- * 匹配 → 事件保留;一级与深层内容都匹配 → 仍不监听(也不会进入子目录)。- *- * 将来名单里若出现**文件**项(如 .DS_Store),要另发不带后缀的 `**\/<name>`- * —— 文件没有“内部”,套用同一对形态会让它自己漏出去。- *- * 名字段展开为**大小写不敏感**的字符类(`[nN][oO]...`):parcel 内部走- * `picomatch.makeRe(value, { dot, windows })`,**没有 nocase** —— glob 区分大小写;- * 而 matcher 用的 `ignore` 包默认 ignorecase=true。大小写不敏感卷上 `NODE_MODULES` /- * `Library` 与名单同名、matcher 判定为忽略,预过滤却匹配不到:开关打开时这些目录被- * matcher 放行,整棵依赖树的每个事件都会一路推过 watcher-host + IPC(评审 P1)。+ * 把 PREFILTER_DIRS 展成"工作区根下直接命中"的绝对路径列表 (parcel 的+ * ignore 选项要求路径而非 glob)。子目录里同名目录(e.g. nested+ * node_modules) parcel 会自己沿父链判断 — 它内部用前缀匹配。*/-const caseInsensitiveName = (name: string): string =>- [...name]- .map((ch) => (/[A-Za-z]/.test(ch) ? `[${ch.toLowerCase()}${ch.toUpperCase()}]` : ch))- .join('');--const ignoreGlobsForDirs = (names: readonly string[]): string[] =>- names.flatMap((name) => {- const dir = caseInsensitiveName(name);- return [`**/${dir}/*`, `**/${dir}/**/*`];- });--function buildIgnoreList(opts: { showIgnoredDirs: boolean }): string[] {- // ALWAYS 名单**无条件注册**,不做存在性探测:parcel 的 ignore 只在- // subscribe 那一刻生效一次,而 node_modules / Library 常常在会话开始后才出现- // (npm install / Unity 导入)。当时不存在就漏掉,就再也没有第二次机会 ——- // 开关打开时这些目录被 matcher 放行,目录里每个生成路径都会一路推过- // watcher-host + IPC。glob 不存在的目录只是永不命中,无副作用。- const always = ignoreGlobsForDirs(PREFILTER_ALWAYS);- // REVEALABLE 只在开关关闭时预过滤:开关打开后它们本来就该推事件;关闭时- // 即使漏掉预过滤,callback 里的 matcher 也会拦下(代价只是多一次 IPC)。- return opts.showIgnoredDirs- ? always- : [...always, ...ignoreGlobsForDirs(PREFILTER_REVEALABLE)];+function buildIgnoreList(workdir: string): string[] {+ const out: string[] = [];+ for (const dir of PREFILTER_DIRS) {+ const abs = path.join(workdir, dir);+ // 不存在的目录传给 parcel 也无害, 但既然遍历是 sync stat 一下省得 native+ // 层处理无效路径。+ if (fs.existsSync(abs)) out.push(abs);+ }+ return out;}/**@@ -245,12 +192,11 @@ export class WatcherManager {async start(window: BrowserWindow,workdir: string,- opts: { hideMetaFiles?: boolean; showIgnoredDirs?: boolean },+ opts: { hideMetaFiles?: boolean },onEvent: (event: FileTreeEvent) => void,): Promise<void> {const k = this.key(window.id, workdir);const hideMetaFiles = opts.hideMetaFiles ?? true;- const showIgnoredDirs = opts.showIgnoredDirs === true;await this.enqueue(k, async () => {const existing = this.entries.get(k);if (existing) {@@ -265,16 +211,13 @@ export class WatcherManager {// 不同的 onEvent 上下文(如不同组件实例);通过 entry.onEvent 间接路由保证// 新调用方能收到后续事件。existing.onEvent = onEvent;- if (- existing.hideMetaFiles === hideMetaFiles &&- existing.showIgnoredDirs === showIgnoredDirs- ) {+ if (existing.hideMetaFiles === hideMetaFiles) {return;}// 过滤选项变了:走完整重建(先拆后建,串行链保证不交错)await this.doStop(k, { onlyIfScheduled: false });}- await this.doStart(window, workdir, k, hideMetaFiles, showIgnoredDirs, onEvent);+ await this.doStart(window, workdir, k, hideMetaFiles, onEvent);});}@@ -312,25 +255,19 @@ export class WatcherManager {workdir: string,k: string,hideMetaFiles: boolean,- showIgnoredDirs: boolean,onEvent: (event: FileTreeEvent) => void,): Promise<void> {if (this.entries.has(k)) {log.debug(`watcher already running for ${k}`);return;}- const matcher = await loadIgnoreMatcher(workdir, {- hideMetaFiles,- honorVcsIgnore: false,- showIgnoredDirs,- });- const ignore = buildIgnoreList({ showIgnoredDirs });+ const matcher = await loadIgnoreMatcher(workdir, { hideMetaFiles, honorVcsIgnore: false });+ const ignore = buildIgnoreList(workdir);const entry: WatcherEntry = {handle: null,matcher,hideMetaFiles,- showIgnoredDirs,onEvent,state: 'active',graceTimer: null,diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.tsindex 6fcbadc82c..8410ab1f24 100644--- a/apps/desktop/src/preload/preload.ts+++ b/apps/desktop/src/preload/preload.ts@@ -2895,8 +2895,6 @@ contextBridge.exposeInMainWorld('electronAPI', {relPath?: string;hideMetaFiles?: boolean;docMode?: boolean;- /** 「显示被忽略的目录」——列出依赖 / 构建产物 / 缓存目录。默认 false。 */- showIgnoredDirs?: boolean;}): Promise<Array<{name: string;@@ -3002,8 +3000,6 @@ contextBridge.exposeInMainWorld('electronAPI', {remoteHostId?: string | null;workdir: string;hideMetaFiles?: boolean;- /** 与 listDir 同源:开关变了要带新 matcher 重建 watcher。 */- showIgnoredDirs?: boolean;}): Promise<{ ok: boolean }> => ipcRenderer.invoke('maker:file-browser:start-watch', params),stopWatch: (params: {remoteHostId?: string | null;diff --git a/apps/desktop/src/renderer/__tests__/fileBrowserTransportRevealCaps.test.ts b/apps/desktop/src/renderer/__tests__/fileBrowserTransportRevealCaps.test.tsdeleted file mode 100644index 607ddf1cdd..0000000000--- a/apps/desktop/src/renderer/__tests__/fileBrowserTransportRevealCaps.test.ts+++ /dev/null@@ -1,172 +0,0 @@-/**- * fileBrowserTransport —— 「显示被忽略的目录」能力探测的三态语义。- *- * 这条链路的错误分类直接决定用户看到什么:- * - 确定性不支持(老被控端没有 remote-op channel)→ false → 标题行开关按- * 不可用呈现并说明原因;- * - 瞬态失败(隧道不可达 / 重连中)→ **null**,不能落定成 false —— 否则一次- * 网络抖动就被显示成「对方版本过旧」,连接恢复后也不会自愈。- *- * 缓存语义同时被锁住:只缓存肯定结论 true;「不支持」不留在缓存里(被控端可能在- * 一次掉线期间升级),瞬态更不缓存。- *- * window.electronAPI 用 vi.stubGlobal 注入(node 环境,无 jsdom)。- */--import { afterEach, describe, expect, it, vi } from 'vitest';--type InvokeMock = ReturnType<typeof vi.fn>;--let invokeMock: InvokeMock;-let transport: typeof import('../lib/fileBrowserTransport');-/** 模块级 reconnect 订阅注册进来的回调:测试用它们模拟「没有任何 hook 观察」期间的重连。 */-let presenceCallbacks: Array<(snapshot: { deviceId: string; online: boolean }) => void>;-let statusCallbacks: Array<(payload: { status: string }) => void>;--/**- * 显式重启边界(非 hook):每个用例开头调用,拿到一份全新的 transport 模块。- * fileBrowserTransport 的模块级重连代次、订阅标志与 per-deviceId 探测缓存均无- * prod 重置入口,只能靠重启模块隔离跨用例残留;放在 beforeEach 里属于「hook- * 重载模块」(无论写什么理由都被 test-hygiene 禁止),所以收拢到这里由用例- * 显式调用。- */-async function freshTransport(): Promise<void> {- // reset-modules: 按用例隔离模块级重连代次、订阅标志与探测缓存- vi.resetModules();- invokeMock = vi.fn();- presenceCallbacks = [];- statusCallbacks = [];- vi.stubGlobal('window', {- electronAPI: {- deviceLink: {- invoke: invokeMock,- onPresenceChanged: (cb: (snapshot: { deviceId: string; online: boolean }) => void) => {- presenceCallbacks.push(cb);- return () => {- const index = presenceCallbacks.indexOf(cb);- if (index >= 0) presenceCallbacks.splice(index, 1);- };- },- onStatusChanged: (cb: (payload: { status: string }) => void) => {- statusCallbacks.push(cb);- return () => {- const index = statusCallbacks.indexOf(cb);- if (index >= 0) statusCallbacks.splice(index, 1);- };- },- },- },- });- transport = await import('../lib/fileBrowserTransport');-}--afterEach(() => {- vi.unstubAllGlobals();-});--// 探测缓存是模块级 per-deviceId,单测用唯一 deviceId 隔离。-let seq = 0;-const freshDevice = () => `reveal-${Date.now().toString(36)}-${seq++}`;--describe('deviceSupportsRevealIgnoredDirs', () => {- it('新被控端:true,并缓存(不重复探测)', async () => {- await freshTransport();- const deviceId = freshDevice();- invokeMock.mockResolvedValue({ ok: true, gzip: true, showIgnoredDirs: true });-- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(true);- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(true);- expect(invokeMock).toHaveBeenCalledTimes(1);- // 探测走 caps op,与 workdir 无关。- expect(invokeMock.mock.calls[0][2][0]).toMatchObject({ op: 'caps' });- });-- it('老被控端(caps 返回 unknown op):false,且不缓存(升级后重连能自愈)', async () => {- await freshTransport();- const deviceId = freshDevice();- invokeMock.mockResolvedValue({ ok: false, message: 'unknown op: caps' });-- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(false);- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(false);- expect(invokeMock).toHaveBeenCalledTimes(2);-- // 被控端升级后重连:同一 deviceId 重探必须拿到新结论。- invokeMock.mockResolvedValue({ ok: true, showIgnoredDirs: true });- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(true);- expect(invokeMock).toHaveBeenCalledTimes(3);- });-- it('caps 有响应但没带能力位(中间版本):false', async () => {- await freshTransport();- const deviceId = freshDevice();- invokeMock.mockResolvedValue({ ok: true, gzip: true });-- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(false);- });-- it('老端无 remote-op channel(CHANNEL_NOT_ALLOWED):确定性 false', async () => {- await freshTransport();- const deviceId = freshDevice();- invokeMock.mockRejectedValue(new Error('DEVICE_LINK_CHANNEL_NOT_ALLOWED'));-- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(false);- });-- it('瞬态失败:返回 null(不是 false),不缓存,恢复后重探拿到真结论', async () => {- await freshTransport();- const deviceId = freshDevice();- invokeMock.mockRejectedValueOnce(new Error('device link tunnel is not connected'));-- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(null);-- invokeMock.mockResolvedValue({ ok: true, showIgnoredDirs: true });- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(true);- expect(invokeMock).toHaveBeenCalledTimes(2);- });-- /**- * 重连代次必须是**进程级**的:面板卸载 →(没有任何 hook 观察)→ 重挂载时- * hook 局计数器又从 0 开始。拿 hook 局代次当缓存 key 的话,下面这步缓存里的- * 旧肯定结论会被误用 —— 开关对着已回滚的老端一直可按。所以缓存自己订阅全局- * reconnect 流拿代次。- */- it('重连(即使没有任何 hook 观察)作废肯定结论缓存', async () => {- await freshTransport();- const deviceId = freshDevice();- invokeMock.mockResolvedValue({ ok: true, showIgnoredDirs: true });-- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(true);- // 同代次命中缓存,不重复探测。- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(true);- expect(invokeMock).toHaveBeenCalledTimes(1);- // 模块级订阅已惰性建立。- expect(presenceCallbacks.length).toBe(1);-- // 设备被回滚成中间版本 + 重连:订阅侧只看到一次 online 事件(非 hook 驱动)。- invokeMock.mockResolvedValue({ ok: true, gzip: true });- presenceCallbacks[0]({ deviceId, online: true });-- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(false);- expect(invokeMock).toHaveBeenCalledTimes(2);-- // 已落定的否定结论本就不缓存 —— 下一次仍然重新问。- invokeMock.mockResolvedValue({ ok: true, showIgnoredDirs: true });- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(true);- expect(invokeMock).toHaveBeenCalledTimes(3);- });-- it('relay 恢复 online 同样作废缓存', async () => {- await freshTransport();- const deviceId = freshDevice();- invokeMock.mockResolvedValue({ ok: true, showIgnoredDirs: true });- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(true);- expect(invokeMock).toHaveBeenCalledTimes(1);- expect(statusCallbacks.length).toBe(1);-- invokeMock.mockResolvedValue({ ok: true, gzip: true });- statusCallbacks[0]({ status: 'online' });-- await expect(transport.deviceSupportsRevealIgnoredDirs(deviceId, '/repo')).resolves.toBe(false);- expect(invokeMock).toHaveBeenCalledTimes(2);- });-});diff --git a/apps/desktop/src/renderer/__tests__/workdirBrowseRemoteSafety.test.ts b/apps/desktop/src/renderer/__tests__/workdirBrowseRemoteSafety.test.tsindex 9de584f2d8..b525a4435c 100644--- a/apps/desktop/src/renderer/__tests__/workdirBrowseRemoteSafety.test.ts+++ b/apps/desktop/src/renderer/__tests__/workdirBrowseRemoteSafety.test.ts@@ -96,11 +96,7 @@ describe('workdir browse remote safety', () => {expect(routeSource).toContain('deviceId={deviceId}');// sidebar 侧同理:树 / 文件名索引 / 搜索 / 增删改全部带 remoteHostId,// 且"显示所在文件夹"这类本机-only 菜单在 remote 下不可用。- // useFileTree 的参数会被格式化折行,取调用块本身断言而不是整行文本。- const treeCall = sidebarBrowseSource.match(/useFileTree\(\{[^}]*\}/)?.[0] ?? '';- expect(treeCall).toContain('workdir');- expect(treeCall).toContain('remoteHostId');- expect(treeCall).toContain('deviceId');+ expect(sidebarBrowseSource).toContain('useFileTree({ workdir, remoteHostId, deviceId,');expect(sidebarBrowseSource).toContain('useProjectFileList(workdir, remoteHostId, deviceId, {');expect(sidebarBrowseSource).toContain('remoteHostId || deviceId ? undefined : handleRevealInFolder');});@@ -234,34 +230,4 @@ describe('workdir browse remote safety', () => {it('keeps empty workdir from reading local files', () => {expect(fileContentSource).toContain('if (!workdir || !relPath)');});-- it('文件树标题图标钮带可见的键盘焦点环', () => {- // G3 全局规则把非输入元素的 outline 一律去掉了(focus-visible:outline-none 必- // 自配):纯图标钮若不自带环,键盘 Tab 时就没有任何可见焦点指示 —— 包括新增的- // 「显示被忽略的目录」开关(评审 P1)。- const source = readFileSync(- resolve(- __dirname,- '..',- 'features',- 'cc-agent',- 'workdir-browse',- 'fileTreeHeaderButtonClass.ts',- ),- 'utf8',- );- expect(source).toContain('focus-visible:outline-none');- expect(source).toContain('focus-visible:ring-2');- expect(source).toContain('focus-visible:ring-[var(--focus-ring)]');- });-- it('persists expanded-set rename under the effective reveal scope', () => { // device-link 老被控端不支持「显示被忽略的目录」时,useFileTree 会退回隐藏态- // store;rename 迁移若仍按用户偏好写 reveal scope,迁移会落在不生效的那一格- // (隐藏 scope 仍存旧路径,面板重挂载后请求已不存在的目录、新目录展开态丢失)。- expect(sidebarBrowseSource).toContain(- 'const scopedShowIgnoredDirs = showIgnoredDirs && tree.showIgnoredDirsSupported !== false;',- );- expect(sidebarBrowseSource).not.toMatch(/loadExpandedSet\(workdir, \{ showIgnoredDirs \}\)/);- expect(sidebarBrowseSource).not.toMatch(/saveExpandedSet\(workdir, next, \{ showIgnoredDirs \}\)/);- });});diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeHeaderActions.tsx b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeHeaderActions.tsxdeleted file mode 100644index 44509cf382..0000000000--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeHeaderActions.tsx+++ /dev/null@@ -1,108 +0,0 @@-/**- * FileTreeHeaderActions — 文件树标题行右侧的动作按钮组。- *- * 两个宿主共用(此前各自复制了一份,加「显示被忽略的目录」时出现了两种圆角):- * - doc 模式侧栏 WorkdirBrowseSidebar- * - RSB 文件浏览器 FileBrowserBody 的 TreeHeader- *- * tree 模式:搜索 / 显示被忽略的目录 / 收起全部 / 刷新- * search 模式:X 退出搜索(依次替代上面四个的名字空间,与 doc 模式历史行为一致)- *- * 几何与可访问名:所有图标钮走 FILE_TREE_HEADER_ICON_BUTTON_CLASS(DESIGN.md §5- * 控件框 pill 档 + 自带 focus-visible 环),并配本地化 aria-label + Tip- * (DESIGN.md §14.6 纯图标控件的交付合同)。- */--import { useTranslation } from 'react-i18next';-import type { ReactNode } from 'react';-import {- ChevronsDownUp,- RefreshCw,- Search,- X as XIcon,-} from 'lucide-react';--import { Tip } from '@/components/ui/tooltip';-import { FILE_TREE_HEADER_ICON_BUTTON_CLASS } from './fileTreeHeaderButtonClass';-import { FileTreeIgnoredDirsToggle } from './FileTreeIgnoredDirsToggle';--export interface FileTreeHeaderActionsProps {- /** 当前是文件树还是项目级搜索:搜索态只留「退出搜索」。 */- mode: 'tree' | 'search';- onToggleSearch: () => void;- onCollapseAll: () => void;- onRefresh: () => void;- /** 被控端不支持「显示被忽略的目录」(老 Desktop):开关渲染成不可用 + 说明原因。 */- ignoredDirsUnsupported?: boolean;-}--export function FileTreeHeaderActions({- mode,- onToggleSearch,- onCollapseAll,- onRefresh,- ignoredDirsUnsupported = false,-}: FileTreeHeaderActionsProps) {- const { t } = useTranslation();-- if (mode === 'search') {- // search 是独立态:refresh / collapse 只对文件树有意义,搜索时不该出现。- return (- <HeaderIconButton- label={t('ccAgent.workdirBrowse.searchPanel.exit')}- onClick={onToggleSearch}- >- <XIcon size={14} strokeWidth={2} />- </HeaderIconButton>- );- }-- return (- <>- {/* 搜索与「显示被忽略的目录」都属于「树里显示什么」,并排放。 */}- <HeaderIconButton- label={t('ccAgent.workdirBrowse.searchPanel.searchFiles')}- onClick={onToggleSearch}- >- <Search size={14} strokeWidth={2} />- </HeaderIconButton>- <FileTreeIgnoredDirsToggle unsupported={ignoredDirsUnsupported} />- <HeaderIconButton- label={t('ccAgent.workdirBrowse.treeAction.collapseAll')}- onClick={onCollapseAll}- >- <ChevronsDownUp size={14} strokeWidth={2} />- </HeaderIconButton>- <HeaderIconButton- label={t('ccAgent.workdirBrowse.treeAction.refresh')}- onClick={onRefresh}- >- <RefreshCw size={14} strokeWidth={2} />- </HeaderIconButton>- </>- );-}--/** 标题行图标钮:Tip 文案与 aria-label 同一个来源,避免只写其中一个。 */-function HeaderIconButton({- label,- onClick,- children,-}: {- label: string;- onClick: () => void;- children: ReactNode;-}) {- return (- <Tip text={label}>- <button- type="button"- aria-label={label}- onClick={onClick}- className={FILE_TREE_HEADER_ICON_BUTTON_CLASS}- >- {children}- </button>- </Tip>- );-}diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeIgnoredDirsToggle.tsx b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeIgnoredDirsToggle.tsxdeleted file mode 100644index a9ce3dac6c..0000000000--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeIgnoredDirsToggle.tsx+++ /dev/null@@ -1,88 +0,0 @@-/**- * FileTreeIgnoredDirsToggle — 文件树标题行里的「显示被忽略的目录」开关。- *- * 位置:与「搜索 / 收起 / 刷新」并列,紧挨搜索(两者都属于"树里显示什么")。- * RSB 文件浏览器(FileBrowserBody 的 TreeHeader)与 doc 模式侧栏- * (WorkdirBrowseSidebar 的标题行)共用本组件 —— 同一份全局偏好只留一个入口,- * 两处以同一视觉/交互出现。- *- * 语义:`useFileBrowserPreference` 全局偏好(默认关),打开后文件树列出 Cindy- * 默认隐藏的依赖 / 构建产物 / 缓存目录(build、dist、out、node_modules…)。- * 偏好进 `useFileTree` 的 store key,切换即换 store 并用新 matcher 重拉,用户- * 不需要手动刷新。- *- * 形态对齐同级按钮与既有先例(ReviewTabBody 的文件树显隐开关):- * - size-5 + 图标 14,与同排三个按钮同几何,不改变标题行节奏- * - 圆角走 DESIGN.md §5 的 pill 档(控件框 = pill);整行四个按钮共用- * fileTreeHeaderButtonClass 里的同一份类名,不再各写一份- * - 状态用 `aria-pressed` + 按压底色表达;图标随状态在 EyeOff / Eye 间切换- * - 文案遵循 DESIGN.md §14.6:说**下一步动作**(显示 / 隐藏),tooltip 与- * aria-label 一起变- * - 被控端不支持时(device-link 连到老 Desktop,它的 listDir 静默忽略该字段):- * 控件呈现为不可用 + 说明原因,不装成"按下去就生效"的假开关- */--import { useTranslation } from 'react-i18next';-import { Eye, EyeOff } from 'lucide-react';--import { cn } from '@/lib/utils';-import { Tip } from '@/components/ui/tooltip';-import { useFileBrowserPreference } from '@/hooks/useFileBrowserPreference';-import { FILE_TREE_HEADER_ICON_BUTTON_CLASS } from './fileTreeHeaderButtonClass';--export interface FileTreeIgnoredDirsToggleProps {- /**- * 当前会话的被控端不支持 `showIgnoredDirs`(老 Desktop 的 listDir 会静默- * 忽略该字段)。由 `useFileTree` 的 `showIgnoredDirsSupported === false` 传入。- */- unsupported?: boolean;-}--export function FileTreeIgnoredDirsToggle({- unsupported = false,-}: FileTreeIgnoredDirsToggleProps) {- const { t } = useTranslation();- const { showIgnoredDirs, setShowIgnoredDirs } = useFileBrowserPreference();-- // 不支持的老被控端:按「关」呈现 —— 这个视图里确实不会显示被忽略目录(tree- // 也按隐藏态建的 store),同时 label 说明原因。压着不动的按下态比禁用更容易- // 被误读为“已经打开了”。- const pressed = !unsupported && showIgnoredDirs;-- // §14.6:状态控件描述将要发生的动作。- const label = unsupported- ? t('ccAgent.workdirBrowse.treeAction.showIgnoredDirsUnsupported')- : t(- pressed- ? 'ccAgent.workdirBrowse.treeAction.hideIgnoredDirs'- : 'ccAgent.workdirBrowse.treeAction.showIgnoredDirs',- );-- return (- <Tip text={label}>- <button- type="button"- aria-pressed={pressed}- aria-label={label}- // aria-disabled 而不走原生 disabled:原生 disabled 的按钮不派发鼠标事件,- // Radix tooltip 打不开 —— 用户就没有地方能看到“为什么不能按”。- aria-disabled={unsupported || undefined}- onClick={() => {- if (unsupported) return;- setShowIgnoredDirs(!showIgnoredDirs);- }}- className={cn(- FILE_TREE_HEADER_ICON_BUTTON_CLASS,- pressed && 'bg-sidebar-item-active text-sidebar-item-active-foreground',- unsupported && 'cursor-not-allowed opacity-45 hover:bg-transparent',- )}- >- {pressed ? (- <Eye size={14} strokeWidth={2} />- ) : (- <EyeOff size={14} strokeWidth={2} />- )}- </button>- </Tip>- );-}diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsxindex 365f78fa67..9ca86af08b 100644--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx+++ b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx@@ -25,7 +25,7 @@ import { openHtmlFileByPreference } from '@/components/chat/useOpenWithMenu';import { resolveSessionFileOrigin } from '@/lib/sessionFileOrigin';import { useCallback, useEffect, useMemo, useRef, useState } from 'react';import { useNavigate, useSearchParams } from 'react-router-dom';-import { ArrowLeft, Check, ChevronDown } from 'lucide-react';+import { ArrowLeft, Check, ChevronDown, ChevronsDownUp, RefreshCw, Search, X as XIcon } from 'lucide-react';import { useTranslation } from 'react-i18next';import { cn } from '@/lib/utils';@@ -44,9 +44,7 @@ import { useFileTree, type DirEntry } from './hooks/useFileTree';import { fileBrowserApiFor } from '@/lib/fileBrowserTransport';import { useConfirmSwitchAwayIfDirty } from './hooks/useConfirmSwitchAwayIfDirty';import { useProjectFileList } from './hooks/useProjectFileList';-import { useFileBrowserPreference } from '@/hooks/useFileBrowserPreference';import { FileTreeView, type FileTreeViewHandle, type PendingCreate } from './FileTreeView';-import { FileTreeHeaderActions } from './FileTreeHeaderActions';import { useRevealFileInTree } from './hooks/useRevealFileInTree';import { FileFilterInput } from './FileFilterInput';import { FilterResultList } from './FilterResultList';@@ -216,18 +214,7 @@ export function WorkdirBrowseSidebar({// 要递归扫一遍判断 "有没有 doc 文件"(即使 sibling 已经并行,顶层走完一轮// 仍然有感知)。先放开让用户看全部文件,等 hasDocDescendant 加缓存或换成// 流式增量返回再启用。scanner.ts 的过滤逻辑保留,改回 true 即可恢复。- //- // showIgnoredDirs 来自设置页「显示被忽略的目录」开关(默认关):打开后- // build / dist / out / node_modules 等被内置清单隐藏的目录会出现在树里。- const { showIgnoredDirs } = useFileBrowserPreference();- const tree = useFileTree({- workdir,- remoteHostId,- deviceId,- hideMetaFiles: true,- docMode: false,- showIgnoredDirs,- });+ const tree = useFileTree({ workdir, remoteHostId, deviceId, hideMetaFiles: true, docMode: false });// 文件名筛选 query —— tree 模式下用,独立于内容搜索。空 query 显示文件树,有// 内容显示筛选结果列表。workdir 切换时自动清空(下方 useEffect)。@@ -608,14 +595,8 @@ export function WorkdirBrowseSidebar({// 文件夹 rename:把 expanded 持久化里所有 oldRel / oldRel/* 的条目改前缀。// 实时 expanded 集合不改 — 反正打开重命名后的新文件夹时会重新 fetch。- //- // scope 必须与 tree store **实际生效**的开关一致:device-link 被控端不支持- // 「显示被忽略的目录」时 useFileTree 会退回隐藏态 store;若这里仍按用户偏好- // 写 reveal scope,迁移就落在不生效的那一格 —— 当前隐藏 scope 仍存旧路径,- // 面板重挂载后会去请求已不存在的目录,新目录的展开态也丢了(评审 P2)。if (entry.type === 'directory') {- const scopedShowIgnoredDirs = showIgnoredDirs && tree.showIgnoredDirsSupported !== false;- const persisted = loadExpandedSet(workdir, { showIgnoredDirs: scopedShowIgnoredDirs });+ const persisted = loadExpandedSet(workdir);let dirty = false;const next = new Set<string>();for (const p of persisted) {@@ -629,19 +610,10 @@ export function WorkdirBrowseSidebar({next.add(p);}}- if (dirty) saveExpandedSet(workdir, next, { showIgnoredDirs: scopedShowIgnoredDirs });+ if (dirty) saveExpandedSet(workdir, next);}},- [- renamingPath,- tree.entries,- tree.showIgnoredDirsSupported,- workdir,- showIgnoredDirs,- selectedPath,- setSearchParams,- t,- ],+ [renamingPath, tree.entries, workdir, selectedPath, setSearchParams, t],);// 右键 文件 → Copy File Path。Electron renderer 启用了 clipboard write,@@ -705,7 +677,7 @@ export function WorkdirBrowseSidebar({type="button"aria-label={t('ccAgent.workdirBrowse.switchProject')}className={cn(- 'flex min-w-0 items-center gap-1.5 rounded-full px-1.5 py-1 -ml-1.5',+ 'flex min-w-0 items-center gap-1.5 rounded-md px-1.5 py-1 -ml-1.5','text-sm font-semibold text-foreground transition-colors','hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground','data-[state=open]:bg-sidebar-item-active data-[state=open]:text-sidebar-item-active-foreground',@@ -746,14 +718,49 @@ export function WorkdirBrowseSidebar({</span>)}<div className="flex shrink-0 items-center gap-1.5">- {/* 搜索 / 显示被忽略的目录 / 收起 / 刷新 —— 与 RSB 文件浏览器同一组件。 */}- <FileTreeHeaderActions- mode={mode}- onToggleSearch={handleToggleSearchMode}- onCollapseAll={handleCollapseAll}- onRefresh={handleRefresh}- ignoredDirsUnsupported={tree.showIgnoredDirsSupported === false}- />+ {mode === 'search' ? (+ // search 是独立态: refresh / collapse 只对文件树有意义,搜索时不该出现。+ // 只保留 X = 退出搜索回到 tree 模式。+ <Tip text={t('ccAgent.workdirBrowse.searchPanel.exit')}>+ <button+ type="button"+ onClick={handleToggleSearchMode}+ className="flex size-5 items-center justify-center rounded-md text-sidebar-action-icon hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground"+ >+ <XIcon size={14} strokeWidth={2} />+ </button>+ </Tip>+ ) : (+ <>+ <Tip text={t('ccAgent.workdirBrowse.searchPanel.searchFiles')}>+ <button+ type="button"+ onClick={handleToggleSearchMode}+ className="flex size-5 items-center justify-center rounded-md text-sidebar-action-icon hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground"+ >+ <Search size={14} strokeWidth={2} />+ </button>+ </Tip>+ <Tip text={t('ccAgent.workdirBrowse.treeAction.collapseAll')}>+ <button+ type="button"+ onClick={handleCollapseAll}+ className="flex size-5 items-center justify-center rounded-md text-sidebar-action-icon hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground"+ >+ <ChevronsDownUp size={14} strokeWidth={2} />+ </button>+ </Tip>+ <Tip text={t('ccAgent.workdirBrowse.treeAction.refresh')}>+ <button+ type="button"+ onClick={handleRefresh}+ className="flex size-5 items-center justify-center rounded-md text-sidebar-action-icon hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground"+ >+ <RefreshCw size={14} strokeWidth={2} />+ </button>+ </Tip>+ </>+ )}</div></div>diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeIgnoredDirsToggle.test.tsx b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeIgnoredDirsToggle.test.tsxdeleted file mode 100644index 3637cff9c5..0000000000--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeIgnoredDirsToggle.test.tsx+++ /dev/null@@ -1,190 +0,0 @@-// @vitest-environment jsdom--/**- * FileTreeIgnoredDirsToggle — 文件树标题行的「显示被忽略的目录」开关。- *- * 锁的不变量:- * - 默认关:aria-pressed=false,文案说**下一步动作**(显示),与 DESIGN.md §14.6- * "stateful controls describe the action that will happen next" 一致;- * - 点击翻转偏好,并把 override 落进 localStorage(规则 20:改回默认即清除);- * - 按下状态有持久底色(不是只在 hover 时可见),否则用户无法判断当前是开是关;- * - 有 Tip(tooltip)与 aria-label 两个标签(§14.6 图标控件的交付合同)。- */--import { cleanup, fireEvent, render, screen } from '@testing-library/react';-import { readFileSync } from 'node:fs';-import { resolve } from 'node:path';-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';--vi.mock('react-i18next', () => ({- useTranslation: () => ({ t: (key: string) => key }),-}));--import { FileTreeIgnoredDirsToggle } from '../FileTreeIgnoredDirsToggle';-import { _resetFileBrowserPreferenceForTests } from '@/hooks/useFileBrowserPreference';--const KEY = 'fileBrowser.showIgnoredDirs';-const SHOW_LABEL = 'ccAgent.workdirBrowse.treeAction.showIgnoredDirs';-const HIDE_LABEL = 'ccAgent.workdirBrowse.treeAction.hideIgnoredDirs';-const UNSUPPORTED_LABEL = 'ccAgent.workdirBrowse.treeAction.showIgnoredDirsUnsupported';--function button(): HTMLElement {- return screen.getByRole('button', { name: SHOW_LABEL });-}--describe('FileTreeIgnoredDirsToggle', () => {- beforeEach(() => {- localStorage.clear();- _resetFileBrowserPreferenceForTests();- });-- afterEach(() => cleanup());-- it('默认关:aria-pressed=false,label 是「显示被忽略的目录」', () => {- render(<FileTreeIgnoredDirsToggle />);- expect(button().getAttribute('aria-pressed')).toBe('false');- expect(button().getAttribute('aria-label')).toBe(SHOW_LABEL);- });-- it('点击打开:写 override、翻成 pressed、label 换成「隐藏」', () => {- render(<FileTreeIgnoredDirsToggle />);- fireEvent.click(button());-- expect(localStorage.getItem(KEY)).toBe('true');- const pressed = screen.getByRole('button', { name: HIDE_LABEL });- expect(pressed.getAttribute('aria-pressed')).toBe('true');- });-- it('再点一次回到默认:清除 override(不写默认值快照)', () => {- localStorage.setItem(KEY, 'true');- render(<FileTreeIgnoredDirsToggle />);- fireEvent.click(screen.getByRole('button', { name: HIDE_LABEL }));-- expect(localStorage.getItem(KEY)).toBeNull();- expect(button().getAttribute('aria-pressed')).toBe('false');- });-- it('按下态有持久底色;未按下只有 hover 底色', () => {- const { unmount } = render(<FileTreeIgnoredDirsToggle />);- expect(button().className).toContain('hover:bg-sidebar-item-active');- expect(button().className).not.toMatch(/(?:^|\s)bg-sidebar-item-active/);- unmount();-- localStorage.setItem(KEY, 'true');- _resetFileBrowserPreferenceForTests();- render(<FileTreeIgnoredDirsToggle />);- expect(screen.getByRole('button', { name: HIDE_LABEL }).className).toMatch(- /(?:^|\s)bg-sidebar-item-active/,- );- });-- /**- * 被控端不支持(device-link 连到老 Desktop,它的 listDir 会静默忽略- * showIgnoredDirs):开关不能装成"按下去就生效"。禁用 + 说明原因,并且点击- * 不改全局偏好。- */- describe('unsupported', () => {- it('压不下去:aria-disabled + pressed=false + 原因文案,点击不改偏好', () => {- render(<FileTreeIgnoredDirsToggle unsupported />);- const el = screen.getByRole('button', { name: UNSUPPORTED_LABEL });-- expect(el.getAttribute('aria-disabled')).toBe('true');- expect(el.getAttribute('aria-pressed')).toBe('false');- expect(el.className).toContain('cursor-not-allowed');-- fireEvent.click(el);- expect(localStorage.getItem(KEY)).toBeNull();- });-- it('偏好已开启也按「关」展示(这个视图确实不会显示被忽略目录)', () => {- localStorage.setItem(KEY, 'true');- _resetFileBrowserPreferenceForTests();- render(<FileTreeIgnoredDirsToggle unsupported />);-- const el = screen.getByRole('button', { name: UNSUPPORTED_LABEL });- expect(el.getAttribute('aria-pressed')).toBe('false');- // 全局偏好本身不被改写 —— 切回本地会话仍然是开着的。- expect(localStorage.getItem(KEY)).toBe('true');- });- });-});--/**- * 接线守卫:开关必须出现在**每个**文件树宿主的标题行里,且与- * 「搜索 / 收起 / 刷新」并列(文本顺序在搜索之后、收起之前) —— 用户就是在这- * 里发现目录被隐藏的,偏好不能只能从设置页改。- *- * 只断言「每个宿主文件内存在」与相对位置,不断言总调用点个数(计数式断言会把- * 「必须重复」写成不变量,见 DESIGN.md §14 的守卫元规则)。- *- * 2026-09 重构后两个宿主共用 FileTreeHeaderActions(此前各自复制一份,加开关时- * 出现了两种圆角)。守卫因此分两层:- * 1. 每个宿主确实挂了共享动作组;- * 2. 共享动作组里开关存在、位置正确,且几何与可访问名只有一份实现。- */-describe('FileTreeIgnoredDirsToggle 接线', () => {- const hosts = [- ['RSB 文件浏览器', ['features', 'right-sidebar', 'plugins', 'file-browser', 'FileBrowserBody.tsx']],- ['doc 模式侧栏', ['features', 'cc-agent', 'workdir-browse', 'WorkdirBrowseSidebar.tsx']],- ] as const;- const sharedActions = [- 'features',- 'cc-agent',- 'workdir-browse',- 'FileTreeHeaderActions.tsx',- ] as const;-- function readSource(segments: readonly string[]): string {- return readFileSync(resolve(__dirname, '..', '..', '..', '..', ...segments), 'utf8');- }-- it.each(hosts)('%s 的标题行挂着共享动作组', (_name, segments) => {- expect(readSource(segments)).toContain('<FileTreeHeaderActions');- });-- it('共享动作组里开关紧跟搜索按钮、先于收起按钮', () => {- const source = readSource(sharedActions);- const toggleAt = source.indexOf('<FileTreeIgnoredDirsToggle');- const searchAt = source.indexOf("'ccAgent.workdirBrowse.searchPanel.searchFiles'");- const collapseAt = source.indexOf("'ccAgent.workdirBrowse.treeAction.collapseAll'");-- expect(toggleAt).toBeGreaterThan(-1);- expect(searchAt).toBeGreaterThan(-1);- expect(collapseAt).toBeGreaterThan(-1);- expect(toggleAt).toBeGreaterThan(searchAt);- expect(toggleAt).toBeLessThan(collapseAt);- });-- /**- * 几何守卫:这行里的每个图标钮都拿共享常量,不各自写圆角。- *- * 起因:开关最初只给自己写了 pill,三个存量按钮各自写 `rounded-md`(6px),- * 同一行就出现两种圆角。抽成共享动作组后,宿主里不应再出现自写的图标钮。- */- it('共享动作组的图标钮全部走共享类名常量', () => {- expect(readSource(sharedActions)).toContain('FILE_TREE_HEADER_ICON_BUTTON_CLASS');- });-- it.each(hosts)('%s 不再自己写标题行图标钮', (_name, segments) => {- expect(readSource(segments)).not.toMatch(- /className="flex size-5 items-center justify-center rounded-/,- );- });-- /**- * 可访问名守卫(DESIGN.md §14.6):纯图标控件的交付合同是**可见 Tip + 本地化- * 可访问名**。共享动作组的按钮由 HeaderIconButton 统一产出,两个标签同源。- */- it('共享动作组的图标钮都带本地化 aria-label', () => {- const source = readSource(sharedActions);- const buttons = source- .split('<button')- .slice(1)- .filter((block) => block.includes('FILE_TREE_HEADER_ICON_BUTTON_CLASS'));-- expect(buttons.length).toBeGreaterThan(0);- for (const block of buttons) {- expect(block.slice(0, block.indexOf('className'))).toContain('aria-label');- }- });-});diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.horizontalScroll.test.tsx b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.horizontalScroll.test.tsxindex 34b364026c..0b83b23ab7 100644--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.horizontalScroll.test.tsx+++ b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.horizontalScroll.test.tsx@@ -87,7 +87,6 @@ function makeFarTargetsTree(): UseFileTreeReturn {loadingPaths: new Set(),initialLoading: false,loadError: null,- showIgnoredDirsSupported: true,storeKey: 'test-store',treeIdentityKey: 'test-store',toggleFolder: vi.fn(),@@ -108,7 +107,6 @@ function makeTree(): UseFileTreeReturn {loadingPaths: new Set(),initialLoading: false,loadError: null,- showIgnoredDirsSupported: true,storeKey: 'test-store',treeIdentityKey: 'test-store',toggleFolder: vi.fn(),diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.imagePreview.test.tsx b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.imagePreview.test.tsxindex f44b1f74b9..5efaf9d5d1 100644--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.imagePreview.test.tsx+++ b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.imagePreview.test.tsx@@ -27,7 +27,6 @@ function makeTree(): UseFileTreeReturn {loadingPaths: new Set(),initialLoading: false,loadError: null,- showIgnoredDirsSupported: true,storeKey: 'test-store',treeIdentityKey: 'test-store',toggleFolder: vi.fn(),diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.inlineEdit.test.tsx b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.inlineEdit.test.tsxindex d42cb147cf..67f1fc9f96 100644--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.inlineEdit.test.tsx+++ b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.inlineEdit.test.tsx@@ -74,7 +74,6 @@ function makeTree(): UseFileTreeReturn {loadingPaths: new Set(),initialLoading: false,loadError: null,- showIgnoredDirsSupported: true,storeKey: '/repo::hidden',treeIdentityKey: '/repo',toggleFolder: vi.fn(),diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.scroll.test.tsx b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.scroll.test.tsxindex c397cc2bd1..e5efde939d 100644--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.scroll.test.tsx+++ b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/__tests__/FileTreeView.scroll.test.tsx@@ -71,7 +71,6 @@ function makeTree(opts: {loadingPaths: new Set(),initialLoading: false,loadError: null,- showIgnoredDirsSupported: true,storeKey,treeIdentityKey: storeKey.split('::')[0],toggleFolder: vi.fn(),diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/fileTreeHeaderButtonClass.ts b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/fileTreeHeaderButtonClass.tsdeleted file mode 100644index b501f80968..0000000000--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/fileTreeHeaderButtonClass.ts+++ /dev/null@@ -1,19 +0,0 @@-/**- * 文件树标题行图标钮的统一类名。- *- * 一行里的动作按钮 —— 搜索 / 显示被忽略的目录 / 收起 / 刷新,外加搜索态的 X ——- * 共用这一份定义。两个宿主(RSB 文件浏览器 FileBrowserBody 的 TreeHeader、- * doc 模式侧栏 WorkdirBrowseSidebar)以前各自复制了一行类名,新增「显示被忽略的- * 目录」时新按钮走 pill、三个旧按钮还是 6px,同一行就出现了两种圆角。- *- * 为什么是 pill(DESIGN.md §5):控件框(含 transient hover / pressed 表面)登记在- * Step 2 的 pill 档;6px 不在受治理取值里(`No 3px / 6px / 10px`)。抽成常量后- * 后续新按钮只能拿到同一个值,不会再各写一份。- *- * focus-visible 环必须自己带:G3 全局规则(globals.css)把非输入元素的 outline- * 一律去掉了(Chromium 默认环在 Esc/点击后跳焦时会闪橙色),所以不显式补环的- * 纯图标钮在键盘 Tab 时没有任何可见焦点指示 —— 包括新增的「显示被忽略的目录」- * 开关(评审 P1)。- */-export const FILE_TREE_HEADER_ICON_BUTTON_CLASS =- 'flex size-5 items-center justify-center rounded-full text-sidebar-action-icon hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--focus-ring)]';diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/__tests__/useFileTree.test.tsx b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/__tests__/useFileTree.test.tsxindex ea4dc50a61..f4f4af2c24 100644--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/__tests__/useFileTree.test.tsx+++ b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/__tests__/useFileTree.test.tsx@@ -16,14 +16,7 @@ const mocks = vi.hoisted(() => {fileBrowserApiFor: vi.fn(),isDeviceTooOldError: vi.fn(() => false),listDir: vi.fn(),- loadExpandedSet: vi.fn(- (_workdir: string, _opts?: { showIgnoredDirs?: boolean }) => new Set<string>(),- ),- deviceSupportsRevealIgnoredDirs: vi.fn(- async (): Promise<boolean | null> => true,- ),- /** 重连代次:测试里改这个值 + rerender 就能驱动重探。 */- reconnectEpoch: { current: 0 },+ loadExpandedSet: vi.fn(() => new Set<string>()),onFileTreeEventFor: vi.fn((_deviceId: string | null | undefined, cb: (event: FileTreeEvent) => void) => {eventCallbacks.push(cb);@@ -40,7 +33,6 @@ const mocks = vi.hoisted(() => {});vi.mock('@/lib/fileBrowserTransport', () => ({- deviceSupportsRevealIgnoredDirs: mocks.deviceSupportsRevealIgnoredDirs,fileBrowserApiFor: mocks.fileBrowserApiFor,isDeviceTooOldError: mocks.isDeviceTooOldError,onFileTreeEventFor: mocks.onFileTreeEventFor,@@ -52,11 +44,6 @@ vi.mock('@/lib/logger', () => ({createLogger: () => ({ warn: vi.fn() }),}));-// jsdom 里没有 window.electronAPI,真实 hook 会去订阅 presence —— 用可变代次替身。-vi.mock('@/features/device-link/useDeviceLinkReconnectEpoch', () => ({- useDeviceLinkReconnectEpoch: () => mocks.reconnectEpoch.current,-}));-vi.mock('../../lib/expandedStore', () => ({loadExpandedSet: mocks.loadExpandedSet,saveExpandedSet: mocks.saveExpandedSet,@@ -77,8 +64,6 @@ describe('useFileTree refresh scheduling', () => {vi.clearAllMocks();mocks.eventCallbacks.length = 0;mocks.fileBrowserApiFor.mockReturnValue({ listDir: mocks.listDir });- // clearAllMocks 不重置实现:用例自设的 loadExpandedSet 行为要在每个用例前复位。- mocks.loadExpandedSet.mockImplementation(() => new Set<string>());});it('limits a directory refresh to one trailing scan during a watcher storm', async () => {@@ -130,981 +115,3 @@ describe('useFileTree refresh scheduling', () => {view.unmount();});});--/**- * 「显示被忽略的目录」开关:作为 store key 的一部分,不同取值必须拿到各自- * 的 store 与 listDir / watch 参数,不能互相污染。- */-describe('useFileTree showIgnoredDirs option', () => {- beforeEach(() => {- vi.clearAllMocks();- mocks.eventCallbacks.length = 0;- mocks.listDir.mockResolvedValue([]);- mocks.fileBrowserApiFor.mockReturnValue({ listDir: mocks.listDir });- // clearAllMocks 不重置实现:用例自设的 loadExpandedSet 行为要在每个用例前复位。- mocks.loadExpandedSet.mockImplementation(() => new Set<string>());- });-- it('listDir / startWatch 带上开关值', async () => {- const view = renderHook(() =>- useFileTree({ workdir: '/workdir-reveal', showIgnoredDirs: true }),- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- expect(mocks.listDir).toHaveBeenCalledWith(- expect.objectContaining({ workdir: '/workdir-reveal', showIgnoredDirs: true }),- );- expect(mocks.startWatchFor).toHaveBeenCalledWith(- null,- expect.objectContaining({ workdir: '/workdir-reveal', showIgnoredDirs: true }),- );- view.unmount();- });-- it('开关不同 = 两份独立 store(互不共用 entries)', async () => {- const hidden = renderHook(() => useFileTree({ workdir: '/workdir-split' }));- const revealed = renderHook(() =>- useFileTree({ workdir: '/workdir-split', showIgnoredDirs: true }),- );- await waitFor(() => expect(hidden.result.current.initialLoading).toBe(false));- await waitFor(() => expect(revealed.result.current.initialLoading).toBe(false));- // 两个 store 各自拉了一次根目录。- expect(mocks.listDir).toHaveBeenCalledTimes(2);- expect(- mocks.listDir.mock.calls.map((c) => c[0].showIgnoredDirs),- ).toEqual([false, true]);- hidden.unmount();- revealed.unmount();- });-- /**- * 展开态持久化同样按开关分片:否则放行态展开过 node_modules / Library 后切回- * 隐藏态,init 会把它们当"已展开"并行 listDir(评审 P2)。- */- it('expanded 持久化按开关分片读取', async () => {- const hidden = renderHook(() => useFileTree({ workdir: '/workdir-scope' }));- await waitFor(() => expect(hidden.result.current.initialLoading).toBe(false));- expect(mocks.loadExpandedSet).toHaveBeenCalledWith('/workdir-scope', {- showIgnoredDirs: false,- });- hidden.unmount();-- const revealed = renderHook(() =>- useFileTree({ workdir: '/workdir-scope', showIgnoredDirs: true }),- );- await waitFor(() => expect(revealed.result.current.initialLoading).toBe(false));- expect(mocks.loadExpandedSet).toHaveBeenCalledWith('/workdir-scope', {- showIgnoredDirs: true,- });- revealed.unmount();- });-- /**- * 切开关会换一份 store。新 store 若从空快照 + initialLoading 起步,FileTreeView- * 会把整树替换成空白占位(本地 <300ms 连 spinner 都没有),视觉上闪一下;- * 「刷新」按钮原地 refetch 所以不闪。新 store 必须继承兄弟 store 的整棵可见树,- * 等新 matcher 的数据回来再整体替换(不是只借根列表,见下一条)。- */- it('切开关继承整棵可见树,不回到 initialLoading 空白', async () => {- const hiddenEntries: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- ];- const revealedEntries: readonly DirEntry[] = [- { name: 'node_modules', relPath: 'node_modules', type: 'directory', size: 0, mtimeMs: 1 },- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- ];- // 切开关后钩住新 matcher 的 listDir:验证“数据还没回来”的那一帧。- const pending = deferred<readonly DirEntry[]>();- mocks.listDir.mockImplementation((args: { showIgnoredDirs?: boolean }) =>- args.showIgnoredDirs ? pending.promise : Promise.resolve(hiddenEntries),- );-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-seed', showIgnoredDirs: reveal }),- { initialProps: { reveal: false } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- expect(view.result.current.entries.get('')).toEqual(hiddenEntries);-- await act(async () => {- view.rerender({ reveal: true });- });- // 新 matcher 的数据尚未回来:这一帧就该有 seed 的旧树且不在 loading。- expect(view.result.current.initialLoading).toBe(false);- expect(view.result.current.entries.get('')).toEqual(hiddenEntries);-- await act(async () => {- pending.resolve(revealedEntries);- await Promise.resolve();- });- await waitFor(() => expect(view.result.current.entries.get('')).toEqual(revealedEntries));-- view.unmount();- });-- /**- * 关开关的首帧就要滤掉内置忽略目录:慢通道下不能等新 matcher 的数据回来,- * 否则「开关关了却还看得见 node_modules」会持续数秒。子树缓存与展开集合不- * 动(父行不在根列表里 → 整棵子树同帧不可达,与「一次性消失」一致)。- */- it('关开关首帧就滤掉被忽略目录,不等新数据', async () => {- const revealedRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- { name: 'node_modules', relPath: 'node_modules', type: 'directory', size: 0, mtimeMs: 1 },- // 大小写变体:matcher 的 ignorecase 默认让 BUILD 与 build 同义,首帧也该滤掉。- { name: 'BUILD', relPath: 'BUILD', type: 'directory', size: 0, mtimeMs: 1 },- { name: 'README.md', relPath: 'README.md', type: 'file', size: 10, mtimeMs: 1 },- ];- const pendingRoot = deferred<readonly DirEntry[]>();- mocks.listDir.mockImplementation((args: { showIgnoredDirs?: boolean }) =>- args.showIgnoredDirs ? Promise.resolve(revealedRoot) : pendingRoot.promise,- );-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-seed-filter', showIgnoredDirs: reveal }),- { initialProps: { reveal: true } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));-- await act(async () => {- view.rerender({ reveal: false });- });-- // 数据还没回来,但被忽略目录已不在根列表;其余行照旧。- expect(view.result.current.entries.get('')?.map((e) => e.name)).toEqual(['src', 'README.md']);-- view.unmount();- });-- /**- * 关开关的消失动作必须是一次性的:过渡期(hidden 数据还没回来)树保持不动- * —— 展开态与子树缓存都还在 —— 而不是先丢子行再丢父行(那是「从最子级逐级- * 折叠」);被忽略的一级目录行由首帧过滤直接拿掉(见上一条),剩下的部分等- * root 数据回来整体替换,并把借来的 reveal-only 展开位剪掉:hidden 树下- * node_modules 已不在 root 列表里,留着会随下次操作写进 hidden scope 的- * localStorage,下次启动白发一批 listDir。- */- it('关开关整树保持到数据回来,再一次性替换并剪掉 reveal-only 展开位', async () => {- const revealedRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- { name: 'node_modules', relPath: 'node_modules', type: 'directory', size: 0, mtimeMs: 1 },- ];- const revealedChild: readonly DirEntry[] = [- { name: 'pkg', relPath: 'node_modules/pkg', type: 'directory', size: 0, mtimeMs: 1 },- ];- const hiddenRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- ];- mocks.listDir.mockImplementation((args: { relPath?: string; showIgnoredDirs?: boolean }) => {- if (args.showIgnoredDirs) {- return Promise.resolve(args.relPath === 'node_modules' ? revealedChild : revealedRoot);- }- return Promise.resolve(hiddenRoot);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-seed-swap', showIgnoredDirs: reveal }),- { initialProps: { reveal: true } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- await act(async () => {- view.result.current.toggleFolder('node_modules');- });- expect(view.result.current.expanded.has('node_modules')).toBe(true);-- // 过渡期:挂住 hidden 侧的 root listDir,模拟慢通道。- const pendingRoot = deferred<readonly DirEntry[]>();- mocks.listDir.mockImplementation((args: { showIgnoredDirs?: boolean }) => {- if (args.showIgnoredDirs) return Promise.resolve(revealedRoot);- return pendingRoot.promise;- });- mocks.listDir.mockClear();-- await act(async () => {- view.rerender({ reveal: false });- });-- // 数据还没回来:被忽略行已由首帧过滤拿掉,它的整棵缓存与展开位也一起剪掉- // (缓存留着会被 refresh() 按 entries key 重扫;展开位留着会被过渡窗口里的- // 操作写进本 scope 的 localStorage);树的其余部分保持不动 —— 不重新挂载、- // 不逐级折叠。- expect(view.result.current.initialLoading).toBe(false);- expect(view.result.current.entries.get('')?.map((e) => e.name)).toEqual(['src']);- expect(view.result.current.entries.has('node_modules')).toBe(false);- expect(view.result.current.expanded.has('node_modules')).toBe(false);- // 过渡期不 warm 借来的子树 —— 不给被忽略路径白发 listDir。- const hiddenCalls = mocks.listDir.mock.calls.filter((c) => c[0].showIgnoredDirs === false);- expect(hiddenCalls.map((c) => c[0].relPath)).toEqual(['']);-- await act(async () => {- pendingRoot.resolve(hiddenRoot);- await Promise.resolve();- });- await waitFor(() => expect(view.result.current.entries.get('')).toEqual(hiddenRoot));- // 整体替换完成:借来的 reveal-only 展开位被剪掉。- expect(view.result.current.expanded.has('node_modules')).toBe(false);-- view.unmount();- });-- /**- * 评审 P1(PR #4398 轮七):创建 store 时借的是另一半 scope 的过渡快照,而剪枝- * 会**同步回写本 scope 的 localStorage** —— 剪之前必须先读本 scope 自己的持久- * 记录并豁免它,否则切回隐藏态时用户原有(本 scope)的展开位会被一起抹掉。- */- it('切回隐藏态时保留本 scope 已持久化的展开位', async () => {- const revealedRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- { name: 'docs', relPath: 'docs', type: 'directory', size: 0, mtimeMs: 1 },- { name: 'node_modules', relPath: 'node_modules', type: 'directory', size: 0, mtimeMs: 1 },- ];- const hiddenRoot = revealedRoot.filter((entry) => entry.name !== 'node_modules');- mocks.listDir.mockImplementation((args: { showIgnoredDirs?: boolean }) =>- Promise.resolve(args.showIgnoredDirs ? revealedRoot : hiddenRoot),- );- // 上一次会话里 hidden scope 自己存过展开位:docs。- mocks.loadExpandedSet.mockImplementation(- (_workdir: string, opts?: { showIgnoredDirs?: boolean }) =>- opts?.showIgnoredDirs ? new Set<string>() : new Set(['docs']),- );-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-scope-keep', showIgnoredDirs: reveal }),- { initialProps: { reveal: true } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- await act(async () => {- view.result.current.toggleFolder('node_modules');- });- expect(view.result.current.expanded.has('node_modules')).toBe(true);-- await act(async () => {- view.rerender({ reveal: false });- });-- // 剪枝回写必须保留本 scope 既有的 'docs',同时仍然剪掉借来的 node_modules。- const hiddenWrites = mocks.saveExpandedSet.mock.calls- .filter((call) => (call[2] as { showIgnoredDirs?: boolean } | undefined)?.showIgnoredDirs === false)- .map((call) => call[1] as Set<string>);- expect(hiddenWrites.length).toBeGreaterThan(0);- const lastWrite = hiddenWrites.at(-1)!;- expect(lastWrite.has('docs')).toBe(true);- expect(lastWrite.has('node_modules')).toBe(false);-- // 内存里也保留:切回后 docs 仍是展开态。- expect(view.result.current.expanded.has('docs')).toBe(true);- expect(view.result.current.expanded.has('node_modules')).toBe(false);-- view.unmount();- });-- /**- * 评审 P1(PR #4398 轮七)的另一半:反向切到放行态时,seed 是**隐藏态**的树- * (本来就看不到被忽略目录),不能拿它判断放行态自己的展开位不可达 —— `keep`- * 必须豁免本 scope 的持久记录,否则用户在放行态展开的 node_modules 会在切回时- * 被剪掉。- */- it('切到放行态时保留本 scope 已持久化的展开位(借来的隐藏树判不了它)', async () => {- const hiddenRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- ];- const revealedRoot: readonly DirEntry[] = [- ...hiddenRoot,- { name: 'node_modules', relPath: 'node_modules', type: 'directory', size: 0, mtimeMs: 2 },- ];- mocks.listDir.mockImplementation((args: { showIgnoredDirs?: boolean }) =>- Promise.resolve(args.showIgnoredDirs ? revealedRoot : hiddenRoot),- );- // 放行态 scope 上次会话存过 node_modules 展开位。- mocks.loadExpandedSet.mockImplementation(- (_workdir: string, opts?: { showIgnoredDirs?: boolean }) =>- opts?.showIgnoredDirs ? new Set(['node_modules']) : new Set<string>(),- );-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-scope-keep-reveal', showIgnoredDirs: reveal }),- { initialProps: { reveal: false } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));-- await act(async () => {- view.rerender({ reveal: true });- });-- // 借来的隐藏树里没有 node_modules,不能因此把放行态自己的展开位剪掉:- // 要么没回写,要么回写里必须带着它。- const revealWrites = mocks.saveExpandedSet.mock.calls- .filter((call) => (call[2] as { showIgnoredDirs?: boolean } | undefined)?.showIgnoredDirs === true)- .map((call) => call[1] as Set<string>);- expect(revealWrites.every((set) => set.has('node_modules'))).toBe(true);- expect(view.result.current.expanded.has('node_modules')).toBe(true);-- view.unmount();- });-- /**- * 评审(切开关丢失展开记录):seed 窗口内 root 先回、子目录列表还是兄弟 scope- * 借来的(借来的 `packages` 列表没有 node_modules)。此时收尾剪枝不得用借来的- * 列表否定本 scope 自己持久化的 `packages/node_modules` 展开位 —— 否则它被剪掉- * 并覆盖 localStorage,之后子目录响应只更新列表、不会恢复展开位。- */- it('seed 窗口 root 先回、子目录还是借来的列表时,保留本 scope 自己的展开位', async () => {- const hiddenRoot: readonly DirEntry[] = [- { name: 'packages', relPath: 'packages', type: 'directory', size: 0, mtimeMs: 1 },- ];- const hiddenPackages: readonly DirEntry[] = [];- const revealedRoot = hiddenRoot;- const revealedPackages: readonly DirEntry[] = [- {- name: 'node_modules',- relPath: 'packages/node_modules',- type: 'directory',- size: 0,- mtimeMs: 2,- },- ];- // 放行态 scope 上次会话存过 packages/node_modules 展开位。- mocks.loadExpandedSet.mockImplementation(- (_workdir: string, opts?: { showIgnoredDirs?: boolean }) =>- opts?.showIgnoredDirs ? new Set(['packages/node_modules']) : new Set<string>(),- );- // 挂住放行态的首次 root listDir(模拟 root 先于子目录数据就绪的窗口)。- const pendingRevealRoot = deferred<readonly DirEntry[]>();- let revealRootCalls = 0;- mocks.listDir.mockImplementation((args: { relPath?: string; showIgnoredDirs?: boolean }) => {- if (!args.showIgnoredDirs) {- return Promise.resolve((args.relPath ?? '') === '' ? hiddenRoot : hiddenPackages);- }- if ((args.relPath ?? '') === '') {- revealRootCalls += 1;- return revealRootCalls === 1- ? pendingRevealRoot.promise- : Promise.resolve(revealedRoot);- }- return Promise.resolve(revealedPackages);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-seed-root-first', showIgnoredDirs: reveal }),- { initialProps: { reveal: false } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));-- await act(async () => {- view.rerender({ reveal: true });- });- // seed 窗口内:创建时 creation prune 已用 keep 保住本 scope 的展开位。- expect(view.result.current.expanded.has('packages/node_modules')).toBe(true);-- // root 这才返回(此时 entries 里的 packages 列表仍是借来的空列表)。- await act(async () => {- pendingRevealRoot.resolve(revealedRoot);- await Promise.resolve();- });- await waitFor(() => expect(view.result.current.entries.get('')).toEqual(revealedRoot));-- // 借来的 packages 列表缺 node_modules ≠ 本 scope 的展开位过期:不得剪掉、- // 不得覆盖持久记录。- expect(view.result.current.expanded.has('packages/node_modules')).toBe(true);- const revealWrites = mocks.saveExpandedSet.mock.calls- .filter(- (call) =>- (call[2] as { showIgnoredDirs?: boolean } | undefined)?.showIgnoredDirs === true,- )- .map((call) => call[1] as Set<string>);- // 修好后的行为:借来的列表没有可剪的东西 → prune 早退、可能零回写;- // 旧代码会剪掉并回写一份不含它的记录 —— 两种情况下这条都必须成立。- expect(revealWrites.every((set) => set.has('packages/node_modules'))).toBe(true);-- view.unmount();- });-- /**- * 评审 P1:被忽略目录嵌在已展开的普通目录下时(`packages/foo/node_modules`),- * 只滤根列表的实现会把它一直留在展开的父目录下 —— 而且 prune 拿过期的 reveal- * 子列表判可达性,会把它保留到手动刷新。逐列表过滤后:首帧就不渲染它,prune 也- * 按新判据把它从展开集合里剪掉,同时不重拉任何目录。- */- it('关开关首帧滤掉展开父目录下的嵌套被忽略目录,prune 不再把它当可达', async () => {- const dir = (name: string, relPath: string): DirEntry => ({- name,- relPath,- type: 'directory',- size: 0,- mtimeMs: 1,- });- const revealedRoot = [dir('packages', 'packages')];- const revealedPackages = [dir('foo', 'packages/foo'), dir('node_modules', 'packages/node_modules')];- const revealedFoo = [dir('src', 'packages/foo/src'), dir('node_modules', 'packages/foo/node_modules')];-- const pendingRoot = deferred<readonly DirEntry[]>();- mocks.listDir.mockImplementation((args: { relPath?: string; showIgnoredDirs?: boolean }) => {- if (!args.showIgnoredDirs) return pendingRoot.promise;- if (args.relPath === 'packages') return Promise.resolve(revealedPackages);- if (args.relPath === 'packages/foo') return Promise.resolve(revealedFoo);- return Promise.resolve(revealedRoot);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-nested-filter', showIgnoredDirs: reveal }),- { initialProps: { reveal: true } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- await act(async () => {- view.result.current.toggleFolder('packages');- });- await waitFor(() => expect(view.result.current.entries.get('packages')).toBeDefined());- await act(async () => {- view.result.current.toggleFolder('packages/foo');- });- await waitFor(() => expect(view.result.current.entries.get('packages/foo')).toBeDefined());-- await act(async () => {- view.rerender({ reveal: false });- });-- // 首帧:两层列表里的 node_modules 行都不再渲染。- expect(view.result.current.entries.get('packages')?.map((e) => e.name)).toEqual(['foo']);- expect(view.result.current.entries.get('packages/foo')?.map((e) => e.name)).toEqual(['src']);-- // root 数据回来后:prune 按过滤后的父列表判可达性,剪掉折叠位。- await act(async () => {- pendingRoot.resolve(revealedRoot);- await Promise.resolve();- });- expect(view.result.current.expanded.has('packages/node_modules')).toBe(false);- expect(view.result.current.expanded.has('packages/foo/node_modules')).toBe(false);- expect(view.result.current.expanded.has('packages/foo')).toBe(true);-- view.unmount();- });-- /**- * 评审 P2:反方向(hidden → reveal)不能只靠过滤 —— hidden 态的数据**缺**了被- * 忽略目录,不重拉的话开了开关也看不到 node_modules / build,一直到手动刷新。- * 所以继承来的展开父目录要按新 matcher 重拉一遍。- */- it('开开关时重拉继承的展开父目录,让嵌套被忽略目录显示出来', async () => {- const dir = (name: string, relPath: string): DirEntry => ({- name,- relPath,- type: 'directory',- size: 0,- mtimeMs: 1,- });- const hiddenRoot: readonly DirEntry[] = [dir('packages', 'packages')];- const hiddenChild = [dir('foo', 'packages/foo')];- const revealedChild = [- dir('foo', 'packages/foo'),- dir('node_modules', 'packages/node_modules'),- ];- mocks.listDir.mockImplementation((args: { relPath?: string; showIgnoredDirs?: boolean }) => {- if (!args.showIgnoredDirs) {- return Promise.resolve(args.relPath === 'packages' ? hiddenChild : hiddenRoot);- }- return Promise.resolve(args.relPath === 'packages' ? revealedChild : hiddenRoot);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-reveal-refetch', showIgnoredDirs: reveal }),- { initialProps: { reveal: false } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- await act(async () => {- view.result.current.toggleFolder('packages');- });- await waitFor(() => expect(view.result.current.entries.get('packages')).toEqual(hiddenChild));-- mocks.listDir.mockClear();- await act(async () => {- view.rerender({ reveal: true });- });- await waitFor(() =>- expect(view.result.current.entries.get('packages')).toEqual(revealedChild),- );- // 重拉的确实是那个继承来的展开父目录。- expect(mocks.listDir).toHaveBeenCalledWith(- expect.objectContaining({ relPath: 'packages', showIgnoredDirs: true }),- );-- view.unmount();- });-- /**- * 评审 P1:只过滤行、不丢缓存会让隐藏态的下一次 refresh() 重扫它们 —— refresh- * 按 entries 的 key 逐个 listDir,node_modules 子树可能有数百个 key(SSH /- * device-link 上就是数百条 RPC)。- */- it('关开关丢弃被移除目录的缓存子树,refresh 不再重扫它们', async () => {- const dir = (name: string, relPath: string): DirEntry => ({- name,- relPath,- type: 'directory',- size: 0,- mtimeMs: 1,- });- const revealedRoot = [dir('src', 'src'), dir('node_modules', 'node_modules')];- const revealedNodeModules = [dir('pkg', 'node_modules/pkg')];- const revealedPkg = [dir('deep', 'node_modules/pkg/deep')];-- const hiddenRoot: readonly DirEntry[] = [dir('src', 'src')];- mocks.listDir.mockImplementation((args: { relPath?: string; showIgnoredDirs?: boolean }) => {- if (!args.showIgnoredDirs) return Promise.resolve(hiddenRoot);- if (args.relPath === 'node_modules') return Promise.resolve(revealedNodeModules);- if (args.relPath === 'node_modules/pkg') return Promise.resolve(revealedPkg);- return Promise.resolve(revealedRoot);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-drop-cache', showIgnoredDirs: reveal }),- { initialProps: { reveal: true } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- await act(async () => {- view.result.current.toggleFolder('node_modules');- });- await waitFor(() => expect(view.result.current.entries.has('node_modules')).toBe(true));- await act(async () => {- view.result.current.toggleFolder('node_modules/pkg');- });- await waitFor(() => expect(view.result.current.entries.has('node_modules/pkg')).toBe(true));-- await act(async () => {- view.rerender({ reveal: false });- });-- // 整棵缓存都丢,不只是父列表里那一行。- expect(view.result.current.entries.has('node_modules')).toBe(false);- expect(view.result.current.entries.has('node_modules/pkg')).toBe(false);-- // 刷新只会扫仍然可达的 key。- mocks.listDir.mockClear();- await act(async () => {- await view.result.current.refresh();- });- const rescanned = mocks.listDir.mock.calls- .map((c) => c[0].relPath as string)- .filter((p) => p === 'node_modules' || p.startsWith('node_modules/'));- expect(rescanned).toEqual([]);- expect(mocks.listDir).toHaveBeenCalledWith(expect.objectContaining({ relPath: '' }));-- view.unmount();- });-- /**- * 评审 P2(延续):进入隐藏态时就把继承的 reveal-only 展开位剪掉,所以过渡窗口- * 里的任何操作写下的集合都是干净的 —— 不再依赖「root 回来时回写」兜底(根请求- * 失败时那条路径根本不执行)。- */- it('过渡窗口操作目录也不会把 reveal-only 展开位写进隐藏 scope', async () => {- const revealedRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- { name: 'node_modules', relPath: 'node_modules', type: 'directory', size: 0, mtimeMs: 1 },- ];- const revealedChild: readonly DirEntry[] = [- { name: 'pkg', relPath: 'node_modules/pkg', type: 'directory', size: 0, mtimeMs: 1 },- ];- const hiddenRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- ];-- const pendingRoot = deferred<readonly DirEntry[]>();- mocks.listDir.mockImplementation((args: { relPath?: string; showIgnoredDirs?: boolean }) => {- if (!args.showIgnoredDirs) {- // 隐藏态的 root 故意挂起(慢通道),src 立刻返回避免测试悬空。- return args.relPath === 'src' ? Promise.resolve([]) : pendingRoot.promise;- }- if (args.relPath === 'node_modules') return Promise.resolve(revealedChild);- return Promise.resolve(revealedRoot);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-persist-prune', showIgnoredDirs: reveal }),- { initialProps: { reveal: true } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- await act(async () => {- view.result.current.toggleFolder('node_modules');- });- await waitFor(() => expect(view.result.current.expanded.has('node_modules')).toBe(true));-- // 切到隐藏态:root 挂起,处于过渡窗口;创建时就已剪掉继承来的展开位。- await act(async () => {- view.rerender({ reveal: false });- });- expect(view.result.current.expanded.has('node_modules')).toBe(false);-- // 过渡窗口里操作普通目录 —— 写进隐藏 scope 的集合必须是干净的(旧实现会把- // 继承来的 node_modules 一并写进去,之后只能靠 root 回来时的回写兜底)。- mocks.saveExpandedSet.mockClear();- await act(async () => {- view.result.current.toggleFolder('src');- });-- // root 数据回来也不该改变这个结论。- await act(async () => {- pendingRoot.resolve(hiddenRoot);- await Promise.resolve();- });- expect(view.result.current.expanded.has('node_modules')).toBe(false);-- const persistedHidden = mocks.saveExpandedSet.mock.calls- .filter((c) => c[2]?.showIgnoredDirs === false)- .map((c) => c[1] as Set<string>)- .at(-1);- expect(persistedHidden?.has('node_modules')).toBe(false);- expect(persistedHidden?.has('src')).toBe(true);-- view.unmount();- });-- /**- * 评审 P2:根请求**失败**时剪枝那条路径根本不会执行(它挂在 fetch 成功分支上),- * 而继承来的 reveal-only 展开位仍会随用户操作写进本 scope 的 localStorage。- * 所以创建 store 时就要按(可能已过滤的)继承树剪一次。- */- it('创建隐藏 store 时即剪掉继承的 reveal-only 展开位(根请求失败也不残留)', async () => {- const revealedRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- { name: 'node_modules', relPath: 'node_modules', type: 'directory', size: 0, mtimeMs: 1 },- ];- const revealedChild: readonly DirEntry[] = [- { name: 'pkg', relPath: 'node_modules/pkg', type: 'directory', size: 0, mtimeMs: 1 },- ];-- // 隐藏态的 listDir 全部失败(模拟根请求失败:剪枝没有第二次机会)。- mocks.listDir.mockImplementation((args: { relPath?: string; showIgnoredDirs?: boolean }) => {- if (!args.showIgnoredDirs) return Promise.reject(new Error('boom'));- if (args.relPath === 'node_modules') return Promise.resolve(revealedChild);- return Promise.resolve(revealedRoot);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-create-prune', showIgnoredDirs: reveal }),- { initialProps: { reveal: true } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- await act(async () => {- view.result.current.toggleFolder('node_modules');- });- await waitFor(() => expect(view.result.current.expanded.has('node_modules')).toBe(true));-- mocks.saveExpandedSet.mockClear();- await act(async () => {- view.rerender({ reveal: false });- });- await waitFor(() => expect(view.result.current.loadError).toBe('load-failed'));-- // 即使根请求失败:隐藏 scope 已经写入了剪枝后的集合,且不含 node_modules。- const persistedHidden = mocks.saveExpandedSet.mock.calls- .filter((c) => c[2]?.showIgnoredDirs === false)- .map((c) => c[1] as Set<string>)- .at(-1);- expect(persistedHidden).toBeDefined();- expect(persistedHidden?.has('node_modules')).toBe(false);- expect(view.result.current.expanded.has('node_modules')).toBe(false);-- view.unmount();- });-- it('根请求失败后 refresh 仍会重新请求根目录', async () => {- // 根失败会清空 entries(含根键);只遍历现有键的 refresh 就永远不会重试根,- // 连接恢复后点「重试 / 刷新」也没用。- let failRoot = true;- mocks.listDir.mockImplementation((args: { relPath?: string }) => {- if (failRoot && (args.relPath ?? '') === '') return Promise.reject(new Error('boom'));- return Promise.resolve([]);- });-- const view = renderHook(() => useFileTree({ workdir: '/workdir-retry-root' }));- await waitFor(() => expect(view.result.current.loadError).toBe('load-failed'));- expect(view.result.current.entries.size).toBe(0);-- failRoot = false;- mocks.listDir.mockClear();- await act(async () => {- await view.result.current.refresh();- });-- expect(mocks.listDir).toHaveBeenCalledWith(expect.objectContaining({ relPath: '' }));- await waitFor(() => expect(view.result.current.loadError).toBeNull());- view.unmount();- });-- /**- * 评审 P2:切开关后新 matcher 的根请求失败时,seed 借来的树**不代表当前视图**- * —— 留着它会让「开关已按下 + 树还是隐藏态旧数据」在 UI 上看起来像加载成功- * (错误占位只在 entries 为空时显示)。失败要可见、可重试。- */- it('切开关后根请求失败:清掉借来的旧树让错误可见', async () => {- const hiddenRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- ];- mocks.listDir.mockImplementation((args: { relPath?: string; showIgnoredDirs?: boolean }) => {- if (args.showIgnoredDirs) return Promise.reject(new Error('boom')); // reveal 侧全失败- if (args.relPath) return Promise.resolve([]);- return Promise.resolve(hiddenRoot);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-seed-fail', showIgnoredDirs: reveal }),- { initialProps: { reveal: false } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));-- // 切到 reveal:先借隐藏态的树(首帧仍有旧数据),随后根请求失败。- await act(async () => {- view.rerender({ reveal: true });- });- await waitFor(() => expect(view.result.current.loadError).toBe('load-failed'));- // 借来的旧树被清掉 → 走错误占位,而不是把旧数据当新视图。- expect(view.result.current.entries.size).toBe(0);- expect(view.result.current.initialLoading).toBe(false);- view.unmount();- });-- /**- * 评审 P1:切开关后根请求**成功**落地就该结束「借来的树」标记 —— 否则之后任何- * 一次根刷新失败(SSH / device-link 瞬时中断)都会把已属于本 scope 的树当成- * 借来的清掉,丢掉最后一次成功的树。- */- it('切开关成功落地后再失败:保留已属于本 scope 的树', async () => {- const hiddenRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- ];- const revealedRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- { name: 'node_modules', relPath: 'node_modules', type: 'directory', size: 0, mtimeMs: 2 },- ];- let failRevealRoot = false;- mocks.listDir.mockImplementation((args: { relPath?: string; showIgnoredDirs?: boolean }) => {- if (args.showIgnoredDirs) {- if (failRevealRoot && !args.relPath) return Promise.reject(new Error('boom'));- if (args.relPath) return Promise.resolve([]);- return Promise.resolve(revealedRoot);- }- if (args.relPath) return Promise.resolve([]);- return Promise.resolve(hiddenRoot);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-seed-clear', showIgnoredDirs: reveal }),- { initialProps: { reveal: false } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));-- // 切 reveal:根请求成功 → 「借来的树」标记到此结束。- await act(async () => {- view.rerender({ reveal: true });- });- await waitFor(() => expect(view.result.current.entries.get('')).toHaveLength(2));-- // 之后的根刷新失败:entries 已属于本 scope,应保留而不是清空。- failRevealRoot = true;- await act(async () => {- await view.result.current.refresh();- });- await waitFor(() => expect(view.result.current.loadError).toBe('load-failed'));- expect(view.result.current.entries.get('')).toHaveLength(2);- view.unmount();- });-- /**- * 上面那条 P1 的另一半:根响应与借来的树**结构一致**时走 entriesStructurallyEqual- * 的提前 return,同样必须结束「借来的树」标记。漏掉这条分支,store 会长久停在- * seeded=true —— 之后一次瞬时失败仍然会把用户最后一次成功的树清掉。- */- it('根结构与 seed 一致(走等价短路)也同样结束「借来的树」', async () => {- const sameRoot: readonly DirEntry[] = [- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- ];- let failRoot = false;- mocks.listDir.mockImplementation((args: { relPath?: string }) => {- if (failRoot && !args.relPath) return Promise.reject(new Error('boom'));- if (args.relPath) return Promise.resolve([]);- return Promise.resolve(sameRoot);- });-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-seed-equal', showIgnoredDirs: reveal }),- { initialProps: { reveal: false } },- );- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));-- // 切 reveal:新 store 借隐藏态的树(同结构),根响应走结构化等价短路。- await act(async () => {- view.rerender({ reveal: true });- });- await waitFor(() => expect(view.result.current.entries.get('')).toHaveLength(1));-- failRoot = true;- await act(async () => {- await view.result.current.refresh();- });- await waitFor(() => expect(view.result.current.loadError).toBe('load-failed'));- expect(view.result.current.entries.get('')).toHaveLength(1);- view.unmount();- });-- /**- * 兄弟 store 还在首次 listDir 上(慢通道)时不能冒充「已加载」:没有可显示内容- * 就保持 initialLoading,否则 FileTreeView 会把空 rows 渲染成「此文件夹为空」- * 而不是延迟 loading 态。- */- it('兄弟 store 还没有首帧数据时保持 initialLoading', async () => {- const pendingReveal = deferred<readonly DirEntry[]>();- const pendingHidden = deferred<readonly DirEntry[]>();- mocks.listDir.mockImplementation((args: { showIgnoredDirs?: boolean }) =>- args.showIgnoredDirs ? pendingReveal.promise : pendingHidden.promise,- );-- const view = renderHook(- ({ reveal }: { reveal: boolean }) =>- useFileTree({ workdir: '/workdir-seed-pending', showIgnoredDirs: reveal }),- { initialProps: { reveal: true } },- );- expect(view.result.current.initialLoading).toBe(true);-- await act(async () => {- view.rerender({ reveal: false });- });- // 兄弟 store 存在但没有可显示内容 → hidden 侧必须继续 loading。- expect(view.result.current.initialLoading).toBe(true);-- await act(async () => {- pendingHidden.resolve([- { name: 'src', relPath: 'src', type: 'directory', size: 0, mtimeMs: 1 },- ]);- await Promise.resolve();- });- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));-- view.unmount();- });-});--/**- * device-link 能力探测:老被控端的 listDir 会静默忽略 showIgnoredDirs ——- * 开关看起来按下去了、树里什么也不变。探到不支持就按隐藏态建 store,并把结论- * expose 给标题行(禁用 + 说明原因)。- */-describe('useFileTree device 的 showIgnoredDirs 能力探测', () => {- beforeEach(() => {- vi.clearAllMocks();- mocks.eventCallbacks.length = 0;- mocks.listDir.mockResolvedValue([]);- mocks.fileBrowserApiFor.mockReturnValue({ listDir: mocks.listDir });- mocks.loadExpandedSet.mockImplementation(() => new Set<string>());- mocks.deviceSupportsRevealIgnoredDirs.mockImplementation(async () => true);- mocks.reconnectEpoch.current = 0;- });-- it('老被控端:按隐藏态建 store,并 expose supported=false', async () => {- mocks.deviceSupportsRevealIgnoredDirs.mockImplementation(async () => false);- const view = renderHook(() =>- useFileTree({ workdir: '/workdir-old-device', deviceId: 'device-1', showIgnoredDirs: true }),- );- await waitFor(() => expect(view.result.current.showIgnoredDirsSupported).toBe(false));-- expect(mocks.deviceSupportsRevealIgnoredDirs).toHaveBeenCalledWith(- 'device-1',- '/workdir-old-device',- );- await waitFor(() =>- expect(mocks.listDir).toHaveBeenCalledWith(- expect.objectContaining({ showIgnoredDirs: false }),- ),- );- // 探测返回前可能已用偏好值乐观拉过一次;落定之后不能再发无效字段。- const calls = mocks.listDir.mock.calls;- expect(calls.length).toBeGreaterThan(0);- expect(calls[calls.length - 1][0].showIgnoredDirs).toBe(false);- view.unmount();- });-- it('支持的被控端:开关照常生效,supported=true', async () => {- const view = renderHook(() =>- useFileTree({ workdir: '/workdir-new-device', deviceId: 'device-2', showIgnoredDirs: true }),- );- await waitFor(() => expect(view.result.current.showIgnoredDirsSupported).toBe(true));- await waitFor(() =>- expect(mocks.listDir).toHaveBeenCalledWith(- expect.objectContaining({ showIgnoredDirs: true }),- ),- );- view.unmount();- });-- it('本地会话不做探测,supported 恒为 true', async () => {- const view = renderHook(() => useFileTree({ workdir: '/workdir-local' }));- await waitFor(() => expect(view.result.current.initialLoading).toBe(false));- expect(view.result.current.showIgnoredDirsSupported).toBe(true);- expect(mocks.deviceSupportsRevealIgnoredDirs).not.toHaveBeenCalled();- view.unmount();- });-- /**- * 瞬态失败(隧道不可达 / 重连中)不能被当成「对方版本过旧」:那会把开关错误地- * 禁用并显示升级提示,而连接恢复后也不会自愈。保持「未知」(不禁用) + 由- * 重连代次驱动重探。- */- it('瞬态失败保持未知并在重连后重探', async () => {- mocks.reconnectEpoch.current = 0;- mocks.deviceSupportsRevealIgnoredDirs.mockImplementation(async () => null);- const view = renderHook(() =>- useFileTree({ workdir: '/workdir-flaky', deviceId: 'device-flaky', showIgnoredDirs: true }),- );- await waitFor(() => expect(mocks.deviceSupportsRevealIgnoredDirs).toHaveBeenCalledTimes(1));- expect(view.result.current.showIgnoredDirsSupported).toBe(null);- // 未知 = 不禁用:树仍按用户偏好(开)建 store。- await waitFor(() =>- expect(mocks.listDir).toHaveBeenCalledWith(- expect.objectContaining({ showIgnoredDirs: true }),- ),- );-- // 连接恢复 → 重连代次自增 → 重新探测并落定。- mocks.deviceSupportsRevealIgnoredDirs.mockImplementation(async () => true);- mocks.reconnectEpoch.current = 1;- view.rerender();- await waitFor(() => expect(view.result.current.showIgnoredDirsSupported).toBe(true));- // 重连代次驱动的「重问」;缓存是否命中由 transport 自己按全局 reconnect 流记账- // (不依赖 hook 生命周期,见 fileBrowserTransport 的进程级重连代次)。- expect(mocks.deviceSupportsRevealIgnoredDirs).toHaveBeenCalledTimes(2);- view.unmount();- });-- it('已定的「不支持」不会被重连代次重置成未知(开关不闪)', async () => {- mocks.reconnectEpoch.current = 0;- mocks.deviceSupportsRevealIgnoredDirs.mockImplementation(async () => false);- const view = renderHook(() =>- useFileTree({ workdir: '/workdir-old2', deviceId: 'device-old2', showIgnoredDirs: true }),- );- await waitFor(() => expect(view.result.current.showIgnoredDirsSupported).toBe(false));-- mocks.reconnectEpoch.current = 1;- view.rerender();- await waitFor(() => expect(mocks.deviceSupportsRevealIgnoredDirs).toHaveBeenCalledTimes(2));- expect(view.result.current.showIgnoredDirsSupported).toBe(false);-- // 旧端升级后重连 → 结论改成支持。- mocks.deviceSupportsRevealIgnoredDirs.mockImplementation(async () => true);- mocks.reconnectEpoch.current = 2;- view.rerender();- await waitFor(() => expect(view.result.current.showIgnoredDirsSupported).toBe(true));- view.unmount();- });-});diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.tsindex eac3aaff41..149d94d3f3 100644--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts+++ b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts@@ -41,12 +41,10 @@* 不进 React state,避免 setState 触发不必要的订阅者重渲。*/-import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';+import { useCallback, useEffect, useMemo, useSyncExternalStore } from 'react';import { createLogger } from '@/lib/logger';-import { useDeviceLinkReconnectEpoch } from '@/features/device-link/useDeviceLinkReconnectEpoch';import {- deviceSupportsRevealIgnoredDirs,fileBrowserApiFor,isDeviceTooOldError,onFileTreeEventFor,@@ -54,10 +52,6 @@ import {stopWatchFor,} from '@/lib/fileBrowserTransport';import { loadExpandedSet, saveExpandedSet } from '../lib/expandedStore';-import {- BUILTIN_IGNORE_ALWAYS,- BUILTIN_IGNORE_REVEALABLE,-} from '../../../../../shared/ignoreNames';const log = createLogger('useFileTree');@@ -92,14 +86,6 @@ interface UseFileTreeOptions {* new/deleted doc file can change which dirs appear at any depth above).*/docMode?: boolean;- /**- * 用户开关「显示被忽略的目录」:列出依赖 / 构建产物 / 缓存目录- * (build / dist / out / node_modules / Library ...)。- *- * 进 store key:切换开关会换一份 store(listDir 与 watcher 都用新 matcher- * 重建),已展开目录的缓存在新 store 里重建。- */- showIgnoredDirs?: boolean;}export interface UseFileTreeReturn {@@ -113,25 +99,13 @@ export interface UseFileTreeReturn {initialLoading: boolean;/** root 加载失败标记(device-too-old = 对方设备版本过旧);见 store 注释。 */loadError: 'device-too-old' | 'load-failed' | null;- /**- * 「显示被忽略的目录」在当前会话是否真的生效:- * - true 本地 / SSH / 支持该字段的被控端;- * - false device-link 连到老 Desktop —— 它的 listDir 静默忽略这个字段,- * 开关看起来按下去了、树里什么也不变;- * - null device 会话首帧,能力探测还没回来(非 device 会话恒为 true)。- * 标题行据此把开关渲染成不可用 + 说明原因;树本身在 false 时已经按隐藏态- * 建 store(不向老端发一个无效字段)。- */- showIgnoredDirsSupported: boolean | null;- /** 当前 store 的稳定标识(workdir + hideMetaFiles + showIgnoredDirs + host/device)。- * 切「显示被忽略的目录」会换一份 store,这个值跟着变;同一 store 内因 snapshot- * 更新造成的重渲染不会变 —— 需要区分"换视图"与"同一视图刷新"的地方(如滚动- * 锚点、DOM 复用判定)用它,而不是靠对象引用。 */+ /** 当前 store 的稳定标识(workdir + 显示模式 + host/device)。刷新 / snapshot 更新+ * 会变 —— 需要区分"换 store"与"同一 store 刷新"的地方用它,而不是靠对象引用。 */storeKey: string;- /** 树身份(workdir + 远端/设备,不含显示模式段)。开关「显示被忽略的目录」不变;- * 切项目 / 换远端才变 —— 滚动锚点继承靠它区分「同树换视口」与「换树」。 */+ /** 树身份(workdir + 远端/设备,不含显示模式段)。切项目 / 换远端才变 —— 滚动+ * 锚点继承靠它区分「同树换视口」(可继承位置)与「换树」(位置不得跨树泄漏)。 */treeIdentityKey: string;toggleFolder: (relPath: string) => void;@@ -142,9 +116,8 @@ export interface UseFileTreeReturn {* 展开 relPath 的所有祖先目录(让该文件可见),触发未 cache 的目录 lazy fetch,* 返回 Promise 等所有 listDir 完成。*- * 用于"筛选文件 / 搜索 / 跳转"等需要把目标文件在树里露出来的场景 —— 上层调- * 完 expandToPath 再调 FileTreeView 的 scrollToPath 把那一行滚进视口,visual- * 节奏稳(虚拟化后由 virtualizer.scrollToIndex 完成)。+ * 用于"筛选文件 / 搜索 / 跳转"等需要把目标��件在树里露出来的场景 —— 上层调+ * 完 expandToPath 再 scrollIntoView 那一行,visual 节奏稳。** Root 文件(relPath 不含 '/')直接 no-op return —— 它已经在根级,无需展开。*/@@ -198,7 +171,6 @@ interface FileTreeStore {readonly deviceId: string | null;readonly hideMetaFiles: boolean;readonly docMode: boolean;- readonly showIgnoredDirs: boolean;snapshot: {entries: ReadonlyMap<string, readonly DirEntry[]>;expanded: ReadonlySet<string>;@@ -211,14 +183,6 @@ interface FileTreeStore {*/loadError: 'device-too-old' | 'load-failed' | null;};- /** 本 store 的 entries 是否还是从兄弟 scope **借来**的 seed 数据(切换开关的- * 过渡窗口)。借来的树一旦根请求失败就不代表当前视图,留着会让失败看起来像- * 加载成功(评审 P2)。 */- seeded: boolean;- /** 本 scope **自己持久化过**的展开位(创建时从 localStorage 读出的那份)。- * seed 窗口收尾的 root 剪枝要继续豁免它们:那时子目录列表可能还是兄弟 scope- * 借来的,列表缺路径 ≠ 本 scope 的展开位过期(评审:切开关丢失展开记录)。 */- readonly persistedExpanded: ReadonlySet<string>;/** 同一 relPath 的并发 listDir,latest 赢:每次开 listDir 前 bump,resolve* 时比对 —— 不一致就丢结果。 */tokens: Map<string, number>;@@ -247,13 +211,12 @@ const stores = new Map<string, FileTreeStore>();function storeKey(opts: Required<UseFileTreeOptions>): string {const remote = opts.remoteHostId ? `::remote=${opts.remoteHostId}` : '';const device = opts.deviceId ? `::device=${opts.deviceId}` : '';- const reveal = opts.showIgnoredDirs ? '::reveal' : '';- return `${opts.workdir}::doc=${opts.docMode}::hideMeta=${opts.hideMetaFiles}${reveal}${remote}${device}`;+ return `${opts.workdir}::doc=${opts.docMode}::hideMeta=${opts.hideMetaFiles}${remote}${device}`;}-/** 树身份:工作目录 + 远端/设备,不含显示模式段(reveal / doc / hideMeta)。- * 开关「显示被忽略的目录」不变;切项目 / 换远端才变。滚动锚点继承用它区分- * 「同树换视口」(可继承位置)与「换树」(位置不得跨树泄漏,评审 P2)。 */+/** 树身份:工作目录 + 远端/设备,不含显示模式段(doc / hideMeta)。同一棵树内+ * 切换显示模式不变;切项目 / 换远端才变。滚动位置恢复用它区分「同树换视口」+ * (可继承滚动锚点)与「换树」(丢弃锚点、回到顶部)。 */function treeIdentityKey(workdir: string,remoteHostId: string | null,@@ -268,167 +231,10 @@ function emit(store: FileTreeStore): void {for (const l of store.listeners) l();}-/**- * 隐藏态会忽略的一级目录名。名单从 @cindy/file-browser-core/ignoreNames 单源- * 导入(经 shared 转发),只覆盖内置项 —— `.gitignore` / `.p4ignore` 里的自定义- * 条目 renderer 拿不到,要等新 matcher 的数据回来才消失。- *- * 名单与比较都折叠大小写:matcher 的 `ignore` 包默认 `ignorecase=true`,大小写- * 变体(`DIST` / `BUILD`)在隐藏态同样不可见,不折叠会让它们在首帧多留一拍。- */-const HIDDEN_VIEW_DIR_NAMES = new Set(- [...BUILTIN_IGNORE_ALWAYS, ...BUILTIN_IGNORE_REVEALABLE]- .filter((name) => name.endsWith('/'))- .map((name) => name.slice(0, -1).toLowerCase()),-);--/**- * 关开关的首帧过滤:把 reveal 态树里「隐藏态会被忽略」的目录行**逐列表**拿掉- * —— 不只是根列表。被忽略目录可能嵌在已展开的普通目录下面- * (`packages/foo/node_modules`):只滤根列表的话它会一直挂在展开的父目录下,- * 而 pruneExpandedForCurrentTree 会拿**过期的 reveal 子列表**当可达性依据、- * 把它判成可达,于是永久保留到手动刷新。- *- * 同时**丢掉被移除目录的整棵缓存**(不只是那一行):它们不再可达,但 refresh()- * 是「按 entries 的 key 逐个 listDir」—— 留着会让隐藏态下一次刷新给 node_modules- * 子树白发数百个 listDir(本地卡顿,SSH / device-link 上就是数百条 RPC)。- *- * 逐列表过滤同时修好 prune 的判据:父列表里已经没有那一行,可达性自然为假。- * 其余子树缓存与展开集合整体不动(不可达的分支本来就不渲染),不重拉任何目录 ——- * 「整体一次性消失」的观感不变。- *- * 只覆盖内置名单:`.gitignore` / `.p4ignore` 的自定义条目 renderer 拿不到- * (不读盘),要等新 matcher 的数据回来才消失。- */-function filterSeedTreeForHiddenView(- entries: ReadonlyMap<string, readonly DirEntry[]>,-): ReadonlyMap<string, readonly DirEntry[]> {- const droppedRoots = new Set<string>();- const next = new Map<string, readonly DirEntry[]>();- for (const [dir, list] of entries) {- const kept = list.filter((entry) => {- if (entry.type === 'directory' && HIDDEN_VIEW_DIR_NAMES.has(entry.name.toLowerCase())) {- droppedRoots.add(entry.relPath);- return false;- }- return true;- });- next.set(dir, kept.length === list.length ? list : kept);- }- if (droppedRoots.size === 0) return entries;- for (const dir of [...next.keys()]) {- if (dir === ROOT_KEY) continue;- // 逐级向上查:key 落在被移除目录自己或它的子树里就丢。- for (let probe = dir; probe !== ''; ) {- if (droppedRoots.has(probe)) {- next.delete(dir);- break;- }- const cut = probe.lastIndexOf('/');- probe = cut < 0 ? '' : probe.slice(0, cut);- }- }- return next;-}--/**- * 切换「显示被忽略的目录」会换一份 store(key 含 reveal 位),新 store 若从- * 空快照 + initialLoading 起步,FileTreeView 会把整棵树替换成占位(本地- * <300ms 连 spinner 都没有,就是空白),视觉上闪一下;同一 workdir 的另一半- * reveal scope 的 store 此刻通常还在表里 —— 旧 store 的 refCount 归零发生在- * 本次 commit 的 effect cleanup,晚于 render 期间的 useMemo —— 借它- * **整棵可见的树**(entries + expanded)当首帧内容,新 matcher 的 listDir 回来- * 后再整体替换。- *- * 为什么整棵借、而不是只借根列表:只借根列表会把消失动作拆成两段 —— 子行先因- * expanded 掉落而消失(父行还在),root 数据回来再拿掉父行 —— 多级展开时看起来- * 就是「从最子级逐级折叠回去」。整棵借过来,关闭开关的动作是一次性的:树先保持- * 不动,数据回来整体切换。- *- * 代价是过渡窗口(reveal → hidden)里旧 matcher 的行还会短暂可见 —— 窗口就是- * 一次 listDir(本地 <12ms;慢通道到数据回来为止)。这是有意的取舍:全量、一次性- * 地消失,比先闪空再重建、或逐级折叠都更接近直觉。- *- * 借来的 expanded 是**过渡态**:initStore 不据此 warm(免得给被忽略路径白发- * listDir),root 数据回来时由 pruneExpandedForCurrentTree 按新树剪掉不可达路径- * —— 否则它们会落进 hidden scope 的 localStorage,下次启动白拉一批。- *- * 「刷新」按钮没有这个问题:它在同一份 store 上原地 refetch,从不经过空态。- */-function findRevealSiblingSnapshot(- opts: Required<UseFileTreeOptions>,-): FileTreeStore['snapshot'] | null {- const siblingKey = storeKey({ ...opts, showIgnoredDirs: !opts.showIgnoredDirs });- return stores.get(siblingKey)?.snapshot ?? null;-}--/**- * root 数据回来后,把「过渡期借来的、在当前树上不可达的展开路径」剪掉。- *- * 切开关时 seed 会把另一半 reveal scope 的整棵可见树带过来(见- * findRevealSiblingSnapshot)。hidden 树下 node_modules / Library 这类路径已经- * 不在 root 列表里,但它们的展开态还挂在 expanded 上 —— 留着会让用户在 hidden- * 态做下一次操作时把它们写进 hidden scope 的 localStorage,下次启动就白发一批- * listDir。逐级查父链:任一级不在对应父列表里即不可达。- *- * 查不到祖先列表(缓存被清 / 还没拉过)时保守保留 —— 宁可留一个 stale 展开位,- * 也不能把用户真实的展开态删掉。- *- * 剪枝后**同步回写持久化**(评审 P2):过渡窗口里 root 数据还没到时,用户若做过- * 一次 toggleFolder,那次 saveExpandedSet 会把继承来的 reveal-only 路径一并- * 写进本 scope —— 不回写就会把它们固化进 localStorage,下次挂载按这些路径逐个- * listDir(上限 200 个,SSH / device-link 上代价明显)。- *- * `keep`:目标 scope **自己持久化过**的展开位,豁免剪枝。回写是整份覆盖,调用方- * 必须先把这些路径并进 `snapshot.expanded` 再调本函数,否则它们会被这次回写抹掉- * (评审 P1:借来的树只能当过渡内容,不能拿它否定本 scope 自己的记录)。- */-function pruneExpandedForCurrentTree(- store: FileTreeStore,- opts?: { keep?: ReadonlySet<string> },-): void {- if (!store.snapshot.entries.has(ROOT_KEY)) return;- const reachable = (relPath: string): boolean => {- const parts = relPath.split('/');- let parent = ROOT_KEY;- for (const part of parts) {- const list = store.snapshot.entries.get(parent);- if (!list) return true;- const child = parent === ROOT_KEY ? part : `${parent}/${part}`;- if (!list.some((entry) => entry.relPath === child)) return false;- parent = child;- }- return true;- };- const next = new Set<string>();- let changed = false;- for (const relPath of store.snapshot.expanded) {- if (relPath === ROOT_KEY || opts?.keep?.has(relPath) || reachable(relPath)) next.add(relPath);- else changed = true;- }- if (!changed) return;- store.snapshot = { ...store.snapshot, expanded: next };- emit(store);- saveExpandedSet(store.workdir, next, { showIgnoredDirs: store.showIgnoredDirs });-}-function getOrCreateStore(opts: Required<UseFileTreeOptions>): FileTreeStore {const key = storeKey(opts);const existing = stores.get(key);if (existing) return existing;- // 切开关路径:借另一半 reveal scope 的整棵树当首帧内容,不经过 initialLoading- // 空白;首次挂载(无兄弟 store)仍走原来的 loading 路径。- const seed = findRevealSiblingSnapshot(opts);- // 本 scope 自己持久化过的展开位:seed 是**过渡内容**,而下面的剪枝会同步回写- // 本 scope 的 localStorage —— 不先读出来并进快照,「借来的树里不可达」就会- // 连带抹掉本 scope 原有记录(评审 P1:切回隐藏态后目录无故全部折叠)。- const persistedExpanded = loadExpandedSet(opts.workdir, {- showIgnoredDirs: opts.showIgnoredDirs,- });- // 兄弟 store 可能还卡在首次 listDir 上(慢通道):没有可显示内容时不得冒充- // 「已加载」—— 否则 FileTreeView 会把 initialLoading:false + 空 rows 渲染成- // 「此文件夹为空」,而不是延迟 loading 态。终态错误可显示(渲染错误占位)。- const seedDisplayable = !!seed && (seed.entries.size > 0 || seed.loadError !== null);const store: FileTreeStore = {key,workdir: opts.workdir,@@ -436,32 +242,13 @@ function getOrCreateStore(opts: Required<UseFileTreeOptions>): FileTreeStore {deviceId: opts.deviceId,hideMetaFiles: opts.hideMetaFiles,docMode: opts.docMode,- showIgnoredDirs: opts.showIgnoredDirs,- snapshot:- seedDisplayable && seed- ? {- // 关开关的首帧就滤掉内置忽略目录(避免慢通道下它们在新数据回来前- // 还挂在「已隐藏」的视图里),见 filterSeedTreeForHiddenView。- entries: opts.showIgnoredDirs- ? seed.entries- : filterSeedTreeForHiddenView(seed.entries),- // 借来的过渡展开态 + 本 scope 已有的持久记录(见上方 persistedExpanded)。- expanded: new Set([...seed.expanded, ...persistedExpanded]),- // 新 store 自己还没有 in-flight 请求,seed 的 loadingPaths 不继承。- loadingPaths: new Set(),- initialLoading: false,- // 错误态一并继承:首帧直接是错误占位,而不是先闪一帧空树再变错误。- loadError: seed.loadError,- }- : {- entries: new Map(),- expanded: new Set([ROOT_KEY]),- loadingPaths: new Set(),- initialLoading: true,- loadError: null,- },- seeded: seedDisplayable && !!seed,- persistedExpanded,+ snapshot: {+ entries: new Map(),+ expanded: new Set([ROOT_KEY]),+ loadingPaths: new Set(),+ initialLoading: true,+ loadError: null,+ },tokens: new Map(),inFlight: new Map(),pendingEventParents: new Set(),@@ -470,13 +257,6 @@ function getOrCreateStore(opts: Required<UseFileTreeOptions>): FileTreeStore {refCount: 0,listeners: new Set(),};- // 继承来的展开集合要按**(可能已过滤的)**树剪一次:剪枝那条路径挂在 fetch- // 成功分支上,根请求失败时根本不会执行 —— 而 reveal-only 路径一旦被写进本- // scope 的 localStorage(用户在错误恢复前操作目录、或 expandToPath 等路径),- // 下次挂载就会变成最多 200 次无用 listDir(评审 P2)。剪完顺带回写本 scope。- // `keep` = 本 scope 自己的持久记录:借来的树只能判「借来的路径」,不能否定本- // scope 的展开位(评审 P1)。- pruneExpandedForCurrentTree(store, { keep: persistedExpanded });stores.set(key, store);return store;}@@ -495,57 +275,27 @@ async function fetchDirOnce(store: FileTreeStore, relPath: string): Promise<voidrelPath,hideMetaFiles: store.hideMetaFiles,docMode: store.docMode,- showIgnoredDirs: store.showIgnoredDirs,});if (store.tokens.get(relPath) !== myToken) return; // staleif (store.snapshot.loadError) {store.snapshot = { ...store.snapshot, loadError: null };}- // 根请求**成功**(无论后面是否结构等价而跳过替换)都代表「借来的树」窗口- // 结束:之后任何一次根刷新失败都不能再把已属于本 scope 的树当成借来的清掉- // (评审 P1;结构等价的路径同样要落定,否则会长久停在"借来"态)。- // wasSeeded 必须在清标志前捕获:seed 窗口收尾的这次 root 剪枝,子目录列表- // 可能还是兄弟 scope 借来的(root 先回、子目录后回)—— 借来的列表缺路径 ≠- // 本 scope 的展开位过期,要继续豁免本 scope 自己的持久记录;等后续 root- // 刷新(entries 已全属本 scope)再做精确剪枝(评审:切开关丢失展开记录)。- const wasSeeded = store.seeded;- if (relPath === ROOT_KEY) store.seeded = false;- // 结构等价 → 跳过 setEntries,避免子组件无意义重渲(参见函数顶部注释)。- // root 仍要 prune 一次:seed 的 root 可能与新 root 结构一致而展开态还是借的。+ // 结构等价 → 跳过 setEntries,避免子组件无意义重渲(参见函数顶部注释)。const prevList = store.snapshot.entries.get(relPath);- if (prevList && entriesStructurallyEqual(prevList, list)) {- if (relPath === ROOT_KEY) {- pruneExpandedForCurrentTree(store, wasSeeded ? { keep: store.persistedExpanded } : undefined);- }- return;- }+ if (prevList && entriesStructurallyEqual(prevList, list)) return;const nextEntries = new Map(store.snapshot.entries);nextEntries.set(relPath, list);store.snapshot = { ...store.snapshot, entries: nextEntries };emit(store);- // 过渡期(seed)借来的展开态在新树里可能已不可达,root 数据落地即剪。- if (relPath === ROOT_KEY) {- pruneExpandedForCurrentTree(store, wasSeeded ? { keep: store.persistedExpanded } : undefined);- }} catch (err) {log.warn(`listDir failed for ${relPath}`, err);// root 失败要可见:空树 + 无提示会被读成"项目是空的"。device-link 的// 版本偏差(老被控端无 remote-op channel)单独标记,渲染升级提示。if (relPath === ROOT_KEY) {- const seededEntries = store.seeded;- store.seeded = false;store.snapshot = {...store.snapshot,- // seed 过渡:借来的树一旦根请求失败就不代表当前视图,留着会让「开关已按下- // + 树还是隐藏态旧数据」看起来像加载成功(错误占位只在 entries 为空时显示,- // 见 FileBrowserBody)。清掉它让失败可见且可重试;只清一次,之后恢复既有- // 「保留旧树」语义(那时 entries 确实属于当前视图)(评审 P2)。- entries: seededEntries ? new Map() : store.snapshot.entries,loadError: isDeviceTooOldError(err) ? 'device-too-old' : 'load-failed',};- // 借来的展开态在空树下不可达,剪枝与回写由**创建时**那次- // pruneExpandedForCurrentTree(getOrCreateStore)完成;root 首次失败时- // snapshot.entries 已被清空,再调 prune 会因缺 ROOT_KEY 直接早退,不重复。emit(store);}// Keep prior state; user can refresh manually.@@ -653,12 +403,9 @@ function queueEventRefresh(store: FileTreeStore, eventRelPath: string): void {/** 首次挂载触发:initial fetch + 恢复 localStorage expanded + 启动 watcher。* 幂等:重复调用直接 no-op(refCount 已 >0)。 */async function initStore(store: FileTreeStore): Promise<void> {- // 恢复 localStorage 持久化的 expanded 集合(workdir × 视图模式共享,见- // expandedStore 的 scope 说明)。seed 带来的展开集合是过渡态(见- // findRevealSiblingSnapshot):先一并留着让整树平滑替换,root 数据回来时- // pruneExpandedForCurrentTree 按新树剪掉不可达路径。- const restored = loadExpandedSet(store.workdir, { showIgnoredDirs: store.showIgnoredDirs });- const nextExpanded = new Set<string>([ROOT_KEY, ...restored, ...store.snapshot.expanded]);+ // 恢复 localStorage 持久化的 expanded 集合(workdir 维度共享)。+ const restored = loadExpandedSet(store.workdir);+ const nextExpanded = new Set<string>([ROOT_KEY, ...restored]);store.snapshot = { ...store.snapshot, expanded: nextExpanded };emit(store);@@ -671,7 +418,6 @@ async function initStore(store: FileTreeStore): Promise<void> {workdir: store.workdir,remoteHostId: store.remoteHostId,hideMetaFiles: store.hideMetaFiles,- showIgnoredDirs: store.showIgnoredDirs,}).catch((err) => log.warn('startWatch failed', err));store.watcherOff = onFileTreeEventFor(store.deviceId, (event) => {@@ -682,51 +428,14 @@ async function initStore(store: FileTreeStore): Promise<void> {// Initial root fetch + 已 restore expanded 目录的并行 lazy fetch。每个 listDir// <12ms,即使 50 个 restored 也能在 <1s 内 warm 完。- //- // seed 带来的展开父目录(不在 restored 里的那些)按**方向**分别处理:- // - 切到 reveal:hidden 态的数据缺了被忽略目录,不重拉就永远看不到- // node_modules / build(评审 P2),所以按新 matcher 重拉一遍;- // - 切到 hidden:reveal 态的数据多出被忽略项,首帧已由- // filterSeedTreeForHiddenView 就地滤掉,不再白发一轮 listDir。- const inheritedExpanded = [...store.snapshot.expanded].filter(- (p) => p !== ROOT_KEY && !restored.has(p),- );- const refetchInherited = store.showIgnoredDirs ? inheritedExpanded : [];- invalidateBorrowedCollapsedEntries(store);await Promise.all([fetchDir(store, ROOT_KEY),...[...restored].map((p) => fetchDir(store, p)),- ...refetchInherited.map((p) => fetchDir(store, p)),]);store.snapshot = { ...store.snapshot, initialLoading: false };emit(store);}-/**- * 切到 reveal 态时,让「借来且当前收起」的目录条目失效。- *- * seed 借的是另一半 scope 的 entries 快照。展开中的目录会被 refetchInherited 按新- * matcher 重拉;但「展开过又收起」的目录不在 expanded 里,既不会被重拉,- * toggleFolder 又见 entries.has() 就跳过请求 —— 那条缓存仍是 hidden 态的结果,- * 缺 packages/dist 这类被忽略目录,之后展开也补不回来(评审 P1)。- *- * 只在「借来的 + reveal 态」清理:首次挂载的 store 没有陈旧条目可清;切回 hidden- * 态时 seed 已由 filterSeedTreeForHiddenView 就地滤掉,不受影响。- */-function invalidateBorrowedCollapsedEntries(store: FileTreeStore): void {- if (!store.seeded || !store.showIgnoredDirs) return;- const expanded = store.snapshot.expanded;- const entries = new Map(store.snapshot.entries);- let dropped = 0;- for (const path of [...entries.keys()]) {- if (path === ROOT_KEY || expanded.has(path)) continue;- entries.delete(path);- dropped++;- }- if (dropped === 0) return;- store.snapshot = { ...store.snapshot, entries };-}-/** 最后一个订阅者离开:停 watcher、从 stores 表移除。store 对象被回收。 */function disposeStore(store: FileTreeStore): void {if (store.eventFlushTimer) clearTimeout(store.eventFlushTimer);@@ -758,7 +467,7 @@ function toggleFolder(store: FileTreeStore, relPath: string): void {void fetchDir(store, relPath);}}- saveExpandedSet(store.workdir, next, { showIgnoredDirs: store.showIgnoredDirs });+ saveExpandedSet(store.workdir, next);store.snapshot = { ...store.snapshot, expanded: next };emit(store);}@@ -769,7 +478,7 @@ function collapseAll(store: FileTreeStore): void {const nextEntries = new Map<string, readonly DirEntry[]>();const rootEntries = prevEntries.get(ROOT_KEY);if (rootEntries) nextEntries.set(ROOT_KEY, rootEntries);- saveExpandedSet(store.workdir, new Set(), { showIgnoredDirs: store.showIgnoredDirs });+ saveExpandedSet(store.workdir, new Set());store.snapshot = {...store.snapshot,expanded: nextExpanded,@@ -779,10 +488,8 @@ function collapseAll(store: FileTreeStore): void {}async function refresh(store: FileTreeStore): Promise<void> {- // 根目录必须恒在请求列表里:根请求失败会清空 entries(含 ROOT_KEY),- // 而只遍历现有键时根就永远不会被重试,连接恢复后点「重试 / 刷新」也没用。- const targets = new Set<string>([ROOT_KEY, ...store.snapshot.entries.keys()]);- await Promise.all([...targets].map((p) => fetchDir(store, p)));+ const targets = [...store.snapshot.entries.keys()];+ await Promise.all(targets.map((p) => fetchDir(store, p)));}async function expandToPath(store: FileTreeStore, relPath: string): Promise<void> {@@ -796,7 +503,7 @@ async function expandToPath(store: FileTreeStore, relPath: string): Promise<void// 一次性写 expanded setconst nextExpanded = new Set(store.snapshot.expanded);for (const a of ancestors) nextExpanded.add(a);- saveExpandedSet(store.workdir, nextExpanded, { showIgnoredDirs: store.showIgnoredDirs });+ saveExpandedSet(store.workdir, nextExpanded);store.snapshot = { ...store.snapshot, expanded: nextExpanded };emit(store);// 未 cache 的祖先并行 fetch@@ -812,62 +519,12 @@ export function useFileTree({deviceId = null,hideMetaFiles = true,docMode = false,- showIgnoredDirs = false,}: UseFileTreeOptions): UseFileTreeReturn {- // device 会话:探测被控端是否支持 showIgnoredDirs。老端的 listDir 会静默忽略- // 这个字段 —— 开关看起来按下去了、树里什么也不变。- //- // 探到不支持就按“隐藏态”建 store(不给老端发无效字段),并把结论 expose 给- // 标题行(开关渲染成不可用 + 说明原因)。非 device 会话恒为 true。- //- // 瞬态失败(隧道不可达 / 重连中)保持「未知」而不是落定成 false:把一次网络抖动- // 显示成「对方版本过旧」并把开关禁掉,连接恢复后也不会自愈。重探由- // reconnectEpoch 驱动 —— relay 或目标设备恢复 online 时它自增。- const revealReconnectEpoch = useDeviceLinkReconnectEpoch(deviceId ?? undefined);- const [deviceRevealSupported, setDeviceRevealSupported] = useState<boolean | null>(null);- /** 上次探测结论归属的设备;换设备不留用旧结论(重连不清,避免开关闪一下)。 */- const revealProbedDeviceRef = useRef<string | null>(null);- useEffect(() => {- if (!deviceId) {- revealProbedDeviceRef.current = null;- setDeviceRevealSupported(null);- return;- }- if (revealProbedDeviceRef.current !== deviceId) {- revealProbedDeviceRef.current = deviceId;- setDeviceRevealSupported(null);- }- let cancelled = false;- // reconnectEpoch 在这里只负责「何时重问」;缓存代次由 transport 自己按全局- // reconnect 流记账 —— hook 卸载期间的重连它也能看到(见 fileBrowserTransport)。- void deviceSupportsRevealIgnoredDirs(deviceId, workdir).then((supported) => {- if (cancelled) return;- // null = 瞬态失败:保持现状(首帧仍是「未知」,已有结论也不推翻),- // 等下一次 reconnectEpoch 或重新挂载时再问一次。- if (supported === null) return;- setDeviceRevealSupported(supported);- });- return () => {- cancelled = true;- };- }, [deviceId, workdir, revealReconnectEpoch]);-- // 探测未返回时(device 首帧)沿用用户偏好:猜错只多一次重建,不会发出无法- // 兑现的用户可见承诺。- const effectiveShowIgnoredDirs = showIgnoredDirs && deviceRevealSupported !== false;-// store 实例按 (workdir + options) 共享 —— 多个 hook 实例订阅同一份。// memo 用 dep 化 options,确保 workdir 切换会换 store。const store = useMemo(- () => getOrCreateStore({- workdir,- remoteHostId,- deviceId,- hideMetaFiles,- docMode,- showIgnoredDirs: effectiveShowIgnoredDirs,- }),- [workdir, remoteHostId, deviceId, hideMetaFiles, docMode, effectiveShowIgnoredDirs],+ () => getOrCreateStore({ workdir, remoteHostId, deviceId, hideMetaFiles, docMode }),+ [workdir, remoteHostId, deviceId, hideMetaFiles, docMode],);// ref-count 生命周期:首挂触发 init(initial fetch + start watch),最后离开@@ -915,8 +572,6 @@ export function useFileTree({loadingPaths: snapshot.loadingPaths,initialLoading: snapshot.initialLoading,loadError: snapshot.loadError,- // 非 device 会话恒 true;device 会话见上面探测注释。- showIgnoredDirsSupported: deviceId ? deviceRevealSupported : true,storeKey: store.key,treeIdentityKey: treeIdentityKey(store.workdir, store.remoteHostId, store.deviceId),toggleFolder: toggleFolderCb,@@ -924,6 +579,6 @@ export function useFileTree({refresh: refreshCb,expandToPath: expandToPathCb,}),- [snapshot, deviceId, deviceRevealSupported, store, toggleFolderCb, collapseAllCb, refreshCb, expandToPathCb],+ [snapshot, store, toggleFolderCb, collapseAllCb, refreshCb, expandToPathCb],);}diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/__tests__/expandedStore.test.ts b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/__tests__/expandedStore.test.tsdeleted file mode 100644index fe9c42738f..0000000000--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/__tests__/expandedStore.test.ts+++ /dev/null@@ -1,74 +0,0 @@-// @vitest-environment jsdom--/**- * expandedStore — 展开态按「显示被忽略的目录」分片持久化。- *- * 起因(评审 P2):放行态展开过 node_modules / Library 后切回隐藏态,旧实现按- * workdir 单一键恢复 → init 会把上百个隐藏的巨大目录当成"已展开"并行 listDir- * (本地卡顿,SSH 上一条条 RPC)。隐藏态必须只看到「隐藏态里展开过的目录」。- */-import { beforeEach, describe, expect, it } from 'vitest';--import { loadExpandedSet, saveExpandedSet } from '../expandedStore';--describe('expandedStore 按 showIgnoredDirs 分片', () => {- beforeEach(() => {- localStorage.clear();- });-- it('放行态写入不污染隐藏态', () => {- saveExpandedSet('/repo', new Set(['Assets', 'node_modules']), { showIgnoredDirs: true });-- expect([...loadExpandedSet('/repo')]).toEqual([]);- expect([...loadExpandedSet('/repo', { showIgnoredDirs: true })]).toEqual([- 'Assets',- 'node_modules',- ]);- });-- /**- * 评审 P1:旧实现用 `::reveal` 裸后缀,workdir 以 `::reveal` 结尾时(如- * `/srv/project::reveal`)它的隐藏键恰好等于 `/srv/project` 的 reveal 键,两个- * 项目的展开态互相覆盖。新键用不可打印的 NUL 分隔(POSIX 路径不允许含 NUL)。- */- it('workdir 以 ::reveal 结尾时不与截断后的 reveal scope 撞键', () => {- saveExpandedSet('/srv/project::reveal', new Set(['a']));- saveExpandedSet('/srv/project', new Set(['b']), { showIgnoredDirs: true });-- expect([...loadExpandedSet('/srv/project::reveal')]).toEqual(['a']);- expect([...loadExpandedSet('/srv/project', { showIgnoredDirs: true })]).toEqual(['b']);- });-- /**- * 评审 P1:**不**回退旧版 `::reveal` 键 —— 它同时可能就是**另一个 workdir 的- * 隐藏键**,回退只是把撞键换了个方向(`/srv/project` 的 reveal 态读到- * `/srv/project::reveal` 的隐藏态),又会对无关路径发 listDir。旧键无法区分两种- * 语义,所以一律不读。- */- it('不读旧版 ::reveal 键:不把别的 workdir 的隐藏态误当自己的 reveal 态', () => {- // `/srv/project::reveal` 以自己的**隐藏态**存了展开数据(合法写入)。- saveExpandedSet('/srv/project::reveal', new Set(['node_modules']));- // `/srv/project` 的 reveal 态没有自己的数据 → 必须是空的,不能借到上面那份。- expect([...loadExpandedSet('/srv/project', { showIgnoredDirs: true })]).toEqual([]);- // 而它自己的隐藏态照旧读到自己的数据。- expect([...loadExpandedSet('/srv/project::reveal')]).toEqual(['node_modules']);- });-- it('隐藏态沿用历史键:升级后原有展开态不丢', () => {- saveExpandedSet('/repo', new Set(['Assets/Scripts']));-- expect([...loadExpandedSet('/repo')]).toEqual(['Assets/Scripts']);- // 放行态是独立一份,不复用隐藏态的展开面。- expect([...loadExpandedSet('/repo', { showIgnoredDirs: true })]).toEqual([]);- });-- it('两态各自清空互不影响', () => {- saveExpandedSet('/repo', new Set(['Assets']), { showIgnoredDirs: true });- saveExpandedSet('/repo', new Set(['README.md']));-- saveExpandedSet('/repo', new Set(), { showIgnoredDirs: true });-- expect([...loadExpandedSet('/repo', { showIgnoredDirs: true })]).toEqual([]);- expect([...loadExpandedSet('/repo')]).toEqual(['README.md']);- });-});diff --git a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.tsindex 85bd213c7b..737bf98c33 100644--- a/apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts+++ b/apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts@@ -6,25 +6,16 @@* navigating away from /cc-agent/files/* and coming back is "my folders* are still where I left them" regardless of what triggered the unmount.*- * 展开态按**视图模式**分片(见 expandedScopeKey):「显示被忽略的目录」关闭时- * 沿用历史键(存量用户零迁移),打开时用独立一份 —— 两态可见的目录集合不同,- * 混用会在切回隐藏态时把 node_modules / Library 这类巨大目录当成"已展开"去- * 恢复,init 一次并行 listDir 上百个隐藏目录(本地卡顿,SSH 上还是一条条 RPC)。- ** Storage shape:* {* "<workdir absolute path>": ["Assets", "Assets/Scripts", "Design"],- * "<workdir absolute path>\u0000reveal": ["node_modules"],* ...* }*- * Cap: max 200 paths per scope (defends against runaway state if a user- * mass-expands a deep tree); 100 scopes total in the bag (LRU evict the- * oldest keys to keep storage bounded). 200 paths × ~80 chars × 100 scopes- * ≈ 1.6 MB worst case — well under localStorage's 5 MB quota.- *- * 注:同一个 workdir 打开开关后占两个 scope,有效 workdir 数量减半(50) ——- * 上限本来就是防御极端情况的粗糙阀值,不值再引入一套二级结构。+ * Cap: max 200 paths per workdir (defends against runaway state if a user+ * mass-expands a deep tree); 100 workdirs total in the bag (LRU evict the+ * oldest workdir keys to keep storage bounded). 200 paths × ~80 chars ×+ * 100 workdirs ≈ 1.6 MB worst case — well under localStorage's 5 MB quota.*/const STORAGE_KEY = 'cc-agent.workdirBrowse.expandedFolders.v1';@@ -66,60 +57,23 @@ function saveBag(bag: Bag): void {}}-export interface ExpandedScopeOptions {- /** 「显示被忽略的目录」开关:true = 独立 scope(默认 false,沿用历史键)。 */- showIgnoredDirs?: boolean;-}--/**- * 持久化 scope 键。隐藏态 = workdir 本身(与历史版本一致,升级不丢展开态);- * 放行态用**不可打印的 NUL 分隔** —— POSIX 路径不允许含 NUL(内核唯一禁用的- * 字节),所以 `${workdir}\0reveal` 不可能撞上任何 workdir 的隐藏键。- *- * 旧实现用 `::reveal` 裸后缀:workdir 以 `::reveal` 结尾时(如- * `/srv/project::reveal`),它的隐藏键恰好等于 `/srv/project` 的 reveal 键,两个- * 项目的展开态互相覆盖、各自恢复无关路径(评审 P1)。- *- * **不回退旧版 `::reveal` 键**:这个字符串同时可能就是**某个 workdir 的隐藏键**,- * 回退只是把同一个碰撞换个方向 —— `/srv/project` 的 reveal 态会读到- * `/srv/project::reveal` 的隐藏态数据,又对无关路径发 listDir(评审 P1)。旧键无法- * 区分「旧版 reveal 写入的数据」与「另一个 workdir 的隐藏数据」,所以一律不读;- * 代价是升级后「放行态展开记录」一次性丢失(重新展开即可),隐藏态不受影响。- */-const REVEAL_SCOPE_SUFFIX = '\u0000reveal';--function expandedScopeKey(workdir: string, opts: ExpandedScopeOptions): string {- return opts.showIgnoredDirs ? `${workdir}${REVEAL_SCOPE_SUFFIX}` : workdir;-}--export function loadExpandedSet(- workdir: string,- opts: ExpandedScopeOptions = {},-): Set<string> {+export function loadExpandedSet(workdir: string): Set<string> {const bag = loadBag();- const list = bag[expandedScopeKey(workdir, opts)];+ const list = bag[workdir];if (!Array.isArray(list)) return new Set();return new Set(list.filter((s): s is string => typeof s === 'string'));}-export function saveExpandedSet(- workdir: string,- expanded: Set<string>,- opts: ExpandedScopeOptions = {},-): void {+export function saveExpandedSet(workdir: string, expanded: Set<string>): void {const bag = loadBag();- const key = expandedScopeKey(workdir, opts);const list = [...expanded];// Filter out the empty-string root key (always implicit) + dedupe.const filtered = list.filter((p) => p !== '');if (filtered.length === 0) {// Don't keep empty entries in the bag — it'd just bloat over time.- delete bag[key];+ delete bag[workdir];} else {- bag[key] = filtered.slice(0, MAX_PATHS_PER_WORKDIR);+ bag[workdir] = filtered.slice(0, MAX_PATHS_PER_WORKDIR);}- // 不清旧版 `::reveal` 键:它和隐藏键共用同一个字符串空间(`/srv/project::reveal`- // 既是 /srv/project 的旧 reveal 键、又是它自己的隐藏键),删它就会误删另一个- // workdir 的数据。旧键只是残留、不再被读也不再被写。saveBag(bag);}diff --git a/apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx b/apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsxindex 789acfd30e..1cbc7543a7 100644--- a/apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx+++ b/apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx@@ -33,11 +33,12 @@ import { openHtmlFileByPreference } from '@/components/chat/useOpenWithMenu';import { resolveSessionFileOrigin } from '@/lib/sessionFileOrigin';import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore, type DragEvent } from 'react';import { useTranslation } from 'react-i18next';-import { FolderX } from 'lucide-react';+import { ChevronsDownUp, FolderX, RefreshCw, Search, X as XIcon } from 'lucide-react';+import { cn } from '@/lib/utils';import { isGlobalDropIntercepted } from '@/lib/globalDropIntercept';-import { useFileBrowserPreference } from '@/hooks/useFileBrowserPreference';import { toast } from '@/lib/toast';+import { Tip } from '@/components/ui/tooltip';import { ImageLightbox } from '@/components/chat/ImageLightbox';import {useSessionScopedTreeWidth,@@ -58,7 +59,6 @@ import { useConfirmSwitchAwayIfDirty } from '@/features/cc-agent/workdir-browse/import { useProjectFileList } from '@/features/cc-agent/workdir-browse/hooks/useProjectFileList';import { useRevealFileInTree } from '@/features/cc-agent/workdir-browse/hooks/useRevealFileInTree';import { SearchPanel } from '@/features/cc-agent/workdir-browse/search/SearchPanel';-import { FileTreeHeaderActions } from '@/features/cc-agent/workdir-browse/FileTreeHeaderActions';import { useProjectSearch } from '@/features/cc-agent/workdir-browse/search/hooks/useProjectSearch';import { FileFilterInput } from '@/features/cc-agent/workdir-browse/FileFilterInput';import { FilterResultList } from '@/features/cc-agent/workdir-browse/FilterResultList';@@ -105,7 +105,7 @@ interface FileBrowserBodyProps {state: FileBrowserState;ctx: TabKindHostContext;/** 宿主 tab 是否激活(PluginBodyHost 传入)。只用于文件树滚动位置的恢复时机;- * 隐藏 tab 的行渲染由虚拟化的 0 视口自然跳过,不再需要门控。 */+ * 隐藏 tab 的行渲染由虚拟化的 0 视口自然跳过,不需要门控。 */active?: boolean;}@@ -141,11 +141,7 @@ function FileBrowserBodyWithWorkdir({);const remoteHostId = deviceId ? null : ctx.remoteHostId;const isRemote = Boolean(remoteHostId) || Boolean(deviceId);- // 设置页「显示被忽略的目录」开关(默认关)。进 useFileTree 的 store key →- // 切换开关会换一份 store,listDir 与 watcher 都用新 matcher 重建,- // 目录列表立即重新拉取(不需要用户手动刷新)。- const { showIgnoredDirs } = useFileBrowserPreference();- const tree = useFileTree({ workdir, hideMetaFiles: true, remoteHostId, deviceId, showIgnoredDirs });+ const tree = useFileTree({ workdir, hideMetaFiles: true, remoteHostId, deviceId });const fileContent = useFileContent(workdir, state.selectedFilePath, remoteHostId, deviceId);const [externalFile, setExternalFile] = useState<ExternalFileSelection | null>(null);const [imageLightboxSrc, setImageLightboxSrc] = useState<string | null>(null);@@ -652,7 +648,6 @@ function FileBrowserBodyWithWorkdir({onToggleSearch={handleToggleSearch}onCollapseAll={tree.collapseAll}onRefresh={handleRefresh}- ignoredDirsUnsupported={tree.showIgnoredDirsSupported === false}/>{/* tree 模式:常驻文件名筛选输入框 + (筛选结果列表 / 文件树)。注:className 必须**只在隐藏时**加 `hidden`,**不能**同时写 `block` ——@@ -740,7 +735,7 @@ function FileBrowserBodyWithWorkdir({* 视觉对齐 doc 模式 WorkdirBrowseSidebar(参考 L570-678):* - 整行 pt-2 pb-1 pl-3 pr-2(窄栏比 doc 模式 pl-6 pr-3 紧)* - 标题 text-sm font-semibold text-foreground- * - icon 按钮共用 FileTreeHeaderActions(DESIGN.md §5 控件框 pill 档)+ * - icon 按钮 size-5 rounded-md hover:bg-sidebar-item-active text-sidebar-action-icon*/function TreeHeader({workdir,@@ -748,16 +743,14 @@ function TreeHeader({onToggleSearch,onCollapseAll,onRefresh,- ignoredDirsUnsupported,}: {workdir: string;mode: TreeMode;onToggleSearch: () => void;onCollapseAll: () => void;onRefresh: () => void;- /** 被控端不支持「显示被忽略的目录」(老 Desktop):开关渲染成不可用 + 说明原因。 */- ignoredDirsUnsupported: boolean;}) {+ const { t } = useTranslation();// workdir basename:POSIX 用最后一段(/Users/sam/Documents/Cindy → Cindy);// Windows 'C:\\Users\\sam\\Cindy' 也按 / 和 \ 切。空值兜底空串。const displayName = workdir.split(/[/\\]/).filter(Boolean).pop() ?? '';@@ -768,15 +761,49 @@ function TreeHeader({{displayName}</span><div className="flex shrink-0 items-center gap-1.5">- {/* 搜索 / 显示被忽略的目录 / 收起 / 刷新(搜索态只剩退出搜索)——- 与 doc 模式侧栏共用 FileTreeHeaderActions,不再各维护一份。 */}- <FileTreeHeaderActions- mode={mode}- onToggleSearch={onToggleSearch}- onCollapseAll={onCollapseAll}- onRefresh={onRefresh}- ignoredDirsUnsupported={ignoredDirsUnsupported}- />+ {mode === 'search' ? (+ // search 模式:refresh / collapse 只对文件树有意义,搜索时不显示;只留 X+ // 退出搜索回到 tree 模式(替代 search 按钮位置,跟 doc 模式同 ergonomics)。+ <Tip text={t('ccAgent.workdirBrowse.searchPanel.exit')}>+ <button+ type="button"+ onClick={onToggleSearch}+ className="flex size-5 items-center justify-center rounded-md text-sidebar-action-icon hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground"+ >+ <XIcon size={14} strokeWidth={2} />+ </button>+ </Tip>+ ) : (+ <>+ <Tip text={t('ccAgent.workdirBrowse.searchPanel.searchFiles')}>+ <button+ type="button"+ onClick={onToggleSearch}+ className="flex size-5 items-center justify-center rounded-md text-sidebar-action-icon hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground"+ >+ <Search size={14} strokeWidth={2} />+ </button>+ </Tip>+ <Tip text={t('ccAgent.workdirBrowse.treeAction.collapseAll')}>+ <button+ type="button"+ onClick={onCollapseAll}+ className="flex size-5 items-center justify-center rounded-md text-sidebar-action-icon hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground"+ >+ <ChevronsDownUp size={14} strokeWidth={2} />+ </button>+ </Tip>+ <Tip text={t('ccAgent.workdirBrowse.treeAction.refresh')}>+ <button+ type="button"+ onClick={onRefresh}+ className="flex size-5 items-center justify-center rounded-md text-sidebar-action-icon hover:bg-sidebar-item-active hover:text-sidebar-item-active-foreground"+ >+ <RefreshCw size={14} strokeWidth={2} />+ </button>+ </Tip>+ </>+ )}</div></div>);diff --git a/apps/desktop/src/renderer/hooks/__tests__/useFileBrowserPreference.test.ts b/apps/desktop/src/renderer/hooks/__tests__/useFileBrowserPreference.test.tsdeleted file mode 100644index a7b6593094..0000000000--- a/apps/desktop/src/renderer/hooks/__tests__/useFileBrowserPreference.test.ts+++ /dev/null@@ -1,97 +0,0 @@-// @vitest-environment jsdom--/**- * useFileBrowserPreference — 覆盖「显示被忽略的目录」的 override 语义(规则 20):- * - 默认关闭(保持历史行为);localStorage 只存 override- * - 打开 → 写入;改回默认 → 删除 key(清 override)- * - 非法存储值回落默认- * - 误写入的默认值('false')也算显式 override(Cindy 会显示「恢复默认」)- */--import { beforeEach, describe, expect, it } from 'vitest';-import { act, renderHook } from '@testing-library/react';--import {- _resetFileBrowserPreferenceForTests,- getShowIgnoredDirs,- useFileBrowserPreference,-} from '../useFileBrowserPreference';--const KEY = 'fileBrowser.showIgnoredDirs';--describe('useFileBrowserPreference', () => {- beforeEach(() => {- localStorage.clear();- _resetFileBrowserPreferenceForTests();- });-- it('无 override 时默认隐藏被忽略目录', () => {- expect(getShowIgnoredDirs()).toBe(false);- const { result } = renderHook(() => useFileBrowserPreference());- expect(result.current.showIgnoredDirs).toBe(false);- expect(result.current.isCustomized).toBe(false);- });-- /**- * 评审 P1:本窗口在没有任何消费者的窗口期里摘掉了 storage listener,期间另一个- * 窗口改了偏好就收不到事件;重挂载时 readPreference 又会走模块级缓存早退,会让- * 开关与文件树永久陈旧到下一次变更或刷新。所以首个监听者(重)挂载时要让缓存- * 失效、回落 localStorage。- */- it('无消费者窗口期后重挂载会重读 localStorage', () => {- const first = renderHook(() => useFileBrowserPreference());- expect(first.result.current.showIgnoredDirs).toBe(false);- first.unmount(); // → 本窗口没有监听者了-- // 另一个窗口改了偏好:只落 localStorage,本窗口收不到 storage 事件。- localStorage.setItem(KEY, 'true');-- const second = renderHook(() => useFileBrowserPreference());- expect(second.result.current.showIgnoredDirs).toBe(true);- expect(second.result.current.isCustomized).toBe(true);- });-- it('读取已存的开启 override', () => {- localStorage.setItem(KEY, 'true');- expect(getShowIgnoredDirs()).toBe(true);- const { result } = renderHook(() => useFileBrowserPreference());- expect(result.current.showIgnoredDirs).toBe(true);- expect(result.current.isCustomized).toBe(true);- });-- it('非法存储值回落默认', () => {- localStorage.setItem(KEY, 'whatever');- expect(getShowIgnoredDirs()).toBe(false);- });-- it('开启写 override;改回默认删除 key', () => {- const { result } = renderHook(() => useFileBrowserPreference());-- act(() => result.current.setShowIgnoredDirs(true));- expect(localStorage.getItem(KEY)).toBe('true');- expect(getShowIgnoredDirs()).toBe(true);- expect(result.current.isCustomized).toBe(true);-- act(() => result.current.setShowIgnoredDirs(false));- expect(localStorage.getItem(KEY)).toBeNull();- expect(getShowIgnoredDirs()).toBe(false);- expect(result.current.isCustomized).toBe(false);- });-- it('存储不可用时内存 SoT 仍生效', () => {- const original = Object.getOwnPropertyDescriptor(window, 'localStorage');- Object.defineProperty(window, 'localStorage', {- configurable: true,- get() {- throw new Error('storage disabled');- },- });- try {- const { result } = renderHook(() => useFileBrowserPreference());- act(() => result.current.setShowIgnoredDirs(true));- expect(result.current.showIgnoredDirs).toBe(true);- } finally {- if (original) Object.defineProperty(window, 'localStorage', original);- }- });-});diff --git a/apps/desktop/src/renderer/hooks/useFileBrowserPreference.ts b/apps/desktop/src/renderer/hooks/useFileBrowserPreference.tsdeleted file mode 100644index c8361ac8d4..0000000000--- a/apps/desktop/src/renderer/hooks/useFileBrowserPreference.ts+++ /dev/null@@ -1,127 +0,0 @@-/**- * useFileBrowserPreference — 侧边栏文件浏览器的视图偏好。- * ---------------------------------------------------------------------------- * 当前只有一个开关:- * - showIgnoredDirs 文件树是否列出 Cindy 默认隐藏的目录(依赖 / 构建产物 /- * 缓存:,如 build / dist / out / node_modules / Library)。- * 默认 false = 保持历史行为。- *- * 规则 20(配置默认值 vs override):localStorage 只存 override——用户改回- * 默认值时**删除** key 而不是写入,这样未自定义的用户未来能跟随新版本默认值;- * isCustomized 即「存在 override」。- *- * 模块级内存 SoT + `storage` 事件跨窗口同步(同 useLinkOpenPreference /- * useMessageNavRailPreference)。文件浏览器在 RSB 分离窗口里会单独挂载,而- * 两个窗口共享同一份 localStorage,storage 事件把改动同步过去。- *- * 消费方:`WorkdirBrowseSidebar`(doc 模式侧栏)与 RSB 的 `FileBrowserBody`- * 都把它喂给 `useFileTree`,store 的 key 包含该开关 → 切换开关会换 store,- * 连带 listDir 与 watcher 用新的 matcher 重建。- */--import { useCallback, useEffect, useState } from 'react';--const STORAGE_KEY = 'fileBrowser.showIgnoredDirs';-/** 系统默认:隐藏(与 BUILTIN_IGNORE 的历史行为一致,Unity Library 之类目录太大)。 */-const DEFAULT_SHOW_IGNORED_DIRS = false;-/** override 的持久化形态;只有非默认值会落盘。 */-const STORED_ENABLED = 'true';--function parseStored(raw: string | null): { value: boolean; customized: boolean } {- if (raw === STORED_ENABLED) return { value: true, customized: true };- if (raw === 'false') return { value: false, customized: true };- return { value: DEFAULT_SHOW_IGNORED_DIRS, customized: false };-}--/** 模块级内存 SoT;null = 尚未被本窗口读定/写定。 */-let memoryValue: boolean | null = null;-let memoryCustomized: boolean | null = null;--function readPreference(): { value: boolean; customized: boolean } {- if (memoryValue !== null && memoryCustomized !== null) {- return { value: memoryValue, customized: memoryCustomized };- }- try {- const parsed = parseStored(localStorage.getItem(STORAGE_KEY));- memoryValue = parsed.value;- memoryCustomized = parsed.customized;- return parsed;- } catch {- // localStorage 不可用——退回默认(不落定内存,留待后续写入)。- return { value: DEFAULT_SHOW_IGNORED_DIRS, customized: false };- }-}--/** 同步读——给非 hook 路径用。 */-export function getShowIgnoredDirs(): boolean {- return readPreference().value;-}--const listeners = new Set<() => void>();--export function useFileBrowserPreference(): {- showIgnoredDirs: boolean;- /** 是否存在用户 override(≠ 系统默认)。设置页据此显示「恢复默认」。 */- isCustomized: boolean;- setShowIgnoredDirs: (next: boolean) => void;-} {- const [preference, setPreference] = useState(readPreference);-- const setShowIgnoredDirs = useCallback((next: boolean) => {- memoryValue = next;- memoryCustomized = next !== DEFAULT_SHOW_IGNORED_DIRS;- setPreference({ value: next, customized: memoryCustomized });- try {- if (next === DEFAULT_SHOW_IGNORED_DIRS) {- // 改回默认 = 清除 override(而非写入默认值快照)。- localStorage.removeItem(STORAGE_KEY);- } else {- localStorage.setItem(STORAGE_KEY, STORED_ENABLED);- }- } catch {- // localStorage 不可用——内存 SoT 已生效;仅跨窗口同步缺失。- }- listeners.forEach((fn) => fn());- }, []);-- useEffect(() => {- const sync = () => setPreference(readPreference());- // 首个监听者(重)挂载时让模块级缓存失效、回落 localStorage:本窗口可能在- // 没有任何消费者的窗口期里错过另一个窗口的 storage 事件(那时 listener 不在- // 场),不重读就会让开关与文件树永久陈旧到下一次变更或刷新(评审 P1)。- if (listeners.size === 0) {- memoryValue = null;- memoryCustomized = null;- }- // 每个订阅者注册时都同步一次:只听首个订阅者会让后来者(如开关与文件树分别- // 挂载)拿首帧旧值,而第一个订阅者已更新缓存、后来者又跳过 sync,两边就一直- // 不一致(开关已打开、目录仍隐藏)。- sync();- listeners.add(sync);- const onStorage = (e: StorageEvent) => {- if (e.key !== STORAGE_KEY) return;- const next = parseStored(e.newValue);- memoryValue = next.value;- memoryCustomized = next.customized;- sync();- };- window.addEventListener('storage', onStorage);- return () => {- listeners.delete(sync);- window.removeEventListener('storage', onStorage);- };- }, []);-- return {- showIgnoredDirs: preference.value,- isCustomized: preference.customized,- setShowIgnoredDirs,- };-}--/** 测试专用:清空内存 SoT,让下一次读回落 localStorage / 默认值。 */-export function _resetFileBrowserPreferenceForTests(): void {- memoryValue = null;- memoryCustomized = null;- listeners.clear();-}diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex 6de56fd5b4..eed111b10f 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -13243,10 +13243,7 @@"treeLoading": "Loading files…","treeAction": {"collapseAll": "Collapse all",- "refresh": "Refresh",- "showIgnoredDirs": "Show ignored directories",- "hideIgnoredDirs": "Hide ignored directories",- "showIgnoredDirsUnsupported": "The remote device is running an older {{appName}} version that cannot show ignored directories"+ "refresh": "Refresh"},"treeMenu": {"newFile": "New File",diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex e363701155..5041e53d01 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -13195,10 +13195,7 @@"treeLoading": "ファイルを読み込み中…","treeAction": {"collapseAll": "すべて折りたたむ",- "refresh": "更新",- "showIgnoredDirs": "無視されるディレクトリを表示",- "hideIgnoredDirs": "無視されるディレクトリを隠す",- "showIgnoredDirsUnsupported": "相手デバイスの {{appName}} のバージョンが古く、無視されるディレクトリを表示できません"+ "refresh": "更新"},"treeMenu": {"newFile": "新規ファイル",diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex 2ecb8c5d4b..dd986439bc 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -13195,10 +13195,7 @@"treeLoading": "파일 불러오는 중…","treeAction": {"collapseAll": "모두 접기",- "refresh": "새로 고침",- "showIgnoredDirs": "무시된 디렉터리 표시",- "hideIgnoredDirs": "무시된 디렉터리 숨기기",- "showIgnoredDirsUnsupported": "상대 기기의 {{appName}} 버전이 오래되어 무시된 디렉터리를 표시할 수 없습니다"+ "refresh": "새로 고침"},"treeMenu": {"newFile": "새 파일",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 939895b600..9cfd9a8fc6 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -13195,10 +13195,7 @@"treeLoading": "正在加载文件…","treeAction": {"collapseAll": "收起所有",- "refresh": "刷新",- "showIgnoredDirs": "显示被忽略的目录",- "hideIgnoredDirs": "隐藏被忽略的目录",- "showIgnoredDirsUnsupported": "对方设备的 {{appName}} 版本过旧,暂不支持显示被忽略的目录"+ "refresh": "刷新"},"treeMenu": {"newFile": "新建文件",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 8a913ddd93..6bdc7dae7c 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -13195,10 +13195,7 @@"treeLoading": "正在載入檔案…","treeAction": {"collapseAll": "收起所有",- "refresh": "重新整理",- "showIgnoredDirs": "顯示被忽略的目錄",- "hideIgnoredDirs": "隱藏被忽略的目錄",- "showIgnoredDirsUnsupported": "對方裝置的 {{appName}} 版本過舊,暫不支援顯示被忽略的目錄"+ "refresh": "重新整理"},"treeMenu": {"newFile": "新建檔案",diff --git a/apps/desktop/src/renderer/lib/fileBrowserTransport.ts b/apps/desktop/src/renderer/lib/fileBrowserTransport.tsindex 90cd12858a..7c0534adcd 100644--- a/apps/desktop/src/renderer/lib/fileBrowserTransport.ts+++ b/apps/desktop/src/renderer/lib/fileBrowserTransport.ts@@ -67,93 +67,6 @@ function deviceSupportsGzip(deviceId: string, workdir: string): Promise<boolean>return probe;}-/**- * 被控端 listDir 是否支持 `showIgnoredDirs`(「显示被忽略的目录」)。- *- * **三态**:`true` / `false` = 已探定的结论;`null` = 未知(瞬态失败) —— 调用方据此- * 保持「还没结论」,不要把一次网络抖动落定成「对方版本过旧」并用它把开关禁用掉。- *- * 区分确定性「不支持」与瞬态失败:老被控端根本没有 `file-browser:remote-op`- * channel,invoke 会被快速拒回 `CHANNEL_NOT_ALLOWED`(确定性);隧道不可达 /- * 重连中的 reject 与之不同,属于瞬态。- *- * 缓存:**只缓存肯定结论 `true`**,且带**进程级重连代次**(见下)。`false`(老端)- * 不留在缓存里 —— 被控端在一次掉线期间升级是真实场景,缓存会把它钉在「不支持」- * 直到重启;重探一次只是一个被快速拒绝的 invoke,代价可忽略。瞬态 `null` 同样- * 不缓存,由调用方在连接恢复后重探。- *- * 与 gzip 那份缓存分开:后者带着「用出空写就永久降级」的自愈语义,两件事互不牵连。- */--/**- * 进程级重连代次。- *- * 不能拿 hook 局的 `useDeviceLinkReconnectEpoch` 当缓存依据:它是 `useState(0)`- * 起步的 hook 局部计数器,只观察**挂载期间**的事件 —— 面板卸载 →(此时设备重连 /- * 被回滚,没有任何 hook 看得到)→ 面板重挂载时新实例又从 0 开始,进程内的缓存却- * 还留着上一代的肯定结论,于是跳过 caps RPC、开关一直可按。- *- * 所以缓存自己订阅全局 reconnect 流:模块级订阅不随面板生命周期起落(惰性建立- * 于首次调用;测试环境没有 deviceLink 时静默跳过,代次恒 0)。任何设备恢复 online- * 或 relay 恢复 online 都让整表代次作废 —— 重探一次 caps 很便宜,不值得按 deviceId- * 精细区分。订阅故意常驻:它本身就是「面板不在时也要记账」的那只耳朵。- */-let reconnectGeneration = 0;-let reconnectSubscribed = false;--function ensureReconnectSubscription(): void {- if (reconnectSubscribed) return;- const api = window.electronAPI?.deviceLink;- if (!api?.onPresenceChanged || !api.onStatusChanged) return;- reconnectSubscribed = true;- const bump = (): void => {- reconnectGeneration += 1;- };- api.onPresenceChanged((snapshot) => {- if (snapshot.online) bump();- });- api.onStatusChanged(({ status }) => {- if (status === 'online') bump();- });-}--const deviceRevealCaps = new Map<- string,- { generation: number; probe: Promise<boolean | null> }->();--/** 只回收「本次探测装上的那条」:同 deviceId 可能已因更新的代次换上新的 probe。 */-function evictRevealCapsIfCurrent(deviceId: string, generation: number): void {- if (deviceRevealCaps.get(deviceId)?.generation === generation) {- deviceRevealCaps.delete(deviceId);- }-}--export function deviceSupportsRevealIgnoredDirs(- deviceId: string,- workdir: string,-): Promise<boolean | null> {- ensureReconnectSubscription();- const cached = deviceRevealCaps.get(deviceId);- if (cached && cached.generation === reconnectGeneration) return cached.probe;- const probeGeneration = reconnectGeneration;- const probe = Promise.resolve()- .then(() => invokeOp<{ ok: boolean; showIgnoredDirs?: boolean }>(deviceId, 'caps', { workdir }))- .then((r) => {- const supported = r?.ok === true && r.showIgnoredDirs === true;- // 只留肯定结论;「不支持」下次重新问(被控端可能已升级)。- if (!supported) evictRevealCapsIfCurrent(deviceId, probeGeneration);- return supported;- })- .catch((err: unknown) => {- evictRevealCapsIfCurrent(deviceId, probeGeneration);- if (isDeviceTooOldError(err)) return false; // 老端:确定性不支持- return null; // 瞬态:不落定,等连接恢复重探- });- deviceRevealCaps.set(deviceId, { generation: probeGeneration, probe });- return probe;-}-export interface FileTreeEventPayload {workdir: string;type: 'add' | 'change' | 'unlink' | 'addDir' | 'unlinkDir';@@ -301,18 +214,7 @@ export function deviceSearchCollect(*/export async function startWatchFor(deviceId: string | null | undefined,- params: {- workdir: string;- remoteHostId?: string | null;- hideMetaFiles?: boolean;- /**- * 「显示被忽略的目录」:本地 / SSH 分支下发到 matcher 与 watcher;- * **device 分支不传**——被控端的 watch 由 `fs-watch:<workdir>` topic- * 订阅驱动,订阅载荷里没有过滤开关(与 hideMetaFiles 同款限制),- * 所以被控端 watcher 仍用默认过滤:目录能列出、内部改动不推事件。- */- showIgnoredDirs?: boolean;- },+ params: { workdir: string; remoteHostId?: string | null; hideMetaFiles?: boolean },): Promise<void> {if (!deviceId) {await window.electronAPI.fileBrowser.startWatch(params);diff --git a/apps/desktop/src/renderer/vite-env.d.ts b/apps/desktop/src/renderer/vite-env.d.tsindex c614b1f63a..89328c3c16 100644--- a/apps/desktop/src/renderer/vite-env.d.ts+++ b/apps/desktop/src/renderer/vite-env.d.ts@@ -2645,8 +2645,6 @@ interface ElectronAPI {relPath?: string;hideMetaFiles?: boolean;docMode?: boolean;- /** 「显示被忽略的目录」——列出依赖 / 构建产物 / 缓存目录。默认 false。 */- showIgnoredDirs?: boolean;}) => Promise<Array<{name: string;@@ -2746,8 +2744,6 @@ interface ElectronAPI {remoteHostId?: string | null;workdir: string;hideMetaFiles?: boolean;- /** 与 listDir 同源:开关变了要带新 matcher 重建 watcher。 */- showIgnoredDirs?: boolean;}) => Promise<{ ok: boolean }>;stopWatch: (params: {remoteHostId?: string | null;diff --git a/apps/desktop/src/shared/ignoreNames.ts b/apps/desktop/src/shared/ignoreNames.tsdeleted file mode 100644index fabc31b7a8..0000000000--- a/apps/desktop/src/shared/ignoreNames.ts+++ /dev/null@@ -1,19 +0,0 @@-/**- * ignoreNames — 内置忽略名单(纯数据)。- *- * 真源已迁至 @cindy/file-browser-core:desktop main / renderer 与远端- * file-service daemon 三处共享同一份定义,避免名单在客户端与 daemon 之间漂移。- * renderer 侧用它做「关掉『显示被忽略的目录』时,立刻滤掉 reveal 态根列表里的- * 一级忽略目录」(见 useFileTree 的 seed 说明)——慢通道下不这样滤,关开关后- * node_modules / build 这些行会在「已隐藏」的视图里滞留数秒。- *- * ⚠️ 必须走 /ignoreNames 子路径导出而不是包根:本文件被 renderer 消费,包根- * barrel 会把 scanner / RipgrepSearcher 等 Node-only 实现(node:fs、node:path)- * 一起拖进浏览器 bundle(同类说明见 shared/textFileExts.ts)。- */--export {- BUILTIN_IGNORE_ALWAYS,- BUILTIN_IGNORE_REVEALABLE,- REVEALABLE_IGNORE_DIR_NAMES,-} from '@cindy/file-browser-core/ignoreNames';diff --git a/docs/design-evidence/2026-09-11/file-tree-header-icon-buttons.md b/docs/design-evidence/2026-09-11/file-tree-header-icon-buttons.mddeleted file mode 100644index bb92ada3d2..0000000000--- a/docs/design-evidence/2026-09-11/file-tree-header-icon-buttons.md+++ /dev/null@@ -1,97 +0,0 @@-# 文件树标题行图标钮圆角统一(#4301)--日期:2026-09-11。平台:Desktop / Windows(用户本机 dev 实例,`DESKTOP_DEV_VERDICT=ready`)。-基点:`64520dd75`(本批本地未提交改动)。采集时 head 与仓库工作区一致。--设计依据:`DESIGN.md §5 Border Radius Scale` Step 2 —— 控件框(含 transient-hover / pressed 表面)登记在 pill 档,`No 3px / 6px / 10px`;`§14.6` 图标钮的-`aria-label` + tooltip 交付合同。治理依据:`design-governance.md §13.3`(圆角分类-审查边界:须指出登记项与作用层,不得用建议改形状代替分类裁决)。--## 本次改了什么--文件树标题行原先只有新增的「显示被忽略的目录」开关走 pill,同排三个存量图标钮-(搜索 / 收起 / 刷新)各自写 `rounded-md`(6px),同一行出现两种圆角。改为四个按钮-(含搜索态的 X)共用 `FILE_TREE_HEADER_ICON_BUTTON_CLASS`,统一 pill;doc 模式宿主-的标题触发器(项目名下拉)同排,同步收为 pill。两个宿主的图标钮类名不再各自复制。--## 有意差异登记--| 表面 | 改前 | 改后 | 依据 |-| --- | --- | --- | --- |-| RSB 文件浏览器标题行:搜索 / 显示被忽略的目录 / 收起 / 刷新(+ 搜索态 X) | 6px(新开关已是 pill) | 9999px | §5 Step 2 控件框 = pill |-| doc 模式侧栏标题行:同上四个按钮 | 6px | 9999px | 同上 |-| doc 模式侧栏标题触发器(项目名 + ChevronDown) | 6px | 9999px | 同一行的控件框、同样带 hover 表面 |--未改:该行之外的同文件控件(错误态「重试」文字按钮、切换项目下拉项)不属本行,-按存量随各自表面迁移处理,未借本次改动一并迁移。--## 自动检查--```-pnpm --filter desktop run typecheck 通过-vitest FileTreeIgnoredDirsToggle.test.tsx 12 passed- (含几何守卫与 aria-label 守卫:两个宿主的标题行图标钮必须走共享常量、必须带可访问名)-vitest typographyDiscipline 5 passed-vitest useFileTree / useFileBrowserPreference 12 passed-vitest expandedStore 3 passed(新增:展开态按 showIgnoredDirs 分片)-node scripts/design-inventory.mjs 已重新生成(49 surfaces)-node scripts/hardcoded-color-audit.mjs 新增硬编码颜色 0-pnpm test:unit:related 通过(desktop 全量 + file-browser-core / remote-file-service)-```--## 真实 Desktop 构建内的实测值--dev 实例(本 checkout,独立命名沙箱 `dev`)经 CDP `Runtime.evaluate` +-`getComputedStyle` 取实测值;截图由 `Page.captureScreenshot` 采集。--| 主题(`data-theme`) | 未按下:图标色 / 圆角 / 尺寸 | 按下:底色 / 图标色 | `--sidebar-item-active` |-| --- | --- | --- | --- |-| `cindy-light` | `rgb(136,136,131)` / 9999px / 20×20 | `rgb(60,63,67)` / `rgb(252,252,252)` | `214.3 5.5% 24.9%` |-| `cindy-dark` | `rgb(111,111,111)` / 9999px / 20×20 | `rgb(238,238,238)` / `rgb(21,21,21)` | `0.0 0.0% 93.3%` |--- 两个宿主各四个按钮实测圆角全部 `9999px`(改前三个为 6px);按钮 20×20、图标 14。-- 按下态在两种主题下都有持久底色(非仅 hover 可见),与 token 值一致。-- 四个按钮的图标色在 idle 态一致(来自 `--sidebar-action-icon`)。--## 目检--RSB 文件浏览器(会话视图右栏)与 doc 模式侧栏(`#/cc-agent/files/<sessionId>`)-两种布局 × Light / Dark 共 4 张截图已由作者目检:入口位置(眼睛按钮在搜索右侧)、-按下态反馈、图标变化(EyeOff ↔ Eye)与 tooltip 文案均符合预期;开关打开后-`node_modules` / `logs` 等目录出现在树里(即本次改动要修的场景)。--2026-09-13 在 `cindy/fierce-goodall-p3@23600c41d` 上重新采集了同规格 4 张-(RSB / doc × Light / Dark,开关为打开态,树里 `build` / `node_modules` 可见),-已上传为 PR 评论可见证据(链接见「缺口登记」)。--## 缺口登记--- **unsupported 禁用态未实机目检**(评审修复轮新增):该状态只在 device-link 连到不支持- `showIgnoredDirs` 的老 Desktop 时出现,本机无该环境。可见面为 `aria-disabled` +- `opacity-45` + `cursor-not-allowed`(与仓库内 `PermissionSelector` 禁用项同款),- 行为(点击不改偏好、树按隐藏态建立)由单测锁定。-- 远端 SSH 会话未实机验证(无可用远端环境):远端 `listDir` 的开关透传与- daemon 事件过滤只在单测层面覆盖,见 PR「未执行的验证」。-- 截图已上传 PR:GitHub 图片附件端点依赖网页会话,本次以 fork release asset 作为稳定- artifact 承载(`https://github.com/zyjisdog/cindy/releases/tag/design-evidence-4398`),- PR 评论入口:<https://github.com/makecindy/cindy/pull/4398#issuecomment-5652260136>。- 本地同步保留一份 `tmp/design-evidence/{rsb,doc}-{light,dark}-flat.png`(gitignore- 覆盖的临时目录,栅格不入仓)。-- 换肤中间帧未验证:截图前已等主题切换完成(设置页切换后等渲染稳定再采集),未检查换肤动画时序。-- 窗口背景透明(vibrancy),CDP 原图含 `alpha=0` 区域;本目录引用的查看版本已把- alpha 展平到对应主题表面色上,避免看图工具各自合成底色导致误判明暗。--## 采集版本源码 SHA-256--哈希按文件内容的 LF 规范化形态计算(`sed 's/\r$//' <file> | sha256sum`,与 Git blob 一致)。-下表已更新到**评审修复轮 + 虚拟滚动轮之后**的源码:默认态 / 按下态的实测值仍然适用-(此后只加过 aria-label、unsupported 禁用态、展开态分片与虚拟滚动接线;标题行控件本身的-配色 / 圆角 / 尺寸未变),unsupported 禁用态本身未实机目检(见「缺口登记」)。--| 文件 | SHA-256 |-| --- | --- |-| `features/cc-agent/workdir-browse/fileTreeHeaderButtonClass.ts` | `571c2021d9589b99141e8ca2c07331f7bab7994384f0a860d3a55534a2232840` |-| `features/cc-agent/workdir-browse/FileTreeIgnoredDirsToggle.tsx` | `de2b2070c559c3f82410761c34e35f84c6fb0cf62fcc78b2eff49b5991f69726` |-| `features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx` | `9733c40b3d319a37c1ab79fe060c4216c835f3967a55472a6562b157a73eb1ea` |-| `features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx` | `67a095a2d548546bf7cc39dd1e1a9c2083d9079bbba1db7a939d0defb8cbd0e3` |diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex 22eafd469f..19cc982348 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -19,7 +19,7 @@| `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 || `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 || `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊 / 群聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊、伙伴群聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotGroupChatView, BotGroupCreateDialog, BotGroupSettingsDrawer, BotHistorySessionView, BotLifecycleSettings, BotMarketDialog, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatLoadingImage.tsx, apps/desktop/src/renderer/components/chat/ChatReplyIcon.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardForm.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostCardRecipients.tsx, apps/desktop/src/renderer/components/chat/GhostMailHistory.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MailHtmlPreview.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/McpAppCard.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageReadAloudContext.ts, apps/desktop/src/renderer/components/chat/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/RichAnswer.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/SessionQuickSendContext.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageImageLink.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/VideoSitePreview.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/historyAfter.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/linkInteraction.ts, apps/desktop/src/renderer/components/chat/mailBodyEditing.ts, apps/desktop/src/renderer/components/chat/mailCardFooter.ts, apps/desktop/src/renderer/components/chat/mailPreviewAppearance.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/rich-answer.css, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useLinkContextMenu.tsx, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerFolderTransfers.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelRouteSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/SpeedIcon.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/askUserDictation.ts, apps/desktop/src/renderer/components/new-chat/askUserVoiceShortcutOwner.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/favoritesSyncFailure.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useAskUserDictation.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/components/new-chat/voiceQuestionSelection.ts, apps/desktop/src/renderer/features/bots/BotAddToGroupMenu.tsx, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAutonomySettings.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotChannelsPage.tsx, apps/desktop/src/renderer/features/bots/BotChatQuoteViews.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotDmThreadHost.tsx, apps/desktop/src/renderer/features/bots/BotDmThreadPreview.tsx, apps/desktop/src/renderer/features/bots/BotDmThreadViews.tsx, apps/desktop/src/renderer/features/bots/BotFollowMark.tsx, apps/desktop/src/renderer/features/bots/BotFollowUpInvitation.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotGlancePopover.tsx, apps/desktop/src/renderer/features/bots/BotGroupAvatars.tsx, apps/desktop/src/renderer/features/bots/BotGroupChatView.tsx, apps/desktop/src/renderer/features/bots/BotGroupComposer.tsx, apps/desktop/src/renderer/features/bots/BotGroupCreateDialog.tsx, apps/desktop/src/renderer/features/bots/BotGroupElapsed.tsx, apps/desktop/src/renderer/features/bots/BotGroupLivePreview.tsx, apps/desktop/src/renderer/features/bots/BotGroupLiveStatus.tsx, apps/desktop/src/renderer/features/bots/BotGroupMentionCard.tsx, apps/desktop/src/renderer/features/bots/BotGroupMessageAttachments.tsx, apps/desktop/src/renderer/features/bots/BotGroupPendingInteraction.tsx, apps/desktop/src/renderer/features/bots/BotGroupPlan.tsx, apps/desktop/src/renderer/features/bots/BotGroupQuote.tsx, apps/desktop/src/renderer/features/bots/BotGroupRuntimeFailureNotice.tsx, apps/desktop/src/renderer/features/bots/BotGroupSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotGroupSidebarRow.tsx, apps/desktop/src/renderer/features/bots/BotGroupTaskCard.tsx, apps/desktop/src/renderer/features/bots/BotGroupThreadHint.tsx, apps/desktop/src/renderer/features/bots/BotGroupThreadViews.tsx, apps/desktop/src/renderer/features/bots/BotGroupTimelineItem.tsx, apps/desktop/src/renderer/features/bots/BotGroupTimelineModel.ts, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotHomeComputerSetting.tsx, apps/desktop/src/renderer/features/bots/BotImportForm.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLearningFooter.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMarketDialog.tsx, apps/desktop/src/renderer/features/bots/BotMarketModules.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotOpeningPending.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotProjectsSettings.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskLink.tsx, apps/desktop/src/renderer/features/bots/BotSessionTaskResultCard.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotStarterOptions.tsx, apps/desktop/src/renderer/features/bots/BotTaskModelEditor.tsx, apps/desktop/src/renderer/features/bots/BotTaskOwnerChip.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/ChatBotAccessField.tsx, apps/desktop/src/renderer/features/bots/ChatGroupSettings.tsx, apps/desktop/src/renderer/features/bots/ChatInviteDialog.tsx, apps/desktop/src/renderer/features/bots/ChatInviteHost.tsx, apps/desktop/src/renderer/features/bots/ChatReactionButton.tsx, apps/desktop/src/renderer/features/bots/ChatServerControls.tsx, apps/desktop/src/renderer/features/bots/ChatThreadPanel.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/CindyMergeSetting.tsx, apps/desktop/src/renderer/features/bots/CloudCompanionOfflineView.tsx, apps/desktop/src/renderer/features/bots/CompanionShadowBanner.tsx, apps/desktop/src/renderer/features/bots/RemoteBotFollowUpInvitation.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSettings.tsx, apps/desktop/src/renderer/features/bots/RemoveChatFromListButton.tsx, apps/desktop/src/renderer/features/bots/TeammateSearchResults.tsx, apps/desktop/src/renderer/features/bots/TeammatesSection.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botChatQuoteContext.tsx, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botDmQuote.ts, apps/desktop/src/renderer/features/bots/botDmThreadRoute.ts, apps/desktop/src/renderer/features/bots/botDmThreads.tsx, apps/desktop/src/renderer/features/bots/botDmThreadsContext.tsx, apps/desktop/src/renderer/features/bots/botFollowScopes.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botGlanceTodos.ts, apps/desktop/src/renderer/features/bots/botGroupAttachments.ts, apps/desktop/src/renderer/features/bots/botGroupComposerChrome.ts, apps/desktop/src/renderer/features/bots/botGroupLane.ts, apps/desktop/src/renderer/features/bots/botGroupMentions.ts, apps/desktop/src/renderer/features/bots/botGroupOutbox.ts, apps/desktop/src/renderer/features/bots/botGroupPresentation.ts, apps/desktop/src/renderer/features/bots/botGroupStore.ts, apps/desktop/src/renderer/features/bots/botImConnectionClient.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botMarketDisplay.ts, apps/desktop/src/renderer/features/bots/botMarketEntryHint.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botSettingsIcons.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botTodo.css, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/chatError.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/companionAvatarCache.ts, apps/desktop/src/renderer/features/bots/companionCloudPresentation.ts, apps/desktop/src/renderer/features/bots/companionCloudStore.ts, apps/desktop/src/renderer/features/bots/islandEntryAlert.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotSettingsData.ts, apps/desktop/src/renderer/features/bots/teammatesSectionPrefs.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotGroupMentionPicker.tsx, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotPluginFocusedSession.ts, apps/desktop/src/renderer/features/bots/useBotReplyTargetPreference.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useBotUnreadSync.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useSessionEntryLocationCommits.ts, apps/desktop/src/renderer/features/bots/useThreadPanelResize.ts, apps/desktop/src/renderer/features/bots/useViewedBotSessionId.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/bots/voice/CompanionVoicePanel.tsx, apps/desktop/src/renderer/features/bots/voice/CompanionVoiceSettings.tsx, apps/desktop/src/renderer/features/bots/voice/CompanionVoiceToolbar.tsx, apps/desktop/src/renderer/features/bots/voice/MessageReadAloudController.ts, apps/desktop/src/renderer/features/bots/voice/PcmSpeechPlayer.ts, apps/desktop/src/renderer/features/bots/voice/SpeechPlaybackQueue.ts, apps/desktop/src/renderer/features/bots/voice/SpeechTextBuffer.ts, apps/desktop/src/renderer/features/bots/voice/SpeechVoiceMenu.tsx, apps/desktop/src/renderer/features/bots/voice/SpeechVoicePicker.tsx, apps/desktop/src/renderer/features/bots/voice/VoiceCallTranscript.tsx, apps/desktop/src/renderer/features/bots/voice/VoiceConversationController.ts, apps/desktop/src/renderer/features/bots/voice/VoicePreviewController.ts, apps/desktop/src/renderer/features/bots/voice/VoiceReplyTracker.ts, apps/desktop/src/renderer/features/bots/voice/microphoneDiagnostics.ts, apps/desktop/src/renderer/features/bots/voice/speechVoiceLabelCache.ts, apps/desktop/src/renderer/features/bots/voice/useMessageReadAloud.ts, apps/desktop/src/renderer/features/bots/voice/voiceCallPresentation.ts, apps/desktop/src/renderer/features/bots/voice/voiceConfiguration.ts, apps/desktop/src/renderer/features/bots/voice/voiceConversation.css, apps/desktop/src/renderer/features/bots/voice/voiceExitIntent.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 304 | 38 | 573 |-| `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeHeaderActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeIgnoredDirsToggle.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/fileTreeHeaderButtonClass.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useTreeScrollRestore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/treeRows.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/treeScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 18 | 5 | 41 |+| `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useTreeScrollRestore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/treeRows.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/treeScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 18 | 5 | 44 || `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 3 || `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AgentTaskLiveDetails.tsx, apps/desktop/src/renderer/components/chat/AnnotationStrokesSvg.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatLoadingImage.tsx, apps/desktop/src/renderer/components/chat/ChatReplyIcon.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostCardForm.tsx, apps/desktop/src/renderer/components/chat/GhostCardHostPrompts.tsx, apps/desktop/src/renderer/components/chat/GhostCardRecipients.tsx, apps/desktop/src/renderer/components/chat/GhostMailHistory.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MailHtmlPreview.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/McpAppCard.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageReadAloudContext.ts, apps/desktop/src/renderer/components/chat/MessageSourceLabels.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/MessageViewport.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/RichAnswer.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/SessionQuickSendContext.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserAttachmentChip.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageImageLink.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/VideoSitePreview.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/animateFocusScroll.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/historyAfter.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/linkInteraction.ts, apps/desktop/src/renderer/components/chat/mailBodyEditing.ts, apps/desktop/src/renderer/components/chat/mailCardFooter.ts, apps/desktop/src/renderer/components/chat/mailPreviewAppearance.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/markdownMedia.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageNavigationProjection.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageViewportGeometry.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/observeProgrammaticScroll.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeHighlightShared.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/rich-answer.css, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/streamingMessageProjection.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useImageClipboard.ts, apps/desktop/src/renderer/components/chat/useImageLoadFailure.ts, apps/desktop/src/renderer/components/chat/useLinkContextMenu.tsx, apps/desktop/src/renderer/components/chat/useMessageViewport.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerAttachments.tsx, apps/desktop/src/renderer/components/new-chat/ComposerFolderTransfers.tsx, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelRouteSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupRemoteDesktopButton.tsx, apps/desktop/src/renderer/components/new-chat/PluginWriteAccessRecovery.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/SpeedIcon.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/askUserDictation.ts, apps/desktop/src/renderer/components/new-chat/askUserVoiceShortcutOwner.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/favoritesSyncFailure.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useAskUserDictation.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/components/new-chat/voiceQuestionSelection.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 270 | 38 | 359 || `desktop.chat.scheduled` | desktop | 调度任务列表 | hash `/cc-agent/scheduled`(SchedulerPage) | SchedulerPage | apps/desktop/src/renderer/features/scheduler/SchedulerPage.tsx, apps/desktop/src/renderer/features/scheduler/components/AgentMark.tsx, apps/desktop/src/renderer/features/scheduler/components/BoundSessionCard.tsx, apps/desktop/src/renderer/features/scheduler/components/ProjectAutomationNotifyBridge.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryCard.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryPane.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleChips.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleFormDialog.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleSessionIndexOwner.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleStatusChip.tsx, apps/desktop/src/renderer/features/scheduler/components/ScriptCapabilityMultiSelect.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListCell.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListFilterPopover.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListPane.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateCard.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateGallery.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateParamForm.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useDeleteScheduleWithSessions.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useReadFailedScheduleRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRunNowBusyGuard.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleForm.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleUnreadRunCounts.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSchedules.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSessionReferences.ts, apps/desktop/src/renderer/features/scheduler/hooks/useTemplates.ts, apps/desktop/src/renderer/features/scheduler/index.ts, apps/desktop/src/renderer/features/scheduler/lib/archiveScheduleWarning.ts, apps/desktop/src/renderer/features/scheduler/lib/cronCodexPreset.ts, apps/desktop/src/renderer/features/scheduler/lib/cronToHuman.ts, apps/desktop/src/renderer/features/scheduler/lib/failedScheduleDismissal.ts, apps/desktop/src/renderer/features/scheduler/lib/formatters.ts, apps/desktop/src/renderer/features/scheduler/lib/pluginScheduleCreateIntent.ts, apps/desktop/src/renderer/features/scheduler/lib/projectAutomationConfig.ts, apps/desktop/src/renderer/features/scheduler/lib/projectScheduleSidebarIndex.ts, apps/desktop/src/renderer/features/scheduler/lib/runHistoryGrouping.ts, apps/desktop/src/renderer/features/scheduler/lib/runUnread.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleBindingIndex.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleFormLogic.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleRunReadSync.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSessionBinding.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSidebarIndexRuns.ts, apps/desktop/src/renderer/features/scheduler/lib/schedulesStore.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilter.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilterStorage.ts, apps/desktop/src/renderer/features/scheduler/lib/templateLocalization.ts | 32 | 0 | 89 |@@ -39,7 +39,7 @@| `desktop.plugins.app-main` | desktop | 插件主视图 | hash `/apps/:ghostId`(GhostMainViewFeatureLayout) | GhostMainViewFeatureLayout, GhostMainViewHost | apps/desktop/src/renderer/features/plugin/GhostMainViewFeatureLayout.tsx, apps/desktop/src/renderer/features/plugin/GhostMainViewHost.tsx | 0 | 0 | 0 || `desktop.plugins.installed` | desktop | 已装插件 | hash `/plugins`(GhostPluginPage) | AddMarketplaceDialog, GhostPluginActions, GhostPluginDetailView, GhostPluginPage, MarketPluginDetailView, MyPublishesSection, PluginDevicePicker, PluginManagementLayout, PluginProjectMenu, RemotePluginConfiguration, RemotePluginPage, RemotePluginReadOnlyDetail, UpdateAllDialog | apps/desktop/src/renderer/features/plugin/AddMarketplaceDialog.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginActions.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginPage.tsx, apps/desktop/src/renderer/features/plugin/MarketPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/MyPublishesSection.tsx, apps/desktop/src/renderer/features/plugin/PluginDevicePicker.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/plugin/PluginScopePicker.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginConfiguration.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginPage.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginReadOnlyDetail.tsx, apps/desktop/src/renderer/features/plugin/UpdateAllDialog.tsx, apps/desktop/src/renderer/features/plugin/plugin-motion.css | 28 | 0 | 48 || `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AddSpeechModelsDialog.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/AvatarCropEditor.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BillingSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DialogueDirectorySection.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GeneralSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.settings-search.ts, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HarnessVersionMenuRow.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.settings-search.ts, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LlamaCppCandidates.tsx, apps/desktop/src/renderer/components/settings/LlamaCppProviderDetail.tsx, apps/desktop/src/renderer/components/settings/LocalAgentSection.settings-search.ts, apps/desktop/src/renderer/components/settings/LocalAgentSection.tsx, apps/desktop/src/renderer/components/settings/LocalModelDownloadUI.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/OwnRemoteProviders.tsx, apps/desktop/src/renderer/components/settings/PersonalizationDetails.settings-search.ts, apps/desktop/src/renderer/components/settings/PersonalizationSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/PiKernelVersionRow.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/ReadOnlyProviderModels.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.settings-search.ts, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.settings-search.ts, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchBox.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchNavigation.ts, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SharedTasks.settings-search.ts, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SpeechModelChoices.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.settings-search.ts, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerEnrollmentDialog.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerFilterCard.tsx, apps/desktop/src/renderer/components/settings/WallpaperSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.settings-search.ts, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.settings-search.ts, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/avatarCropGeometry.ts, apps/desktop/src/renderer/components/settings/avatarCropImage.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dialogueDirectoryDisplay.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/settingsRowClasses.ts, apps/desktop/src/renderer/components/settings/settingsSearchCatalog.ts, apps/desktop/src/renderer/components/settings/settingsSearchTypes.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBarsTooltip.tsx, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageDeviceSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageFilterSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.settings-search.ts, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/useSettingsEscape.ts, apps/desktop/src/renderer/components/settings/useSettingsSectionTarget.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 137 | 95 | 548 |-| `desktop.shell.main-layout` | desktop | 主窗口壳(标题栏 / 左右栏 / 内容区) | main BrowserWindow → renderer/index.tsx → main-entry.tsx → App → MainLayout (`#/` 受保护壳) | ChromeActions, DeviceSectionHeader, FeishuConflictDialogHost, GhostMediaLightboxHost, MainLayout, ProjectsSection, RightSidebar, RightSidebarShell, SessionShareImportWizard, Sidebar, UpdateNoticeDialog, WindowControls | apps/desktop/src/renderer/cindy-brain/GhostMediaLightboxHost.tsx, apps/desktop/src/renderer/components/UpdateNoticeDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialogHost.tsx, apps/desktop/src/renderer/components/layout/AppBadgeAttentionSync.tsx, apps/desktop/src/renderer/components/layout/BrowserWebviewPool.tsx, apps/desktop/src/renderer/components/layout/ChromeActions.tsx, apps/desktop/src/renderer/components/layout/ContentHeader.tsx, apps/desktop/src/renderer/components/layout/CredentialStoreBanner.tsx, apps/desktop/src/renderer/components/layout/FadeSwitcher.tsx, apps/desktop/src/renderer/components/layout/GlobalDropImportListener.tsx, apps/desktop/src/renderer/components/layout/MainEntryRedirect.tsx, apps/desktop/src/renderer/components/layout/MainLayout.tsx, apps/desktop/src/renderer/components/layout/RightSidebar.tsx, apps/desktop/src/renderer/components/layout/RightSidebarDetach.tsx, apps/desktop/src/renderer/components/layout/RightSidebarMaximize.tsx, apps/desktop/src/renderer/components/layout/RightSidebarToggle.tsx, apps/desktop/src/renderer/components/layout/SidebarTabWindowLayout.tsx, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/components/layout/WallpaperVideo.tsx, apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts, apps/desktop/src/renderer/components/layout/chromeActionsLayout.ts, apps/desktop/src/renderer/components/layout/railChromeActions.ts, apps/desktop/src/renderer/components/layout/windowDrag.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/sidebar/AccountSwitcherDialog.tsx, apps/desktop/src/renderer/components/sidebar/AttentionDot.tsx, apps/desktop/src/renderer/components/sidebar/DatabaseSizeWarningBanner.tsx, apps/desktop/src/renderer/components/sidebar/GhostMainViewNavEntries.tsx, apps/desktop/src/renderer/components/sidebar/MobileDownloadDialog.tsx, apps/desktop/src/renderer/components/sidebar/NavigationCountBadge.tsx, apps/desktop/src/renderer/components/sidebar/NewTag.tsx, apps/desktop/src/renderer/components/sidebar/Sidebar.tsx, apps/desktop/src/renderer/components/sidebar/SidebarIconButton.tsx, apps/desktop/src/renderer/components/sidebar/SidebarNavigationCustomize.tsx, apps/desktop/src/renderer/components/sidebar/SidebarTopNav.tsx, apps/desktop/src/renderer/components/sidebar/SortableList.tsx, apps/desktop/src/renderer/components/sidebar/UpdateBanner.tsx, apps/desktop/src/renderer/components/sidebar/UserInfoSection.tsx, apps/desktop/src/renderer/components/sidebar/VendorIcon.tsx, apps/desktop/src/renderer/components/sidebar/VendorReadinessBadge.tsx, apps/desktop/src/renderer/components/sidebar/WorktreeBadge.tsx, apps/desktop/src/renderer/components/sidebar/sidebarNavigationPrefs.ts, apps/desktop/src/renderer/components/sidebar/useHoverOpenMenu.ts, apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx, apps/desktop/src/renderer/components/title-bar/MenuButton.tsx, apps/desktop/src/renderer/components/title-bar/WindowControls.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/DeviceSectionHeader.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/botMenuOwnerContext.ts, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useRetainedBrowserTabHosts.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.test.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openPluginTaskTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-task/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/retired-feature/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/tabAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/layout/LayoutRoot.tsx, apps/desktop/src/renderer/layout/PanelDragController.tsx, apps/desktop/src/renderer/layout/PanelDragPrototype.tsx, apps/desktop/src/renderer/layout/collapsePrefs.ts, apps/desktop/src/renderer/layout/layoutDevTools.ts, apps/desktop/src/renderer/layout/panePlacement.tsx, apps/desktop/src/renderer/layout/paneWidths.tsx, apps/desktop/src/renderer/layout/panelMaximize.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 147 | 46 | 197 |+| `desktop.shell.main-layout` | desktop | 主窗口壳(标题栏 / 左右栏 / 内容区) | main BrowserWindow → renderer/index.tsx → main-entry.tsx → App → MainLayout (`#/` 受保护壳) | ChromeActions, DeviceSectionHeader, FeishuConflictDialogHost, GhostMediaLightboxHost, MainLayout, ProjectsSection, RightSidebar, RightSidebarShell, SessionShareImportWizard, Sidebar, UpdateNoticeDialog, WindowControls | apps/desktop/src/renderer/cindy-brain/GhostMediaLightboxHost.tsx, apps/desktop/src/renderer/components/UpdateNoticeDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialogHost.tsx, apps/desktop/src/renderer/components/layout/AppBadgeAttentionSync.tsx, apps/desktop/src/renderer/components/layout/BrowserWebviewPool.tsx, apps/desktop/src/renderer/components/layout/ChromeActions.tsx, apps/desktop/src/renderer/components/layout/ContentHeader.tsx, apps/desktop/src/renderer/components/layout/CredentialStoreBanner.tsx, apps/desktop/src/renderer/components/layout/FadeSwitcher.tsx, apps/desktop/src/renderer/components/layout/GlobalDropImportListener.tsx, apps/desktop/src/renderer/components/layout/MainEntryRedirect.tsx, apps/desktop/src/renderer/components/layout/MainLayout.tsx, apps/desktop/src/renderer/components/layout/RightSidebar.tsx, apps/desktop/src/renderer/components/layout/RightSidebarDetach.tsx, apps/desktop/src/renderer/components/layout/RightSidebarMaximize.tsx, apps/desktop/src/renderer/components/layout/RightSidebarToggle.tsx, apps/desktop/src/renderer/components/layout/SidebarTabWindowLayout.tsx, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/components/layout/WallpaperVideo.tsx, apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts, apps/desktop/src/renderer/components/layout/chromeActionsLayout.ts, apps/desktop/src/renderer/components/layout/railChromeActions.ts, apps/desktop/src/renderer/components/layout/windowDrag.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/sidebar/AccountSwitcherDialog.tsx, apps/desktop/src/renderer/components/sidebar/AttentionDot.tsx, apps/desktop/src/renderer/components/sidebar/DatabaseSizeWarningBanner.tsx, apps/desktop/src/renderer/components/sidebar/GhostMainViewNavEntries.tsx, apps/desktop/src/renderer/components/sidebar/MobileDownloadDialog.tsx, apps/desktop/src/renderer/components/sidebar/NavigationCountBadge.tsx, apps/desktop/src/renderer/components/sidebar/NewTag.tsx, apps/desktop/src/renderer/components/sidebar/Sidebar.tsx, apps/desktop/src/renderer/components/sidebar/SidebarIconButton.tsx, apps/desktop/src/renderer/components/sidebar/SidebarNavigationCustomize.tsx, apps/desktop/src/renderer/components/sidebar/SidebarTopNav.tsx, apps/desktop/src/renderer/components/sidebar/SortableList.tsx, apps/desktop/src/renderer/components/sidebar/UpdateBanner.tsx, apps/desktop/src/renderer/components/sidebar/UserInfoSection.tsx, apps/desktop/src/renderer/components/sidebar/VendorIcon.tsx, apps/desktop/src/renderer/components/sidebar/VendorReadinessBadge.tsx, apps/desktop/src/renderer/components/sidebar/WorktreeBadge.tsx, apps/desktop/src/renderer/components/sidebar/sidebarNavigationPrefs.ts, apps/desktop/src/renderer/components/sidebar/useHoverOpenMenu.ts, apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx, apps/desktop/src/renderer/components/title-bar/MenuButton.tsx, apps/desktop/src/renderer/components/title-bar/WindowControls.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/DeviceSectionHeader.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/botMenuOwnerContext.ts, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useRetainedBrowserTabHosts.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.test.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openPluginTaskTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-task/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/retired-feature/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/tabAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/layout/LayoutRoot.tsx, apps/desktop/src/renderer/layout/PanelDragController.tsx, apps/desktop/src/renderer/layout/PanelDragPrototype.tsx, apps/desktop/src/renderer/layout/collapsePrefs.ts, apps/desktop/src/renderer/layout/layoutDevTools.ts, apps/desktop/src/renderer/layout/panePlacement.tsx, apps/desktop/src/renderer/layout/paneWidths.tsx, apps/desktop/src/renderer/layout/panelMaximize.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 147 | 46 | 201 || `desktop.skillhub.local` | desktop | SkillHub 本地技能 | hash `/skillhub/local` 及统一详情 `/skillhub/detail`(旧详情链接重定向) | InstallTargetPicker, PluginDevicePicker, PluginManagementLayout, RemoteSkillsPage, SkillCategoryFilterBar, SkillDetailLayout, SkillhubDetailRoute, SkillhubDetailView, SkillhubFeatureLayout, SkillhubHomeView, SkillhubLocalLayout, SkillhubMarketDetailView | apps/desktop/src/renderer/features/plugin/PluginDevicePicker.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/skillhub/RemoteSkillsPage.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailRoute.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubFeatureLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubLocalLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketDetailView.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx, apps/desktop/src/renderer/features/skillhub/skillhub-home.css | 39 | 0 | 45 || `desktop.skillhub.market` | desktop | SkillHub 市场 | hash `/skillhub/market`(SkillhubMarketListView) | InstallTargetPicker, MarketCard, MarketInfoEditDialog, SkillhubMarketDetailView, SkillhubMarketListView, VisibilityEditorDialog | apps/desktop/src/renderer/features/skillhub/SkillhubMarketDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketListView.tsx, apps/desktop/src/renderer/features/skillhub/components/HomeMarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInfoEditDialog.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInstallStatus.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketListError.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketLocalSkills.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketPreviewTree.tsx, apps/desktop/src/renderer/features/skillhub/components/OfficialSkillBadge.tsx, apps/desktop/src/renderer/features/skillhub/components/PlatformTagSelector.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillIcon.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillTagList.tsx, apps/desktop/src/renderer/features/skillhub/components/TeamScopePicker.tsx, apps/desktop/src/renderer/features/skillhub/components/VisibilityEditorDialog.tsx | 42 | 0 | 35 || `desktop.window.computer-permission-guide` | desktop | 电脑使用权限引导 | `?view=computer-permission-guide` → ComputerPermissionGuideWindow;backdrop 同文件 | ComputerPermissionBackdrop, ComputerPermissionGuideWindow | apps/desktop/src/main/computer-permission-guide/MacComputerPermissionGuideNativeHost.ts, apps/desktop/src/main/computer-permission-guide/placement.ts, apps/desktop/src/main/computer-permission-guide/request.ts, apps/desktop/src/main/computer-permission-guide/switch-target.ts, apps/desktop/src/main/computer-permission-guide/window.ts, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx | 7 | 2 | 9 |@@ -47,7 +47,7 @@| `desktop.window.resource-usage` | desktop | 资源用量窗口 | `?resourceUsageWindow=1` → renderer/resource-usage-entry.tsx(不走 router.tsx) | ResourceUsageWindowLayout, ResourceUsageWindowRoot | apps/desktop/src/main/resource-usage-window/controller.ts, apps/desktop/src/main/resource-usage-window/ipc.ts, apps/desktop/src/main/resource-usage-window/open-sender.ts, apps/desktop/src/main/resource-usage-window/registry.ts, apps/desktop/src/main/resource-usage-window/window.ts, apps/desktop/src/renderer/components/resource-usage/ResourceUsageWindowLayout.tsx, apps/desktop/src/renderer/resource-usage-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 79 | 38 | 15 || `desktop.window.review-artifact-confirm` | desktop | Review 成果确认窗 | main/reviewer/reviewArtifactConfirmWindow.ts 内联 HTML/CSS(不走 renderer 路由) | reviewArtifactConfirmWindow | apps/desktop/src/main/reviewer/reviewArtifactConfirmWindow.ts | 8 | 18 | 2 || `desktop.window.session-drag-preview` | desktop | 会话拖拽预览 | main/session-drag-preview.ts 透明预览窗 | session-drag-preview | apps/desktop/src/main/session-drag-preview.ts | 0 | 1 | 0 |-| `desktop.window.sidebar` | desktop | 右侧栏独立窗口 | `?sidebarWindow=1` → renderer/sidebar-window-entry.tsx;hash `/sidebar-window` | RightSidebar, RightSidebarShell, SidebarWindowLayout | apps/desktop/src/main/right-sidebar-window/controller.ts, apps/desktop/src/main/right-sidebar-window/ipc.ts, apps/desktop/src/main/right-sidebar-window/registry.ts, apps/desktop/src/main/right-sidebar-window/resolveHostContext.ts, apps/desktop/src/main/right-sidebar-window/settings-store.ts, apps/desktop/src/main/right-sidebar-window/window.ts, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/botMenuOwnerContext.ts, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useRetainedBrowserTabHosts.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.test.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openPluginTaskTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-task/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/retired-feature/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/tabAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/sidebar-window-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 113 | 45 | 116 |+| `desktop.window.sidebar` | desktop | 右侧栏独立窗口 | `?sidebarWindow=1` → renderer/sidebar-window-entry.tsx;hash `/sidebar-window` | RightSidebar, RightSidebarShell, SidebarWindowLayout | apps/desktop/src/main/right-sidebar-window/controller.ts, apps/desktop/src/main/right-sidebar-window/ipc.ts, apps/desktop/src/main/right-sidebar-window/registry.ts, apps/desktop/src/main/right-sidebar-window/resolveHostContext.ts, apps/desktop/src/main/right-sidebar-window/settings-store.ts, apps/desktop/src/main/right-sidebar-window/window.ts, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/botMenuOwnerContext.ts, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useRetainedBrowserTabHosts.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.test.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openPluginTaskTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-task/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/retired-feature/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/tabAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/sidebar-window-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 113 | 45 | 120 || `desktop.window.voice-dictionary-toast` | desktop | 语音词典 Toast 窗 | `?view=voice-input-dictionary-toast` → main-entry.tsx → VoiceInputDictionaryToast | VoiceInputDictionaryToast | apps/desktop/src/renderer/voice-input/VoiceInputDictionaryToast.tsx | 6 | 0 | 2 || `desktop.window.voice-overlay` | desktop | 语音输入浮窗 | `?view=voice-input-overlay` → main-entry.tsx → VoiceInputOverlay | VoiceInputOverlay, VoiceInputStatusNotice | apps/desktop/src/main/voice-input/global.ts, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css, apps/desktop/src/renderer/voice-input/VoiceInputOverlay.tsx, apps/desktop/src/renderer/voice-input/VoiceInputStatusNotice.tsx | 84 | 38 | 20 || `mobile.account-deletion` | mobile | 账号注销 | app/account-deletion.tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ConnectionBanner, ConnectionNoticeOverlay, DeviceLinkContext, DirectLinkTransport, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, HomeStackHeader, IncomingShareBridge, McpAppViews, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileOutboxBridge, MobilePrimitives, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton.ios, NativeChromeButton.ios, NativeMcpAppSurface, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, OutsideTap, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RecentMessageHistories, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteHistoryPrefetchBridge, ResidentHomeList, SheetModal, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, _layout, account-deletion, gestureHandler, nativeToolbarMenuItems, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/account-deletion.tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/DirectLinkTransport.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/AdaptiveWindow.tsx, apps/mobile/src/platform/OutsideTap.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.android.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/HomeStackHeader.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeButton.ios.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/chrome/nativeToolbarMenuItems.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/FoldTouchpad.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeHeaderGlassButton.ios.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/McpAppViews.tsx, apps/mobile/src/session/MobileOutboxBridge.tsx, apps/mobile/src/session/NativeBottomSheet.android.tsx, apps/mobile/src/session/NativeBottomSheet.tsx, apps/mobile/src/session/NativeMcpAppSurface.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 218 | 59 |diff --git a/packages/file-browser-core/package.json b/packages/file-browser-core/package.jsonindex 7714a7c763..b474466525 100644--- a/packages/file-browser-core/package.json+++ b/packages/file-browser-core/package.json@@ -8,8 +8,7 @@"types": "./src/index.ts","exports": {".": "./src/index.ts",- "./textFileExts": "./src/textFileExts.ts",- "./ignoreNames": "./src/ignoreNames.ts"+ "./textFileExts": "./src/textFileExts.ts"},"scripts": {"build": "tsc --noEmit",diff --git a/packages/file-browser-core/src/__tests__/ignore.test.ts b/packages/file-browser-core/src/__tests__/ignore.test.tsindex d66efddc9e..2098c7b6f7 100644--- a/packages/file-browser-core/src/__tests__/ignore.test.ts+++ b/packages/file-browser-core/src/__tests__/ignore.test.ts@@ -12,7 +12,7 @@ import path from 'node:path';import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';-import { __clearCacheForTesting, createEventIgnoreMatcher, loadIgnoreMatcher } from '../ignore';+import { __clearCacheForTesting, loadIgnoreMatcher } from '../ignore';async function makeWorkdir(gitignore?: string): Promise<string> {const dir = await fs.mkdtemp(path.join(os.tmpdir(), 'ignore-test-'));@@ -132,112 +132,3 @@ describe('loadIgnoreMatcher cache + inflight', () => {}});});--describe('loadIgnoreMatcher 内置忽略分层 (showIgnoredDirs)', () => {- let workdir: string;-- beforeEach(async () => {- __clearCacheForTesting();- workdir = await makeWorkdir();- });-- afterEach(async () => {- await fs.rm(workdir, { recursive: true, force: true }).catch(() => {});- });-- it('默认隐藏依赖 / 构建产物 / 缓存目录', async () => {- const matcher = await loadIgnoreMatcher(workdir, { honorVcsIgnore: false });- for (const dir of ['build', 'dist', 'out', 'bin', 'obj', 'target', 'vendor', 'Temp', 'Logs']) {- expect(matcher.ignores(`${dir}/`, true), dir).toBe(true);- }- });-- it('showIgnoredDirs 放行依赖 / 构建产物 / 缓存目录', async () => {- const matcher = await loadIgnoreMatcher(workdir, {- honorVcsIgnore: false,- showIgnoredDirs: true,- });- for (const dir of ['build', 'dist', 'out', 'bin', 'obj', 'target', 'vendor', 'Temp']) {- expect(matcher.ignores(`${dir}/`, true), dir).toBe(false);- }- expect(matcher.ignores('node_modules/', true)).toBe(false);- expect(matcher.ignores('Library/', true)).toBe(false);- });-- it('VCS 元数据 / OS 垃圾不受开关影响', async () => {- const matcher = await loadIgnoreMatcher(workdir, {- honorVcsIgnore: false,- showIgnoredDirs: true,- });- expect(matcher.ignores('.git/', true)).toBe(true);- expect(matcher.ignores('.git/config', false)).toBe(true);- expect(matcher.ignores('.DS_Store', false)).toBe(true);- });-- it('*.meta 仍只由 hideMetaFiles 决定,与开关正交', async () => {- const revealKeepMeta = await loadIgnoreMatcher(workdir, {- honorVcsIgnore: false,- hideMetaFiles: false,- showIgnoredDirs: true,- });- expect(revealKeepMeta.ignores('Foo.cs.meta', false)).toBe(false);-- const revealHideMeta = await loadIgnoreMatcher(workdir, {- honorVcsIgnore: false,- hideMetaFiles: true,- showIgnoredDirs: true,- });- expect(revealHideMeta.ignores('Foo.cs.meta', false)).toBe(true);- });-- it('两个开关值分别缓存(互不污染)', async () => {- const off = await loadIgnoreMatcher(workdir, { honorVcsIgnore: false });- const on = await loadIgnoreMatcher(workdir, { honorVcsIgnore: false, showIgnoredDirs: true });- expect(on).not.toBe(off);- // 再次取用各自命中自己的缓存条目。- expect(await loadIgnoreMatcher(workdir, { honorVcsIgnore: false })).toBe(off);- expect(- await loadIgnoreMatcher(workdir, { honorVcsIgnore: false, showIgnoredDirs: true }),- ).toBe(on);- });-});--/**- * 事件侧的恒真层。这一层和 listDir 的口径必须**故意不同**:开关打开后- * node_modules / Library 可以列出来,但内部改动永远不推事件(daemon- * WorkdirWatchManager 靠它挡住 SSH 上的事件洪水)。- */-describe('createEventIgnoreMatcher(事件侧恒真层)', () => {- it('不论开关如何都挡掉依赖 / Unity 资源缓存,包含其后代与嵌套同名目录', () => {- const matcher = createEventIgnoreMatcher();- // 目录本身、目录内文件、任意深度的同名目录都算 —— 与- // BUILTIN_IGNORE_* 的「路径任意位置命中」口径一致。- for (const rel of [- 'node_modules/',- 'node_modules/react/index.js',- 'packages/app/node_modules/react/index.js',- 'Library/',- 'Library/ScriptAssemblies/Assembly-CSharp.dll',- 'Assets/Library/foo.prefab',- ]) {- expect(matcher.ignores(rel, rel.endsWith('/')), rel).toBe(true);- }- });-- it('不误伤开关要放行的构建产物与普通目录', () => {- const matcher = createEventIgnoreMatcher();- // build / dist / Temp 这类目录**不在**这一层:开关打开时它们的改动要推事件。- for (const rel of ['build/app.js', 'dist/index.html', 'Temp/x', 'src/index.ts']) {- expect(matcher.ignores(rel, false), rel).toBe(false);- }- // 名字相近但不同名的不算(子串不算命中)。- expect(matcher.ignores('myLibrary/a', false)).toBe(false);- expect(matcher.ignores('node_modules_backup/a', false)).toBe(false);- });-- it('VCS 元数据与 OS 垃圾也挡', () => {- const matcher = createEventIgnoreMatcher();- expect(matcher.ignores('.git/config', false)).toBe(true);- expect(matcher.ignores('.DS_Store', false)).toBe(true);- });-});diff --git a/packages/file-browser-core/src/__tests__/listAllFilesWalk.test.ts b/packages/file-browser-core/src/__tests__/listAllFilesWalk.test.tsindex 5615097c3b..0621d2d03a 100644--- a/packages/file-browser-core/src/__tests__/listAllFilesWalk.test.ts+++ b/packages/file-browser-core/src/__tests__/listAllFilesWalk.test.ts@@ -10,7 +10,7 @@ import path from 'node:path';import { afterEach, beforeEach, describe, expect, it } from 'vitest';import { listAllFilesWalk } from '../listAllFiles.js';-import { __clearCacheForTesting, loadIgnoreMatcher } from '../ignore.js';+import { __clearCacheForTesting } from '../ignore.js';describe('listAllFilesWalk', () => {let workdir: string;@@ -61,28 +61,4 @@ describe('listAllFilesWalk', () => {expect(res.truncated).toBe(false);expect(res.files.some((f) => f.includes('loop'))).toBe(false);});-- /**- * 决策测试(不是遗漏):文件名筛选**不跟随**文件树的「显示被忽略的目录」开关。- * 同一份工作区里两侧故意给出不同答案:文件树(loadIgnoreMatcher)在开关打开后- * 放行 build/,而筛选清单仍然不含它。- *- * 为什么不能只改 fallback:rg 后端无法"只放行构建产物"而保留用户自己的- * .gitignore 规则,单边跟随会让筛选结果随「机器上装没装 rg」而变(更细的理据- * 见 listAllFiles.ts 的 fallback 注释)。要改这条语义必须两个后端一起改,这条- * 测试就是那道闸。- */- it('不跟随「显示被忽略的目录」:树放行 build/,筛选清单仍然不含它', async () => {- await mkdir(path.join(workdir, 'build'));- await writeFile(path.join(workdir, 'build', 'bundle.js'), 'x\n', 'utf8');-- const treeMatcher = await loadIgnoreMatcher(workdir, {- honorVcsIgnore: false,- showIgnoredDirs: true,- });- expect(treeMatcher.ignores('build/', true)).toBe(false); // 树:看得见-- const res = await listAllFilesWalk({ workdir });- expect(res.files.some((f) => f.startsWith('build/'))).toBe(false); // 筛选:找不到- });});diff --git a/packages/file-browser-core/src/__tests__/scanner.test.ts b/packages/file-browser-core/src/__tests__/scanner.test.tsindex 57288fecf2..58dd2b8cd1 100644--- a/packages/file-browser-core/src/__tests__/scanner.test.ts+++ b/packages/file-browser-core/src/__tests__/scanner.test.ts@@ -304,37 +304,3 @@ describe('readFile binary detection', () => {}});});--describe('file-browser scanner builtin ignore tiers', () => {- /**- * 回归:用户在文件树里右键新建 `build` 这类目录后看不到它、且刷新无效- * (2026-09 用户报告)。根因是 BUILTIN_IGNORE 无差别隐藏构建产物目录。- * 现在内置清单分两层,`showIgnoredDirs` 放行可放开的那一层。- */- it('hides a freshly created build/ dir by default, shows it with showIgnoredDirs', async () => {- const { loadIgnoreMatcher, listDir, __clearCacheForTesting } = await import('../index');- __clearCacheForTesting();- const workdir = await mkdtemp(path.join(os.tmpdir(), 'fb-builtin-'));- try {- await createFolder(workdir, 'build');- await createFolder(workdir, 'src');-- const hiddenMatcher = await loadIgnoreMatcher(workdir, {- hideMetaFiles: true,- honorVcsIgnore: false,- });- const hidden = await listDir(workdir, '', hiddenMatcher, { docMode: false });- expect(hidden.map((e) => e.name)).toEqual(['src']);-- const revealMatcher = await loadIgnoreMatcher(workdir, {- hideMetaFiles: true,- honorVcsIgnore: false,- showIgnoredDirs: true,- });- const revealed = await listDir(workdir, '', revealMatcher, { docMode: false });- expect(revealed.map((e) => e.name)).toEqual(['build', 'src']);- } finally {- await rm(workdir, { recursive: true, force: true });- }- });-});diff --git a/packages/file-browser-core/src/ignore.ts b/packages/file-browser-core/src/ignore.tsindex d56518ea15..eee3e5371c 100644--- a/packages/file-browser-core/src/ignore.ts+++ b/packages/file-browser-core/src/ignore.ts@@ -27,20 +27,54 @@ import path from 'node:path';import ignoreLib from 'ignore';import { scopedLogger } from './logging.js';-import {- BUILTIN_IGNORE_ALWAYS,- BUILTIN_IGNORE_REVEALABLE,- WATCH_ALWAYS_IGNORE,-} from './ignoreNames.js';--// 名单真源在 ignoreNames.ts(desktop renderer 也消费同一份);这里 re-export-// 保持既有 API —— 包内与 daemon 都直接取 WATCH_ALWAYS_IGNORE。-export { WATCH_ALWAYS_IGNORE } from './ignoreNames.js';const log = scopedLogger('file-browser/ignore');-// 名单定义已搬到 ignoreNames.ts(desktop renderer 也消费同一份);本文件只留-// matcher 逻辑。+/**+ * Folder names (last path segment) that should never be walked into,+ * regardless of vcs ignore files. Patterns are folder-name-only (no globs)+ * because `ignore` lib treats them as "match anywhere in the path".+ */+const BUILTIN_IGNORE = [+ // VCS+ '.git/',+ '.svn/',+ '.hg/',+ // Package managers+ 'node_modules/',+ '__pycache__/',+ 'vendor/',+ '.venv/',+ '.cache/',+ // Editor / IDE caches+ '.vs/',+ '.idea/',+ '.vscode-test/',+ // OS junk+ '.DS_Store',+ 'Thumbs.db',+ // Generic build outputs+ 'dist/',+ 'build/',+ 'out/',+ '.next/',+ 'target/',+ 'bin/',+ 'obj/',+ // Unity-specific (huge caches; .gitignore usually has them but be defensive)+ 'Library/',+ 'Temp/',+ 'Logs/',+ 'UserSettings/',+ // Project-internal generated dirs (seen on real Unity workdirs)+ 'AssetDepotOutput/',+ 'ChuangXiangEditorCache/',+ // .meta files (Unity per-asset metadata) — rendered behind a "show meta"+ // user toggle; defaulting to hidden cuts ~47% of typical Unity entries.+ // Toggle is honored by Matcher.shouldShowMeta below.+ // Note: NOT added to BUILTIN_IGNORE here — handled separately because it's+ // user-toggleable per session.+];export interface Matcher {/**@@ -52,32 +86,6 @@ export interface Matcher {ignores(relPath: string, isDir: boolean): boolean;}-/**- * 事件侧的恒真过滤层:只吃 BUILTIN_IGNORE_ALWAYS + WATCH_ALWAYS_IGNORE,不读- * `.gitignore`、不随 showIgnoredDirs 变化。- *- * 用途:daemon 的 watcher 需要在「开关打开后仍然不推事件」的方向上兜底 —— 它- * 没有 desktop 侧的 parcel 预过滤层可用,`fs.watch recursive` 照样把这些目录的- * 事件推上来,只能自己丢。- *- * 目录模式(`Library/`)对 `ignore` 库是「匹配该名字的目录及其全部后代」,且与- * BUILTIN_IGNORE_* 一样是「路径任意位置命中」,所以 `Assets/Library/x` 也算了- * (`src/node_modules/a.js` 同理) —— 与文件树的隐藏口径保持一致。- *- * 无 workdir 依赖(不读盘),可以当成常量用。- */-export function createEventIgnoreMatcher(): Matcher {- const ig = ignoreLib();- ig.add(BUILTIN_IGNORE_ALWAYS);- ig.add(WATCH_ALWAYS_IGNORE.map((name) => `${name}/`));- return {- ignores(relPath: string, isDir: boolean): boolean {- const normalized = isDir && !relPath.endsWith('/') ? `${relPath}/` : relPath;- return ig.ignores(normalized);- },- };-}-const VCS_IGNORE_DISABLED_SOURCE = '__vcs-disabled';interface CacheEntry {@@ -91,13 +99,8 @@ interface CacheEntry {const cache = new Map<string, CacheEntry>();const inflight = new Map<string, Promise<Matcher>>();-function cacheKey(- workdir: string,- hideMetaFiles: boolean,- honorVcsIgnore: boolean,- showIgnoredDirs: boolean,-): string {- return `${workdir} ${hideMetaFiles ? '1' : '0'} ${honorVcsIgnore ? 'vcs' : 'tree'}${showIgnoredDirs ? ' reveal' : ''}`;+function cacheKey(workdir: string, hideMetaFiles: boolean, honorVcsIgnore: boolean): string {+ return `${workdir} ${hideMetaFiles ? '1' : '0'} ${honorVcsIgnore ? 'vcs' : 'tree'}`;}/**@@ -116,22 +119,11 @@ function cacheKey(*/export async function loadIgnoreMatcher(workdir: string,- opts: {- hideMetaFiles?: boolean;- honorVcsIgnore?: boolean;- /**- * 用户开关「显示被忽略的目录」:true 时放行 BUILTIN_IGNORE_REVEALABLE- * (依赖 / 构建产物 / 缓存 / IDE 缓存)。默认 false = 保持历史行为。- * 只影响内置清单,VCS 元数据与 OS 垃圾永远隐藏,`*.meta` 仍由- * hideMetaFiles 单独决定。- */- showIgnoredDirs?: boolean;- } = {},+ opts: { hideMetaFiles?: boolean; honorVcsIgnore?: boolean } = {},): Promise<Matcher> {const hideMetaFiles = opts.hideMetaFiles ?? true;const honorVcsIgnore = opts.honorVcsIgnore ?? true;- const showIgnoredDirs = opts.showIgnoredDirs ?? false;- const key = cacheKey(workdir, hideMetaFiles, honorVcsIgnore, showIgnoredDirs);+ const key = cacheKey(workdir, hideMetaFiles, honorVcsIgnore);const pending = inflight.get(key);if (pending) return pending;@@ -141,7 +133,7 @@ export async function loadIgnoreMatcher(if (cached && (await isCacheFresh(workdir, cached))) {return cached.matcher;}- const built = await buildMatcher(workdir, hideMetaFiles, honorVcsIgnore, showIgnoredDirs);+ const built = await buildMatcher(workdir, hideMetaFiles, honorVcsIgnore);cache.set(key, built);return built.matcher;})();@@ -189,11 +181,9 @@ async function buildMatcher(workdir: string,hideMetaFiles: boolean,honorVcsIgnore: boolean,- showIgnoredDirs: boolean,): Promise<CacheEntry> {const ig = ignoreLib();- ig.add(BUILTIN_IGNORE_ALWAYS);- if (!showIgnoredDirs) ig.add(BUILTIN_IGNORE_REVEALABLE);+ ig.add(BUILTIN_IGNORE);let sourceName: string | null = honorVcsIgnore ? null : VCS_IGNORE_DISABLED_SOURCE;let sourceMtimeMs = 0;diff --git a/packages/file-browser-core/src/ignoreNames.ts b/packages/file-browser-core/src/ignoreNames.tsdeleted file mode 100644index c3aad862db..0000000000--- a/packages/file-browser-core/src/ignoreNames.ts+++ /dev/null@@ -1,104 +0,0 @@-/**- * ignoreNames — 忽略名单的**纯数据**面(VCS/OS 垃圾 + 依赖/构建产物/缓存)。- *- * 拆出来只有一个原因:desktop renderer 也要用同一份名单。切「显示被忽略的- * 目录」开关时,renderer 要立刻把 reveal 态根列表里「隐藏态会被忽略」的一级- * 目录滤掉 —— 否则关开关后这些行要等新 matcher 的数据回来才消失,慢通道- * (SSH / device-link)下会有数秒「开关关了却还看得见」的窗口。- *- * 因此本文件必须保持零依赖:不 import 任何东西、不碰 fs。它经- * `@cindy/file-browser-core/ignoreNames` 子路径导出给 renderer,而包根入口- * (index.ts)会把 node:fs 拖进浏览器 bundle(同类说明见 desktop 的- * shared/textFileExts.ts)。名单只此一份:ignore.ts 的两宿主 matcher 从这里- * import。- *- * ⚠️ 改名单要同时想清楚三处消费:- * 1. loadIgnoreMatcher —— 两宿主列目录的过滤口径;- * 2. createEventIgnoreMatcher —— daemon 事件侧的恒真层;- * 3. desktop renderer 切开关的首帧过滤 —— 只认这里的一级目录名。- * 第 3 处只覆盖内置名单:`.gitignore` / `.p4ignore` 里的自定义条目拿不到- * (renderer 不读盘),要等新 matcher 的数据回来才生效 —— 不为它加一条 IPC。- */--/**- * Folder names (last path segment) that should never be walked into,- * regardless of vcs ignore files. Patterns are folder-name-only (no globs)- * because `ignore` lib treats them as "match anywhere in the path".- *- * 分两层,因为「用户看得见的工程目录」和「纯噪音」不是一回事:- * - ALWAYS:VCS 元数据与 OS 垃圾 —— 任何设置下都不列、不递归。- * - REVEALABLE:依赖 / 构建产物 / 缓存 / IDE 缓存 —— 默认隐藏(Unity 的- * Library 之类目录动辄数十万条,默认列出会让文件树不可用),但用户可在- * 设置里开「显示被忽略的目录」放行。- */-export const BUILTIN_IGNORE_ALWAYS = [- // VCS metadata: never part of the project's own file tree.- '.git/',- '.svn/',- '.hg/',- // OS junk- '.DS_Store',- 'Thumbs.db',-];--export const BUILTIN_IGNORE_REVEALABLE = [- // Package managers- 'node_modules/',- '__pycache__/',- 'vendor/',- '.venv/',- '.cache/',- // Editor / IDE caches- '.vs/',- '.idea/',- '.vscode-test/',- // Generic build outputs- 'dist/',- 'build/',- 'out/',- '.next/',- 'target/',- 'bin/',- 'obj/',- // Unity-specific (huge caches; .gitignore usually has them but be defensive)- 'Library/',- 'Temp/',- 'Logs/',- 'UserSettings/',- // Project-internal generated dirs (seen on real Unity workdirs)- 'AssetDepotOutput/',- 'ChuangXiangEditorCache/',- // .meta files (Unity per-asset metadata) — rendered behind a "show meta"- // user toggle; defaulting to hidden cuts ~47% of typical Unity entries.- // Toggle is honored by Matcher.shouldShowMeta below.- // Note: NOT added here — handled separately because it's user-toggleable- // per session via `hideMetaFiles`.-];--/**- * 「可以列出、但不实时 watch」的目录名 —— 与 BUILTIN_IGNORE_REVEALABLE 正交的- * 一层:即使开了「显示被忽略的目录」(它们会出现在文件树里),事件侧也要丢掉- * 它们内部的改动。- *- * 理由:node_modules 动辄数十万条目,Unity 的 Library 需要真正的资源依赖分析- * ——原生递归 watch 的代价与收益不成比例,手动刷新已够用。两个宿主的**事件**- * 过滤都必须吃这份清单(desktop 的 parcel 预过滤 + daemon 的事件过滤),但- * **列目录不看它**(listDir 只问 BUILTIN_IGNORE_*)。- */-export const WATCH_ALWAYS_IGNORE = ['node_modules', 'Library'] as const;--/**- * `BUILTIN_IGNORE_REVEALABLE` 的目录名集合(去掉名单里的尾斜杠)。用于判断某个- * relPath 是否落在「只有 reveal 态才可见」的目录内部 —— 事件侧按可见性分流时需要- * 它(见 desktop `device-op.ts` 的 device-link 转发)。- *- * 与 `WATCH_ALWAYS_IGNORE` 的分工:后者是「永远不 watch 内部」的一层(daemon 不会- * 发它们的事件);本集合是「隐藏态不可见、reveal 态可见」的一层 —— daemon 在并集- * matcher 下会发它们的事件,订阅方要自己按自己的可见性滤。- *- * 成员统一小写:`ignore` 包默认 `ignorecase=true`(大小写不敏感卷上 `DIST` 与- * `dist` 是同一个目录),消费方比较路径段前必须折叠大小写。- */-export const REVEALABLE_IGNORE_DIR_NAMES: ReadonlySet<string> = new Set(- BUILTIN_IGNORE_REVEALABLE.map((name) => name.replace(/\/$/, '').toLowerCase()),-);diff --git a/packages/file-browser-core/src/index.ts b/packages/file-browser-core/src/index.tsindex 52e7d2a5f4..ad3f43d59e 100644--- a/packages/file-browser-core/src/index.ts+++ b/packages/file-browser-core/src/index.ts@@ -40,8 +40,6 @@ export {export {loadIgnoreMatcher,- createEventIgnoreMatcher,- WATCH_ALWAYS_IGNORE,__clearCacheForTesting,type Matcher,} from './ignore.js';diff --git a/packages/file-browser-core/src/listAllFiles.ts b/packages/file-browser-core/src/listAllFiles.tsindex 71595c505c..35c39606e8 100644--- a/packages/file-browser-core/src/listAllFiles.ts+++ b/packages/file-browser-core/src/listAllFiles.ts@@ -162,20 +162,10 @@ export interface ListAllFilesWalkArgs {* 无 ripgrep 的纯 JS fallback:递归 readdir + 与文件树同一个 ignore matcher。** 与 rg 版的语义差异(有意为之、确定可解释):过滤走 loadIgnoreMatcher(根- * .gitignore / .p4ignore + BUILTIN_IGNORE 的**默认层**,即- * BUILTIN_IGNORE_REVEALABLE 仍然隐藏);rg 版额外理解嵌套 .gitignore /- * .rgignore,也不吃 BUILTIN_IGNORE。用途场景(远端裸机器没有 rg 时的文件名- * 筛选)里"接近文件树默认口径"比"和 rg 一致"更符合直觉。性能:纯 JS 串行遍历比- * rg 慢一个量级,但被 cap 上限兜底,中型项目 <1s。- *- * 这里**不接**「显示被忽略的目录」(showIgnoredDirs):该开关只作用于**浏览面**- * (文件树),文件名筛选与内容搜索一直按 ignore 规则工作 —— rg 那一路吃- * .gitignore / .ignore / .rgignore,这条 fallback 吃根 .gitignore +- * BUILTIN_IGNORE 默认层。两条路都无法跟这个开关一致(rg 侧没有办法"只放行构建- * 产物"而保留用户自己的 gitignore 规则),而**只让 fallback 跟随**会让同一份筛选- * 在装没装 rg 的机器上给出不同结果 —— 那比"树里看得见、筛选找不到"更难解释。- * 所以开关打开后树里出现 build / dist、而这份清单不含它们,是有意的语义差异- * (决策测试见 listAllFilesWalk.test.ts);要改就得两个后端一起改。+ * .gitignore / .p4ignore + BUILTIN_IGNORE),即**清单 = 用户在文件树里能看到的+ * 文件全集**;rg 版额外理解嵌套 .gitignore / .rgignore,并且不吃 BUILTIN_IGNORE。+ * 用途场景(远端裸机器没有 rg 时的文件名筛选)里"和树一致"比"和 rg 一致"更符合+ * 直觉。性能:纯 JS 串行遍历比 rg 慢一个量级,但被 cap 上限兜底,中型项目 <1s。** symlink:目录/文件符号链接一律跳过(rg --files 默认同样不 follow symlink,* 也避免链接环)。不可读目录(权限/竞态删除)静默跳过,不 fail 整个清单。diff --git a/packages/remote-file-service/src/__tests__/rpc.test.ts b/packages/remote-file-service/src/__tests__/rpc.test.tsindex 80d5ff6d32..80037790ca 100644--- a/packages/remote-file-service/src/__tests__/rpc.test.ts+++ b/packages/remote-file-service/src/__tests__/rpc.test.ts@@ -83,22 +83,15 @@ describe('remote-file-service RPC end-to-end', () => {expect(names).toContain('README.md');// 文件树不吃 VCS ignore(honorVcsIgnore: false):真实存在的目录要可见。expect(names).toContain('ignored-dir');- // 内置大目录默认隐藏(hideMetaFiles 与 showIgnoredDirs 是两个独立开关,- // 后者默认关 = 保持历史行为)。+ // 内置大目录屏蔽不受开关影响。expect(names).not.toContain('node_modules');expect(entries[0]?.type).toBe('directory');});- it('listDir 带 showIgnoredDirs 时列出内置隐藏目录', async () => {- await client.connect();- const { entries } = await client.request('listDir', { workdir, showIgnoredDirs: true });- expect(entries.map((e) => e.name)).toContain('node_modules');- });-it('listDir can return complete entries over the same RPC', async () => {await client.connect();const { entries } = await client.request('listDir', { workdir, includeIgnored: true, docMode: true });- expect(entries.map((e) => e.name)).toEqual(expect.arrayContaining(['node_modules', '.gitignore', 'blob.bin']));+ expect(entries.map(e => e.name)).toEqual(expect.arrayContaining(['node_modules', '.gitignore', 'blob.bin']));await expect(client.request('listDir', { workdir, includeIgnored: true, maxEntries: 1 })).rejects.toThrow('DIRECTORY_TOO_LARGE');});@@ -233,7 +226,6 @@ describe('remote-file-service RPC end-to-end', () => {await client.request('watchStop', { workdir });});-it('channel close rejects pending requests and marks client dead', async () => {await client.connect();toServer.end();diff --git a/packages/remote-file-service/src/__tests__/watchOptions.test.ts b/packages/remote-file-service/src/__tests__/watchOptions.test.tsdeleted file mode 100644index b3e0b3840c..0000000000--- a/packages/remote-file-service/src/__tests__/watchOptions.test.ts+++ /dev/null@@ -1,592 +0,0 @@-/**- * watchOptions.test.ts — daemon 侧 WorkdirWatchManager 的过滤开关语义。- *- * 背景:文件树新增「显示被忽略的目录」开关(showIgnoredDirs)。远端 daemon 的- * watcher 在 watchStart 时就把 matcher 固定下来,所以:- * - 重复 watchStart 且开关未变 → 幂等,不重建原生 watcher;- * - 开关变了 → 必须重建 matcher(否则控制端改了开关、watch 仍按旧规则过滤,- * 目录能列出来但内部改动永远没有事件);- * - 启动窗口内到达的 stop + 带新选项的 start → 必须收敛到新选项,且不能- * 留下「没有 watcher」的空档(两个 RPC 都报 success 的静默失效);- * - node_modules / Library 内部改动永远不推事件(事件侧恒真层):fs.watch- * recursive 会把它们照单全推,daemon 侧没有 desktop 的 parcel 预过滤兜底。- *- * 这里用假 `watch` + 假 loadIgnoreMatcher 锁定这些语义,不依赖真实 fs 事件- * (真机 Windows / Node 24 的 recursive fs.watch 本身有原生断言崩溃,见- * rpc.test.ts 的 watchStart 用例)。事件侧恒真层用**真实现**(纯函数、不读盘),- * 只有真正要读盘的 loadIgnoreMatcher 被替换掉。- */--import { describe, expect, it, vi, beforeEach } from 'vitest';--type FsWatchCallback = (eventType: string, filename: string | null) => void;--interface FakeWatcher {- on: (event: string, cb: (err: Error | null, filename: string | null) => void) => void;- close: () => void;-}--const h = vi.hoisted(() => {- const created: Array<{- dir: string;- watcher: FakeWatcher;- closed: boolean;- cb: FsWatchCallback | null;- }> = [];- return {- created,- /** loadIgnoreMatcher 收到的选项(按调用顺序)。 */- matcherOpts: [] as Array<Record<string, unknown>>,- /** 非零时接下来 N 次 loadIgnoreMatcher 直接 reject(模拟挂载不可用)。 */- failNext: 0,- /** 门闩:非空时下一次 loadIgnoreMatcher 等它放行(模拟读盘未完成)。 */- gate: null as Promise<void> | null,- watchSpy: vi.fn((dir: string, _opts: unknown, cb: FsWatchCallback) => {- const watcher: FakeWatcher = { on: vi.fn(), close: vi.fn() };- const record = { dir, watcher, closed: false, cb };- (watcher.close as unknown as ReturnType<typeof vi.fn>).mockImplementation(() => {- record.closed = true;- });- created.push(record);- return watcher;- }),- };-});--vi.mock('node:fs', async (importOriginal) => {- const actual = await importOriginal<typeof import('node:fs')>();- return { ...actual, watch: h.watchSpy };-});--vi.mock('@cindy/file-browser-core', async (importOriginal) => {- const actual = await importOriginal<typeof import('@cindy/file-browser-core')>();- return {- // 恒真层 / 后缀常量用真实现:前者的匹配语义(目录模式含后代)正是被测目标。- createEventIgnoreMatcher: actual.createEventIgnoreMatcher,- WATCH_ALWAYS_IGNORE: actual.WATCH_ALWAYS_IGNORE,- XDT_TMP_SUFFIX: actual.XDT_TMP_SUFFIX,- scopedLogger: () => ({ debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() }),- loadIgnoreMatcher: vi.fn(async (_workdir: string, opts: Record<string, unknown>) => {- h.matcherOpts.push(opts);- if (h.failNext > 0) {- h.failNext -= 1;- throw new Error('matcher load failed');- }- const gate = h.gate;- if (gate) {- h.gate = null;- await gate;- }- // 工作区 matcher 由测试单独控制(真实现要读盘)。- return { ignores: (rel: string) => rel.startsWith('hidden/') };- }),- };-});--import { WorkdirWatchManager } from '../watch';-import type { RemoteFileTreeEvent } from '../watch';--/** 触发一次原生事件,并等 coalesce 窗口(50ms)把批次吐出来。 */-async function fireEvent(- record: (typeof h.created)[number],- eventType: string,- filename: string,-): Promise<RemoteFileTreeEvent[]> {- record.cb?.(eventType, filename);- // 等生产代码真实的 coalesce 窗口(50ms)吐批次 —— 这是被测行为本身,- // 换 fake timers 会改掉 coalescing 的真实计时语义。- // real-wait: 等 coalesce 窗口真实计时器把批次吐出- await new Promise((resolve) => setTimeout(resolve, 120));- return emitted;-}--let emitted: RemoteFileTreeEvent[] = [];--describe('WorkdirWatchManager 过滤开关', () => {- beforeEach(() => {- h.created.length = 0;- h.matcherOpts.length = 0;- h.failNext = 0;- h.gate = null;- h.watchSpy.mockClear();- emitted = [];- });-- it('同 workdir 同选项重复 start 幂等,不重建原生 watcher', async () => {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', { hideMetaFiles: true, showIgnoredDirs: false });- await manager.start('/repo', { hideMetaFiles: true, showIgnoredDirs: false });- expect(h.watchSpy).toHaveBeenCalledTimes(1);- expect(h.matcherOpts).toHaveLength(1);- expect(h.created[0].closed).toBe(false);- manager.stopAll();- });-- it('showIgnoredDirs 变化触发重建:旧 watcher 关闭 + matcher 用新开关重建', async () => {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', { showIgnoredDirs: false });- await manager.start('/repo', { showIgnoredDirs: true });-- expect(h.created[0].closed).toBe(true);- expect(h.watchSpy).toHaveBeenCalledTimes(2);- expect(h.matcherOpts[0].showIgnoredDirs).toBe(false);- expect(h.matcherOpts[1].showIgnoredDirs).toBe(true);- manager.stopAll();- });-- it('start 的过滤开关原样落到 matcher(hideMetaFiles 默认 true)', async () => {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', {});- expect(h.matcherOpts[0]).toMatchObject({ hideMetaFiles: true, showIgnoredDirs: false });- manager.stopAll();- });-- /**- * 竞态回归(评审 P1):控制端切开关时 renderer 是「先 stop 再带新选项 start」。- * 若首个 watchStart 的 matcher 还在加载中,旧实现会复用那个 promise —— 新选项- * 被丢掉,而 stop 打的 stopDuringStart 标记又让那个 watcher 自拆,最终两边都- * 报 success 却**没有 watcher**。现在必须收敛到新选项。- */- it('启动窗口内 stop + 带新选项 start:收敛到新选项且留下活着的 watcher', async () => {- const manager = new WorkdirWatchManager((event) => emitted.push(event));- let release = (): void => {};- h.gate = new Promise<void>((resolve) => {- release = resolve;- });-- const first = manager.start('/repo', { showIgnoredDirs: false });- // 启动未落地:此刻 stop(renderer 的 effect cleanup)再 start(新选项)。- const stopped = Promise.resolve(manager.stop('/repo'));- const second = manager.start('/repo', { showIgnoredDirs: true });-- release();- await Promise.all([first, stopped, second]);-- // 旧实现:只建 1 个且已关 → 覆盖「没有 watcher」。新实现:旧的自拆,新的活着。- expect(h.created).toHaveLength(2);- expect(h.created[0].closed).toBe(true);- expect(h.created[1].closed).toBe(false);- expect(h.matcherOpts.at(-1)?.showIgnoredDirs).toBe(true);-- // 新 watcher 是活的:事件能按新 matcher 推出来。- const emittedEvents = await fireEvent(h.created[1], 'change', 'build/app.js');- expect(emittedEvents.some((e) => e.relPath === 'build/app.js')).toBe(true);- manager.stopAll();- });-- it('启动窗口内 stop 后没有新 start:不留 watcher,也不复活', async () => {- const manager = new WorkdirWatchManager(() => {});- let release = (): void => {};- h.gate = new Promise<void>((resolve) => {- release = resolve;- });-- const first = manager.start('/repo', { showIgnoredDirs: true });- manager.stop('/repo');- release();- await first;-- expect(h.created.every((c) => c.closed)).toBe(true);- manager.stopAll();- });-- /**- * 评审 P1:开关打开后 daemon 曾把 node_modules / Library 也放行给事件过滤,- * fs.watch recursive 会把装依赖 / Unity 导入的每个路径都推成 fileTree 帧过- * SSH。事件侧必须保留恒真层(与 desktop 的 PREFILTER_ALWAYS 同名单)。- */- it('开关打开也不推 node_modules / Library 的事件,但放行 build / dist', async () => {- const manager = new WorkdirWatchManager((event) => emitted.push(event));- await manager.start('/repo', { showIgnoredDirs: true });- const record = h.created[0];-- for (const rel of ['node_modules/react/index.js', 'Library/ScriptAssemblies/a.dll']) {- expect(await fireEvent(record, 'change', rel), rel).toHaveLength(0);- }- // 正对照:开关要放行的构建产物仍然推事件(否则这个开关在远端等于没生效)。- const buildEvents = await fireEvent(record, 'change', 'build/app.js');- expect(buildEvents.map((e) => e.relPath)).toEqual(['build/app.js']);- manager.stopAll();- });-- /**- * 评审 P2(PR #4398 轮五):恒真层的名字比较必须与 matcher 的大小写口径一致。- * `ignore` 包默认 `ignorecase=true`(`NODE_MODULES/` 会被恒真层匹配),而本地按- * 段比较若区分大小写,大小写变体目录在开关打开时可见、它**自身**的 rename /- * unlink 却被吞掉,行陈旧到手动刷新。- */- it('大小写变体的恒真目录:自身事件放行、内部事件仍然丢', async () => {- const manager = new WorkdirWatchManager((event) => emitted.push(event));- await manager.start('/repo', { showIgnoredDirs: true });- const record = h.created[0];-- // 目录自身(大小写变体)的事件必须推出去,否则树上的这一行会陈旧。- const own = await fireEvent(record, 'change', 'NODE_MODULES');- expect(own.map((e) => e.relPath)).toEqual(['NODE_MODULES']);-- // 内部事件仍然被恒真层丢掉(不再增长)。- const afterInside = await fireEvent(record, 'change', 'NODE_MODULES/react/index.js');- expect(afterInside).toHaveLength(1);- expect(afterInside[0].relPath).toBe('NODE_MODULES');- manager.stopAll();- });-- it('工作区 matcher 仍然生效(hidden/ 前缀被丢)', async () => {- const manager = new WorkdirWatchManager((event) => emitted.push(event));- await manager.start('/repo', { showIgnoredDirs: true });- expect(await fireEvent(h.created[0], 'change', 'hidden/x.ts')).toHaveLength(0);- manager.stopAll();- });-- /**- * 评审 P2:同一 workdir 会被两个消费方同时订阅 —— desktop 文件树(可开着- * 「显示被忽略的目录」)与 device-link 控制端(默认隐藏)。watcher 只能有一份- * matcher,必须取可见性并集;后到的隐藏态请求不能把先到的 reveal 覆盖掉,- * 否则 desktop 仍列着 build / dist,却再也收不到它们的事件。- */- it('多消费者取可见性并集:后到的隐藏态需求不覆盖先到的 reveal', async () => {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- await manager.start('/repo', { hideMetaFiles: true }, 'device-link');-- // 并集仍是 reveal:不重建原生 watcher。- expect(h.created).toHaveLength(1);- expect(h.created[0].closed).toBe(false);- expect(h.matcherOpts).toHaveLength(1);- expect(h.matcherOpts[0]).toMatchObject({ showIgnoredDirs: true });- manager.stopAll();- });-- it('部分消费者 stop:按剩余并集收敛,收窄为隐藏且 watcher 仍在', async () => {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- await manager.start('/repo', { showIgnoredDirs: false }, 'device-link');- expect(h.created).toHaveLength(1);-- manager.stop('/repo', 'desktop-tree');- await new Promise((resolve) => setTimeout(resolve, 0)); // 等异步 reconcile-- expect(h.created).toHaveLength(2);- expect(h.created[0].closed).toBe(true);- expect(h.created[1].closed).toBe(false);- expect(h.matcherOpts.at(-1)?.showIgnoredDirs).toBe(false);- manager.stopAll();- });-- /**- * 评审 P2(PR #4398 轮六):并集变化触发 watcher 重建时,旧 entry 的 `pending`- * 不能随 entry 一起丢 —— 已入队(尚未过 50ms 合并窗口)的事件仍要转发给还在线的- * 消费者,否则文件树陈旧到同目录下一次事件或手动刷新。- */- it('重建 watcher 前先转发 pending 事件:并集收窄不丢已入队事件', async () => {- const manager = new WorkdirWatchManager((event) => emitted.push(event));- await manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- await manager.start('/repo', { showIgnoredDirs: false }, 'device-link');- expect(h.created).toHaveLength(1);-- // 可见文件的 change 事件进入 50ms 合并窗口(还没到 flush)。- h.created[0].cb?.('change', 'src/app.ts');- expect(emitted).toHaveLength(0);-- // desktop 消费者在窗口内停止 → 并集收窄 → 重建 watcher。- manager.stop('/repo', 'desktop-tree');-- // pending 必须先转发给仍在线的 device-link 客户端,而不是随旧 entry 丢弃。- expect(emitted.map((e) => e.relPath)).toEqual(['src/app.ts']);-- await new Promise((resolve) => setTimeout(resolve, 0)); // 等异步 reconcile- expect(h.created).toHaveLength(2);- expect(h.created.at(-1)?.closed).toBe(false);- expect(h.matcherOpts.at(-1)?.showIgnoredDirs).toBe(false);- manager.stopAll();- });-- it('最后一个消费者 stop 才拆 watcher', async () => {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- await manager.start('/repo', { showIgnoredDirs: true }, 'device-link');-- manager.stop('/repo', 'desktop-tree');- await new Promise((resolve) => setTimeout(resolve, 0));- expect(h.created.every((c) => c.closed)).toBe(false); // 并集没变:watcher 留着-- manager.stop('/repo', 'device-link');- expect(h.created.every((c) => c.closed)).toBe(true);- manager.stopAll();- });-- /**- * 评审 P1:`ignore` 的目录模式(`node_modules/`)同时匹配目录自身与全部后代,- * 而事件过滤要的只是后代 —— 开关打开时 node_modules / Library 这一行就在树里,- * 它自己被建 / 删 / 改名必须推给父目录 refetch,否则树陈旧到手动刷新。- */- it('开关打开时恒真忽略目录自身的事件仍推,只丢其后代', async () => {- const manager = new WorkdirWatchManager((event) => emitted.push(event));- await manager.start('/repo', { showIgnoredDirs: true });- const record = h.created[0];-- // 目录自身的生命周期事件:推(类型由 lstat 映射出 add/unlink,这里只看 relPath)。- await fireEvent(record, 'rename', 'node_modules');- expect(emitted.map((e) => e.relPath)).toEqual(['node_modules']);-- // 后代仍然静默:npm install / Unity 导入不会打爆通道。- const before = emitted.length;- for (const rel of ['node_modules/react/index.js', 'foo/node_modules/a.js', 'foo/Library/x.dll']) {- await fireEvent(record, 'change', rel);- }- expect(emitted.length).toBe(before);- manager.stopAll();- });-- /**- * 评审 P1:错误处理曾调 `stop(workdir)`(默认 consumerId)—— 删错人,且- * reconcile 看到同一个坏 entry 选项没变而原地返回,直播静默冻结到手动改开关- * 或 daemon 重启。现在按剩余消费者并集拆掉重建成新的活 watcher。- */- it('watcher 出错时保留消费者意图并重建,不静默冻结', async () => {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- expect(h.created).toHaveLength(1);-- const onSpy = h.created[0].watcher.on as unknown as ReturnType<typeof vi.fn>;- const handler = onSpy.mock.calls.find(([evt]) => evt === 'error')?.[1] as (err: Error) => void;- handler(new Error('boom'));- await new Promise((resolve) => setTimeout(resolve, 0));-- expect(h.created).toHaveLength(2);- expect(h.created[0].closed).toBe(true);- expect(h.created[1].closed).toBe(false);- manager.stopAll();- });-- /**- * 评审 P2:watcher 报错后紧接着的 reconcile 又失败时不能只记日志 —— 消费者- * 意图还在 desired,但没有 watcher、也没有定时器再收敛,SSH 连接没断的情况下- * 事件会永久停止。要有带退避与上限的重试(退避避免持续失败时紧密重建循环)。- */- it('watcher 出错后收敛失败:退避重试直到恢复', async () => {- vi.useFakeTimers();- try {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- expect(h.created).toHaveLength(1);-- // 触发 error(拆掉 entry → 立即 reconcile),并让这次 reconcile 失败。- let failWith = (_err: Error): void => {};- h.gate = new Promise<void>((_resolve, reject) => {- failWith = reject;- });- const onSpy = h.created[0].watcher.on as unknown as ReturnType<typeof vi.fn>;- const handler = onSpy.mock.calls.find(([evt]) => evt === 'error')?.[1] as (err: Error) => void;- handler(new Error('boom'));- failWith(new Error('reconcile failed'));- await vi.advanceTimersByTimeAsync(0);-- // 退避(500ms)后重试成功:重新建出活着的 watcher。- await vi.advanceTimersByTimeAsync(600);- expect(h.created.length).toBeGreaterThanOrEqual(2);- expect(h.created.at(-1)?.closed).toBe(false);- manager.stopAll();- } finally {- vi.useRealTimers();- }- });-- /**- * 评审 P1(PR #4398):退避到顶(约 15.5s)后不能永久放弃 —— 挂载 / 权限故障- * 持续超过退避窗口时旧实现删掉重试状态,故障恢复后再没有定时器收敛;SSH 连接- * 没断的情况下文件事件永久静默,只有重挂面板 / 改开关才能救。- */- it('持续失败超过退避窗口后仍会继续重建(不永久停摆)', async () => {- vi.useFakeTimers();- try {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- expect(h.created).toHaveLength(1);-- // watcher 报错触发重建,并让之后所有 reconcile 都失败(挂载持续不可用)。- h.failNext = Number.MAX_SAFE_INTEGER;- const onSpy = h.created[0].watcher.on as unknown as ReturnType<typeof vi.fn>;- const handler = onSpy.mock.calls.find(([evt]) => evt === 'error')?.[1] as (err: Error) => void;- handler(new Error('boom'));-- // 跑过退避窗口(500+1000+2000+4000+8000 ≈ 15.5s)并再等几轮。- await vi.advanceTimersByTimeAsync(60_000);- expect(h.created.at(-1)?.closed).toBe(true); // 一直在失败,尚未建回-- // 故障恢复:下一次封顶退避(8s)内的重试必须把 watcher 建回来。- h.failNext = 0;- await vi.advanceTimersByTimeAsync(9_000);- expect(h.created.at(-1)?.closed).toBe(false);- manager.stopAll();- } finally {- vi.useRealTimers();- }- });-- /**- * 评审 P1:回滚后的恢复也失败时同样要退避重试 —— 只记日志的话,原有消费者会在- * 「选项变化 → 拆旧 watcher → 重建失败 → 回滚恢复意图」之后既没有 watcher、也没- * 有定时器再收敛。- */- it('回滚后的恢复失败:退避重试直到恢复', async () => {- vi.useFakeTimers();- try {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', {}, 'desktop-tree'); // 已生效的隐藏态 watcher- expect(h.created).toHaveLength(1);-- // 改选项(并集变化 → 拆旧重建)失败,且回滚后的恢复也失败。- h.failNext = 2;- await expect(- manager.start('/repo', { showIgnoredDirs: true }, 'device-link'),- ).rejects.toThrow('matcher load failed');- await vi.advanceTimersByTimeAsync(0);-- // 只剩 desktop-tree(隐藏)的意图 —— 靠退避重试把它的 watcher 建回来。- await vi.advanceTimersByTimeAsync(600);- expect(h.created.at(-1)?.closed).toBe(false);- expect(h.matcherOpts.at(-1)?.showIgnoredDirs).toBe(false);- manager.stopAll();- } finally {- vi.useRealTimers();- }- });-- /**- * 评审 P2:**部分停止**按剩余消费者收窄 matcher 时重建失败,也要退避重试 ——- * 旧 watcher 这时已经拆了,只记日志会让剩下的消费者永久失去实时事件。- */- it('部分停止后的重建失败:退避重试直到恢复', async () => {- vi.useFakeTimers();- try {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- await manager.start('/repo', {}, 'device-link');- expect(h.created).toHaveLength(1); // 并集 watcher 只建一个-- // 部分停止 → 收窄重建,但这次 loadIgnoreMatcher 失败。- h.failNext = 1;- manager.stop('/repo', 'desktop-tree');- await vi.advanceTimersByTimeAsync(0);- expect(h.created.at(-1)?.closed).toBe(true); // 旧 watcher 已关-- // 退避重试后按剩余消费者(隐藏)建回 watcher。- await vi.advanceTimersByTimeAsync(600);- expect(h.created.at(-1)?.closed).toBe(false);- expect(h.matcherOpts.at(-1)?.showIgnoredDirs).toBe(false);- manager.stopAll();- } finally {- vi.useRealTimers();- }- });-- /**- * 评审 P1:启动失败时若把消费者的意图留在 desired 里,控制端只会清本地注册、- * 不会再发 watchStop → daemon 里多出一个幽灵消费者:它抬高别的消费者的可见性- * 并集,最后一人 stop 时还会把它当孤儿 watcher 留下。- */- it('启动失败回滚本次消费者意图:不抬高别的消费者并集,也不留孤儿 watcher', async () => {- const manager = new WorkdirWatchManager(() => {});- let failWith = (_err: Error): void => {};- h.gate = new Promise<void>((_resolve, reject) => {- failWith = reject;- });-- const failing = manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- failWith(new Error('matcher load failed'));- await expect(failing).rejects.toThrow('matcher load failed');- expect(h.created).toHaveLength(0);-- // device-link(隐藏)看到的并集不应被那个失败的 reveal 需求抬高。- await manager.start('/repo', {}, 'device-link');- expect(h.matcherOpts.at(-1)?.showIgnoredDirs).toBe(false);-- // 最后一个真实消费者 stop:watcher 被拆(没有幽灵撑着)。- manager.stop('/repo', 'device-link');- expect(h.created.every((c) => c.closed)).toBe(true);- manager.stopAll();- });-- /**- * 自查发现:回滚改变了并集,而且失败可能就发生在「选项变化 → closeEntry 拆掉旧- * watcher → startInner 失败」之后 —— 原有消费者此刻没有 watcher。回滚后必须按- * 恢复后的意图再收敛一次,否则它会静默失去直播。- */- it('启动失败回滚后按恢复的意图重建原有消费者的 watcher', async () => {- const manager = new WorkdirWatchManager(() => {});- // A(隐藏)先建好 watcher。- await manager.start('/repo', {}, 'desktop-tree');- expect(h.created).toHaveLength(1);-- // B(reveal)到来:并集变化 → 拆旧重建;让这次 matcher 加载失败。- let failWith = (_err: Error): void => {};- h.gate = new Promise<void>((_resolve, reject) => {- failWith = reject;- });- const failing = manager.start('/repo', { showIgnoredDirs: true }, 'device-link');- failWith(new Error('matcher load failed'));- await expect(failing).rejects.toThrow('matcher load failed');- await new Promise((resolve) => setTimeout(resolve, 0)); // 等回滚后的 reconcile-- // 回滚后只剩 A 的意图:必须有一个活着的 watcher 用隐藏 matcher。- expect(h.created).toHaveLength(2);- expect(h.created[0].closed).toBe(true);- expect(h.created[1].closed).toBe(false);- expect(h.matcherOpts.at(-1)?.showIgnoredDirs).toBe(false);- manager.stopAll();- });-- /**- * 评审 P1:同一 consumerId 的重叠 start(双窗口启同一 workdir)共享同一次启动、- * 一起失败时,后到的那个不能把前一个**同样失败的**尝试当「前值」恢复 —— 否则- * 失败注册复活,回滚后的 fire-and-forget 收敛会真给它建一个没人再 stop 的- * 孤儿 watcher。- */- it('同一 consumerId 的重叠 start 都失败:不复活失败注册,不留活着的孤儿 watcher', async () => {- const manager = new WorkdirWatchManager(() => {});- let failWith = (_err: Error): void => {};- h.gate = new Promise<void>((_resolve, reject) => {- failWith = reject;- });-- const first = manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- const second = manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- failWith(new Error('matcher load failed'));- await expect(first).rejects.toThrow('matcher load failed');- await expect(second).rejects.toThrow('matcher load failed');- await new Promise((resolve) => setTimeout(resolve, 0)); // 等 fire-and-forget 收敛-- // 两个 caller 都失败 → 不能留下活着的 watcher(旧实现会复活失败注册并建出它)。- expect(h.created.every((c) => c.closed)).toBe(true);-- // 下一次同选项 start 要真能建出活 watcher(注册表里没有幽灵)。- await manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- expect(h.created.at(-1)?.closed).toBe(false);- manager.stopAll();- });-- /**- * 正向锁定:同一消费者已有生效注册、改选项重建失败时,回滚要恢复到**已生效**- * 的值(committed),而不是把注册从表里删掉 —— 否则那个消费者静默失去直播。- */- it('已有生效注册的消费者改选项失败:回滚到已生效值', async () => {- const manager = new WorkdirWatchManager(() => {});- await manager.start('/repo', {}, 'desktop-tree');- expect(h.created).toHaveLength(1);-- let failWith = (_err: Error): void => {};- h.gate = new Promise<void>((_resolve, reject) => {- failWith = reject;- });- const failing = manager.start('/repo', { showIgnoredDirs: true }, 'desktop-tree');- failWith(new Error('matcher load failed'));- await expect(failing).rejects.toThrow('matcher load failed');- await new Promise((resolve) => setTimeout(resolve, 0));-- // 回滚到已生效的隐藏态:watcher 活着且 matcher 用隐藏选项。- expect(h.matcherOpts.at(-1)?.showIgnoredDirs).toBe(false);- expect(h.created.at(-1)?.closed).toBe(false);- manager.stopAll();- });-});diff --git a/packages/remote-file-service/src/protocol.ts b/packages/remote-file-service/src/protocol.tsindex 71a85c0ddf..a1572fbe16 100644--- a/packages/remote-file-service/src/protocol.ts+++ b/packages/remote-file-service/src/protocol.ts@@ -36,7 +36,7 @@ import type {export const FILE_SERVICE_SCHEMA_VERSION = 3;/** 人读 bundle 版本(probe / 日志用),行为变化时手动 bump。 */-export const FILE_SERVICE_BUNDLE_VERSION = '0.2.6';+export const FILE_SERVICE_BUNDLE_VERSION = '0.2.5';/* ============================== 帧 ============================== */@@ -132,24 +132,7 @@ export interface FsRpcMethods {};};listDir: {- params: {- workdir: string;- relPath?: string;- hideMetaFiles?: boolean;- docMode?: boolean;- /**- * 完全绕过展示过滤(手机 HTML 快照枚举用)。可选 / append-only:老 daemon- * 忽略未知字段 → 维持隐藏语义(拿不到全量,但不会报错)。- */- includeIgnored?: boolean;- /** 条目上限;超出时 daemon 返回 DIRECTORY_TOO_LARGE。 */- maxEntries?: number;- /**- * 控制端「显示被忽略的目录」开关。可选 / append-only:老 daemon 忽略未知- * 字段 → 维持隐藏语义(拿不到放行,但不会报错)。- */- showIgnoredDirs?: boolean;- };+ params: { workdir: string; relPath?: string; hideMetaFiles?: boolean; docMode?: boolean; includeIgnored?: boolean; maxEntries?: number };result: { entries: DirEntry[] };};readFile: {@@ -210,23 +193,12 @@ export interface FsRpcMethods {params: { searchId: string };result: { ok: true };};- /**- * 订阅某个 workdir 的文件事件。`consumerId` 标识订阅方(desktop 文件树 /- * device-link 被控端 watch),可选 —— 老调用方缺省即归到默认消费者。- * 同一 workdir 的多个消费者各自登记过滤需求,daemon 取**可见性并集**- * (见 WorkdirWatchManager),不会互相覆盖 matcher。- */watchStart: {- params: {- workdir: string;- hideMetaFiles?: boolean;- showIgnoredDirs?: boolean;- consumerId?: string;- };+ params: { workdir: string; hideMetaFiles?: boolean };result: { ok: true };};watchStop: {- params: { workdir: string; consumerId?: string };+ params: { workdir: string };result: { ok: true };};}diff --git a/packages/remote-file-service/src/server.ts b/packages/remote-file-service/src/server.tsindex 717f15bbec..4424b0c15a 100644--- a/packages/remote-file-service/src/server.ts+++ b/packages/remote-file-service/src/server.ts@@ -140,7 +140,6 @@ export function runFileService(const matcher = p?.includeIgnored === true ? null : await loadIgnoreMatcher(workdir, {hideMetaFiles: p?.hideMetaFiles ?? true,honorVcsIgnore: false,- showIgnoredDirs: p?.showIgnoredDirs === true,});const entries = await listDir(workdir, p?.relPath ?? '', matcher, {docMode: p?.includeIgnored === true ? false : p?.docMode,@@ -206,21 +205,13 @@ export function runFileService(return { ok: true as const };},watchStart: async (p) => {- await watchManager.start(- requireString(p?.workdir, 'workdir'),- {- hideMetaFiles: p?.hideMetaFiles ?? true,- showIgnoredDirs: p?.showIgnoredDirs === true,- },- typeof p?.consumerId === 'string' ? p.consumerId : undefined,- );+ await watchManager.start(requireString(p?.workdir, 'workdir'), {+ hideMetaFiles: p?.hideMetaFiles ?? true,+ });return { ok: true as const };},watchStop: (p) => {- watchManager.stop(- requireString(p?.workdir, 'workdir'),- typeof p?.consumerId === 'string' ? p.consumerId : undefined,- );+ watchManager.stop(requireString(p?.workdir, 'workdir'));return { ok: true as const };},};diff --git a/packages/remote-file-service/src/watch.ts b/packages/remote-file-service/src/watch.tsindex 156402623b..58960fba1b 100644--- a/packages/remote-file-service/src/watch.ts+++ b/packages/remote-file-service/src/watch.ts@@ -17,80 +17,19 @@** 生命周期:per-workdir 单 watcher(重复 watchStart 幂等);stdin EOF /* watchStop 时 close。事件经注入的 emit 回调发 `fileTree` 帧。- *- * 注:自带过滤器(ignore matcher / .xdt-tmp)在 watchStart 时就固定下来,- * 控制端改开关后需要先 watchStop 再 watchStart 才能换 matcher。- *- * 同一 workdir 会被**多个消费方**请求(desktop 的 SSH 文件浏览器、device-link- * 的 fs-watch topic)。每个消费方用 consumerId 登记自己的过滤需求,watcher 取- * 全部消费者的**可见性并集** —— 否则后到的一方(控制端默认隐藏)会把前一方的- * reveal matcher 覆盖掉:desktop 仍列着 build / dist,它们的改动却永远没有- * 事件。多推的帧由订阅端按各自视图忽略,代价远小于静默丢事件。任一消费者在,- * watcher 就不拆;最后一个 stop 才关。选项变化由 start() / stop() 收敛。*/import { watch as fsWatch, promises as fs, type FSWatcher } from 'node:fs';import path from 'node:path';import {- createEventIgnoreMatcher,loadIgnoreMatcher,scopedLogger,- WATCH_ALWAYS_IGNORE,XDT_TMP_SUFFIX,type Matcher,} from '@cindy/file-browser-core';const log = scopedLogger('file-service/watch');-/**- * 「即使开关打开也不推事件」的恒真层(node_modules / Library / VCS / OS 垃圾)。- * 与 desktop 本地 watcher 的 PREFILTER_ALWAYS 同一份名单(单源:- * file-browser-core 的 WATCH_ALWAYS_IGNORE),因为 fs.watch recursive 会把- * 这些目录的事件照单全推上来 —— 没有这层兜底,`npm install` 或 Unity 导入会在- * SSH + IPC 上打出一串与路径数同阶的 fileTree 帧。容器依赖 workdir,常量即可。- */-const eventAlwaysIgnore = createEventIgnoreMatcher();--/**- * `WATCH_ALWAYS_IGNORE` 的小写集合。- *- * 按段比较的本地判断必须折叠大小写,与 `ignore` 包(createEventIgnoreMatcher- * 消费它,`ignorecase` 默认 true)的口径一致:大小写不敏感卷上 `NODE_MODULES` /- * `library` 这类变体在开关打开时可见,若本地比较区分大小写,它们**自身**的事件- * 会被恒真层吞掉,行陈旧到手动刷新(评审 P2)。- */-const alwaysIgnoreNamesLower = new Set(- (WATCH_ALWAYS_IGNORE as readonly string[]).map((name) => name.toLowerCase()),-);--/**- * 路径是否落在「开关打开也永远不推事件」目录的**内部**(不含目录自身)。- *- * 为什么不直接问 eventAlwaysIgnore:`ignore` 的目录模式(`node_modules/`)同时- * 匹配该目录自身与它全部后代,而这里要的只是后代 —— 开关打开时 node_modules /- * Library 这一行就在树里,它自己被创建 / 删除 / 改名必须让父目录 refetch- * (评审 P1:整条 rename 被吞掉的话,树会陈旧到手动刷新)。所以按路径段判断:- * 除最后一段外任一段命中名单即为「内部」。- */-function isInsideAlwaysIgnoredDir(relPath: string): boolean {- const segments = relPath.split('/');- for (let i = 0; i < segments.length - 1; i += 1) {- if (alwaysIgnoreNamesLower.has(segments[i].toLowerCase())) return true;- }- return false;-}--/**- * 路径是否是「开关打开也永远不推事件」目录的**自身**(node_modules / Library)。- * 这些行在开关打开时就在树里(见 isInsideAlwaysIgnoredDir),而恒真层的`ignore`- * 模式对自身也命中 —— 兜底那一行必须先把它排除掉,否则目录自身的 rename 又会被- * 吞回去。- */-function isAlwaysIgnoredDirItself(relPath: string): boolean {- const last = relPath.slice(relPath.lastIndexOf('/') + 1);- return alwaysIgnoreNamesLower.has(last.toLowerCase());-}-export interface RemoteFileTreeEvent {workdir: string;type: 'add' | 'change' | 'unlink';@@ -101,49 +40,13 @@ export interface RemoteFileTreeEvent {interface WatchEntry {watcher: FSWatcher;matcher: Matcher;- /** 建 watcher 时生效的过滤开关;变了要重建 matcher(fs.watch 本身不变)。 */- hideMetaFiles: boolean;- showIgnoredDirs: boolean;/** coalesce 缓冲:key = `${type}::${relPath}`。 */pending: Map<string, RemoteFileTreeEvent>;flushTimer: NodeJS.Timeout | null;}-/** 决定 watcher 过滤行为的选项(不含 workdir)。 */-interface WatchFilterOptions {- hideMetaFiles: boolean;- showIgnoredDirs: boolean;-}--/** 一个消费者在某个 workdir 上的意图。 */-interface ConsumerIntent {- /** 当前尝试的过滤需求(reconcile 与并集用这个)。 */- options: WatchFilterOptions;- /** 最近一次 reconcile **成功后**生效过的值;从没成功过是 null。- * 失败回滚恢复到它 —— 不能快照「进入 start 时的前值」:同一 consumerId 的- * 重叠 start 里,那个前值可能是另一个尚未提交、同样失败的尝试(评审 P1)。 */- committed: WatchFilterOptions | null;-}--function normalizeWatchOptions(opts: {- hideMetaFiles?: boolean;- showIgnoredDirs?: boolean;-}): WatchFilterOptions {- return { hideMetaFiles: opts.hideMetaFiles ?? true, showIgnoredDirs: opts.showIgnoredDirs === true };-}--function sameWatchOptions(a: WatchFilterOptions, b: WatchFilterOptions): boolean {- return a.hideMetaFiles === b.hideMetaFiles && a.showIgnoredDirs === b.showIgnoredDirs;-}-const COALESCE_MS = 50;-/** watcher 报错后重建的退避参数:起点 / 上限 / 次数上限。 */-const RECONCILE_RETRY_BASE_MS = 500;-const RECONCILE_RETRY_MAX_MS = 8_000;-/** 退避指数的封顶档位:计数到这里后不再变大,转为固定 RECONCILE_RETRY_MAX_MS 重试。 */-const RECONCILE_RETRY_BACKOFF_CAP = 5;-export class WorkdirWatchManager {private readonly entries = new Map<string, WatchEntry>();/** 启动中的 workdir:has 判定与 entries.set 之间隔着 loadIgnoreMatcher 的@@ -154,233 +57,47 @@ export class WorkdirWatchManager {/** 启动窗口内收到 stop 的 workdir:startInner 完成时不装 watcher(装完即拆),* 否则快速开关文件浏览会留下无人再来 stop 的孤儿原生 watcher。 */private readonly stopDuringStart = new Set<string>();- /** 每个 workdir 的消费者 → 它的意图(当前尝试 + 最近一次生效值)。watcher 只此- * 一份,选项取全部消费者的可见性并集(见 effectiveOptions);start() / stop()- * 每轮重读它收敛。 */- private readonly desired = new Map<string, Map<string, ConsumerIntent>>();-- /** watcher 报错后的重建重试定时器与次数(退避 + 上限,见 scheduleReconcileRetry)。 */- private readonly retryTimers = new Map<string, NodeJS.Timeout>();- private readonly retryAttempts = new Map<string, number>();-- /** 没带 consumerId 的调用方(旧控制端 / 内部调用)归到这个默认消费者。 */- private static readonly DEFAULT_CONSUMER = 'default';private readonly emit: (event: RemoteFileTreeEvent) => void;constructor(emit: (event: RemoteFileTreeEvent) => void) {this.emit = emit;}- /** 幂等启动。matcher 加载失败 / fs.watch 抛错向上冒(RPC 返回 OPERATION_FAILED)。- * 已存在同 workdir 的 watcher 时:过滤开关不同则重建(控制端改了「显示被忽略- * 的目录」后无需先 stop,重启守护进程也不必同步状态)。 */- async start(- workdir: string,- opts: { hideMetaFiles?: boolean; showIgnoredDirs?: boolean } = {},- consumerId: string = WorkdirWatchManager.DEFAULT_CONSUMER,- ): Promise<void> {- const consumers = this.desired.get(workdir) ?? new Map<string, ConsumerIntent>();- const attempted = normalizeWatchOptions(opts);- consumers.set(consumerId, {- options: attempted,- committed: consumers.get(consumerId)?.committed ?? null,- });- this.desired.set(workdir, consumers);+ /** 幂等启动。matcher 加载失败 / fs.watch 抛错向上冒(RPC 返回 OPERATION_FAILED)。 */+ async start(workdir: string, opts: { hideMetaFiles?: boolean } = {}): Promise<void> {+ if (this.entries.has(workdir)) return;+ const inflight = this.starting.get(workdir);+ if (inflight) return inflight;+ const run = this.startInner(workdir, opts);+ this.starting.set(workdir, run);try {- await this.reconcile(workdir);- this.clearReconcileRetry(workdir); // 新意图已生效:旧的重试状态作废- // 成功才记 committed:失败回滚只恢复到「真的生效过」的值。- const settled = this.desired.get(workdir)?.get(consumerId);- if (settled && settled.options === attempted) settled.committed = attempted;- } catch (err) {- // 启动失败:回滚**本次**写入的意图,否则 daemon 会留下一个「幽灵消费者」——- // 控制端的失败处理只清本地注册、不会再发 watchStop(见 remote-watch.ts),- // 之后别的消费者的可见性并集会被它抬高,最后一人 stop 时还会因它留下- // 孤儿 watcher(评审 P1)。- //- // 恢复到 **committed** 而不是进入时快照:同一 consumerId 的重叠 start(双- // 窗口启同一 workdir)里,快照可能是另一个尚未提交、同样失败的尝试 ——- // 恢复它等于让失败注册复活,而下面 fire-and-forget 的 reconcile 会真给- // 它建一个没人再 stop 的 watcher。没有 committed = 该 consumer 从未成功- // 注册过,直接删。- const current = this.desired.get(workdir)?.get(consumerId);- if (current && current.options === attempted) {- if (current.committed) {- current.options = current.committed;- } else {- this.desired.get(workdir)?.delete(consumerId);- if (this.desired.get(workdir)?.size === 0) this.desired.delete(workdir);- }- }- // 回滚改变了并集,而且失败可能就在「选项变化 → closeEntry 拆掉旧 watcher →- // startInner 失败」之后:原有消费者此刻没有 watcher。按恢复后的意图再收敛- // 一次;这次也失败(挂载仍不可用)就走**带退避的重试** —— 只记日志会让原消费- // 者静默失去直播,直到下一次显式 start / stop 或 daemon 重连(评审 P1)。- void this.reconcile(workdir)- .then(() => this.retryAttempts.delete(workdir))- .catch((rerr) => {- log.warn('watch reconcile after rollback failed', workdir, String(rerr));- this.scheduleReconcileRetry(workdir);- });- throw err;- }- }-- /**- * 收敛到「当前所有消费者的可见性并集」。为什么不直接 piggyback 启动中的- * promise:启动窗口内到达的 stop 会给 stopDuringStart 打标记让那个 watcher- * 自拆,而带新选项的 start 如果只是复用旧 promise,就会既丢掉新选项、又因为- * 标记留下「没有 watcher」的空档(两个 RPC 都报 success)。这里每轮重读- * desired,所以两种中途变化都在下一轮收敛。- *- * 终止性:每轮要么直接确认返回、要么推进一次真实的 startInner;desired 只会- * 被更新的请求改写或被 stop 删除,并发调用者数量有限 —— 循环次数以此封顶。- */- private async reconcile(workdir: string): Promise<void> {- for (;;) {- const inflight = this.starting.get(workdir);- if (inflight) {- // 前一轮可能用了已被覆盖的旧选项,也可能因期间到来的 stop 自拆 ——- // 都交给下一轮。它的失败由发起它的 caller 冒走,这里不吞也不重试。- await inflight;- continue;- }- const want = this.effectiveOptions(workdir);- if (!want) {- // 没有消费者了:watcher 不该活着。所有进入这里的路径(stop、回滚删掉- // 最后一个消费者)都要维护这个不变量 —— 否则会留下没人再 stop 的孤儿- // watcher(评审 P1 同类:回滚删注册后 fire-and-forget 的收敛不会再拆)。- this.closeEntry(workdir);- return;- }- const existing = this.entries.get(workdir);- if (existing) {- if (sameWatchOptions(existing, want)) return;- // 选项变了:拆掉重建(不能走 stop(),它会撤销 desired)。重建前先转发- // 合并窗口里的事件 —— 否则还在线的消费者会漏掉这一批(评审 P2)。- this.closeEntry(workdir, { flushPending: true });- }- const run = this.startInner(workdir, want);- this.starting.set(workdir, run);- try {- await run;- } finally {- this.starting.delete(workdir);- this.stopDuringStart.delete(workdir);- }- }- }-- /**- * 全部消费者的可见性并集:任一消费者要看被忽略目录 / `.meta`,watcher 就得- * 放行它们(推给各订阅端后由各自的视图忽略)。没有消费者时返回 null。- */- private effectiveOptions(workdir: string): WatchFilterOptions | null {- const consumers = this.desired.get(workdir);- if (!consumers || consumers.size === 0) return null;- let showIgnoredDirs = false;- let showMetaFiles = false;- for (const intent of consumers.values()) {- if (intent.options.showIgnoredDirs) showIgnoredDirs = true;- if (!intent.options.hideMetaFiles) showMetaFiles = true;+ await run;+ } finally {+ this.starting.delete(workdir);+ this.stopDuringStart.delete(workdir);}- return { showIgnoredDirs, hideMetaFiles: !showMetaFiles };}- /**- * watcher 报错后的收敛重试(退避封顶,不设总上限)。- *- * 为什么不能只 catch 一下:错误把 entry 拆掉后,如果紧接着的 reconcile 又失败- * (远程挂载短暂不可用 / 目录正在被替换),消费者意图仍留在 desired、但已经- * 没有 watcher,也没有任何定时器会再来收敛 —— SSH 连接没断的情况下,后续文件- * 事件会永久停止,直到用户改开关或重挂载面板(评审 P2)。退避避免持续失败时- * 形成紧密重建循环。- *- * 为什么退避到顶还要继续:挂载 / 权限故障持续超过退避窗口(约 15.5s)在真实- * 环境里很常见(扩容挂载、目录正在被替换),此时不能永久放弃 —— 意图还在,- * watcher 就必须最终建回来,否则故障恢复后事件永久静默、只能靠重挂面板救- * (评审 P1)。封顶后按固定频率重试,单次只做一次 matcher 加载 + fs.watch,- * 代价可忽略;消费者撤销由 clearReconcileRetry / stopAll 结束这个循环。- */- private scheduleReconcileRetry(workdir: string): void {- if (this.retryTimers.has(workdir)) return;- if (!this.desired.has(workdir)) return; // 期间消费者全撤了:不再重试- const attempt = (this.retryAttempts.get(workdir) ?? 0) + 1;- // 计数封顶:延迟计算不会越界,超限后转为固定频率重试。- const capped = Math.min(attempt, RECONCILE_RETRY_BACKOFF_CAP);- this.retryAttempts.set(workdir, capped);- if (attempt === RECONCILE_RETRY_BACKOFF_CAP + 1) {- log.warn('watch reconcile still failing, retrying at capped backoff', workdir);- }- const delay = Math.min(- RECONCILE_RETRY_BASE_MS * 2 ** (capped - 1),- RECONCILE_RETRY_MAX_MS,- );- const timer = setTimeout(() => {- this.retryTimers.delete(workdir);- void this.reconcile(workdir)- .then(() => this.retryAttempts.delete(workdir))- .catch((err) => {- log.warn('watch reconcile retry failed', workdir, String(err));- this.scheduleReconcileRetry(workdir);- });- }, delay);- timer.unref?.();- this.retryTimers.set(workdir, timer);- }-- /** 清掉某个 workdir 的重试状态(stop / 新 start 成功时调用)。 */- private clearReconcileRetry(workdir: string): void {- const timer = this.retryTimers.get(workdir);- if (timer) {- clearTimeout(timer);- this.retryTimers.delete(workdir);- }- this.retryAttempts.delete(workdir);- }-- private async startInner(workdir: string, opts: WatchFilterOptions): Promise<void> {+ private async startInner(workdir: string, opts: { hideMetaFiles?: boolean }): Promise<void> {const matcher = await loadIgnoreMatcher(workdir, {- hideMetaFiles: opts.hideMetaFiles,+ hideMetaFiles: opts.hideMetaFiles ?? true,honorVcsIgnore: false,- showIgnoredDirs: opts.showIgnoredDirs,});- const entry: WatchEntry = {- watcher: null as unknown as FSWatcher,- matcher,- hideMetaFiles: opts.hideMetaFiles,- showIgnoredDirs: opts.showIgnoredDirs,- pending: new Map(),- flushTimer: null,- };+ const entry: WatchEntry = { watcher: null as unknown as FSWatcher, matcher, pending: new Map(), flushTimer: null };const watcher = fsWatch(workdir, { recursive: true }, (eventType, filename) => {// filename 偶发 null(平台边缘情况),无法定位目标 — 丢弃,聚焦刷新兜底。if (!filename) return;void this.handleRaw(workdir, entry, eventType, filename.toString());});watcher.on('error', (err) => {- // watcher 挂了(权限 / 目录被删):拆掉**这个** entry,保留消费者意图并按- // 剩余并集重建。不能走 stop(workdir) —— 那要挑一个 consumerId,而错误不是- // 任何消费者的意图变化:拿默认 id 会删错人,reconcile 又看到同一个坏- // entry 选项没变而原地返回,直播就静默冻结到手动改开关或 daemon 重启。+ // watcher 挂了(权限 / 目录被删):log 后移除,消费端靠手动刷新。log.warn('fs.watch error, dropping watcher', workdir, String(err));- if (this.entries.get(workdir) !== entry) return; // 已被替换 / 停止:不碰新 entry- // 报错前已入队的事件仍是真实事件:重建前先转发,不随旧 entry 丢弃(评审 P2)。- this.closeEntry(workdir, { flushPending: true });- // 就地收敛;失败(挂载短暂不可用 / 目录正在被替换)则带退避重试,直到成功- // 或耗尽 —— 只记日志会让这个入口静默失效到用户改开关(评审 P2)。- void this.reconcile(workdir)- .then(() => this.retryAttempts.delete(workdir))- .catch((rerr) => {- log.warn('watch reconcile after error failed', workdir, String(rerr));- this.scheduleReconcileRetry(workdir);- });+ this.stop(workdir);});entry.watcher = watcher;if (this.stopDuringStart.delete(workdir)) {// 启动期间来了 stop(调用方的登记已清,不会再发第二次 stop):当场拆掉。- // 标记的清理归 reconcile 的 finally(成功 / 失败两条路径都走那里)。try {watcher.close();} catch {@@ -393,60 +110,13 @@ export class WorkdirWatchManager {log.info('watch started', workdir);}- stop(workdir: string, consumerId: string = WorkdirWatchManager.DEFAULT_CONSUMER): void {- const consumers = this.desired.get(workdir);- if (consumers) {- consumers.delete(consumerId);- if (consumers.size > 0) {- // 还有别的消费者:按剩余并集收敛(可能收窄,需要重建 matcher)。这里是- // sync 的 RPC handler,重建异步进行 —— RPC 语义是「撤销本消费者的- // 需求」,不承诺 watcher 在返回前已重建完。失败要走带退避的**重试**:- // 旧 watcher 此刻已经被拆了,只记日志会让剩下的消费者在挂载短暂不可用- // 时永久失去实时事件,直到下一次显式 start / stop 或 daemon 重连- // (评审 P2)。- void this.reconcile(workdir)- .then(() => this.retryAttempts.delete(workdir))- .catch((err) => {- log.warn('watch reconcile after partial stop failed', workdir, String(err));- this.scheduleReconcileRetry(workdir);- });- return;- }- this.desired.delete(workdir);- }- this.clearReconcileRetry(workdir);- // 撤销意图:收敛循环读到 desired 缺失即结束(piggyback 的新 start 会写回)。+ stop(workdir: string): void {// 还在启动窗口:打标记让 startInner 完成时自拆(entries 里此刻还没有它)。if (this.starting.has(workdir)) this.stopDuringStart.add(workdir);- this.closeEntry(workdir);- }-- /** 把合并窗口里已经入队的事件立刻发出去(重建前保序转发用)。 */- private flushPending(entry: WatchEntry): void {- if (entry.flushTimer) {- clearTimeout(entry.flushTimer);- entry.flushTimer = null;- }- if (entry.pending.size === 0) return;- const batch = [...entry.pending.values()];- entry.pending.clear();- for (const evt of batch) this.emit(evt);- }-- /**- * 拆掉已就位的 watcher。不碰 desired —— 选项变化重建时由调用方决定意图。- *- * `flushPending`:**重建**路径(选项变化 / watcher 报错后重建)要先转发合并- * 窗口里的事件 —— 旧 entry 的 `pending` 随 entry 一起被丢的话,还活着的消费者- * 会漏掉这次事件,文件树陈旧到同目录下一次事件或手动刷新(评审 P2)。- * 最后一个消费者停止 / stopAll 不带这个旗标:那时事件已无人消费,直接丢。- */- private closeEntry(workdir: string, opts?: { flushPending?: boolean }): void {const entry = this.entries.get(workdir);if (!entry) return;this.entries.delete(workdir);- if (opts?.flushPending) this.flushPending(entry);- else if (entry.flushTimer) clearTimeout(entry.flushTimer);+ if (entry.flushTimer) clearTimeout(entry.flushTimer);try {entry.watcher.close();} catch {@@ -456,13 +126,8 @@ export class WorkdirWatchManager {}stopAll(): void {- // 全部意图撤销:启动中的 workdir 也要让收敛循环看到「没有 desired」而结束。- this.desired.clear();- for (const timer of this.retryTimers.values()) clearTimeout(timer);- this.retryTimers.clear();- this.retryAttempts.clear();for (const workdir of [...this.starting.keys()]) this.stopDuringStart.add(workdir);- for (const workdir of [...this.entries.keys()]) this.closeEntry(workdir);+ for (const workdir of [...this.entries.keys()]) this.stop(workdir);}private async handleRaw(@@ -474,14 +139,8 @@ export class WorkdirWatchManager {const relPath = rawFilename.split(path.sep).join('/');if (relPath === '' || relPath.startsWith('..')) return;if (relPath.endsWith(XDT_TMP_SUFFIX)) return;- /** matcher 不知道路径是 file 还是 dir,双查任一命中即丢(同 desktop watcher)。 */+ // matcher 不知道路径是 file 还是 dir,双查任一命中即丢(同 desktop watcher)。if (entry.matcher.ignores(relPath, false) && entry.matcher.ignores(relPath, true)) return;- // 开关打开也永远不推的目录(node_modules / Library):只丢**内部**事件,- // 目录自身的生命周期事件要留(见 isInsideAlwaysIgnoredDir)。- if (isInsideAlwaysIgnoredDir(relPath)) return;- // 兜底:BUILTIN_IGNORE_ALWAYS(.git / .DS_Store 之类,自身与后代都不显示)。- // 但恒真忽略目录自身已在上一行放行,不能再被这里拦下。- if (!isAlwaysIgnoredDirItself(relPath) && eventAlwaysIgnore.ignores(relPath, true)) return;let type: RemoteFileTreeEvent['type'];if (eventType === 'change') {@@ -503,7 +162,9 @@ export class WorkdirWatchManager {if (entry.flushTimer) return;entry.flushTimer = setTimeout(() => {entry.flushTimer = null;- this.flushPending(entry);+ const batch = [...entry.pending.values()];+ entry.pending.clear();+ for (const evt of batch) this.emit(evt);}, COALESCE_MS);entry.flushTimer.unref?.();}