前言¶

在 DeepSeek Harness（DSH）里跑多条会话时，侧边栏往往只有标题文字，很难一眼区分「主线」「待跟进」或「已归档」。靠记忆或在外部工具里记笔记可以，但切换成本高。下面介绍社区插件 dsh-sidebar-marks：在浏览器侧给每条对话单独设置整行淡色底、彩色圆点和标题字号，未标记的行与原生界面一致。

这是什么¶

dsh-sidebar-marks 是面向 DSH Web 界面的客户端插件，维护者与仓库见 GitHub（包名 dsh-sidebar-marks，当前版本 0.1.1，MIT 许可证）。它在左侧边栏的每个对话行上叠加可选样式，数据落在本机 localStorage，零运行时依赖；分类上在 SkillHub 目录 归入「趣味换装」，本质是侧边栏会话的可视化整理，而非改模型或工作流逻辑。

DSH 生态强调「一切皆插件」；SkillHub 为社区独立目录，与 DeepSeek / 幻方无官方从属关系。

核心功能¶

经 README 核实，插件提供以下能力（每条对话独立配置）：

对话正在运行或已归档时，「标题左侧」圆点会自动降级消失；淡色底、右侧圆点、字号仍可用。新标记默认：蓝色 + 10% 淡色底 + 最右侧圆点。

安装与启用¶

推荐从 GitHub 安装（命令须与官方 README 一致）：

dsh plugin --profile web add github:QIN-SMART/dsh-sidebar-marks

npm 发布后也可：

dsh plugin --profile web add dsh-sidebar-marks

装完后刷新浏览器页面即可，无需重启 dsh web。插件仅在 web profile 下加载客户端模块，不读写文件系统、不依赖平台分支；在 macOS、Windows、Linux 上安装命令相同（Windows 本地链接路径需加引号）。

安装前请自行查看仓库源码与许可证。插件以当前 DSH 进程及浏览器 origin 的权限运行；标记存于 localStorage['dsh.sidebar-marks.v1']，换端口、换浏览器或清站点数据会丢失，README 中说明了若需跨环境持久可改走 DSH Config 的扩展方式。

典型用法¶

打开标记面板有三种入口：

1. 对话行悬停 →「…」菜单 → 标记…（在「分叉会话」与「归档会话」之间）
2. 侧边栏聚焦时快捷键：⌘⇧M（Windows / Linux：Ctrl+Shift+M）
3. 在任意对话行上 右键

面板内点选即时生效并落盘（约 200ms 去抖），无保存按钮；左下角「清除标记」，Esc 或点击面板外关闭。

开发或调试时，控制台可访问（README 示例）：

window.__dshSidebarMarks.marks
window.__dshSidebarMarks.set('<sessionId>', { color:'#e11d48', fill:16, dots:'both', size:'l' })
window.__dshSidebarMarks.open('<sessionId>')

持久化数据形状示例：

{ "version": 2, "marks": { "<sessionId>": { "color": "blue", "fill": 10, "dots": "right", "size": "inherit" } } }

实现与验证（简要）¶

插件通过稳定 DOM 钩子 div[role="treeitem"][data-row-key="session:<id>"] 标注行，用 linear-gradient 与 color-mix 做淡色底，行尾圆点用 radial-gradient；标题左侧圆点走官方插槽 sidebar.session.row.leading。未标记行不写入任何 data-dshmk* 属性。

仓库提供 node --test 自测（21 个用例）及浏览器 demo / CDP 截图检查；CI 在多 OS 与 Node 22 / 24 上跑同一套验证。

适用场景与注意¶

适合长期在 DSH Web 里维护大量对话、需要用颜色和大小区分优先级或主题的开发者。不适合指望标记自动同步到另一台机器或另一浏览器——除非按 README 自行接到 DSH 配置存储。

若你已在用同类侧边栏增强插件，安装前确认 profile 与插件列表无冲突即可。

链接¶

• 目录页：SkillHub — dsh-sidebar-marks
• 源码与完整说明：github.com/QIN-SMART/dsh-sidebar-marks