前言¶
在 DSH 里切换工作区时，侧栏会列出当前可用的 workspace 标题。名称一旦偏长——例如带项目前缀、环境后缀或完整目录语义——在固定宽度的侧栏里往往会被截断或挤在一行里，扫一眼很难区分。改工作区本身的标题或路径并不是好办法：那会影响别处展示，也和「只想让 UI 更易读」的目标不对齐。
下面介绍的 dsh-workspace-name-wrap 走另一条路：只在客户端侧栏对名称做换行排版，行高随内容增长，不改动 workspace 标题与目录名。它属于 DSH 的客户端插件，通过扩展点注入样式，禁用时随 bundle 卸载，不增加工具、模型提示、外部请求或会话记录。
这是什么¶
dsh-workspace-name-wrap 由维护者 MeirinRuan 发布，在社区插件目录中归类为客户端插件（SkillHub 目录页：dsh-workspace-name-wrap）。当前 package.json 版本为 1.0.0，许可证为 MIT。
一句话定位：在 DSH 原生工作区侧栏中，让过长的 workspace 名称在可用宽度内自动换行，短名称仍保持单行；文件夹与操作控件与标题首行对齐。
核心功能¶
依据仓库 README 与 package.json 中的 dsh.client 配置，插件能力可以概括为：
- 侧栏换行：样式仅作用于原生 workspace 侧栏中的 workspace 行；长标题按侧栏宽度换行，短标题保持一行。
- 不篡改数据：workspace 标题与目录名称在数据层不变，只是展示层排版变化。
- 轻量边界：使用 DSH 扩展点与
cordis.patch.yml打包；immediately: true在 Web 客户端注入目标模块@deepseek-ai/dsh-client-ui-workspace。 - 零配置：官方文档说明没有可配置项；禁用 bundle 即恢复原生布局。
声明的运行环境包括 Node.js ^22.19.0 || >=24.0.0，以及 DSH 0.2.2-rc.1（engines.dsh 写死为该版本，其他 DSH 版本需自行验证，因插件依赖 DSH 的 DOM 结构）。
安装与启用¶
官方安装说明见仓库 docs/guide.md。推荐路径是从 GitHub Releases 下载预构建的 .tgz，再用 DSH Plugin Manager 安装；也可在本地替换为实际下载路径后执行：
dsh plugin --profile web add <absolute-path-to-downloaded.tgz>
其中 --profile 换成你实际使用的 profile 名称（示例中为 web）。
若使用 Desktop CLI：需先打开 Desktop 一次以初始化 profile，再完全退出 Desktop 后执行插件命令。
冲突注意：不要同时启用本公开包与 @local/dsh-workspace-name-wrap，二者会贡献相同样式。启用本插件前，应先禁用或移除旧的 local bundle。
从示例 profile 卸载：
dsh plugin --profile web remove dsh-workspace-name-wrap
典型用法¶
安装并启用后，无需额外配置。打开 DSH Web 客户端（或对应 profile 下的界面），在原生工作区侧栏查看列表即可：名称较短时仍为单行；名称较长时会在侧栏宽度内换行，操作按钮与标题第一行对齐。
官方文档明确：会话名称不在该样式选择器范围内，本插件不负责会话侧栏标题的换行。
开发与打包（仅供维护者或自测）时，可在仓库内做语法检查并打出 npm 格式归档：
pnpm run check
pnpm pack --out <external-output-directory>/dsh-workspace-name-wrap.tgz
输出目录应设在仓库 checkout 之外；打包前建议在目标 DSH 版本上做界面验证。
适用场景与注意¶
适合谁
- 经常在 DSH 侧栏切换 workspace，且命名偏长、截断影响辨认的开发者。
- 希望在不动 workspace 元数据的前提下，只改善 Web 客户端侧栏可读性的场景。
兼容性
- 标题选择器依赖 workspace 行的 folder、chevron、title-container、action 等 DOM 顺序。若第三方侧栏完全替换该结构，样式可能不生效；悬停出现的操作区也会挤占名称可用宽度。
- 样式继承原生字体与颜色，不向外部发送 workspace 名称、路径或会话内容。
安全与权限
- 插件随当前 DSH 进程权限运行，安装前建议阅读 GitHub 源码 与 MIT 许可证，确认符合你的使用与合规要求。
DSH 生态奉行「一切皆插件」；SkillHub 等目录由社区维护，与 DeepSeek / 幻方无官方从属关系，本文链接仅作发现与核对来源之用。
结尾¶
dsh-workspace-name-wrap 解决的是侧栏长名称可读性问题：换行展示、行高随行数增长、禁用即还原。若你需要在 0.2.2-rc.1 环境下验证，可按官方文档从 Release 安装 .tgz 并避免与 local 同名样式包并存。
