dsh-IDE — DSH Web GUI 一体化开发环境（JupyterLab 风格工作区 + SSH 远程开发）

当前版本：v0.2.0（Notebook 阅读与编辑 · 2026-08）— 完整版本历史见 CHANGELOG.md

中文 | English

把 DeepSeek Harness（DSH）Web GUI 升级为一体化开发环境，四大核心能力：

• 🖥️ 右侧边栏：可停靠的右栏抽屉——文件树 + 预览/编辑同框；拖 tab 拖出成浮窗，拖回右缘自动停靠（下框 / 右栏 / 浮动 / 三栏 IDE 四态切换）
• 📄 预览：Markdown / HTML / 图片 / CSV / Notebook（.ipynb，结构化 cells + 输出渲染，可逐 cell 编辑） / Office（docx / xlsx / pptx）/ 日志等多格式直接预览
• ✏️ 编辑：代码即时编辑（语法高亮 + 行号 + 斑马纹）+ Markdown/HTML Word 式可视化编辑 + Office 框内富文本编辑
• 🧩 IDE：文件树、命令行终端、Trae 风格红绿 diff、类型颜色标签、Git 角标、监视路径——开箱即用的 JupyterLab 式工作区

同时内置 SSH 远程工作区模式：右上角（session log 左侧）配置 SSH 主机（密码 / 密钥，复用 ~/.dsh/dsh-ssh.json），进入后右侧面板自动切换为远程文件树，模型本机的 read / write / edit / glob / grep 与 bash / 终端在 SSH 模式下透明地在远程服务器执行，LLM 与 Agent 循环仍在本机——「本地大脑、远程手脚」。

功能总览

⚙️ 右边栏工作区设置（系统设置内）

「设置」→「右边栏工作区」栏目集中管理右栏工作区的功能开关（8 项：自动 diff / 监视圆点 / Git 角标 / 语法高亮 / 缩放预览 / 三栏 IDE / 终端停靠 / 会话隔离）与编辑工具栏工具（9 项，供富文本编辑选用），圆角卡片 + 开关，改动即时生效并持久化。

🖼️ Markdown 预览（三种布局）

Markdown 文件在面板中直接渲染预览（青色标签），并支持三种布局随意切换：

• 下框展示（⇊）：预览显示在下栏
• 右侧弹出（⇉）：预览显示在右侧代码栏
• 浮动覆盖（⇱）：浮动覆盖在对话框上方，宽度更大

🌳 左侧文件树

左侧文件树：懒加载、按文件名搜索定位、Git 状态角标（A/M/D/R/U/C）、右键菜单（新建文件 / 新建文件夹 / 下载 / 行内重命名 / 复制 / 粘贴 / 删除进回收站），本地目录与 SSH 远程目录自动切换；已打开的文件绝不重复开 tab，磁盘变化时在原 tab 上自动刷新内容。

🔍 监视路径（自动弹出范围）：默认只监视一级目录（根目录及其直接子目录下的文件）。 点击目录行右侧圆点逐级切换：浅黄 = 监视此目录下一级路径，绿色 = 监视此目录下所有层级（n级），再点恢复默认；监视标记按会话记忆。顶栏（文件 / 变更 / >_ 右侧）有规则说明框。构建产物、临时文件、锁文件等过程文件无论标记都不弹出。

📊 状态栏

底部状态栏展示工作区状态。

✏️ 支持代码即时编辑

代码区即时编辑：五颜六色的语法高亮（Trae 风格配色，跟随浅色/深色主题自动切换）+ 行号 + 斑马底纹，可读写编辑、Ctrl+S 保存、保存带 mtime 冲突检测；工具栏提供分屏（编辑器 | 预览）、刷新等操作。

🔴🟢 红绿标注（Trae 风格编辑 diff）

任何外部编辑（Agent 工具写文件、其他进程改动）都会自动弹出「Update(路径)」卡片到下栏—— Added/removed 统计 + 删除行红底、新增行绿底；每个文件的每次编辑都会弹（基线自动推进，不重复不遗漏）； 保存后同样弹出：

• 全新文件（无历史基线）自动弹出全绿卡片（整份文件视为新增）
• 文件被删除自动弹出全红卡片（整份文件视为移除）
• diff 卡带固定双列行号（旧 / 新各一列，增删行号对齐）、未变更行斑马底纹
• 点「编辑最新版本」→ 编辑器覆盖整个显示框，可直接修改最新代码并保存（保存后红绿自动更新）； 点「刷新」红绿不丢失

🎨 颜色标记（类型颜色标签）

每个打开的标签带类型色块——橙 = 图片、绿 = CSV、蓝 = Python、黄 = JS/TS、紫 = JSON、 青 = Markdown、红 = diff、灰 = 日志——标签再多也能一眼分辨；新打开的文件与 diff 自动滚到 可见位置，标签条横向滚动 + 标题截断，绝不拥挤。

⌨️ 命令行展示（终端与运行）

内置命令行终端：代码工具栏「▶ 运行」直接执行当前文件（python / node / bash 等），「>_ 终端」打开 命令行面板随时输入命令（SSH 模式下均在远程执行）；文件栏 tab 条也有独立终端入口。终端以 真实终端风格停靠在聊天栏底部五分之一处（黑体、macOS 圆点标题、❯ 提示符、绿光标，不与对话重叠）。

📜 日志预览

日志文件（灰色标签）在面板中直接预览。

🖼️ 图片预览 / 📋 CSV 预览 / 🌐 HTML 预览

• 图片（橙色标签）与 HTML（紫色标签）预览支持放大/缩小：工具栏 − / % / + / 1:1 / 适应宽度，或 Ctrl+滚轮缩放
• CSV 数据表渲染为表格（绿色标签）

🖥️ 右侧边栏（可停靠抽屉 · 拖拽停靠 / 脱离）

• 右栏抽屉（默认）：预览停靠在右侧栏（文件树 + 预览同框的 drawer）；四态切换——下框（⇊）/ 右栏（⇉） / 浮动（⇱）/ 三栏 IDE（⿻，对话 | 文件树 | 预览三栏并排）
• 拖 tab 拖出成浮窗：任意布局下按住预览 tab 条 / 工具栏空白处拖动，即把预览拖出成浮动窗，位置 1:1 跟随指针、动画流畅不卡
• 拖回右缘自动停靠：把浮窗拖到屏幕右缘松手，自动停靠回右侧抽屉；拖到「盖住文件树（树自动折叠为圆形按钮）/ 树下方 / 聊天区下方」附近则吸附到对应预设位，拖出吸附区即回到自由浮动
• 浮窗自由缩放：右下角斜纹把手拖拽改宽高（尺寸记忆，吸附时保留）
• 聚焦模式：预览打开时点文件栏折叠箭头，文件树收为约 30px 右栏 rail（仅留小圆角展开按钮），点击即展开，专注预览与编辑；折叠后预览框保持原宽度

🧬 R 语言支持

.R / .r 脚本以 Rscript 运行（▶ 运行），R 标签用 R 官方蓝；.Rmd（R Markdown）识别为 Markdown 可预览渲染；代码高亮原生支持 R。

📓 Notebook（.ipynb 阅读与编辑）

• 文件树点击 .ipynb 结构化呈现（nbformat ≥ 4）：Markdown cell 渲染、代码 cell 语法高亮 + In [n] 计数、输出区渲染（文本 / 错误 traceback / PNG·JPEG 图 / HTML / markdown）
• 逐 cell「编辑」内联修改源码（Ctrl/Cmd+Enter 快速保存），保存只改 source，outputs / metadata / nbformat / execution_count 原样保留；不执行代码（无 kernel）

…