前言¶
在 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。
典型用法¶
- 完成底座與本插件的安裝，在 Windows 本機使用 DSH（web 或 Desktop profile 均可）。
- 打開一個會話，確保 workspace 目錄即你要在 IDE 裏編輯的項目根。
- 在會話頭部找到 「Open In…」，在菜單中選擇 Android Studio（多版本時選對應版本條目）。
- 宿主會以當前會話目錄爲參數拉起該版本的 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 目錄頁。
