ADrive Studio

像 macOS Finder / Windows 资源管理器一样，在 VS Code 侧边栏中浏览阿里云盘（alipan.com）。目录浏览的做法与同目录下的 File Studio（file-studio-plugin）相同，连接阿里云盘的做法与 x-cmd（osclass4/osclass4-adrive-client）相同。

功能

• 活动栏新增「ADrive Studio」视图，登录后显示阿里云盘的文件树：
  • 备份盘（默认盘，默认展开）
  • 资源盘（账号有资源盘且不同于备份盘时才显示）
  • 顶层盘的行尾淡淡地写着账号名，文件的行尾写着大小
• 侧边栏只有一个视图（工具栏与文件树之间没有可拖拽的分割线），视图标题栏里不放任何按钮：
  • 工具栏一行：第一个带文字的按钮 添加文件夹，在当前选中的目录下新建（选中文件时取其所在目录，未选中时为备份盘的根），新建后展开到新条目并选中
  • 后三个只有图标的按钮：刷新（重新读取云端内容并重新取盘列表）、全部折叠、设置（齿轮），悬停显示名称
  • 齿轮菜单：退出登录（行尾附注账号名；未登录时是扫码登录）；清理已下载的文件缓存；「界面语言」是二级菜单，行尾显示当前语言，展开后列出「跟随 VS Code」与六种语言，当前设置打勾，点选即切换
  • 工具栏第二排是收藏的文件夹：鼠标放到目录行上，行尾最后一个五角星按钮把它收藏（已收藏的目录星是实心的、一直显示，再点一下取消收藏），每个收藏是一个按钮，按钮名默认为文件夹名，放不下时换行。单击按钮在下面的树里展开到该文件夹、选中并滚到顶上（按云端 file_id 定位，目录被改名、移动过也照样找得到）；右键按钮可重命名（只改按钮名，云端目录不动）或移除收藏。文件夹在云端已不存在时单击会提示，并可顺手移除。收藏记录在配置文件里（见下文），没有收藏时这一排不显示
• 界面语言支持中文、English、Deutsch、Français、日本語、한국어，默认跟随 VS Code 的显示语言，选择记录在配置文件里（见下文）。命令面板中的命令标题由 VS Code 按其显示语言渲染，不受此设置影响
• 文件树由插件自己绘制，图标为统一的线条图标（不跟随 VS Code 的文件图标主题）。文件按扩展名显示易于辨认的类型图标并着色：网页 < >（橙）、XML（蓝）、JSON { }（黄）、CSS { }（蓝）、YAML 列表（紫）、Markdown M↓（蓝）、PDF（红）、Word W（蓝）、PowerPoint P（橙）、Excel / CSV 表格（绿）、图片（紫）、音频（绿）、视频（红）、压缩包（黄）、代码 </>（按语言着色）、配置文件、字体；未识别的扩展名用普通文件图标
• 鼠标放到行上时，行尾出现动作按钮：目录是复制路径、添加到收藏（五角星）；文件是下载、复制路径。复制的是云端路径（如 /backup/photos）
• 目录内容按需读取，展开时才加载；收展状态、选中项和滚动位置在视图折叠再展开后保持
• 单击任意文件即下载到本地缓存（~/.x1/adrive-studio/cache/），然后在当前 VS Code 窗口中打开。打开的是只读副本（在本次会话里设为只读），改动不会传回云盘。同一版本（file_id 与 content_hash 都没变）第二次打开直接用缓存；超过 50 MB 的文件先弹确认框。单击目录展开 / 折叠
• 键盘：上下键移动，右键展开、左键折叠或跳到父目录，Enter 打开文件或切换目录，Home / End 跳到首尾，Delete（macOS 也可 ⌘⌫）删除，F2 重命名
• 右键菜单：在目录上新建文件夹；在文件上打开、下载…（弹出保存对话框选位置，默认在「下载」文件夹）；在任意条目上「复制路径」；在顶层盘之外的任意条目上「重命名」「删除」
• 删除前先弹出确认框，确认后移入阿里云盘的回收站（可在阿里云盘里恢复），不做永久删除。命令面板里的「删除」对当前选中项生效
• 不支持上传：本插件定位是浏览与取用，往云盘传文件请用 x-cmd 的 adrive push

