DeepSeek Harness 手机预览插件
在 DeepSeek Harness 聊天右侧打开真实 Android App，支持点击、滑动、返回与
Flutter 界面热重载。当前适配星伴 / Operit2 工程，使用已构建的调试 APK，不在每次保存时
重新打包。插件通过 Harness 的原生右侧页签 API 接入，不改宿主安装包。
环境
- Windows；Node.js 22.19.0+；DeepSeek Harness 0.2.1-rc.2+，仍需保留同一公开右侧页签/connection API。
- 已配置的星伴 / Operit2 工程，包含
scripts/rolelife/environment.ps1、
scripts/rolelife/start-debug-preview.ps1 和当前源码生成的 Android 调试 APK。
- 已安装 Android SDK、模拟器、固定版本 Flutter SDK、官方 scrcpy 3.3.3。
- 当前版本只连接配置中指定的模拟器，默认
emulator-5556；不枚举或控制其他手机。
不会自动下载 SDK，不分发宿主、APK、scrcpy 或用户配置。所有开发环境路径由本机项目脚本
决定；建议将项目、SDK、缓存和模拟器数据放在空间充足的非系统盘。
安装与配置
GitHub 源码地址：https://github.com/skyjjgw/dsh-plugin-android-preview。
包已包含可直接加载的客户端和宿主产物，安装后无需构建前端。
通过 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”可恢复调试。
本版按竖屏验证，旋转后的控制尚未验证。
连接和权限
安装插件只启动空闲的 127.0.0.1 网页服务；打开手机页签后才运行项目的预览准备脚本、
ADB、scrcpy 和 Flutter。网页管理操作需要同源随机会话令牌，WebSocket 同时校验 Host
和 Origin。Harness 内发现地址的 /api/android-preview/info 路由由其 connection 层验证
owner Peer。仅允许明确的 dsh-app://app 父页面嵌入；Web Harness 用户可额外配置准确的
http://127.0.0.1:端口，不支持通配符或外网来源。
没有模型工具、自动 prompt、麦克风/音频、系统剪贴板读取、任意 shell 或任意文件接口。
键盘输入/用户主动粘贴会把对应文字写到安卓剪贴板并粘贴，自动剪贴板同步关闭。不会保存屏幕录像。
本机调试地址、路径和日志不应粘贴到公开 issue；不要上传 profile、账号密钥或聊天记录。
开发与验证
npm run check
npm test
npm pack --dry-run
lib/client.js 直接注册到宿主模块加载器；React 由宿主提供，不打包第二份 React。
Host 的 @deepseek-ai/schemastery 由 DSH 运行时提供，声明为可选 peer，避免包管理器另装一份 SDK。
lib/preview/ 保留完整可读源码。许可与来源见 NOTICE.md 和 LICENSE。
