桌面版界面风格 zkforge/dsh-claude-desktop-theme

DSH Claude Desktop Theme

为 DeepSeek Harness（DSH）Desktop 换上 Claude Code Desktop 外观

安装 · 功能 · 界面预览 · 配置 · 架构 · 设计规范 · 安装指南 · 问题反馈

快速安装

npm 包已发布，两种入口任选其一：

- 插件页：「插件 → 添加插件」，输入 dsh-claude-desktop-theme
- 终端：dsh plugin --profile desktop add dsh-claude-desktop-theme

源码安装见安装指南。

界面预览

以下展示 macOS 浅色与深色主题的完整窗口。首页使用 Claude 像素宠物与问候样式，开启水波纹和统计卡片；会话页展示工具调用摘要与文件栏。两种宠物的点击回应与 Effort 拉到底的动效见下一节。

| 界面 | 浅色 | 深色 |
| 新会话页 | 新会话页 · 浅色 | 新会话页 · 深色 |
| 会话页 | 会话页 · 浅色 | 会话页 · 深色 |
| 模型选单展开 | 模型选单完整窗口 · 浅色 | 模型选单完整窗口 · 深色 |
| 插件设置 | 插件设置 · 浅色 | 插件设置 · 深色 |

组件特写

| 组件 | 浅色 | 深色 |
| 模型选择器 | 模型选择器 · 浅色 | 模型选择器 · 深色 |
| DeepSeek 余额 | 余额组件 · 浅色 | 余额组件 · 深色 |
| 上下文圆环与分解面板 | 上下文圆环与分解面板 · 浅色 | 上下文圆环与分解面板 · 深色 |
| 会话右侧信息卡片 | 会话信息卡片 · 浅色 | 会话信息卡片 · 深色 |

以下为真实组件的局部截图，使用演示数据。模型选择器展示服务商分组、模型图标与当前选中项；可选模型和 Effort 档位以 DSH 实际提供的目录为准。余额特写使用演示账号与金额，常显于左下角账号上方，列出总余额、赠金和当前峰谷时段，点击可刷新。上下文面板展示分类占比与展开的 MCP 工具明细，右下角保留用量圆环入口。

细节动效

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

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

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

Claude 像素宠物取出笔记本电脑、敲键盘，再恢复站姿

在「设置 → Claude 主题 → 个性化 → 宠物样式」中切换小鲸鱼或 Claude 像素宠物，点击宠物即可播放动作。

Effort 拉到底 · 浅色

Effort 拉到底 · 深色

功能

侧栏

- 「显示 API 余额」默认开启，可在「设置 → Claude 主题 → 视图」关闭；关闭后隐藏余额与峰谷时段，并停止查询。开启时，左下角账号上方显示 DeepSeek 官方 API 的人民币余额（¥），第二行显示赠金、峰时/谷时标签与切换时间（峰时琥珀色、谷时绿色）；悬停卡片列出今日消耗、近 7 天日均、预计可用天数、充值、赠金与峰谷倒计时。消耗由本机记录的余额下降推算，充值只重置基线，不计入消耗；点击刷新，侧栏展开时每分钟后台更新，重新展开保留上次读数。折叠侧栏时在账号菜单保留余额入口。复用设置 → 模型中的官方 API Key；未配置或查询失败时显示对应状态。

- DeepSeek Harness 品牌条目默认隐藏，可在「设置 → Claude 主题 → 视图」开启显示。
- 新建 / 搜索 / 自定义 / 定时任务 / 主题入口与工作区、会话列表、账号菜单共用紧凑行高，当前入口常驻底色；「更多」以三个点表示。原标题行隐藏「最近会话」标题，只保留右侧筛选视图按钮。
- 「主题」入口在主区域打开本插件的配置页，内容与「设置 → Claude 主题」相同；关闭 Claude 主题后入口仍在，用来重新开启。
- 点击「更多」，在「浏览插件…」「创建插件…」下方选「编辑侧边栏…」，勾选要在侧栏中显示的面板；取消勾选的面板移到「更多」菜单顶部，选择保存在本机。
- 点击「搜索」或按 ⌘K 打开搜索面板：按全部 / 会话 / 项目 / 定时任务切换类型，空白时列出最近使用；输入后按标题匹配并补充会话内容命中。↑↓ 选择、↵ 打开、⌥↵ 打开行操作（置顶、创建分支、归档等）、Tab 用输入内容新建会话、/ 筛选类型、← → 切换类型、Esc 关闭。
- 会话条目尾部只有一枚 ⋮，菜单里是置顶、重命名、分叉与归档。
- 视图选项分状态、分组与排序、空分组三段。「按状态」把会话分为需要输入 / 进行中 / 已结束，状态变化时平滑移动，进行中的会话下显示子任务，没有会话的分区不显示标题，点击分区标题可收起或展开，收起后当前打开的会话仍保留在列表中；项目分组与单列表仍然可选。
- 「对话 / 轨迹」切换器停在侧栏窗口控制行，以图标表示。

会话页

- 新会话页、输入卡片与聊天页共用一套布局，正文边缘随滚动渐隐。
- 顶栏左侧是电脑图标与标题下拉（Open in、Rename、Fork、Transcript view、Output style、Archive、Delete）；不显示项目名，标题按自然宽度完整展示，只在空间不足时截断。有宿主接口的动作接真实操作，其余点击说明限制。
- 新建会话页与聊天页顶栏右侧依次是终端、浏览器、项目文件夹三个右栏入口；展开右栏的动作在会话 ⋯ 菜单第一项。
- 整轮过程默认展开，「已完成，用时…」与步骤分组标题不再显示。
- Markdown 的链接、行内代码、表格与代码块按 CCD 风格重绘。

输入框

