前言¶

在 DSH 的左侧边栏中，尚未打开的会话通常只显示工作区文件夹名称，没有主题。只有点击进入会话后，主题才会出现。这通常是因为 session.list 只读取投影缓存中未发生 I/O 的行。
dsh-session-theme 插件通过在启动时预热投影缓存来解决这个问题。下面介绍这个插件的功能和使用方法。

插件介绍¶

dsh-session-theme 是一个 DSH Web 插件，由 Xliecc 维护。它解决了侧边栏中冷会话显示为文件夹名称的问题，确保在页面加载时就能看到每个会话的主题。

核心功能¶

• 在页面加载时显示每个会话的主题。
• 启动时预热会话投影缓存。
• 仅处理“冷”会话（未在此进程中打开的会话）。
• 每个会话的容错处理（一个会话损坏不会影响其他会话）。
• 幂等写入回写（保证后续启动命中缓存）。

安装与启用¶

执行以下命令进行安装：

dsh plugin add dsh-session-theme

安装完成后，浏览器端需要硬刷新（Ctrl/Cmd+Shift+R），以便客户端重新拉取 session.list 数据。

验证¶

安装并刷新后，打开 DSH Web 侧边栏，检查每个会话行是否显示其主题。

同时，在服务器日志中查找以下行以确认缓存预热成功：

dsh-session-theme: projection cache warmed (N sessions)

注意事项¶

• 安装后必须进行硬刷新。
• 插件采用 MIT 许可证。
• 插件零外部依赖。

结语¶

dsh-session-theme 通过在启动阶段修复投影缓存，让侧边栏的会话展示更加直观。相关源码与目录信息可在以下地址查看：
GitHub
社区目录