DSH Claude Desktop Theme — Claude 风格桌面主题
为 DeepSeek Harness（DSH）Desktop 换上 Claude Code Desktop 外观
dsh-claude-desktop-theme是面向 macOS 与 Windows 的 DSH Claude 风格主题 / 界面美化插件。
安装指南 · 架构说明 · 设计规范 · 问题反馈
🚀 快速安装
npm 包已发布，可通过官方插件页或终端安装。
| 入口 | 安装方式 |
|---|
| 官方插件页 | 「插件 → 添加插件」输入 dsh-claude-desktop-theme |
| 终端 | dsh plugin --profile desktop add dsh-claude-desktop-theme |
| 插件市场 | 待目录收录后可搜索安装；当前请使用上面两个入口 |
终端（需先注册 dsh）
dsh plugin --profile desktop add dsh-claude-desktop-theme
插件页：打开「插件 → 添加插件」，粘贴
dsh-claude-desktop-theme
首次安装后插件自动开启，升级沿用已保存的配置。应用内添加插件无需注册 CLI；安装后重载 DSH，具体步骤、应用内置 CLI 路径与源码安装见 安装指南。
🌟 核心特性
🧩 紧凑侧栏
导航、工作区与会话列表
|
💬 统一会话页
新会话页与聊天页同一套布局
|
🎛️ 模型与 effort
独立选择器，支持搜索与滑块
|
🐳 像素小鲸鱼
待机眨眼，点击随机回应
|
- 紧凑侧栏：工作区导航与会话列表，浏览区只有一行表头——工作区名在左，新建会话、搜索与视图选项在右；新会话条目在第一次发送后出现。会话条目尾部只有一枚 ⋮，菜单里是置顶、重命名、分叉与归档。
- 统一会话页：新会话页、输入卡片与聊天布局共用一套样式，正文边缘随滚动渐隐。
- 模型与 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 包中。
🛠️ 环境要求
| 项目 | 要求 |
|---|
| 宿主 | DSH 0.2.0-rc.2 |
| 平台 | macOS（Apple 芯片）、Windows 10 及以上（64 位） |
| 主题 | 浅色、深色与跟随系统 |
| 开发环境 | Node.js ≥ 22.18.0 |
🧑💻 开发
npm ci --cache .cache/npm
npm run check
npm run pack:local --cache .cache/npm
npm run check 依次执行类型检查、模块边界与文档链接检查、测试、构建和包内容校验。本机有 Chrome 时，测试还会在真实浏览器中验证视图选项二级菜单的鼠标命中、跨菜单间隙与键盘操作，以及上下文分解面板的两态、锚定几何、分段间隙与浅深配色；没有 Chrome 时跳过这一项，可用 CHROME 指定浏览器路径。
全部脚本
| 脚本 | 作用 |
|---|
npm run typecheck | TypeScript 类型检查 |
npm run check:architecture | 模块边界、颜色归属与本地文档链接 |
npm test | 配置、生命周期、布局适配与统计行为测试 |
npm run build | 构建 Host 与 Client 产物 |
npm run check:package | 校验 npm 安装包内容 |
npm run check | 依次执行以上全部 |
npm run dev | 客户端增量构建 |
npm run pack:local | 生成用于本地安装的 tarball |
npm run pet:gifs | 重新渲染 README 里小鲸鱼的三个动图（需已安装 Chrome 与 ffmpeg） |
npm run effort:gifs | 重新渲染 README 里 Effort 拉到底的深浅两个动图（同上） |
代码结构见 ARCHITECTURE.md。
📮 反馈与许可
通过 Issue 反馈问题，附上 DSH 版本、窗口尺寸和复现步骤。
MIT © 2026 zkforge。
