AIRIKE1/dsh-ide-panels

dsh-ide-panels

DSH（DeepSeek Harness）客户端布局插件 —— 仿 VS Code 的 IDE 外壳

license
version
DeepSeek Harness

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

手动三步：

1. 把 dsh-ide-panels 整个文件夹复制到
%USERPROFILE%\.dsh\profiles\desktop\node_modules\dsh-ide-panels；
2. 编辑 %USERPROFILE%\.dsh\profiles\desktop\package.json，在
dsh.profile.bundles 数组末尾追加 "dsh-ide-panels"；
3. 重启 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 命名规范），重启后保持。

🔍 工作原理

1. 插件注册进官方 shell.overlay 槽位（root 级 list），在 DSH 对话界面叠加可开关的外壳；
2. 右侧栏注册进 AppFrame 的右列槽位（DSH 2.0.10+ 为 rightbar，旧版为 details；priority -1 压制官方右栏），作为同级网格列渲染——对话列自动变窄、互不遮挡；
3. 布局锚点与官方类名解耦：官方 AppFrame 的类名是构建期 CSS Modules 哈希（升级即变），插件改为运行时用稳定锚点 data-shell-overlay 找到框架与其三个列，打上自有属性 data-dp-frame / data-dp-col，CSS 只引用这两个属性——DSH 换哈希也不会失配；
4. 网格用 CSS 变量（--dp-left/--dp-right/--dp-chat/--dp-strip）动态驱动：侧栏宽、聊天宽、右侧宽、底部高都能拖拽/拉伸，并随窗口大小自适应（中间工具区保底 300px）；
5. 终端走 host 端 node-pty（winpty 后端）——真实 PowerShell 进程，xterm.js 渲染，轮询读写；
6. 代码变更走本地文件快照（.dsh-changes/ 目录）——不依赖 git，任何目录都能对比；
7. 搜索/远程/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

- [x] 中间标签工具区（多开/拖拽/关闭/溢出收纳）
- [x] 右侧栏（去重 + 竖排开关）
- [x] 底部面板（可拉伸/常驻）
- [x] 真实 PowerShell 终端
- [x] 本地代码变更对比（不依赖 git）
- [x] Git 源码管理 / SSH+WSL 远程 / 本地搜索
- [ ] 设置里自定义右侧栏/中间工具
- [ ] 标签右键菜单（复制/固定）
- [ ] 多工作区文件树

Created by AIRIKE · MIT License · Powered by DeepSeek Harness*