dsh-plugin-android-preview
在原生 DeepSeek Harness 侧边栏标签页中预览真实 Android 应用并进行 Flutter 热重载。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:skyjjgw/dsh-plugin-android-preview#e8e4b2bc2cfb2caabc1a93b19eb4c01bd04138f9Plugin Android Preview 以 dsh-plugin-android-preview 发布，当前版本为 0.1.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
在 DeepSeek Harness 聊天右侧打开真实 Android App，支持点击、滑动、返回与 Flutter 界面热重载。当前适配星伴 / Operit2 工程，使用已构建的调试 APK，不在每次保存时 重新打包。插件通过 Harness 的原生右侧页签 API 接入，不改宿主安装包。
scripts/rolelife/environment.ps1、
scripts/rolelife/start-debug-preview.ps1 和当前源码生成的 Android 调试 APK。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 或其他插件配置。
apps/flutter/app/lib 或
apps/flutter/packages/operit_ui/lib 下的 Dart 文件，即可自动更新画面。同一模拟器同时只运行一个 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。