File Studio

像 macOS Finder / Windows 资源管理器一样，在 VS Code 侧边栏中浏览本机文件系统，与当前工作区无关。

功能

• 活动栏新增「File Studio」视图，打开即显示本机文件系统：
  • 主目录（默认展开）
  • 系统根目录：macOS 显示为 Macintosh HD，Linux 显示为根目录，Windows 列出所有盘符
  • macOS 外接卷（/Volumes 下的其他磁盘）
• 侧边栏只有一个视图（工具栏与文件树之间没有可拖拽的分割线），视图标题栏里不放任何按钮：
  • 工具栏一行：前两个带文字的按钮 添加文件夹、添加文件，在当前选中的目录下新建（选中文件时取其所在目录，未选中时为主目录），新建后展开到新条目并选中，新建文件后立即打开
  • 后三个只有图标的按钮：刷新（重新读取磁盘内容并重新探测盘符 / 外接卷）、全部折叠、设置（齿轮），悬停显示名称
  • 齿轮菜单：切换「显示隐藏文件」；「界面语言」是二级菜单，行尾显示当前语言，展开后列出「跟随 VS Code」与六种语言，当前设置打勾，点选即切换；「设置水印…」弹出输入框输入水印文字（预填当前的），行尾显示当前的水印文字，清空即移除
  • 工具栏第二排是收藏的文件夹：鼠标放到目录行上，行尾最后一个五角星按钮把它收藏（已收藏的目录星是实心的、一直显示，再点一下取消收藏），每个收藏是一个蓝色按钮（取 VS Code 主题的主按钮色，与上一排灰色的工具栏按钮区分），按钮名默认为文件夹名，放不下时换行。单击按钮在下面的树里展开到该文件夹、选中并滚到顶上；右键按钮可重命名（只改按钮名，路径不变）或移除收藏。文件夹已不存在时单击会提示，并可顺手移除。收藏记录在配置文件里（见下文），没有收藏时这一排不显示
• 界面语言支持中文、English、Deutsch、Français、日本語、한국어，默认跟随 VS Code 的显示语言，选择记录在配置文件里（见下文）。命令面板中的命令标题由 VS Code 按其显示语言渲染，不受此设置影响
• 文件树由插件自己绘制，图标为统一的线条图标（不跟随 VS Code 的文件图标主题）。主目录下的「下载」文件夹显示为红色图标、「桌面」文件夹显示为蓝色图标，便于快速定位（macOS / Windows 通用，Windows 上 OneDrive 备份后的桌面同样识别）
• 文件按扩展名显示易于辨认的类型图标并着色：网页 < >（橙）、XML（蓝）、JSON { }（黄）、CSS { }（蓝）、YAML 列表（紫）、Markdown M↓（蓝）、PDF（红）、Word W（蓝）、PowerPoint P（橙）、Excel / CSV 表格（绿）、图片（紫）、音频（绿）、视频（红）、压缩包（黄）、代码 </>（按语言着色）、配置文件、字体；未识别的扩展名用普通文件图标
• 鼠标放到目录行上时，行尾出现四个按钮：在 Finder 中打开（Windows 为在资源管理器中打开，Linux 为系统文件管理器）、在终端中打开（macOS 打开「终端」，Windows 打开命令提示符 cmd，Linux 用 VS Code 的 terminal.external.linuxExec 设置；系统终端起不来时退回集成终端）、复制路径、添加到收藏（五角星）
• 目录内容按需读取，展开时才加载；收展状态、选中项和滚动位置在视图折叠再展开后保持
• 单击任意文件即在当前 VS Code 窗口中打开；单击目录展开 / 折叠
• 键盘：上下键移动，右键展开、左键折叠或跳到父目录，Enter 打开文件或切换目录，Home / End 跳到首尾，Delete（macOS 也可 ⌘⌫）删除
• 右键菜单：在目录上新建文件夹 / 文件（在 Finder 中打开、在终端中打开、复制路径由目录行尾的按钮承担，不在右键菜单里）；在文件上打开、在系统文件管理器中显示（定位到该文件）、「在终端中打开」（开在所在目录）「复制路径」；在主目录、磁盘、卷之外的任意条目上「删除」，其中目录以及图片、视频文件上还有「添加水印」「校验水印」
• 删除前先弹出确认框，确认后移到废纸篓 / 回收站而不是直接抹掉；移不进去（外接卷、网络盘常见）时再确认一次才永久删除。命令面板里的「删除」对当前选中项生效

水印

