📚 导航

⚡ 安装 · 🎨 功能 · 🖥️ 界面结构 · ⌨️ 快捷键 · 🔍 工作原理 · 🔷 更新日志 · ❓ 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+J
切换底部面板	Ctrl+Shift+B
收起单个面板	面板标题右侧 ✕
终端缩放字号	终端内 Ctrl+滚轮

所有开关状态持久化在 Host settings（ui-panels 命名空间，全小写，符合 DSH 命名规范），重启后保持。

---

🔍 工作原理

1. 插件注册进官方 shell.overlay 槽位（root 级 list），在 DSH 对话界面叠加可开关的外壳；
2. 右侧栏注册进 AppFrame 的 details 槽位（priority -1 压制官方详情面板），作为同级网格列渲染——对话列自动变窄、互不遮挡；
3. 网格用 CSS 变量（--dp-left/--dp-right/--dp-chat/--dp-strip）动态驱动：侧栏宽、聊天宽、右侧宽、底部高都能拖拽/拉伸，并随窗口大小自适应；
4. 终端走 host 端 node-pty（winpty 后端）——真实 PowerShell 进程，xterm.js 渲染，轮询读写；
5. 代码变更走本地文件快照（.dsh-changes/ 目录）——不依赖 git，任何目录都能对比；
6. 搜索/远程/Git 全部由 host 路由直连本地（/dsh-ui-panels/*），不经过 Agent。

---

🔷 更新日志

🔷 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 远程 / 本地搜索
• 设置里自定义右侧栏/中间工具
• 标签右键菜单（复制/固定）
• 多工作区文件树

---