前言¶

DeepSeek Harness (DSH) Web 界面默认提供了基础的会话和文件视图。对于需要频繁管理临时草稿、切换工作目录的开发者来说，原生的按钮布局和列表展示可能不够高效。dsh-plugin-pi-ui 插件旨在通过重构侧边栏，提供更紧凑的会话管理和文件浏览体验。

插件介绍¶

这是一个受 pi-web 启发的侧边栏增强组件，由 ice-ai-lab 维护。它通过 --dsw-* 设计令牌跟随主题，解决了以下问题：将左侧边栏重塑为逻辑分块的结构，顶部展示临时会话，下方通过选择器展示特定工作目录的会话列表，并提供一个仅在发送后才生效的草稿编辑器，同时接管右侧列的文件选项卡。

核心功能¶

• 侧边栏分块重塑：将左侧栏分为临时会话区、工作目录选择器与会话列表区。
• 临时会话管理：顶部展示最近 5 个临时会话，支持点击 + 创建草稿，点击 🗑 清理未使用的目录。
• 工作目录与会话绑定：通过下拉菜单选择工作目录，下方的会话列表仅显示该目录下的会话。
• 草稿机制：所有“新建”操作（点击 +）仅打开草稿编辑器，不创建任何文件或会话，直到发送消息。
• 右侧文件资源管理器：在右侧列的 Files 选项卡位置显示紧凑的文件浏览器。

安装与启用¶

使用以下命令安装插件：

dsh plugin --profile web add dsh-plugin-pi-ui

安装后，必须重启 dsh web 才能生效。由于浏览器端代码在启动时组装，新添加的客户端插件在已运行的服务器上不会立即显示，需要刷新页面。

典型用法¶

• 创建临时会话：点击左侧栏顶部的 + 按钮，输入内容并发送。此时才会生成对应的临时目录。
• 清理临时目录：点击顶部的 🗑 按钮，可以删除不再使用的临时目录。
• 切换工作目录：点击“工作区”行与 + 按钮之间的下拉菜单，选择目标目录。下方的会话列表将只显示该目录的内容。
• 管理文件资源管理器：进入设置中的“通用”选项，可以开启或关闭右侧列的文件资源管理器功能。

注意事项¶

插件以当前 dsh 进程的权限运行。插件内的设置（如文件资源管理器开关、工作目录切换器）是内存级的，刷新页面后会重置。临时会话对应的目录会保留在磁盘上，如果不再需要，可以手动删除 <DSH_HOME>/scratch/ 目录。

后续¶

该插件采用 MIT 许可证，源代码托管在 GitHub。更多细节可参考 SkillHub 目录。