登录与授权

做法与 x-cmd 相同：插件不持有阿里云盘的 app 密钥，扫码、换取 / 刷新 token 一律经由授权服务端 http://adrive.osclass.cn/adrive-server（写死在 src/adrive/authClient.ts 里，不是配置项）完成；拿到 access_token 之后的列目录、新建、改名、删除、取下载地址才由插件直连 https://openapi.alipan.com。

• 第一次打开视图时显示登录面板，点扫码登录：插件向授权服务端取二维码，把图片抓下来显示在侧边栏里（抓不到时可点「在浏览器中打开」），用手机阿里云盘 App 扫码并确认，最长等 3 分钟。二维码过期或出错时可点「重试」
• 授权成功后 token 存到 ~/.x1/adrive-studio/token.json（权限 rw-------），重启 VS Code 后免扫码。access_token 临过期（2 分钟内）自动用 refresh_token 刷新；刷新失败（refresh_token 也失效）会自动登出并回到登录面板
• 与 x-cmd 的 ~/.xcmd/adrive-token.json 各用各的文件：阿里云盘刷新 token 后旧的 refresh_token 会失效，两个程序若共用一份会互相把对方踢下线
• 齿轮菜单里的退出登录只删本地的 token.json，不会撤销授权
• 云端限流（HTTP 429）时按服务端给的 Retry-After 等待后重试，所有在途请求一起等；5xx 与网络异常有限次重试后报错

配置文件

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

~/.x1/adrive-studio/ 下的其他文件：

~/.x1/adrive-studio/
├── conf.yaml        偏好（界面语言、收藏）
├── token.json       阿里云盘授权（access / refresh token 与过期时刻）
└── cache/           单击打开文件时下载的只读副本：<driveId>/<fileId>/<content_hash 前 8 位>/<文件名>
                     齿轮菜单「清理已下载的文件缓存」可整个清掉

目录结构

• src/：扩展代码
  • extension.ts：激活、命令注册；新建 / 改名 / 删除 / 下载 / 打开 / 收藏 / 语言切换 / 清缓存的具体执行
  • sidebarView.ts：侧边栏唯一的 webview 视图（下发文案、盘列表与目录内容，推送扫码登录的进度，执行页面交回的动作）
  • adrive/authClient.ts：授权服务端的三个端点（取二维码、轮询扫码状态、换取 / 刷新 token），解开 { success, message, data } 信封
  • adrive/openApi.ts：阿里云盘开放平台接口（云盘信息、列目录、取文件、新建文件夹、改名、移入回收站、取下载地址）与限流 / 重试
  • adrive/session.ts：token 持久化与自动刷新、扫码登录流程、盘列表
  • adrive/download.ts：把云端文件下载到本地（缓存副本 / 另存为）
  • adrive/types.ts：报文类型
  • i18n.ts：运行时文案的翻译与语言切换；confFile.ts：读写配置文件 ~/.x1/adrive-studio/conf.yaml
• media/main/：侧边栏页面（HTML / CSS / JS），工具栏、登录面板、文件树、右键菜单、齿轮菜单都在这里绘制
• l10n/：运行时文案的翻译包，英文原文为 key
• package.nls.*.json：命令标题、视图名等静态文案，由 VS Code 按显示语言选用
• scripts/check-l10n.js：校验 t() 用到的每条文案在各语言包里都有译文、没有多余 key，以及 package.nls.*.json 的 key 一一对应

开发与调试

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

• 按 F5 启动「Run Extension」在扩展开发宿主中调试。
• 或将本目录符号链接到 ~/.vscode/extensions/lupee.adrive-studio-0.0.1，编译后执行 Developer: Reload Window 即可在日常使用的 VS Code 中加载。
• 依赖的 VS Code 版本 ≥ 1.85（内置 Node 18，全局 fetch 可用，插件没有引入 HTTP 库）。

打包

npm run package      # 生成 adrive-studio-<version>.vsix