• 齿轮菜单的「设置水印…」设定水印文字，记在配置文件的 watermark 键里
• 右键菜单的「添加水印」（目录，以及图片、视频文件上有）打开一个任务面板：先显示目标、水印文字与说明，点「开始」才动文件，进行中可「停止」，关掉面板也等于停止。面板上有五个计数（已遍历 / 已添加 / 已有水印 / 非图片视频 / 失败）和执行日志，每处理完一个文件一条，只保留最新 50 条
• 右键菜单的「校验水印」（同样在目录，以及图片、视频文件上有）打开同一个任务面板，只读不写：检查每个图片、视频文件的末尾是不是水印文字。计数为已遍历 / 有水印 / 无水印 / 非图片视频 / 失败，其余与「添加水印」一样。校验也需要先设置水印文字
• 处理方式：把水印文字（UTF-8 字节）追加到文件末尾；文件夹则递归其下（含子文件夹）的所有文件。只处理图片和视频（按扩展名，见 src/watermark.ts 的 IMAGE_EXTENSIONS / VIDEO_EXTENSIONS；SVG 这类文本格式追加会损坏，不在内；.ts / .mts 更常见的是 TypeScript 源码，也不在内），其他类型的文件计入「非图片视频」跳过。文件末尾已经是这段水印的跳过，不重复追加。隐藏文件与文件夹按「显示隐藏文件」的设置决定是否包括，符号链接一律跳过
• 性能：目录用 opendir 一批一批地读条目、边遍历边处理，从不先把所有文件列出来，再大的目录内存也是平的；8 个文件并发处理；「已有水印」只读文件末尾几十字节，不读全文，大文件一样快。发给面板的进度最多每 100ms 一次，日志在扩展与页面两侧都只留最新 50 条，处理得再快界面也不会被消息淹没
• 结果着色：「添加水印」后，本次追加了水印的文件名在文件树里显示为绿色，已有水印跳过的显示为蓝色；「校验水印」后，有水印的显示为绿色，没有水印的显示为红色。非图片视频跳过的、读不了的文件颜色不变。着色只来自这两个操作的结果，不在每次列目录时检测文件——那要打开每个文件读末尾，网络盘和大目录上会明显拖慢，树的展示效率放第一位
• 着色的保留：与收展状态一样存在视图状态里，视图折叠、切换面板、重载窗口后仍在；在本插件里删除了该文件即丢掉；最多记 5000 个文件，超过丢最早的。文件在外部被改动时着色不会自动失效，再执行一次「添加水印」或「校验水印」会重新检测并刷新

配置文件

插件不使用 VS Code 的设置项，所有偏好记录在用户目录的 ~/.x1/file-studio/conf.yaml 里（与 SSH Studio 的 ~/.x1/ssh-studio/conf.yaml 同一套做法）。齿轮菜单里的操作会直接写入该文件，文件里的其他键原样保留；也可以手工编辑，重启 VS Code 后生效。

目录结构

• src/：扩展代码。sidebarView.ts 是侧边栏唯一的 webview 视图（下发文案、根列表与目录内容，执行页面交回的动作），localFs.ts 负责探测顶层位置和读取目录，systemApps.ts 负责调起系统的文件管理器与终端，i18n.ts 负责运行时文案的翻译与语言切换，confFile.ts 负责读写配置文件 ~/.x1/file-studio/conf.yaml，watermark.ts 负责遍历、追加与校验水印，watermarkPanel.ts 是「添加水印」「校验水印」共用的任务面板，webviewHtml.ts 给两个 webview 渲染 HTML 模板
• media/main/：侧边栏页面（HTML / CSS / JS），工具栏、文件树、右键菜单、齿轮菜单都在这里绘制；media/watermark/ 是「添加水印」「校验水印」共用的任务面板页面
• l10n/：运行时文案的翻译包，英文原文为 key
• package.nls.*.json：命令标题、视图名等静态文案，由 VS Code 按显示语言选用
• scripts/check-l10n.js：校验 t() 用到的每条文案在各语言包里都有译文、没有多余 key，以及 package.nls.*.json 的 key 一一对应
• resources/：图标资源。icon.png 是插件市场 / 扩展列表里显示的图标（128×128，由 icon.svg 导出），icon-folder-badge-f.svg 是活动栏里的单色图标
• release/：打包产物存放处，npm run package 生成的 .vsix 都放在这里

开发与调试

npm install
npm run compile      # 编译到 out/
npm run watch        # 监听源码变化自动编译
npm run check-l10n   # 校验翻译文件

• 按 F5 启动「Run Extension」在扩展开发宿主中调试。
• 或将本目录符号链接到 ~/.vscode/extensions/lupee.file-studio-1.0.0，编译后执行 Developer: Reload Window 即可在日常使用的 VS Code 中加载。

打包与安装

npm run package      # 编译后打包，产物为 release/file-studio-<version>.vsix

打包产物统一放在 release/ 目录下，当前版本为 release/file-studio-1.0.0.vsix。安装方式二选一：

code --install-extension release/file-studio-1.0.0.vsix

或在 VS Code 中打开命令面板，执行 Extensions: Install from VSIX...，选择 release/ 下的 .vsix 文件，安装后重载窗口。