🚀 快速安装

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

终端（需先注册 dsh）

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

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

dsh-claude-desktop-theme

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

🌟 核心特性

• 紧凑侧栏：工作区导航与会话列表，新会话条目在第一次发送后出现。
• 统一会话页：新会话页、输入卡片与聊天布局共用一套样式，正文边缘随滚动渐隐。
• 模型与 effort：两个独立选择器，支持搜索、滑块和键盘操作；滑杆停在最后一档时，轨道上的实心填充换成一条像素流光。
• 会话顶栏：项目文件夹、终端、浏览器三个右侧栏入口；展开侧栏收进会话 ⋯ 菜单第一项。
• 输入框与状态栏：聚焦时加深输入边框；细线发送 / 停止按钮、模型、effort、权限与语音控件统一尺寸和间距，权限始终显示文字，上下文圆环位于行末。
• 统一菜单：工作区、会话、权限与模型等选单共用紧凑行高、圆角和悬停反馈，浅色与深色模式保持一致。
• Markdown 排版：链接、行内代码、表格与代码块按 CCD 风格重绘。
• 像素小鲸鱼：停在新会话页的输入卡旁，待机时眨眼与摆尾；点击随机喷一口水、轻弹眨眼或摆尾回应。
• 主题跟随：跟随 DSH 的浅色、深色和系统主题，支持自定义背景色与字体。
• 用量统计卡片：Overview／Models 视图、时间范围、贡献热力图与模型图表。

🐳 与小鲸鱼互动

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

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

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

🎚️ Effort 选单

浅色

深色

🖼️ 界面预览

截图为 macOS 版本，使用默认配色与 Geist 字体，统计卡片与状态栏统计读数已开启。静态截图展示整体布局；小鲸鱼的三种点击回应与 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 依次执行类型检查、模块边界与文档链接检查、测试、构建和包内容校验。

代码结构见 ARCHITECTURE.md。

📮 反馈与许可

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

MIT © 2026 zkforge。