🚀 快速安装

npm 包已发布，可通过官方插件页或终端安装。

终端（需先注册 dsh）

dsh plugin --profile desktop add dsh-claude-desktop-theme

插件页：打开「插件 → 添加插件」，粘贴

dsh-claude-desktop-theme

首次安装后插件自动开启，升级沿用已保存的配置。应用内添加插件无需注册 CLI；安装后重载 DSH，具体步骤、应用内置 CLI 路径与源码安装见 安装指南。

🌟 核心特性

• 紧凑侧栏：工作区导航与会话列表，浏览区只有一行表头——工作区名在左，新建会话、搜索与视图选项在右；新会话条目在第一次发送后出现。会话条目尾部只有一枚 ⋮，菜单里是置顶、重命名、分叉与归档。
• 统一会话页：新会话页、输入卡片与聊天布局共用一套样式，正文边缘随滚动渐隐。
• 模型与 effort：两个独立选择器，支持搜索、滑块和键盘操作；滑杆停在最后一档时，轨道上的实心填充换成一条像素流光。
• 会话顶栏：项目文件夹、终端、浏览器三个右侧栏入口；展开侧栏收进会话 ⋯ 菜单第一项。
  标题左侧显示电脑图标，右侧下拉按参考提供 Open in、Rename、Fork、Transcript view、Output style、Archive、Delete；项目名以灰色标签显示，点击打开目录菜单。重命名、Fork、归档、对话／轨迹切换、宿主默认外部应用打开、复制目录路径／名称与打开终端接入真实操作。Show in Finder、Open repository on GitHub、Change folder、Output style 和 Delete 因 DSH 未提供相应公开接口或仓库信息，仅还原外观，点击显示具体限制说明；不会伪造删除或目录变更。
• 右侧栏与 Files 页签：Files、浏览器等视图各占一张卡，多个终端共用一张卡并通过标签页切换，加号新增真实终端；前两块上下排列，第三块开启右列；两列的上下分隔线独立可拖，关闭后同列补位，比例按会话保留。卡片可以放大到覆盖聊天区域（保留左导航）／还原，单视图标题为无交互文本，顶部按视频排列加号／搜索、⋮、展开与关闭，最后一块关闭时收起右侧栏。文件预览放在 Files 卡片内部，文件树与预览左右分栏；窄列无预览时优先显示完整文件树，放宽后显示空预览。支持拖动树宽、点击标题左侧蓝色清单按钮收起／展开文件树和切换已打开的文件；过滤框按名字收窄已加载的行，Esc 清除。
  浏览器按参考提供 Servers／Files／Settings 分组菜单，以及单项 Save screenshot 菜单；桌面网页可保存 PNG，空页禁用。地球按钮右侧可直接输入服务地址并回车访问，dev 可聚焦地址框；启动服务器、本地文件直接浏览及三项配置暂时提供限制说明。独立窗口按钮暂时隐藏；浏览器元素选取保留按钮外观，点击说明 DSH 暂无接口；全目录搜索未接入，当前只过滤已加载文件。
• 输入框与状态栏：原生加号位于输入框内左侧，新会话的工作区选择行放在输入区与工具行下方。聚焦时加深输入边框；细线发送 / 停止按钮、模型、effort、权限与语音控件统一尺寸和间距，权限始终显示文字，上下文圆环位于行末。
• 统一菜单：工作区、会话、权限与模型等选单共用紧凑行高、圆角和悬停反馈，浅色与深色模式保持一致。
• 顶栏入口：子代理数量入口与智能体团队入口默认隐藏，可在「Claude 主题 → 视图」中分别开启；子代理运行、团队功能与侧栏子代理树保持可用。
• 滚动条：平时不画——滚动时出现、停下约一秒淡出，鼠标移到滚动条那条窄边上也会出现；五个页面级滚动面（会话页、转录列、侧栏树、文件树、智能体团队面板）改用一条封顶的深色浮层胶囊（长短不随内容变成整条高），轨道几何仍是宿主的（正文 5px、设置列 9px），宿主自己隐藏滚动条的几条横条保持原样。
• 视图选项：按参考图分成状态、分组与排序、空分组三段；「维度 + 当前值 + ›」的值行展开紧贴右侧的二级卡片。状态按活跃／已归档／全部命名，底部可一键清除筛选，并可开关空分组。分组方式新增「按状态」：需要输入／进行中／已结束，状态变化时平滑移动，进行中的会话下显示已加载的子任务；原有项目与单列表视图仍可选。
• 主页字符水波纹：固定的字符行上，多层不规则蓝色波带自主交错、增强并消退，安静时保留微弱纹理。点击主页空白处可触发同样不规则的扩散，连点只播放一次，结束后可再次触发；切入聊天、隐藏窗口或开启系统减少动态效果时停止。
• 上下文分解面板：点上下文圆环打开分段面板。收起态是标题行加一条 4px 分段条；点标题行展开成分类行（MCP 工具／系统工具／系统提示词／技能／记忆文件／对话消息／自动压缩余量／空闲空间）与可折叠的逐项分组（逐工具、逐指令文件、逐技能）。数字来自 DSH 的投影；每次打开时标题和各明细分组都默认收起，不显示估算差额，没有底部按钮。
• Markdown 排版：链接、行内代码、表格与代码块按 CCD 风格重绘。
• 像素小鲸鱼：停在新会话页的输入卡旁，待机时眨眼与摆尾；点击随机喷一口水、轻弹眨眼或摆尾回应。
• 主题跟随：跟随 DSH 的浅色、深色和系统主题，支持自定义背景色与字体。
• 用量统计卡片：概览／模型视图、时间范围、贡献热力图与模型图表。

🐳 与小鲸鱼互动

喷一口水 身体轻晃、闭眼，从头顶喷出水柱，水滴向两侧散开落下

轻弹眨眼 蓄力、向上轻跳、落地回弹并眨眼

摆尾回应 身体左右轻晃，尾巴与胸鳍摆动并眨眼

🎚️ Effort 选单

浅色

深色

🖼️ 界面预览

截图为 macOS 版本，使用默认配色与 Geist 字体，统计卡片已开启，状态栏统计读数保持默认关闭。新会话页展示像素小鲸鱼与统计卡片，聊天页展示 Markdown 表格与代码高亮；插件设置两图分别展示模块开关，以及主题、背景色、视图与字体。小鲸鱼的三种点击回应与 Effort 拉到底的动效见上方。

	浅色	深色
新会话页
聊天页
插件设置

⚙️ 配置

打开「插件 → dsh-claude-desktop-theme」，调整总开关、模块、主题、颜色和字体。改动即时生效。

[!NOTE]
自定义背景色只作用于浅色模式，深色模式使用内置深色调色板。界面默认使用 Geist，未安装时回退系统字体；仓库的 assets/fonts/ 提供本机安装用字体与 OFL 许可，字体不包含在 npm 包中。

🛠️ 环境要求

🧑‍💻 开发

npm ci --cache .cache/npm
npm run check
npm run pack:local --cache .cache/npm

npm run check 依次执行类型检查、模块边界与文档链接检查、测试、构建和包内容校验。本机有 Chrome 时，测试还会在真实浏览器中验证视图选项二级菜单的鼠标命中、跨菜单间隙与键盘操作，以及上下文分解面板的两态、锚定几何、分段间隙与浅深配色；没有 Chrome 时跳过这一项，可用 CHROME 指定浏览器路径。

代码结构见 ARCHITECTURE.md。

📮 反馈与许可

通过 Issue 反馈问题，附上 DSH 版本、窗口尺寸和复现步骤。

MIT © 2026 zkforge。