前言¶
DeepSeek Harness (DSH) 的 Web GUI 是進行智能體開發和調試的重要界面。在 Android 應用開發過程中，查看 logcat 日誌是排查問題的核心環節。傳統的做法是在終端手動執行 adb logcat，或者在 IDE 中開啓單獨的窗口，缺乏與當前 Web 界面的無縫銜接。dsh-adb-logcat 插件通過在 DSH Web GUI 內部嵌入一個與 Android Studio 風格一致的日誌查看面板，解決了這一割裂問題。
插件簡介¶
插件名稱：dsh-adb-logcat
維護者：dxsdyhm
許可證：MIT
定位：DSH Web GUI 的 Android Studio 風格 ADB logcat 查看器。
安裝與啓用¶
安裝該插件需要使用 DSH 的包管理命令。執行以下命令即可完成添加：
dsh plugin --profile web add dsh-adb-logcat
安裝完成後，需重啓 dsh web 服務以加載新插件。
核心功能¶
該插件在 Web 端提供了完整的 logcat 查看能力，具體包括：
- 設備列表：通過
adb devices -l命令自動刷新，顯示設備的序列號、狀態（在線/離線）以及設備型號。 - 實時流：使用
adb -s <serial> logcat -v threadtime -T 300命令獲取日誌，並實時解析爲可讀的行數據。 - 級別與文本過濾：支持按日誌級別（V/D/I/W/E/F）篩選，也支持通過關鍵詞或正則表達式過濾文本與標籤。
- 顏色編碼：根據日誌級別顯示不同顏色（V=灰，D=藍，I=綠，W=黃，E=紅，F=亮紅），顏色方案會自動適配主題。
- 佈局控制：支持兩種模式——浮動模式（位於屏幕右下角的膠囊狀懸浮窗）和停靠模式（固定在聊天輸入框下方）。
- 交互與調整：用戶可以通過拖動面板頂部邊緣調整高度；支持自動換行、全寬顯示、自動滾動等選項。
- 自動開始：當面板打開且檢測到設備存在時，會自動開始捕獲日誌。
使用方法¶
使用該插件的過程分爲以下幾步：
- 打開底部右下角的 “ADB Logcat” 膠囊。
- 在設備列表中選擇目標設備（若設備存在，通常會自動選中並開始捕獲）。
- 使用下方的級別芯片、文本/標籤過濾器以及換行/全寬/自動滾動切換按鈕來管理日誌顯示。
- 點擊面板上的 “停靠” 按鈕可將面板移動到聊天輸入框下方，方便在調試對話中查看；點擊 “浮動” 則將其還原爲覆蓋層。
注意事項與安全¶
使用前需確認環境滿足以下條件：
- 主機環境：必須在主機系統的
PATH環境變量中安裝了adb（來自 Android platform-tools）。 - 設備連接：需要連接已啓用 USB 調試的 Android 設備，或已授權的模擬器。
- 安全機制：所有設備訪問均通過主機的
subprocess服務進行，未經過 shell 字符串插值，避免了命令注入風險。主機端掛載了一個僅限迴環（loopback）訪問的 HTTP 網關（/api/logcat/*），這意味着遠程瀏覽器訪問會被拒絕（返回 403），僅限本地 Web GUI 調用。
生態與資源¶
DSH 採用「一切皆插件」的生態理念。該插件遵循 MIT 許可證，可自由使用與修改。更多詳情與源碼，請訪問插件目錄頁或 GitHub 倉庫。
