前言¶
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 仓库。
