dsh-ide-panels

📚 导航

⚡ 安装 · 🎨 功能 · 🖥️ 界面结构 · ⌨️ 快捷键 · 🔍 工作原理 · 🔷 更新日志 · ❓ 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 会话   │   聊天   │  中间标签工具区   │ 文档      │ 右侧栏  │
│  侧栏       │  (常驻)  │  (标签可多开)     │ 终端      │ (竖排)  │
│             │          │                  │ 代码变更  │         │
│             │          ├──────────────────┴───────────┴─────────┤
│             │          │  底部面板：终端 / 调试控制台 / 输出       │
└─────────────┴──────────┴─────────────────────────────────────────┘

• 左侧：DSH 自带会话侧栏（保留）
• 聊天：始终在左侧 400px，不被任何面板遮挡
• 中间：工具标签区（可拖拽/多开/关闭）
• 右侧：主侧栏（图标竖排 + 面板）
• 底部：面板条（可拉伸高度）

⌨️ 快捷键

所有开关状态持久化在 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

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