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