dsh-web-preview-float

DeepSeek Harness（DSH）Web UI 的悬浮预览插件：两个独立、可拖拽、可拉伸、可缩小的悬浮窗，让你在等待模型回复或改代码时实时预览项目，类似 Google AI Studio。

• 预览窗：<iframe> 直连项目 dev server，URL 自动从项目 package.json 脚本探测（Vite→5173、Next/CRA→3000、Astro→4321，可手改）。
• 代码窗：工作区文件树 + 只读代码预览（懒加载目录，点文件看内容）。

只依赖官方扩展点（ctx.webServer / ctx.fs / ctx.sandboxPolicy + 自包含 DOM portal），不改 DSH 核心，因此可作为独立插件发布、被 dsh-plugin 生态收录。

安装

作为 profile 的 patch 层安装（DSH 官方插件市场 / bundle 机制）：

# 该插件自带的 cordis.patch.yml 会插入这一行
- id: dsh-web-preview-float
  name: '@dsh-external/dsh-web-preview-float'

安装后重启 dsh web，浏览器里会出现两个悬浮窗。

开发

pnpm install
pnpm run typecheck
pnpm run test
pnpm run build      # 产出 lib/index.js（node 半）+ lib/client.js（浏览器半）

@deepseek-ai/cordis 是 vendored 包、不在 npm 上，本地开发请把 package.json 里 devDependencies 的 link: 指向你的 harness checkout 的 vendor/cordis。

结构

src/index.ts            # node 半：/__web_preview_float_fs 路由（list/read/dev）
src/invariant.ts        # invariant companion
src/client/index.tsx    # 浏览器半：挂载两个悬浮窗到 document.body
src/client/FloatingWindow.tsx  # 拖拽/拉伸/缩小
src/client/PreviewWindow.tsx   # 预览窗（iframe）
src/client/CodeWindow.tsx      # 代码窗（文件树 + 代码）
src/client/CodeView.tsx        # 文件树 + 代码阅读器
dsh.plugin.json         # 插件清单
cordis.patch.yml        # profile patch 层

说明

• 预览窗支持常用宽幅比预设（16:9 / 4:3 / 3:2 / 21:9 与手机竖屏 9:16 / 9:18 / 9:19.5），可选「锁定比例」让手动拉伸保持比例，也可直接输入宽×高自定义；另有常用分辨率预设（1920×1080 / 1366×768 / 390×844 等），一键把窗口放大到指定分辨率（超出屏幕时自动缩放适配）。
• 代码窗采用接近 VS Code 的布局：编辑器标签页、活动栏（可开关资源管理器）、文件树侧栏、带行号的可编辑编辑器 + 状态栏（Ln/Col、语言、UTF-8）。
• 代码窗可直接编辑：点「编辑」进入编辑态，改完后点「保存」（或 Ctrl+S）弹出确认框；确认后写入文件，并作为 web-preview/code-edit 会话事件记录到 DSH 日志；「取消」保留草稿，「还原」丢弃修改。
• 两个悬浮窗标题栏都有放大/还原按钮（⛶ 一键放大到贴合屏幕）；最小化成胶囊后也可直接拖动。
• 二进制/超大文件（>256KB）会提示「文件过大」；写操作限制在 1MB 内。
• 语法高亮未做（纯文本显示），后续可加 shiki。
• 悬浮窗位置/大小状态在内存中，刷新后回到默认位置。

License

MIT