- 加号位于输入面内左侧；工作区与模式两枚 chip 同长，工作区名过长时省略，模式标签始终完整。
- 模型选单名称前的图标可在「Claude 主题 → 视图 → 显示模型图标」中开关，默认开启。
- 模型选择器支持搜索；effort 用滑杆，停在最后一档时实心填充换成一条像素流光。两者都可用键盘操作。
- 发送 / 停止是细线按钮，权限常显文字，上下文圆环在行末；输入面聚焦时边框加深。
- 上下文圆环点开分段面板：MCP 工具、系统工具、系统提示词、技能、记忆文件、对话消息、自动压缩余量与空闲空间，可逐项展开。

右侧栏

- 信息卡片外侧为阴影保留留白，聊天滚动条位于卡片右边，不再夹在聊天正文与卡片之间。
- 会话右侧优先显示「上下文 / 环境 / 会话用量」信息卡片，顶部终端按钮左侧的「会话栏」按钮控制开关，选中时与其他工具按钮一样显示蓝色底色，中间以竖线分隔；手动关闭会记住选择。卡片可折叠，拖动标题或卡片内容时整张卡片随指针移动，其余卡片让位，松开后保存顺序，Esc 取消；排序手柄也支持上下方向键。右侧栏收起时，可用聊天区域不足 900px 宽或 400px 高会自动关闭，恢复到 924×424px 后按开关选择重新显示；打开文件、终端或浏览器后，信息卡片改为浮在会话右上方，不再额外压缩正文，可继续用会话栏按钮开关。
- 环境卡读取实际会话工作目录、Git 分支及工作树状态（主工作树 / 独立工作树）。路径与其他字段均单行省略，悬停或键盘聚焦用黑色提示显示完整内容；若宿主还未加载环境接口，会明确提示完整退出并重新打开 DSH。会话用量展示输入 / 输出 token、缓存命中率、提示次数和输出 TPS；输入包含缓存读写，TPS 为整会话已结算输出的平均生成速度，每个模型步骤结束时更新。分叉会话包含继承历史，无有效数据时显示「—」。
- Files 与浏览器各占一张浮动卡片，多个终端共用一张并用标签切换；第三块开启右列，两列分隔线各自可拖，比例按会话保留。
- 卡片可放大到覆盖聊天区（保留左导航）／还原；最后一块关闭时收起右栏。
- Files 的文件树与预览左右分栏、树宽可拖；标题左侧蓝色清单按钮收起 / 展开文件树；过滤框按名字收窄已加载的行，Esc 清除。
- 浏览器带 Servers / Files / Settings 分组菜单与 Save screenshot；标题栏可直接输入服务地址并回车访问。

菜单与滚动条

- 工作区、会话、权限与模型等菜单共用紧凑行高、圆角与悬停反馈，浅色与深色一致。
- 滚动条平时不画：滚动时出现、停下约一秒淡出；五个页面级滚动面（会话页、转录列、侧栏树、文件树、智能体团队面板）用一条封顶的深色浮层胶囊。

主题与细节

- 跟随 DSH 的浅色、深色与系统主题。
- 可自定义会话与侧栏背景色（仅浅色模式），以及界面、界面中文与代码字体。
- 主页字符水波纹持续流动，点击空白处触发同款扩散。
- 输入卡旁的宠物可在小鲸鱼与 Claude 像素宠物之间切换：小鲸鱼点击随机喷水、弹跳或摆尾；Claude 宠物点击后取出笔记本电脑、敲键盘，再恢复站姿。
- 「Claude 主题 → 个性化」可独立选择宠物样式、输出中状态（原生鲸鱼或收缩扩散的 Claude 星芒与阶段文字）、回复签名（鲸鱼尾巴或 Claude 星芒）、首页问候与图标；首页保留「探索未知之境」，也可切换为橙色星芒图标与 “What’s up next?”，问候语跟随界面语言，不显示姓名。默认使用 Claude 宠物、输出状态、回复签名与首页问候。
- 用量统计卡片：概览 / 模型视图、时间范围、贡献热力图与模型图表。

配置

打开侧栏「主题」或「设置 → Claude 主题」，改动即时生效：

| 分组 | 可调项 |
| 模块 | 左侧栏、右侧栏（独立启停）、新建页、主页字符水波纹（默认开启）、聊天页、输入框小鲸鱼、统计卡片（默认开启）、状态栏统计读数（默认关闭）、上下文分解面板 |
| 外观 | 主题（浅色 / 深色 / 跟随系统）、会话背景色、侧栏背景色 |
| 视图 | 显示 API 余额（默认开启）；顶栏子代理入口、顶栏团队入口、顶栏后台任务入口、显示空分组（默认均关闭） |
| 字体 | 界面字体、代码与等宽字体；界面中文字体在设置页不列，需写进配置档的 cordis.patch.yml |

[!NOTE]
自定义背景色只作用于浅色模式，深色模式使用内置深色调色板。默认界面西文、中文与代码字体分别为 Anthropic Sans Web、Anthropic Serif Web 与 SF Mono，未安装时沿字体栈回退；仓库的 assets/fonts/ 提供本机安装用字体与 OFL 许可，字体不包含在 npm 包中。

环境要求

兼容目标为 DSH Desktop 0.2.1-rc.3，已验证 macOS（Apple 芯片）。Windows 10 及以上（64 位）的安装入口保留，新版宿主的 Windows 构建尚未完成验证。源码构建另需 Node.js ≥ 22.18.0。

反馈与许可

点击侧栏左下角账号旁的反馈按钮，填写描述后会打开预填好环境信息的 GitHub Issue；也可以直接通过 Issue 反馈问题，附上 DSH 版本、窗口尺寸和复现步骤。

MIT © 2026 zkforge。