前言¶

在 DeepSeek Harness（DSH）里跑智能体或改项目时，工作目录往往落在会话的 workspace。若你同时在 Windows 上做 Android 开发，常见做法是手动打开 Android Studio，再选目录或从资源管理器拖进去——步骤多、也容易开错版本（正式版与预览版并存时尤其如此）。DSH 社区插件 dsh-open-in-androidstudio 把这一步接到会话头部已有的 「Open In…」 按钮组：选中 Android Studio 目标后，用本机安装的对应版本直接打开当前会话目录。下面介绍它是什么、怎么装、怎么用，以及使用时的边界。

这是什么¶

dsh-open-in-androidstudio 是 DSH 第三方插件，维护者为 lovezi0，仓库地址 github.com/lovezi0/dsh-open-in-androidstudio。它不负责画会话头部的按钮和菜单——那部分由底座插件 dsh-open-in-app-base 统一渲染；本插件只注册 Android Studio 这一条「打开目标」，并在宿主侧实现「本机是否可用」以及「如何拉起 IDE」。

当前 package 版本为 0.1.1，许可证 MIT，声明的 DSH 兼容范围为 >=0.2.1-0 <1.0.0（README 徽章标注 DeepSeek Harness 0.2.1-rc.2）。SkillHub 目录分类为 客户端。

核心功能¶

接入位置与多版本¶

目标并入会话头部 「Open In…」 按钮组，尺寸与图标规格由底座处理。插件会先探测本机全部 Android Studio 安装，每个版本对应一条菜单项；版本按新→旧排列，最新版为菜单默认项。本机同时有正式版与预览版时，点哪条就用哪个版本打开当前 workspace。

自动探测与补配路径¶

探测顺序（README 概括）：显式配置 → 注册表卸载项与 App Paths → 各版本系统目录的 .home 记录 → 常见安装目录扫描。系统级与用户级默认路径、非系统盘、<盘符>:\Android Studio\<版本>\、Toolbox / Chocolatey / Scoop 等布局在说明中均有覆盖。探测不到时该目标不会出现在菜单里（远程或 SSH 场景下相当于自然不可用）；也可以在面板或 profile 里 额外 指定安装根，与自动结果合并，不会取代自动探测。

双端与平台¶

web profile 与 Desktop（Electron）profile 使用同一条通道、同一份代码（README 称「双端一致」）。仅 Windows 生效：非 Windows 平台该目标恒不可用。

安全相关行为¶

宿主侧路由仅接受回环/可信 Host 的同源请求；目标目录须为本机绝对路径且真实存在；版本清单不会把本机安装路径下发给客户端（README「安全围栏」一节）。

安装与启用¶

前置：底座插件¶

必须先安装 dsh-open-in-app-base（会话头部「Open In…」按钮组；面板配置依赖底座 0.2.0 起提供的 openInAppState）。本插件不携带底座；底座未装时本插件不会报错，只是菜单里看不到任何由它注册的目标。

dsh plugin --profile web add dsh-open-in-app-base
dsh plugin --profile desktop add dsh-open-in-app-base

安装 Android Studio 目标插件¶

项目 暂不发布 npm 包，需从源码或 git 安装（仓库自带 lib/，README 说明零构建）。

本机路径安装（在仓库的父目录执行，file: 指向本仓库）：

dsh plugin --profile web add file:./dsh-open-in-androidstudio
dsh plugin --profile desktop add file:./dsh-open-in-androidstudio

从 GitHub 安装（将 tag 换成仓库实际发布的版本号，例如与 package.json 中 version 对应的 tag）：

dsh plugin --profile web add 'github:lovezi0/dsh-open-in-androidstudio#vX.Y.Z'

开发调试（在仓库根目录执行，改完立即生效）：

dsh plugin --profile web add .

装载后可用下面命令确认配置层是否出现本插件段落：

dsh --profile web --dump-config

输出中应包含 # == dsh-open-in-androidstudio。

典型用法¶

1. 完成底座与本插件的安装，在 Windows 本机使用 DSH（web 或 Desktop profile 均可）。
2. 打开一个会话，确保 workspace 目录即你要在 IDE 里编辑的项目根。
3. 在会话头部找到 「Open In…」，在菜单中选择 Android Studio（多版本时选对应版本条目）。
4. 宿主会以当前会话目录为参数拉起该版本的 Android Studio。

若自动探测找不到免安装版或非标准路径，可在 插件管理面板 补路径：侧边栏「插件」→ 本插件 →「额外的 Android Studio 安装路径」，逐行填写后保存（值由底座托管、跨 profile 共享）。也可在 profile 的 cordis.patch.yml 里写 studioHome（与面板配置合并生效）：

- id: open-in-androidstudio
  config:
    studioHome:
      - C:\Tools\AndroidStudio
      - C:\Portable\Android Studio

留空则仅依赖自动探测；无效路径会在宿主日志中警告。

适用场景与注意¶

适合谁：在 Windows 上用 DSH 管理 Android 相关 workspace、希望从会话头一键进 Android Studio 的开发者；本机多版本并存时需要明确选版本的情况。

权限与信任：插件以 当前 dsh 进程权限 运行，安装前请阅读仓库源码与 MIT 许可证，自行判断是否满足环境安全要求。社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系，DSH 生态强调「一切皆插件」，第三方插件需自行甄别。

其他：Node 引擎要求 >=20；打包分发可用 npm pack 生成 tgz 后 dsh plugin add ./<包名>-<版本>.tgz 安装——细节见仓库 README「开发与分发」。

结尾¶

dsh-open-in-androidstudio 把「用 Android Studio 打开当前会话 workspace」收成会话头部 「Open In…」 里的一条目标，并与 dsh-open-in-app-base 分工清晰：底座负责 UI，本插件负责 Windows 上的探测、配置与拉起。需要查阅说明或提交 issue 时，见 GitHub 仓库 与 SkillHub 目录页。