dsh-ide-panels
DSH（DeepSeek Harness）客户端布局插件 —— 仿 VS Code 的 IDE 外壳
English · 中文
"聊天的左边是对话，聊天的右边是你的 IDE。"
中间工具标签区（编辑器/终端/浏览器/代码变更，可多开）· 右侧栏（资源管理器/搜索/Git/远程）· 底部面板（终端/输出，可拉伸）——全部可开关，状态持久化。
📚 导航
⚡ 安装 · 🎨 功能 · 🖥️ 界面结构 · ⌨️ 快捷键 · 🔍 工作原理 · 🔷 更新日志 · ❓ FAQ · 🗺️ Roadmap
⚡ 安装
2026 年了，你有 Agent，让它自己装。打开 DeepSeek Harness 的插件市场或直接把下面这句丢给任意 Agent：
帮我安装 dsh-ide-panels 这个插件：https://github.com/AIRIKE1/dsh-ide-panels
Agent 会自动识别 DSH 的 profile 目录、完成复制、注册 bundle。完成后重启 DSH Desktop 即可看到外壳。
🛠️ 想自己手动装？点开看路径
一键脚本（在插件源码目录执行）：
.\install.ps1
手动三步：
- 把
dsh-ide-panels 整个文件夹复制到
%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-ide-panels；
- 编辑
%USERPROFILE%\.dsh\profiles\desktop\package.json，在
dsh.profile.bundles 数组末尾追加 "dsh-ide-panels"；
- 重启 DSH Desktop（新插件的 bundle 需要重新生成启动图，无法热加载）。
卸载：从 bundles 里移除该名称、删除 node_modules\dsh-ide-panels 文件夹即可。
Windows 特殊处理、排障、验证方法见 📦 详细安装说明 INSTALL.md。
🎨 功能
| 区域 | 内容 | 亮点 |
|---|
| 🗂️ 中间标签页工具区 | 编辑器 / 文档 / 终端 / 浏览器 / 代码变更 | 同一工具可无限多开、标签拖拽排序、关闭即回收；空状态是"打开工具"面板 |
| 📁 右侧栏 | 资源管理器 / 搜索 / 源代码管理 / 远程 / 扩展管理 / 设置 / Agent | 图标竖排 + 面板，底部带开关按钮 |
| 📉 底部面板 | 终端 / 调试控制台 / 输出 | 常驻标签条、高度可自由拉伸、内容区随动 |
| 🖥️ 真实 PowerShell 终端 | node-pty + xterm.js | winpty 后端稳定输出、Ctrl+滚轮缩放字号、容器自适应行列 |
| 🆚 本地代码变更对比 | 快照基线 → 前后文件对比 | 不依赖 git：建立基线后，改过的文件左右分栏展示，新增代码绿色高亮 |
| 🌿 Git 源码管理 | status / stage / commit / diff / log | 无仓库时一键初始化；变更列表 + 提交历史 |
| 🌐 远程资源管理器 | SSH / WSL | 直接输入 IP/主机连接；SSH 分组读取 ~/.ssh/config、WSL 列出发行版 |
| 🔍 本地文件搜索 | 文件名 / 内容 / 两者 | 不依赖 Agent，递归扫描，点击结果直达编辑器 |
🖥️ 界面结构
┌─────────────┬──────────┬──────────────────┬───────────┬─────────┐
│ │ │ │ 编辑器 │ │
│ DSH 会话 │ 聊天 │ 中间标签工具区 │ 文档 │ 右侧栏 │
│ 侧栏 │ (常驻) │ (标签可多开) │ 终端 │ (竖排) │
│ │ │ │ 代码变更 │ │
│ │ ├──────────────────┴───────────┴─────────┤
│ │ │ 底部面板：终端 / 调试控制台 / 输出 │
└─────────────┴──────────┴─────────────────────────────────────────┘
- 左侧：DSH 自带会话侧栏（保留）
- 聊天：始终在左侧 400px，不被任何面板遮挡
- 中间：工具标签区（可拖拽/多开/关闭）
- 右侧：主侧栏（图标竖排 + 面板）
- 底部：面板条（可拉伸高度）
⌨️ 快捷键
| 操作 | 方式 |
|---|
| 开关整个外壳 | Ctrl+Shift+S |
| 切换中间工作区 | Ctrl+Shift+M |
| 切换右侧栏 | Ctrl+Shift+J |
| 切换底部面板 | Ctrl+Shift+B |
| 收起单个面板 | 面板标题右侧 ✕ |
| 终端缩放字号 | 终端内 Ctrl+滚轮 |
所有开关状态持久化在 Host settings（ui-panels 命名空间，全小写，符合 DSH 命名规范），重启后保持。
🔍 工作原理
- 插件注册进官方
shell.overlay 槽位（root 级 list），在 DSH 对话界面叠加可开关的外壳；
- 右侧栏注册进 AppFrame 的右列槽位（DSH 2.0.10+ 为
rightbar，旧版为 details；priority -1 压制官方右栏），作为同级网格列渲染——对话列自动变窄、互不遮挡；
- 布局锚点与官方类名解耦：官方 AppFrame 的类名是构建期 CSS Modules 哈希（升级即变），插件改为运行时用稳定锚点
data-shell-overlay 找到框架与其三个列，打上自有属性 data-dp-frame / data-dp-col，CSS 只引用这两个属性——DSH 换哈希也不会失配；
- 网格用 CSS 变量（
--dp-left/--dp-right/--dp-chat/--dp-strip）动态驱动：侧栏宽、聊天宽、右侧宽、底部高都能拖拽/拉伸，并随窗口大小自适应（中间工具区保底 300px）；
- 终端走 host 端 node-pty（winpty 后端）——真实 PowerShell 进程，xterm.js 渲染，轮询读写；
- 代码变更走本地文件快照（
.dsh-changes/ 目录）——不依赖 git，任何目录都能对比；
- 搜索/远程/Git 全部由 host 路由直连本地（
/dsh-ui-panels/*），不经过 Agent。
🔷 更新日志
🔷 2026.09.14 — v0.1.4 发布：底栏与中间工作区合并为同一块空间
之前的模型有问题：底栏是独立开关，中间工作区关掉后第 3 列仍然留着 1fr 的空档，底栏还孤零零浮在这块空档里，聊天栏也过不去。
现在：
- 底栏属于中间工作区：关闭中间工作区，底栏一起消失（
bottomOpen 偏好保留，重开中间会自动恢复）；反过来打开底栏时会自动把中间工作区一起打开，不会浮在空档里
- 关闭中间工作区不再占空间：第 3 列收成
0px，聊天列改用 1fr 吃满这块空间（实测：聊天 381px → 700px），--dp-strip 归零让分栏手柄撑满全高
- 中间关闭时「聊天|中间」分栏手柄自动隐藏（没有可拖的分界），右侧栏按新空间重算宽度上限（聊天只保最小宽度，右侧能拖得更宽）
- 新增
Ctrl+Shift+M 切换中间工作区（之前只有外壳/右侧/底部的快捷键）
🔷 2026.09.14 — v0.1.3 发布：性能优化 + 持久化致命 bug + 死代码清理
性能（都是实测数字，不是体感）
| 项目 | 之前 | 现在 |
|---|
sync()（切面板/开标签/改设置都会跑） | 每次含一次全 DOM 扫描：18555 节点下 45–84ms | 扫描彻底移除，稳态 1.6–4.3ms |
| 5 秒一次的诊断探针 | 84ms（每次都在全 DOM 上做 getBoundingClientRect + textContent） | 2–8ms（全量扫描改为每 60 秒一次） |
| 窗口拖拽缩放 | 每个 resize 事件都跑一次 sync | rAF 合并，一帧最多一次 |
| 后台（非当前标签）的终端 | 每个仍以 12.5 次/秒 轮询 | 隐藏即暂停（恢复可见时补回输出） |
| host 端 pty 输出缓冲 | 无上限，长期不读会一直涨 | 封顶 1MB，丢弃最旧部分 |
| 打开大文件 | 先把整个文件读进内存再截断（1GB 日志 = 1GB 内存） | 只读前 512KB |
功能：修复「面板状态完全不持久化」（最严重的一个）
v0.1.0 存的 openTabs 是字符串数组，v0.1.1 改成对象数组后，host 启动时 settings.register() 校验既有持久化数据会抛错 → ui-panels 命名空间整个注册失败（客户端 status: unavailable）→ 右侧栏视图、底部展开态、打开的标签页既不保存也不恢复，而且因为拿不到 revision，写入也会被拒。
现在：openTabs 用宽松类型 + 再挂一份「全宽松」兜底 schema，任何历史数据都不会再把命名空间炸掉。诊断日志里新增每次加载一条的持久化自检（settings-read）。
功能：切标签不再卸载视图
每个标签一个 pane、非活动的 display:none —— 编辑器里未保存的改动、终端会话与滚动历史、滚动位置都不会因为切标签而丢失（之前全部会丢）。
清理
- 删除不可达的左侧栏死代码：
leftOpen / leftView / toggleLeft / openLeft / setLeftView + .dp-left CSS（用户设计里聊天固定在最左，插件左侧栏从未渲染过）
- 视图分发表里重复的
browser 键与返回 null 的 chat 项
- 新增
tests/i18n.test.mjs：文案缺失/孤儿检查（中英各 151 条、129 个静态 key 全覆盖，view. 动态前缀单列校验）
🔷 2026.09.14 — v0.1.2 发布：一轮系统性排查 + 6 个 bug 修复
对 host 路由做了边界压测、对客户端做了真实页面自检（573 次心跳零运行期错误），发现并修掉：
| # | 问题 | 影响 |
|---|
| 1 | 搜索默认模式「文件名+内容」从不读正文（条件写错，只在文件名已命中时才搜内容） | 搜代码里的符号/关键字几乎搜不到东西 |
| 2 | 空工作区时 dir/search/git/changes 的 path 为空静默回退到宿主进程 CWD | 无活动会话时会"搜出"DSH 安装目录的文件；极端情况下会在安装目录里建变更快照 |
| 3 | /remote 未知 action 不报错，悄悄执行默认的 wsl ls | 打错参数会莫名执行 WSL 命令 |
| 4 | /pty/kill 销毁不存在的会话返回 ok:true | 与 read/write 的 404 行为不一致 |
| 5 | 二进制文件按 UTF-8 读进编辑器 → 一整屏乱码（UTF-16 文本同样） | 资源管理器点到图片/可执行文件时卡且乱；UTF-16 文本现在正确解码 |
| 6 | 中间标签 key 用模块级计数器，客户端重载后计数器归零 → 与已恢复的历史标签撞 key | 关闭/拖动标签会作用到错误的标签 |
另修正一处不一致：dir/git/changes 对不存在的路径统一返回 404/400 而不是落到 CWD。
新增 tests/host-routes.test.mjs（stub webServer 直接调用 host 处理函数，覆盖上述全部修复 + 基础路由回归）。
🔷 2026.09.14 — v0.1.1 发布：适配 DSH Desktop 2.0.10 外壳重写
2.0.10 重写了 AppFrame，本插件两处硬编码跟着失效：① 布局列框架的 CSS Modules 哈希类名变了（.pI_x6G_frame → .qNbT7G_frame），4 列网格覆盖选择器失配，中间工具区浮到聊天列上方、右侧栏空白；② 官方右栏槽位改名（details → rightbar），右侧栏整块不再渲染；③ ctx.layout.closeDetails() 被 closeRightbar() 取代。
v0.1.1 起不再依赖任何官方哈希类名：运行时通过稳定的 data-shell-overlay 锚点定位框架与三个列，打上自有属性 data-dp-frame / data-dp-col，CSS 只引用这两个属性——以后 DSH 再换哈希也不会失配；右栏槽位双注册（rightbar 优先 + details 兜底，互斥只生效一个），新旧版本都能用；中间工具区最小宽度提到 300px，避免被聊天/右侧栏挤成一条缝；底部 4 个开关按钮改为无背景色。
🔷 2026.08.18 — v0.1.0 发布：首个版本。中间标签工具区（多开/拖拽/关闭）、右侧栏（资源管理器/搜索/Git/远程/扩展/设置/Agent）、底部面板（可拉伸 + 终端/调试/输出）、真实 PowerShell 终端（winpty + xterm）、本地代码变更对比（快照 + 前后高亮）、Git 源码管理、SSH/WSL 远程、本地文件搜索。
⭐ 觉得好用的话，给仓库点个 Star 吧！
❓ FAQ
装了没效果？
重启 DSH Desktop。新插件的 bundle 需要重新生成启动图，无法热加载。
中间"打开工具"面板点不开工具？
旧版本设置里可能存了旧格式的标签数据；重启一次（host schema 已更新为多开结构）即可。
代码变更对比为什么是空的？
先点"建立基线"——它会把当前目录所有文本文件存一份快照；之后改过的文件才会列出来。不依赖 git，任何目录可用。
终端没有输出？
确认 host 端 node-pty 可用（重启后生效）。终端是真实 PowerShell（winpty 后端），连接断开点"重连"。
远程 SSH 连不上？
先在输入框填 user@ip 直接连接；用 ~/.ssh/config 里配置的主机需要免密/密钥认证。
怎么卸载？
从 dsh.profile.bundles 移除该名称，删除 node_modules\dsh-ide-panels 文件夹，重启。
🗺️ Roadmap
