MirrMeur/dsh-workspace-colors

dsh-workspace-colors

DSH Web 外观增强插件（宿主半 + 浏览器半，零依赖）：

1. 工作区颜色 —— 侧边栏每个工作区分配专属颜色：文件夹图标着色 + 标题行
左侧色条 + 整个分组微色底。深浅主题都适配。
2. 页面背景 tint —— 给整个界面叠一层你选的颜色（官方
ctx.theme.overrideTokens() token 覆盖层，明/暗主题各自生效，内置的
浅色/深色/跟随系统偏好完全不受影响）。
3. 内存回收面板 —— 宿主半注册 /ws-colors/api/reclaim 只读状态接口，
上报 DSH 后端进程 RSS/CPU、Chrome renderer 渲染进程内存占用合计，
以及 auto-reclaim.sh 守护进程是否在跑；可开关 ~/.dsh/auto-reclaim.yaml
里的 enabled 标志。

安装 / 升级

从 GitHub 装（推荐）
dsh plugin --profile web add github:MirrMeur/dsh-workspace-colors

钉住 tag
dsh plugin --profile web add github:MirrMeur/dsh-workspace-colors#v0.4.1

本地目录（link 挂载，改文件后重启即生效）
dsh plugin --profile web add file:/path/to/dsh-workspace-colors

重启 dsh web 生效（不是刷新浏览器）。

升级：

cd ~/.dsh/profiles/web          # 或 $DSH_HOME/profiles/web
pnpm up dsh-workspace-colors

使用

打开 设置 → 外观增强：

- 页面背景：开关 + tint 色彩 + 强度滑杆，6 个预设（豆沙绿/暖米/天青/淡紫/
樱粉/墨蓝），全部实时生效，保存在浏览器 localStorage。
- 工作区颜色：开关 + 「重新分配」按钮。
- 内存回收：状态面板 + 开关。

颜色规则

- 色彩体系：全部基于 OKLCH 感知均匀色彩空间（Radix/Material 3 式 tonal
体系）—— 每个角色（色块/色条/图标）一组固定明度·彩度，只转色相，所有
工作区颜色自动同一质感；色块是实色 tonal 层而非透明度叠加，不会被
页面背景稀释。
- 工作区颜色：10 个 OKLCH 感知等距色相（红/橙/金/绿/青/天/蓝/紫/品红/玫），
按工作区首次出现顺序先到先得；映射按「名字 → 色相」存在 localStorage
（dsh-workspace-colors.map）。
启用背景 tint 时，与背景色相相差 ≤45° 的工作区颜色会被自动改派
（例如豆沙绿背景下，绿/青系工作区让位），关闭背景后恢复原分配。
手动指定：

const m = JSON.parse(localStorage.getItem('dsh-workspace-colors.map'));
m['日常工作'] = 215;          // 0-360 任意色相
localStorage.setItem('dsh-workspace-colors.map', JSON.stringify(m));

刷新页面生效。超过 10 个工作区按名字哈希回落，可能重复。
- 背景 tint：强度默认 45%。页面底色吃满强度，表面层（layer-1/2/3、侧栏）
依次衰减（0.7/0.5/0.35/0.7 倍），边框 0.3 倍，保持界面层次。原始值从
当前页面按明/暗两套捕获并缓存，官方主题/预设改动后重启页面即重新捕获。

存储键

| key | 内容 |
|---|---|
| dsh-workspace-colors.config | { workspaceColors, bg: { enabled, tint, strength } } |
| dsh-workspace-colors.map | { 工作区名: 色相 } |

宿主接口

| 方法 | 路径 | 说明 |
|---|---|---|
| GET | /ws-colors/api/reclaim | 只读状态：{ enabled, thresholdGb, idleMinutes, daemonRunning, process:{pid,rssMb,cpu}, renderer:{count,rssMb,biggestPid} } |
| POST | /ws-colors/api/reclaim | body {action:"enable"\|"disable"\|"restart"} |

restart 只在后端由 launchd 托管（ppid === 1）时才执行，否则返回 409
not-launchd-managed —— 手工启动的后端杀掉后不会自己回来。

兼容性

宿主半 inject: ["webServer"]，客户端半用 slots / locale / theme 服务与
ctx.theme.overrideTokens()，不 import @deepseek-ai/* 运行时包
（dsh-client-runtime 在 DSH 0.1.5 已被移除，本插件不依赖它）。

卸载

dsh plugin --profile web remove dsh-workspace-colors

License

MIT