Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { Button } from '@/components/ui/button';
/**
* FileBrowserBody — file-browser plugin 的 TabBody 实现。
*
* 视觉(对设计稿 F2 双 Pane 镜像版,2026-06-30 用户要求左右换):
* ┌─────────────────────────────────┬───────────┐
* │ Body │ Tree │
* │ (flex-1, FileBodyView) │ (resizable) │
* └─────────────────────────────────┴───────────┘
*
* 中间分割线可拖拽 + 双击复位(useSessionScopedTreeWidth 走 per-session 持久化,
* 树在 handle 右边、invert=true 让指针左移=树变宽)。树宽 **per-session** 持久化
* (每个 session 单独记自己的宽度),同一 session 内多个 file-browser tab 共享同
* 一个 per-session 偏好;首次没值时继承全局 `:last` fallback,再没值落 200px 默认。
* 详见 `useSessionScopedTreeWidth.ts`。
*
* 数据驱动:
* - `useFileTree({ workdir, hideMetaFiles: true })` 拉文件树(internal lazy expand)。
* - `useFileContent(workdir, selectedFilePath)` 拉选中文件内容(text/binary/error/loading)。
* - 选中 / 新增 / 重命名等可变操作 v1 不引入 —— 嵌入式版只支持"看",不支持"改文件结构"。
* 用户需要管理文件请走 doc 模式(顶部右键 → "在 doc 模式打开" 之类)。
*
* Workdir 缺失兜底:remote session / 尚未解析 → workdir = '',不挂底层 hooks(否则
* useFileTree 会按空字符串去打 IPC、把 main 端炸出 invalid path 错误),直接渲染
* "未关联本地目录" 占位。
*
* Dirty 切换:用户在文件编辑态有 unsaved 改动时,onSelectFile 走 `useConfirmSwitchAwayIfDirty`
* 弹三选一(保存 / 不保存 / 取消)。底层 hook 走 module-level activeFileBodyHandle
* singleton 拿当前 dirty 状态,跟 doc 模式行为一致。
*/
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 { cn } from '@/lib/utils';
import { isGlobalDropIntercepted } from '@/lib/globalDropIntercept';
import { useFileBrowserPreference } from '@/hooks/useFileBrowserPreference';
import { toast } from '@/lib/toast';
import { ImageLightbox } from '@/components/chat/ImageLightbox';
import {
useSessionScopedTreeWidth,
TREE_MIN_WIDTH,
TREE_MAX_WIDTH,
} from './useSessionScopedTreeWidth';
import {
FileTreeView,
type FileTreeViewHandle,
} from '@/features/cc-agent/workdir-browse/FileTreeView';
import { FileBodyView } from '@/features/cc-agent/workdir-browse/FileBodyView';
import {
useFileTree,
type DirEntry,
} from '@/features/cc-agent/workdir-browse/hooks/useFileTree';
import { useFileContent } from '@/features/cc-agent/workdir-browse/hooks/useFileContent';
import { useConfirmSwitchAwayIfDirty } from '@/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty';
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';
import {
FILTER_RESULT_LIMIT,
filterFiles,
} from '@/features/cc-agent/workdir-browse/lib/filterFiles';
import { toOsAbsolutePath } from '@/features/cc-agent/workdir-browse/lib/fileMeta';
import { addTab, ensureHydrated } from '@/features/right-sidebar/store';
import { toWorkdirRel } from '../../../../../shared/workdirPath';
import {
getSessionDeviceId,
remoteProjectsStore,
} from '@/features/device-link/remoteProjectsStore';
import type { TabKindHostContext } from '../../types';
import type { FileBrowserState } from './index';
import { buildFileTreeImagePreviewUrl } from './fileTreeImagePreview';
import {
countFileDragItems,
hasFileDragPayload,
isDroppedFilePreviewSupported,
runExternalFileOpenRequest,
splitExternalFilePath,
type ExternalFileSelection,
} from './dropExternalFile';
/** 项目级 ripgrep 搜索硬上限,跟 doc 模式 sidebar 同值。 */
const SEARCH_MAX_MATCHES = 1000;
type TreeMode = 'tree' | 'search';
// CodeMirror padding / max-width override —— 让嵌入式版 FileBodyView 在窄栏里
// 内容真正贴边,不被 doc 模式那套阅读舒适 padding(72px + max-w 920px)挤到中间。
import './FileBrowserBody.css';
/** body 至少要留给 FileBodyView 的最小可视宽度。tree 在 DOM 末尾、容器 overflow-hidden,
* RSB 缩小后如不给 body 留底,tree 会被从右边缘切掉(2026-07-01 用户实测 bug:
* 左栏展开 → RSB pixel 宽按 fraction 缩 → tree 被切看着像"自动折叠")。 */
const BODY_MIN_RESERVE = 100;
interface FileBrowserBodyProps {
state: FileBrowserState;
ctx: TabKindHostContext;
/** 宿主 tab 是否激活(PluginBodyHost 传入)。只用于文件树滚动位置的恢复时机;
* 隐藏 tab 的行渲染由虚拟化的 0 视口自然跳过,不需要门控。 */
active?: boolean;
}
export function FileBrowserBody({ state, ctx, active }: FileBrowserBodyProps) {
const { workdir } = ctx;
if (!workdir) {
return <NoWorkdirPlaceholder />;
}
return (
<FileBrowserBodyWithWorkdir state={state} ctx={ctx} workdir={workdir} active={active} />
);
}
/**
* 拆出"workdir 非空"分支以保证 hooks 顺序稳定 —— useFileTree / useFileContent
* 不应在 workdir 空字符串时挂载(IPC 路径校验会炸),React 又禁止条件 hook,所以
* 把"是否挂"上提到 component 级条件渲染。
*/
function FileBrowserBodyWithWorkdir({
state,
ctx,
workdir,
active,
}: FileBrowserBodyProps & { workdir: string }) {
const { t } = useTranslation();
// 会话归属三路:local / SSH(remoteHostId)/ device-link(deviceId)。
// deviceId 从 sessionId→deviceId 注册表取(useSyncExternalStore:注册可能晚于
// 首渲染,见 useRemoteMediaUrl 同款处理);嵌套(device-link 会话自带
// remoteHostId)时 deviceId 优先——SSH 二跳由被控端 device-op 处理,控制端
// 不能把被控端的 hostId 发给自己的 main。
const deviceId = useSyncExternalStore(remoteProjectsStore.subscribe, () =>
ctx.sessionId ? getSessionDeviceId(ctx.sessionId) ?? null : null,
);
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 fileContent = useFileContent(workdir, state.selectedFilePath, remoteHostId, deviceId);
const [externalFile, setExternalFile] = useState<ExternalFileSelection | null>(null);
const [imageLightboxSrc, setImageLightboxSrc] = useState<string | null>(null);
const externalFileContent = useFileContent(externalFile?.workdir ?? workdir, externalFile?.relPath ?? null);
const fileDragDepthRef = useRef(0);
const [isDraggingFile, setIsDraggingFile] = useState(false);
const confirmSwitchAway = useConfirmSwitchAwayIfDirty();
// 文件树 / 搜索 双模式 —— 跟 doc 模式 sidebar 同 ergonomics(参考 WorkdirBrowseSidebar
// L124 的 mode state)。mode 不持久化,关 tab 重开默认 tree(合理预期:用户切到
// 新 tab 期望"看文件",不是"接着上次的搜索状态")。
const [mode, setMode] = useState<TreeMode>('tree');
const [searchQuery, setSearchQuery] = useState('');
const [searchCaseSensitive, setSearchCaseSensitive] = useState(false);
// 文件名筛选 query —— tree 模式下用,独立于内容搜索。空 query 显示文件树,有
// 内容显示筛选结果列表。不持久化(关 tab 重开默认空)。
const [filterQuery, setFilterQuery] = useState('');
// 项目级文件名扁平列表(走 ripgrep --files honor .gitignore),给文件名筛选用。
// 缓存 30 秒,跨 tab 共享同 workdir 索引;tree.refresh 时同步 invalidate。
// remote:daemon 内跑远端 rg;远端没有 rg 时返回空 + error,走"未索引"占位。
// enabled 惰性拉取:query 为空(FilterResultList 不显示)时不扫描 —— 切会话
// 不再为用不上的索引付 rg + IPC + 建索引的主线程成本。trim 与 filterFiles
// 的匹配语义对齐:纯空格 query 结果必为空,不值得为它扫描。
const projectFiles = useProjectFileList(workdir, remoteHostId, deviceId, {
enabled: filterQuery.trim() !== '',
});
const filteredFiles = useMemo(
() => filterFiles(filterQuery, projectFiles.files),
[filterQuery, projectFiles.files],
);
const search = useProjectSearch({
workdir,
remoteHostId,
deviceId,
query: searchQuery,
caseSensitive: searchCaseSensitive,
maxMatches: SEARCH_MAX_MATCHES,
});
// 容器宽度 ResizeObserver —— 给 tree max 做动态钳制。
// RSB 总宽 = fraction × (窗口宽 − 左栏宽),左栏展开 / 折叠会让 RSB pixel 宽按比例缩放。
// 不监听容器宽 → tree max 写死 500 / tree 当前宽是固定 px → RSB 缩到不够时 tree 在
// DOM 末尾被 `overflow-hidden` 从右切掉,视觉上像"自动折叠消失"(2026-07-01 用户实测)。
const containerRef = useRef<HTMLDivElement>(null);
const [containerWidth, setContainerWidth] = useState(0);
useEffect(() => {
const el = containerRef.current;
if (!el) return;
setContainerWidth(el.clientWidth);
const ro = new ResizeObserver(() => setContainerWidth(el.clientWidth));
ro.observe(el);
return () => ro.disconnect();
}, []);
// 动态 tree max:留给 body 至少 BODY_MIN_RESERVE 像素;首帧 containerWidth=0 时
// 退回静态 TREE_MAX_WIDTH(此时 hook 还没读到容器宽,不要把 max 算成负值)。
// useHorizontalResize 的 L230-236 effect 会在 max 收缩时把当前 width 自动 clamp,
// 持久值不动 —— 用户拖宽过的 tree 在 RSB 恢复后能拖回原样。
const dynamicTreeMax =
containerWidth > 0
? Math.max(TREE_MIN_WIDTH, Math.min(TREE_MAX_WIDTH, containerWidth - 1 - BODY_MIN_RESERVE))
: TREE_MAX_WIDTH;
// 树宽度可拖拽 + per-session 持久化。invert=true:handle 在树左边,指针左移(delta<0)
// 树变宽,跟 RightSidebar 自身 resize handle 的方向语义一致。双击 handle 自动复位到默认 200,
// 同时把 200 写进全局 `:last`(影响后续新 session 的初值)。详见 useSessionScopedTreeWidth.ts。
const {
width: treeWidth,
isDragging: isTreeDragging,
handleDragStart: handleTreeDragStart,
resetWidth: resetTreeWidth,
} = useSessionScopedTreeWidth({
sessionId: ctx.sessionId,
dynamicTreeMax,
});
const handleSelectFile = useCallback(
async (relPath: string) => {
// 切到同一文件 / 当前没有 active dirty editor → 直接放行;否则弹三选一。
const ok = await confirmSwitchAway(state.selectedFilePath, relPath);
if (!ok) return;
setExternalFile(null);
ctx.patchState({ selectedFilePath: relPath });
},
[confirmSwitchAway, ctx, state.selectedFilePath],
);
// 搜索结果点击 → 切回 tree 模式 + 选中该文件。
// RSB 版 plugin state 暂时只持有 selectedFilePath,没有 jumpLine / jumpQuery 字段
// (doc 模式靠 URL ?line= 跳行号、?search= 高亮命中),所以这里 lineNumber 暂时丢弃,
// 用户能定位到文件已经满足"项目级搜索 → 打开命中文件"主流程。
// Phase 后续如果有诉求,可扩展 FileBrowserState 持 jumpLine 字段。
const handleOpenMatch = useCallback(
async (relPath: string) => {
const ok = await confirmSwitchAway(state.selectedFilePath, relPath);
if (!ok) return;
setExternalFile(null);
ctx.patchState({ selectedFilePath: relPath });
setMode('tree');
},
[confirmSwitchAway, ctx, state.selectedFilePath],
);
// FileTreeView 的 imperative ref —— useRevealFileInTree 通过它调 scrollToPath。
const fileTreeRef = useRef<FileTreeViewHandle>(null);
const revealFileInTree = useRevealFileInTree(tree, fileTreeRef);
// 聊天目录 chip → openDirInSidebarFileBrowser 写入的一次性定位请求:切回 tree
// 视图、展开父目录并滚到该目录行、把目录本身也展开(用户意图是"看这个文件夹
// 里有什么")。消费后立即清空 transient 字段,tab 重挂载 / 会话切换不会重放。
// nonce 进依赖:同一目录重复点击也重新触发。
const revealDirPath = state.revealDirPath ?? null;
const revealDirNonce = state.revealDirNonce ?? 0;
useEffect(() => {
if (!revealDirPath) return;
let cancelled = false;
void (async () => {
setMode('tree');
setFilterQuery('');
await revealFileInTree(revealDirPath);
if (cancelled) return;
if (!tree.expanded.has(revealDirPath)) tree.toggleFolder(revealDirPath);
setExternalFile(null);
ctx.patchState({ revealDirPath: null });
})();
return () => {
cancelled = true;
};
// tree/ctx 引用变化不该重放已消费的请求。
}, [revealDirPath, revealDirNonce]);
// 聊天文件 chip → openFileInSidebarFileBrowser 写入的一次性定位请求:
// 选中文件,切回 tree 视图,展开父目录并把文件行滚到视口中部。切换前仍走
// dirty guard,避免用户在当前 RSB 文件里有未保存编辑时被外部右键菜单直接切走。
const revealFilePath = state.revealFilePath ?? null;
const revealFileNonce = state.revealFileNonce ?? 0;
useEffect(() => {
if (!revealFilePath) return;
let cancelled = false;
void (async () => {
const ok = await confirmSwitchAway(state.selectedFilePath, revealFilePath);
if (cancelled) return;
if (!ok) {
ctx.patchState({ revealFilePath: null });
return;
}
setMode('tree');
setFilterQuery('');
setExternalFile(null);
ctx.patchState({ selectedFilePath: revealFilePath });
await revealFileInTree(revealFilePath);
if (cancelled) return;
ctx.patchState({ revealFilePath: null });
})();
return () => {
cancelled = true;
};
// state/ctx/tree 引用变化不该重放已消费的请求。
}, [revealFilePath, revealFileNonce]);
// 文件名筛选结果点击 → 选中文件 + 清空 query + 展开父目录 + 滚动到该行
// (回到正常文件树视图,跟用户直觉一致:"我找到这个文件了,接下来就在看它")。
// 展开 + 滚动逻辑封在 useRevealFileInTree,doc 模式 sidebar 共用同一份(以后
// 优化 reveal 行为只改 hook 一处)。
const handleSelectFromFilter = useCallback(
async (relPath: string) => {
const ok = await confirmSwitchAway(state.selectedFilePath, relPath);
if (!ok) return;
setExternalFile(null);
ctx.patchState({ selectedFilePath: relPath });
setFilterQuery('');
// 等 filterQuery 清空 → tree 视图重新可见,然后 reveal 内部再两次 rAF
// 等 React commit / layout 稳定 → scroll。
void revealFileInTree(relPath);
},
[confirmSwitchAway, ctx, revealFileInTree, state.selectedFilePath],
);
// refresh 按钮:文件树 + 项目文件索引一起 invalidate。
const handleRefresh = useCallback(() => {
void tree.refresh();
projectFiles.refresh();
}, [tree, projectFiles]);
const handleCopyFilePath = useCallback(
async (entry: DirEntry) => {
const abs = toOsAbsolutePath(workdir, entry.relPath);
try {
await navigator.clipboard.writeText(abs);
toast.success(t('ccAgent.workdirBrowse.pathCopied'));
} catch {
toast.warning(t('ccAgent.workdirBrowse.copyFailed'));
}
},
[workdir, t],
);
const handlePreviewImage = useCallback(
(entry: DirEntry) => {
const src = buildFileTreeImagePreviewUrl({
workdir,
relPath: entry.relPath,
remoteHostId,
deviceId,
});
if (!src) {
toast.warning(t('ccAgent.workdirBrowse.unrenderable.remoteNotSupported'));
return;
}
setImageLightboxSrc(src);
},
[deviceId, remoteHostId, t, workdir],
);
const handleRevealInFolder = useCallback(
async (entry: DirEntry) => {
const abs = toOsAbsolutePath(workdir, entry.relPath);
const res = await window.electronAPI.showItemInFolder({ filePath: abs });
if (!res.success) {
toast.error(t('ccAgent.workdirBrowse.revealFailed', { error: res.error ?? t('ccAgent.common.unknownError') }));
}
},
[workdir, t],
);
const handleOpenInSidebarBrowser = useCallback(
async (entry: DirEntry) => {
await openHtmlFileByPreference(
ctx.sessionId,
toOsAbsolutePath(workdir, entry.relPath),
t,
{
origin: resolveSessionFileOrigin(deviceId ?? undefined, remoteHostId),
workingDir: workdir,
},
'sidebar',
);
},
[ctx.sessionId, workdir, deviceId, remoteHostId, t],
);
const handleOpenInFileBrowser = useCallback(
async (entry: DirEntry) => {
if (entry.type !== 'file') return;
if (!ctx.sessionId) return;
try {
await ensureHydrated(ctx.sessionId);
await addTab(ctx.sessionId, 'file-browser', { selectedFilePath: entry.relPath });
} catch {
toast.error(t('rightSidebar.tabs.addFailed'));
}
},
[ctx.sessionId, t],
);
const handleOpenInBrowser = useCallback(
async (entry: DirEntry) => {
await openHtmlFileByPreference(
ctx.sessionId,
toOsAbsolutePath(workdir, entry.relPath),
t,
{
origin: resolveSessionFileOrigin(deviceId ?? undefined, remoteHostId),
workingDir: workdir,
},
'external',
);
},
[ctx.sessionId, workdir, deviceId, remoteHostId, t],
);
const handleDroppedExternalFile = useCallback(
async (absPath: string, isCancelled: () => boolean = () => false) => {
if (!isDroppedFilePreviewSupported(absPath)) {
toast.error(t('rightSidebar.fileBrowser.unsupportedDropFile'));
return;
}
const localRelPath = !isRemote ? toWorkdirRel(workdir, absPath) : null;
if (localRelPath) {
const ok = await confirmSwitchAway(state.selectedFilePath, localRelPath);
if (isCancelled() || !ok) return;
setExternalFile(null);
setMode('tree');
setFilterQuery('');
ctx.patchState({ selectedFilePath: localRelPath });
void revealFileInTree(localRelPath);
return;
}
const external = splitExternalFilePath(absPath);
if (!external) {
toast.error(t('rightSidebar.fileBrowser.unsupportedDropFile'));
return;
}
const ok = await confirmSwitchAway(state.selectedFilePath, null);
if (isCancelled() || !ok) return;
setMode('tree');
setFilterQuery('');
setExternalFile(external);
ctx.patchState({ selectedFilePath: null });
},
[confirmSwitchAway, ctx, isRemote, revealFileInTree, state.selectedFilePath, t, workdir],
);
// 聊天文件 chip 的“在侧边栏文件浏览器中打开”可把 workdir 外本地文件写成
// 一次性请求。这里直接复用上面的原生拖入处理,确保格式限制、dirty guard、
// 只读预览和“仓内路径仍定位文件树”的行为只有一份实现。
const externalFilePath = state.externalFilePath ?? null;
const externalFileNonce = state.externalFileNonce ?? 0;
useEffect(() => {
if (!externalFilePath) return;
let cancelled = false;
void runExternalFileOpenRequest({
absPath: externalFilePath,
open: handleDroppedExternalFile,
isCancelled: () => cancelled,
clearRequest: () => ctx.patchState({ externalFilePath: null }),
});
return () => {
cancelled = true;
};
// ctx / handler 引用变化不应重放已消费的请求;path / nonce 更新会取消旧请求。
}, [externalFilePath, externalFileNonce]);
const handleDrop = useCallback(
(event: DragEvent<HTMLDivElement>) => {
if (!hasFileDragPayload(event.dataTransfer)) return;
event.preventDefault();
event.stopPropagation();
fileDragDepthRef.current = 0;
setIsDraggingFile(false);
// .cindy / .cshare 已被窗口级 capture 接管(装入 / 导入链路),
// 只清理拖拽 UI 状态,不进文件预览。
if (isGlobalDropIntercepted(event.nativeEvent)) return;
if (countFileDragItems(event.dataTransfer) > 1) {
toast.error(t('rightSidebar.fileBrowser.multipleDropFilesUnsupported'));
return;
}
const items = event.dataTransfer.items;
for (let i = 0; i < items.length; i++) {
const item = items[i];
if (item.kind !== 'file') continue;
const entry = item.webkitGetAsEntry?.();
if (entry?.isDirectory) {
toast.error(t('rightSidebar.fileBrowser.unsupportedDropFile'));
return;
}
const file = item.getAsFile();
if (!file) continue;
let absPath = '';
try {
absPath = window.electronAPI.getFilePath(file);
} catch {
absPath = '';
}
if (absPath) {
void handleDroppedExternalFile(absPath);
return;
}
}
if (event.dataTransfer.files.length > 0) {
let absPath = '';
try {
absPath = window.electronAPI.getFilePath(event.dataTransfer.files[0]);
} catch {
absPath = '';
}
if (absPath) {
void handleDroppedExternalFile(absPath);
return;
}
}
toast.error(t('rightSidebar.fileBrowser.unsupportedDropFile'));
},
[handleDroppedExternalFile, t],
);
const handleFileDragEnter = useCallback((event: DragEvent<HTMLDivElement>) => {
if (!hasFileDragPayload(event.dataTransfer)) return;
event.preventDefault();
event.stopPropagation();
fileDragDepthRef.current += 1;
setIsDraggingFile(true);
event.dataTransfer.dropEffect = 'copy';
}, []);
const handleFileDragOver = useCallback((event: DragEvent<HTMLDivElement>) => {
if (!hasFileDragPayload(event.dataTransfer)) return;
event.preventDefault();
event.stopPropagation();
setIsDraggingFile(true);
event.dataTransfer.dropEffect = 'copy';
}, []);
const handleFileDragLeave = useCallback((event: DragEvent<HTMLDivElement>) => {
if (!hasFileDragPayload(event.dataTransfer)) return;
event.preventDefault();
event.stopPropagation();
fileDragDepthRef.current = Math.max(0, fileDragDepthRef.current - 1);
if (fileDragDepthRef.current === 0) setIsDraggingFile(false);
}, []);
const handleFileDragEnd = useCallback(() => {
fileDragDepthRef.current = 0;
setIsDraggingFile(false);
}, []);
const activeWorkdir = externalFile?.workdir ?? workdir;
const activeRelPath = externalFile?.relPath ?? state.selectedFilePath;
const activeContent = externalFile ? externalFileContent.content : fileContent.content;
// remote 会话的 watch 事件经远端 daemon 推回(P4),正常路径下与本地同等实时;
// 但 SSH 断链重连的间隙里 daemon 换代、事件会漏,窗口重新聚焦时静默刷新
// 文件树 + 当前文件作为兜底,保证"断链期间远端改了文件 → 用户切回来能看到"。
useEffect(() => {
if (!isRemote) return;
const onFocus = () => {
void tree.refresh();
fileContent.refresh();
};
window.addEventListener('focus', onFocus);
return () => window.removeEventListener('focus', onFocus);
}, [isRemote, tree, fileContent]);
const handleToggleSearch = useCallback(() => {
setMode((m) => (m === 'search' ? 'tree' : 'search'));
}, []);
return (
<div
ref={containerRef}
className={cn(
'relative flex h-full min-h-0 w-full overflow-hidden',
// 拖拽中全局禁用文本选中 + 强制 col-resize 光标(防止经过文件树/编辑器时
// 光标跳变)。
isTreeDragging && 'cursor-col-resize select-none',
)}
onDragEnter={handleFileDragEnter}
onDragOver={handleFileDragOver}
onDragLeave={handleFileDragLeave}
onDragEnd={handleFileDragEnd}
onDrop={handleDrop}
>
{/* 左 pane:正文。所有文件(包括 markdown)走 FileBodyView(CodeMirror)以保
留 RSB 内编辑 / Ctrl+S 保存 / in-file 搜索能力 —— 2026-06-30 用户明确否
决"切只读 HTML"路径(那条路视觉 100% 对标 Codex 但不能编辑)。
视觉对标 Codex 走 FileBrowserBody.css 的 .rsb-fbody-compact scope CSS:
统一字号(13/14/12px)、密集 prose 节奏、系统 mono 字体栈、fence 灰底模拟 card,
做到 CSS 路径能达到的最大对标度。 */}
<div className="rsb-fbody-compact flex h-full min-w-0 flex-1 flex-col overflow-hidden">
<FileBodyView
key={externalFile?.absPath ?? 'project-file-browser'}
workdir={activeWorkdir}
remoteHostId={externalFile ? null : remoteHostId}
deviceId={externalFile ? null : deviceId}
// 外部文件(externalFile)不属于会话,图片"发送到对话/标注"不适用。
sessionId={externalFile ? undefined : ctx.sessionId}
relPath={activeRelPath}
content={activeContent}
allowEdit={!externalFile}
onSaved={externalFile ? undefined : fileContent.setLocal}
/>
</div>
{/* 中间分割线 + resize handle —— 4px 命中宽度,内部 1px 实线;hover 高亮提示
可拖。双击复位到默认 200px。pointer-events 仅在 handle 上,不挡邻接 pane。
(语义对齐 RightSidebar 主壳 resize handle 的样式) */}
<div
className="relative h-full w-px shrink-0 cursor-col-resize bg-[var(--border-default)]"
onPointerDown={handleTreeDragStart}
onDoubleClick={resetTreeWidth}
role="separator"
aria-orientation="vertical"
>
<div className="absolute -left-1 top-0 h-full w-1 group/handle">
{/* hover 高亮:整条 1px 分割线变成 sidebar-action-icon 色调,跟主壳的 handle 视觉一致。 */}
<div
className={cn(
'absolute left-1 top-0 h-full w-px transition-colors',
isTreeDragging
? 'bg-sidebar-action-icon'
: 'bg-transparent group-hover/handle:bg-sidebar-action-icon',
)}
/>
</div>
</div>
{/* 右 pane:文件树 / 搜索 双模式 —— 拖拽宽度,跨 tab 共享持久化。
v1 不接 onNewFile / onDelete / onRename 等右键能力,只支持选中文件 —— RSB
这种狭窄面板里弹"新建文件 / 重命名"对话框体验差,doc 模式更合适。
tree / search 切换跟 doc 模式 sidebar 同 ergonomics:tree 模式显示文件树,
search 模式显示 SearchPanel(ripgrep 项目级搜索)。 */}
<div
className="rsb-fbody-tree-pane flex h-full shrink-0 flex-col overflow-hidden"
style={{ width: treeWidth }}
>
<TreeHeader
workdir={workdir}
mode={mode}
onToggleSearch={handleToggleSearch}
onCollapseAll={tree.collapseAll}
onRefresh={handleRefresh}
ignoredDirsUnsupported={tree.showIgnoredDirsSupported === false}
/>
{/* tree 模式:常驻文件名筛选输入框 + (筛选结果列表 / 文件树)。
注:className 必须**只在隐藏时**加 `hidden`,**不能**同时写 `block` ——
Tailwind 的 `block` 是 display:block,会覆盖 `flex`,容器不再是 flex 容器,
内部 `min-h-0 flex-1` 拿不到明确高度,FileTreeView 的 overflow-y-auto
就滚不动了(2026-06-30 用户实测 bug)。 */}
<div className={cn('flex min-h-0 flex-1 flex-col', mode !== 'tree' && 'hidden')}>
<FileFilterInput value={filterQuery} onChange={setFilterQuery} />
{filterQuery ? (
<FilterResultList
files={filteredFiles}
truncated={
// ripgrep cap 截断,或者前端展示上限截断(命中超过 FILTER_RESULT_LIMIT)
projectFiles.truncated || filteredFiles.length >= FILTER_RESULT_LIMIT
}
isLoading={projectFiles.isLoading}
indexError={projectFiles.error}
selectedPath={state.selectedFilePath}
onSelectFile={handleSelectFromFilter}
/>
) : tree.loadError && tree.entries.size === 0 ? (
<TreeLoadErrorPlaceholder kind={tree.loadError} onRetry={handleRefresh} />
) : (
<div className="rsb-fbody-tree-scroll min-h-0 flex-1">
<FileTreeView
ref={fileTreeRef}
tree={tree}
scrollScope={ctx.tabId}
active={active}
selectedPath={state.selectedFilePath}
onSelectFile={handleSelectFile}
onPreviewImage={handlePreviewImage}
onCopyFilePath={!isRemote ? handleCopyFilePath : undefined}
onRevealInFolder={!isRemote ? handleRevealInFolder : undefined}
onOpenInFileBrowser={ctx.sessionId ? handleOpenInFileBrowser : undefined}
onOpenInSidebarBrowser={ctx.sessionId ? handleOpenInSidebarBrowser : undefined}
onOpenInBrowser={handleOpenInBrowser}
/>
</div>
)}
</div>
{/* search 模式:整个 body 替换为 ripgrep 内容搜索面板 */}
<div className={cn('min-h-0 flex-1', mode === 'search' ? 'block' : 'hidden')}>
<SearchPanel
query={searchQuery}
onQueryChange={setSearchQuery}
caseSensitive={searchCaseSensitive}
onCaseSensitiveChange={setSearchCaseSensitive}
results={search.results}
totalMatches={search.totalMatches}
totalFiles={search.totalFiles}
status={search.status}
errorMessage={search.errorMessage}
errorCode={search.errorCode}
maxMatches={SEARCH_MAX_MATCHES}
onOpenMatch={handleOpenMatch}
/>
</div>
</div>
{isDraggingFile && (
<div
className="pointer-events-none absolute inset-2 z-20 rounded-xl border border-dashed border-[var(--drop-overlay-border)] bg-[var(--drop-overlay-bg)]"
aria-hidden="true"
/>
)}
{imageLightboxSrc ? (
<ImageLightbox
src={imageLightboxSrc}
sessionId={ctx.sessionId}
onClose={() => setImageLightboxSrc(null)}
/>
) : null}
</div>
);
}
/**
* 文件树顶部 chrome —— 对标 doc 模式 WorkdirBrowseSidebar 顶部那行(标题 + 工具按钮)。
*
* 内容:
* - 左:workdir basename(项目名,从 workdir 路径末段提取)
* - 右(tree 模式):search / collapse-all / refresh 三个 icon 按钮
* - 右(search 模式):X 退出搜索(替代 search 按钮位置)
*
* 视觉对齐 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 档)
*/
function TreeHeader({
workdir,
mode,
onToggleSearch,
onCollapseAll,
onRefresh,
ignoredDirsUnsupported,
}: {
workdir: string;
mode: TreeMode;
onToggleSearch: () => void;
onCollapseAll: () => void;
onRefresh: () => void;
/** 被控端不支持「显示被忽略的目录」(老 Desktop):开关渲染成不可用 + 说明原因。 */
ignoredDirsUnsupported: boolean;
}) {
// workdir basename:POSIX 用最后一段(/Users/sam/Documents/Cindy → Cindy);
// Windows 'C:\\Users\\sam\\Cindy' 也按 / 和 \ 切。空值兜底空串。
const displayName = workdir.split(/[/\\]/).filter(Boolean).pop() ?? '';
return (
<div className="flex shrink-0 items-center justify-between pt-2 pb-1 pl-3 pr-2">
<span className="truncate text-sm font-semibold text-foreground" title={workdir}>
{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}
/>
</div>
</div>
);
}
/**
* 文件树 root 加载失败占位。device-too-old = 对方设备版本过旧(老被控端没有
* remote-op channel,能力全有全无),提示升级;其余给通用失败 + 重试。
*/
function TreeLoadErrorPlaceholder({
kind,
onRetry,
}: {
kind: 'device-too-old' | 'load-failed';
onRetry: () => void;
}) {
const { t } = useTranslation();
return (
<div className="flex flex-1 flex-col items-center justify-center gap-3 p-6 text-center">
<span className="text-12 text-[var(--text-tertiary)]">
{t(
kind === 'device-too-old'
? 'rightSidebar.fileBrowser.deviceTooOld'
: 'rightSidebar.fileBrowser.loadFailed',
)}
</span>
{kind === 'load-failed' && (
<Button variant="secondary" size="xs" compact tone="quiet" type="button" onClick={onRetry}>
{t('ccAgent.workdirBrowse.treeAction.refresh')}
</Button>
)}
</div>
);
}
function NoWorkdirPlaceholder() {
const { t } = useTranslation();
return (
<div className="flex flex-1 flex-col items-center justify-center gap-3 p-8 text-center">
<div className="flex h-12 w-12 items-center justify-center rounded-full bg-[var(--surface-elevated)]">
<FolderX size={20} strokeWidth={1.5} className="text-[var(--text-tertiary)]" />
</div>
<span className="text-12 text-[var(--text-tertiary)]">
{t('rightSidebar.fileBrowser.noWorkdir')}
</span>
</div>
);
}