dsh-plugin-session-colors
English | 中文
给 DeepSeek Harness 的每个会话标上颜色：在侧栏悬停即可选色，被标色的会话一眼可辨。
中文
功能
🎨 侧栏悬停取色
鼠标停在侧栏任意会话行上，行左缘浮出一枚颜色圆点，点开即是取色面板 —— 12 种预设颜色 + 一键清除，选完立即生效。全程无需打开会话。
- 圆点即为状态：已标色的会话显示实心色点，未标色的显示虚线圆圈
- 面板自动在屏幕边缘翻转方向，不会溢出视野
- 160ms 悬停防抖：扫视列表时不会误触，停留即出现
🌈 会话行着色
被标色的会话行左侧显示同色竖条（3px 内嵌条），多会话并行工作时一眼找到目标行。切换会话、刷新页面、重启应用后依然保持。
💾 宿主侧持久化
颜色存在 Harness 宿主的 storages/session-colors.json，浏览器端有 localStorage 镜像：
- 重启应用、换浏览器都不丢
- 打开页面即时显示（镜像先渲染，宿主数据随后对齐）
- 宿主 API 短暂不可达时仍可查看，恢复后自动同步
安装
方式一：插件市场（推荐）
Settings → Plugin Market → 搜索 session-colors → 一键安装 → 刷新页面。
方式二：CLI
dsh plugin --profile web add dsh-plugin-session-colors
方式三：本地 link 开发
把包符号链接到 web profile 的 node_modules，并在 profile 的 package.json 登记 dependencies 与 dsh.profile.bundles。
工作原理
┌─ 浏览器（client half）────────────────┐ ┌─ 宿主（host half）──────────────┐
│ 悬停取色覆盖层（portal，不动 React DOM） │ │ /session-colors HTTP API │
│ 会话行匹配引擎（标题精确匹配 + 兜底） │──▶│ PUT / GET / DELETE 颜色映射 │
│ 行着色（inset bar，rAF 节流重绘） │ │ storages/session-colors.json │
└───────────────────────────────┘ └─────────（原子写、损坏自愈）────┘
- 宿主半：一个零依赖的 cordis 插件，向 Harness webserver 注册
/session-colors路由，把sessionId → 颜色映射持久化为 JSON（临时文件 + 原子重命名，损坏的存储文件会在下次写入时自动修复）。 - 浏览器半：懒 CJS 工厂包（
__ModuleLoader__），零运行时依赖。由于官方未提供会话行的插槽，侧栏着色通过「会话标题 ↔ 行标题 span」精确匹配实现（未读噪声安全、同名会话按 DOM 序消费、子串陷阱防护）。匹配失败只影响着色，不影响数据。
HTTP API
| 方法 | 路径 | 说明 |
|---|---|---|
GET |
/session-colors/api/colors |
全量颜色映射 { colors: { [sessionId]: "#rrggbb" } } |
PUT |
/session-colors/api/colors/:sessionId |
设置颜色，body {"color": "#ef4444"}；null 清除 |
DELETE |
/session-colors/api/colors/:sessionId |
清除一个会话的颜色 |
颜色接受 #rgb / #rrggbb 十六进制（统一规范化为小写 6 位）；会话 ID 校验后落盘。
兼容性与限制
- 标准
dsh.bundle插件包，DeepSeek Harness Web / Desktop 均可使用 - 侧栏着色基于 DOM 匹配（best-effort）：同名会话按列表顺序取色；无标题（空白）会话不着色；Harness 大版本若更改会话行结构，着色可能失效 —— 取色与数据不受影响
- Node ≥ 22.19 / ≥ 24
开发
node smoke-host.js # 宿主半离线冒烟测试（11 项）
node smoke-host-phase2.js <临时目录> # 存储损坏自愈测试（3 项）
npm i --no-save jsdom # 仅 DOM 测试需要
node smoke-client-dom.js # 浏览器半 jsdom DOM 测试（15 项）
License
MIT
English
Per-session color tags for DeepSeek Harness: hover a sidebar session row to pick a color, and tagged sessions stand out at a glance.
Features
🎨 Hover-to-color in the sidebar
Rest the pointer on any session row in the sidebar and a color dot appears at the row's left edge. Click it for the palette — 12 preset colors plus one-click clear, applied instantly. No need to open the session.
- The dot reflects state: filled for tagged sessions, dashed outline otherwise
- The palette flips at screen edges so it never overflows
- A 160ms hover dwell keeps quick scanning free of pop-ups
🌈 Colored session rows
Tagged rows show a matching 3px bar on their left edge, so the session you want is findable at a glance across parallel work. Colors survive session switches, page reloads, and app restarts.
💾 Host-side persistence
Colors live in the Harness host's storages/session-colors.json with a localStorage mirror in the browser:
- Survives restarts and browser switches
- Instant first paint (mirror renders first, then reconciles with the host)
- Readable even while the host API is briefly unreachable; re-syncs on recovery
Install
Option 1 — plugin market (recommended)
Settings → Plugin Market → search session-colors → install → refresh the page.
Option 2 — CLI
dsh plugin --profile web add dsh-plugin-session-colors
Option 3 — local link (development)
Symlink the package into the web profile's node_modules, then register it in the profile package.json (dependencies + dsh.profile.bundles).
How it works
- Host half: a zero-dependency cordis plugin that registers a
/session-colorsroute on the Harness webserver and persists thesessionId → colormap as JSON (temp file + atomic rename; a corrupted store self-heals on the next write). - Client half: a lazy-CJS
__ModuleLoader__bundle with zero runtime dependencies. Harness ships no slot for session rows, so sidebar coloring matches session titles to row title spans exactly (unread-noise safe, DOM-order queue for duplicate titles, substring-trap guarded). A match failure only affects painting — never the data.
HTTP API
| Method | Path | Purpose |
|---|---|---|
GET |
/session-colors/api/colors |
Full map { colors: { [sessionId]: "#rrggbb" } } |
PUT |
/session-colors/api/colors/:sessionId |
Set a color, body {"color": "#ef4444"}; null clears |
DELETE |
/session-colors/api/colors/:sessionId |
Clear one session's color |
Colors accept #rgb / #rrggbb hex (normalized to lowercase 6-digit); session ids are validated before storage.
Compatibility & limitations
- Ships as a standard
dsh.bundleplugin package; works in DeepSeek Harness Web and Desktop - Sidebar painting is DOM-matched (best-effort): same-title rows consume colors in list order; blank/untitled sessions are never matched; a future Harness release that changes the row structure may disable painting — picking and data are unaffected
- Node ≥ 22.19 / ≥ 24
Development
node smoke-host.js # host-half offline smoke tests (14 checks)
node smoke-host-phase2.js # corrupted-store recovery test
npm i --no-save jsdom # only the DOM test needs it
node smoke-client-dom.js # client-half jsdom tests (15 checks)
License
MIT
