安装与配置

GitHub 源码地址：。包已包含可直接加载的客户端和宿主产物，安装后无需构建前端。

通过 Harness 的插件安装入口填写 github:skyjjgw/dsh-plugin-android-preview#v0.1.2，或对 CLI 的 Web profile 执行：

dsh plugin --profile web add github:skyjjgw/dsh-plugin-android-preview#v0.1.2

CLI 的 web profile 与桌面应用管理的 profile 分开，桌面用户应使用当前应用内的插件安装入口。本包已声明 dsh.bundle.patch，正常安装会自动选入 bundle，无需再插入第二份插件行。未发布到 npm，请使用 GitHub 源码或 GitHub Release 安装包。在对应插件配置中填写本机路径，例如：

- insert:
    - id: android-preview
      name: dsh-plugin-android-preview
      config:
        projectRoot: E:/projects/starcompanion-operit2
        adbPath: E:/Android/Sdk/platform-tools/adb.exe
        scrcpyServer: E:/tools/scrcpy-win64-v3.3.3/scrcpy-server
        port: 18772
        serial: emulator-5556
        frameAncestors:
          - dsh-app://app

该行是用户 overlay 的独立安装示例；已由 bundle 创建同名行时，编辑已有行的配置，不要再次插入同一 id。不要覆盖整个用户 profile、已有 bundle 或其他插件配置。

使用

打开一个聊天会话，点击聊天顶部“手机预览”，或从右侧新建页签的引导页选“手机预览”。
页签打开后自动连接手机，复用模拟器、安装已有调试 APK，并连接 Flutter 调试器。
连接完成后，画面占满面板，只保留一排底部工具按钮。保存 apps/flutter/app/lib 或 apps/flutter/packages/operit_ui/lib 下的 Dart 文件，即可自动更新画面。
用鼠标点击、拖动、滚轮操作手机；点中手机输入框后直接用键盘输入或粘贴。
调试 App 中断时点击底部左侧的运行图标重启 App。禁用插件会关闭其本机监听、连接、文件监听器与自己创建的 Flutter 进程；模拟器保留供其他开发工具复用。

同一模拟器同时只运行一个 Flutter 调试会话。切换到此插件前，停止 VS Code/Codex 中同一设备的 Flutter 调试连接。原生/Rust/插件宿主/权限变化仍需重建调试 APK。

当前 ARM64 调试包通过 x86 模拟器翻译运行，默认使用 Skia GPU 渲染。配套项目启动器使用宿主 GPU 和 4 GB 内存；本机 RTX 4060 已验证。 CPU 翻译和视频编码仍有开销，不代表整个预览链路都在 GPU 上运行。驱动不兼容时，在启动 Harness 前设置 OPERIT_PREVIEW_RENDERER=software，重新启动模拟器后可回退；项目环境脚本会传递该选项。性能和玻璃材质效果以真机为准。模拟器 WebView 曾出现原生崩溃，插件的“重启 App”可恢复调试。本版按竖屏验证，旋转后的控制尚未验证。

dsh-plugin-android-preview

インストール

ドキュメント

安装与配置

使用