dsh-workspace-style
moonmooncl/dsh-workspace-style
Gives each workspace its own sidebar icon and color through a single Edit dialog that replaces the row menu's Rename item. Each icon has a collapsed outline, an expanded outline, and a filled hollow form shown while the workspace holds the current session.
설치
dsh plugin --profile web add github:moonmooncl/dsh-workspace-styleREADME
dsh-workspace-style
给 DeepSeek Harness 侧栏的每个工作区配上自己的图标和颜色:一个「编辑」对话框同时改名称、图标与颜色,图标在收起 / 展开 / 选中三种状态下各有形态。
English · 功能 · 安装 · 使用 · 持久化与限制 · 开发文档
DSH 的侧栏里所有工作区都长同一个文件夹样。这个插件让每个工作区有自己的图标与颜色——把工作区行菜单里的“重命名”换成“编辑”,一个对话框同时改名称、图标与颜色。
这是一个浏览器端 DSH 插件(Client plugin)。它不修改 Host 的 Workspace 记录,也不新增 Remote 方法;外观保存在浏览器
localStorage中,按稳定的 Workspace id 关联。
功能
- 菜单:编辑 — 工作区行“⋯”菜单中的“重命名”项替换为“编辑”,点击打开统一编辑对话框。
- 系统默认选项 — 图标列表首位是“系统默认图标”(原生文件夹,带展开/收起两态),颜色列表首位是“跟随系统”(平时灰色、工作区包含当前会话时高亮蓝色,即内置的选中逻辑)。两个选项独立勾选:可以只换图标、只换颜色,或全部恢复默认。
- 统一编辑对话框 — 工作区名称、工作区图标(1 个默认 + 14 个图形)、工作区颜色(1 个跟随系统 + 14 色),一次保存;两行瓦片数量一致,对话框两边缘对齐。
- 三态图标 — 每个图形图标都镜像内置文件夹的完整状态模型:收起显示收起形态描边版,展开切换为展开形态描边版,工作区包含当前会话时再切换为实心镂空版(填充轮廓 + 20% 透明内芯)。悬停对话框瓦片可预览实心形态。
- 侧栏即时生效 — 保存后工作区行左侧图标即时更新;“默认图标 + 自定义颜色”只给原生文件夹染色(两态与选中变蓝均保留)。
- 名称校验 — 与内置重命名一致:空名称禁用保存,同名冲突在本地提示;无重命名权限时名称只读,但外观仍可保存。
- 跨标签页同步 — 同一站点其他标签页通过
storage事件即时更新。 - 本地化 — 内置中文与英文文案;跟随 DSH 当前语言。
安装
插件以 DSH bundle 的形式发布:包清单里的 dsh.bundle.patch 会插入 dsh-workspace-style 的 Host 条目,dsh.client 则声明浏览器入口。
# 从 npm 安装(推荐)
dsh plugin --profile web add dsh-workspace-style
# 不走 npm,直接从 GitHub 源码安装
dsh plugin --profile web add github:moonmoonCL/dsh-workspace-style
把 --profile web 换成你实际使用的 profile(如 desktop、dsh-tui)。也可以直接使用 DSH 的插件管理界面安装/启用这个 bundle。安装完成后重新载入 DSH 页面即可,无需重启 Host 会话。
本地开发安装
在 DSH profile(例如 ~/.dsh/profiles/web)中把它作为本地包启用:
- 把包链接进 profile 依赖(
pnpm add link:/path/to/dsh-workspace-style或写入package.json后pnpm install)。 - 在 profile 的
dsh.profile.bundles中加入dsh-workspace-style。 - 重新加载 DSH Web 页面;新插件通过客户端模块图加载,无需重启 Host 会话。
使用
- 在侧栏找到任意工作区,悬停后点击右侧“⋯”。
- 选择 编辑。
- 修改名称、点选图标与颜色,点击 保存。
持久化与限制
- 外观保存在当前浏览器的
localStorage(键dsh-workspace-style:styles:v1),按 Workspace id 存储,不写入 Host 数据库。存储值为{icon, color},任一字段为null表示该维度使用系统默认;两者都为默认时该条目会被删除(即“恢复默认”会真正清掉保存的样式)。 - 因此同一 Workspace 在不同浏览器 / 不同 DSH Web 端口之间不会同步;清除站点数据会丢失外观。
- 工作区行 DOM 由
@deepseek-ai/dsh-client-ui-workspace渲染,本插件通过其稳定的data-row-key="workspace:<id>"属性附加装饰;DSH 若改变该属性,装饰会失效但不会影响原有功能。 - 内置“重命名”菜单项由 ui-workspace 注册,外部插件无法注销,因此本插件只在包含“编辑”项的菜单中按当前语言文案隐藏该项。
- 图标几何取自 Phosphor Icons(MIT 协议):描边形态用 regular 字重,实心镂空形态用 duotone 字重;在侧栏通过 CSS mask 绘制。“跟随系统”颜色直接继承内置的灰/蓝选中逻辑,自定义颜色则为固定色值,深色/浅色主题均使用同一组色值。
- 内置文件夹图标的展开/收起两态与选中变蓝由宿主原生维护;插件目录中的
folder采用宿主同款几何(无实心变体,保持与“系统默认”一致的观感)。
开发
package.json 插件清单(dsh.bundle + dsh.client)
cordis.patch.yml bundle 的 Host 条目
index.js Host 半侧(无状态)
client.js 浏览器半侧:菜单、对话框、持久化、侧栏装饰
screenshots.json 插件市场详情页截图声明
docs/assets/ 截图与配图
locale/{zh,en}.json 插件市场展示文案
无构建步骤:client.js 直接以 window.__ModuleLoader__.load({ id, factory }) 形式注册,和内置客户端插件使用同一套模块系统。
node --check client.js
node --test test/*.test.mjs
License
MIT