前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许在客户端扩展功能。在智能体开发或代码处理场景中，开发者通常需要频繁查看文件结构、Git 变更记录或代码 Diff。dsh-flyout-sidebar 插件通过提供一个覆盖整个会话区的侧边栏，以及支持弹出的独立标签页，解决了在对话流中查看文件和代码的需求。
这是什么¶
这是一个 DSH 客户端插件，提供可弹出式侧边栏。它由 oxlyn 维护，使用 MIT 许可证。核心价值在于将文件树、Git 变更列表与代码预览集成在一个可拖拽、可弹出的面板中，并保证与主会话区的实时同步。
安装与启用¶
使用以下命令安装插件：
dsh plugin --profile web add dsh-flyout-sidebar
安装完成后，需要重启 dsh web 并在浏览器中执行硬刷新（Cmd/Ctrl+Shift+R）以使图标和面板生效。可以通过以下命令验证配置层是否正确加载：
dsh --profile web --dump-config | grep dsh-flyout-sidebar
核心功能¶
- 双视图模式：面板默认显示文件树视图，支持一键切换到 Git 变更视图。Git 变更列表会自动跟随，显示变更类型（M/A/D/R/U）及行数统计，支持悬停查看暂存状态。
- 大面积预览：预览区会盖住左侧整个会话区域，提供充足的阅读宽度。支持代码软换行、图片滚轮缩放以及着色的 unified diff。
- 独立弹出：面板左上角提供按钮，可将侧边栏一键弹出为独立的浏览器标签页。该标签页可拖拽到另一块显示器，且与主面板通过
localStorage实时同步会话与主题。 - 系统集成：预览栏支持在系统默认编辑器或 IDE 中打开当前文件。
使用示例¶
安装并重启后，验证插件功能：
1. 点击刷新按钮，强制拉取 Git 变更列表的最新状态。
2. 点击文件列表中的某一项，查看着色的 unified diff。
3. 点击面板左上角的弹出图标，查看独立标签页是否正确同步了当前会话和主题。
注意事项¶
- 工作区必须是一个 git 仓库，否则 Git 变更视图会显示错误提示（文件树视图不受影响）。
- 代码预览功能依赖于浏览器的原生查找功能。
- 本地开发构建需要安装
devDependencies。 - DSH profile 的 pnpm 供应链策略可能会暂缓安装刚刚发布的版本，导致需要等待一段时间才能更新。
