dsh-claude-desktop-theme 0.4.2 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,101 +1,92 @@
1
1
  <div align="center">
2
2
 
3
- # DSH Claude Desktop Theme — Claude 风格桌面主题
3
+ # DSH Claude Desktop Theme
4
4
 
5
- ### 为 DeepSeek Harness(DSH)Desktop 换上 Claude Code Desktop 外观
5
+ 为 DeepSeek Harness(DSH)Desktop 换上 Claude Code Desktop 外观
6
6
 
7
7
  <p align="center">
8
- <img src="https://img.shields.io/badge/License-MIT-3DA639?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="License Badge"/>
9
- <img src="https://img.shields.io/badge/DSH-0.2.0--rc.2-4D6BFE?style=for-the-badge" alt="DSH Badge"/>
10
- <img src="https://img.shields.io/badge/Platform-macOS%20%7C%20Windows-0078D4?style=for-the-badge" alt="Platform Badge"/>
11
- <img src="https://img.shields.io/badge/TypeScript-7.0-3178C6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript Badge"/>
12
- <img src="https://img.shields.io/badge/Node.js-%E2%89%A522.18-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node Badge"/>
13
- <img src="https://img.shields.io/badge/Themes-Light%20%2F%20Dark-111827?style=for-the-badge" alt="Themes Badge"/>
8
+ <img src="https://img.shields.io/badge/License-MIT-3DA639?style=for-the-badge&logo=opensourceinitiative&logoColor=white" alt="License"/>
9
+ <img src="https://img.shields.io/npm/v/dsh-claude-desktop-theme?style=for-the-badge&color=4D6BFE&logo=npm&logoColor=white" alt="npm"/>
10
+ <img src="https://img.shields.io/badge/DSH-0.2.0--rc.2-4D6BFE?style=for-the-badge" alt="DSH"/>
11
+ <img src="https://img.shields.io/badge/Platform-macOS%20%7C%20Windows-0078D4?style=for-the-badge" alt="Platform"/>
14
12
  </p>
15
13
 
16
- ---
14
+ [安装](#快速安装) · [功能](#功能) · [界面预览](#界面预览) · [配置](#配置) · [架构](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/ARCHITECTURE.md) · [设计规范](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/DESIGN.md) · [安装指南](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/install.md) · [问题反馈](https://github.com/zkforge/dsh-claude-desktop-theme/issues)
17
15
 
18
- `dsh-claude-desktop-theme`是面向 macOS 与 Windows 的 **DSH Claude 风格主题 / 界面美化插件**。
16
+ </div>
19
17
 
20
- [安装指南](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/install.md) · [架构说明](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/ARCHITECTURE.md) · [设计规范](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/DESIGN.md) · [问题反馈](https://github.com/zkforge/dsh-claude-desktop-theme/issues)
18
+ <!-- 截图占位 · hero
19
+ 新会话页,浅色,1600px WebP:assets/screenshots/new-session-light.webp
20
+ 替换本段注释为一行居中 img,宽 1200,alt「新会话页」 -->
21
21
 
22
- </div>
22
+ ## 快速安装
23
23
 
24
- ## 🚀 快速安装
24
+ [npm 包](https://www.npmjs.com/package/dsh-claude-desktop-theme)已发布,两种入口任选其一:
25
25
 
26
- [npm 包](https://www.npmjs.com/package/dsh-claude-desktop-theme)已发布,可通过官方插件页或终端安装。
26
+ - **插件页**:「插件 → 添加插件」,输入 `dsh-claude-desktop-theme`
27
+ - **终端**:`dsh plugin --profile desktop add dsh-claude-desktop-theme`
27
28
 
28
- <div align="center">
29
+ 首次安装后插件自动开启,升级沿用已保存的配置。应用内安装无需注册 CLI;重载、应用内置 CLI 路径、旧包名迁移与源码安装见[安装指南](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/install.md)。
29
30
 
30
- | 入口 | 安装方式 |
31
- | --- | --- |
32
- | 官方插件页 | 「插件 → 添加插件」输入 `dsh-claude-desktop-theme` |
33
- | 终端 | `dsh plugin --profile desktop add dsh-claude-desktop-theme` |
34
- | 插件市场 | 待目录收录后可搜索安装;当前请使用上面两个入口 |
31
+ ## 功能
35
32
 
36
- </div>
33
+ ### 侧栏
37
34
 
38
- **终端**(需先注册 `dsh`)
35
+ - 新建会话 / 插件 / 例程三枚入口与工作区、会话列表、账号菜单共用紧凑行高,当前入口常驻底色。
36
+ - 会话条目尾部只有一枚 ⋮,菜单里是置顶、重命名、分叉与归档。
37
+ - 视图选项分状态、分组与排序、空分组三段。「按状态」把会话分为需要输入 / 进行中 / 已结束,状态变化时平滑移动,进行中的会话下显示子任务;项目分组与单列表仍然可选。
38
+ - 「对话 / 轨迹」切换器停在侧栏窗口控制行,以图标表示。
39
39
 
40
- ```sh
41
- dsh plugin --profile desktop add dsh-claude-desktop-theme
42
- ```
40
+ ### 会话页
43
41
 
44
- **插件页**:打开「插件 → 添加插件」,粘贴
42
+ - 新会话页、输入卡片与聊天页共用一套布局,正文边缘随滚动渐隐。
43
+ - 顶栏左侧是电脑图标与标题下拉(Open in、Rename、Fork、Transcript view、Output style、Archive、Delete);项目名以灰色标签显示,点击打开目录菜单。有宿主接口的动作接真实操作,其余点击说明限制。
44
+ - 顶栏右侧是项目文件夹、终端、浏览器三个右栏入口;展开右栏的动作在会话 ⋯ 菜单第一项。
45
+ - 整轮过程默认展开,「已完成,用时…」与步骤分组标题不再显示。
46
+ - Markdown 的链接、行内代码、表格与代码块按 CCD 风格重绘。
45
47
 
46
- ```text
47
- dsh-claude-desktop-theme
48
- ```
48
+ ### 输入框
49
49
 
50
- 首次安装后插件自动开启,升级沿用已保存的配置。应用内添加插件无需注册 CLI;安装后重载 DSH,具体步骤、应用内置 CLI 路径与源码安装见 [安装指南](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/install.md)。
50
+ - 加号位于输入面内左侧;工作区与模式两枚 chip 同长,工作区名过长时省略,模式标签始终完整。
51
+ - 模型选择器支持搜索;effort 用滑杆,停在最后一档时实心填充换成一条像素流光。两者都可用键盘操作。
52
+ - 发送 / 停止是细线按钮,权限常显文字,上下文圆环在行末;输入面聚焦时边框加深。
53
+ - 上下文圆环点开分段面板:MCP 工具、系统工具、系统提示词、技能、记忆文件、对话消息、自动压缩余量与空闲空间,可逐项展开。
51
54
 
52
- ## 🌟 核心特性
55
+ ### 右侧栏
53
56
 
54
- <div align="center">
57
+ - Files 与浏览器各占一张浮动卡片,多个终端共用一张并用标签切换;第三块开启右列,两列分隔线各自可拖,比例按会话保留。
58
+ - 卡片可放大到覆盖聊天区(保留左导航)/还原;最后一块关闭时收起右栏。
59
+ - Files 的文件树与预览左右分栏、树宽可拖;标题左侧蓝色清单按钮收起 / 展开文件树;过滤框按名字收窄已加载的行,Esc 清除。
60
+ - 浏览器带 Servers / Files / Settings 分组菜单与 Save screenshot;标题栏可直接输入服务地址并回车访问。
55
61
 
56
- <table>
57
- <tr>
58
- <td width="25%" align="center">
59
- <b>🧩 紧凑侧栏</b><br/>
60
- 导航、工作区与会话列表
61
- </td>
62
- <td width="25%" align="center">
63
- <b>💬 统一会话页</b><br/>
64
- 新会话页与聊天页同一套布局
65
- </td>
66
- <td width="25%" align="center">
67
- <b>🎛️ 模型与 effort</b><br/>
68
- 独立选择器,支持搜索与滑块
69
- </td>
70
- <td width="25%" align="center">
71
- <b>🐳 像素小鲸鱼</b><br/>
72
- 待机眨眼,点击随机回应
73
- </td>
74
- </tr>
75
- </table>
62
+ ### 菜单与滚动条
76
63
 
77
- </div>
64
+ - 工作区、会话、权限与模型等菜单共用紧凑行高、圆角与悬停反馈,浅色与深色一致。
65
+ - 滚动条平时不画:滚动时出现、停下约一秒淡出;五个页面级滚动面(会话页、转录列、侧栏树、文件树、智能体团队面板)用一条封顶的深色浮层胶囊。
66
+
67
+ ### 主题与细节
68
+
69
+ - 跟随 DSH 的浅色、深色与系统主题。
70
+ - 可自定义会话与侧栏背景色(仅浅色模式),以及界面、界面中文与代码字体。
71
+ - 主页字符水波纹持续流动,点击空白处触发同款扩散。
72
+ - 像素小鲸鱼停在输入卡旁:待机时眨眼摆尾,点击随机喷水、弹跳或摆尾。
73
+ - 用量统计卡片:概览 / 模型视图、时间范围、贡献热力图与模型图表。
78
74
 
79
- - **紧凑侧栏**:工作区导航与会话列表,浏览区只有一行表头——工作区名在左,新建会话、搜索与视图选项在右;新会话条目在第一次发送后出现。会话条目尾部只有一枚 ⋮,菜单里是置顶、重命名、分叉与归档。
80
- - **统一会话页**:新会话页、输入卡片与聊天布局共用一套样式,正文边缘随滚动渐隐。
81
- - **模型与 effort**:两个独立选择器,支持搜索、滑块和键盘操作;滑杆停在最后一档时,轨道上的实心填充换成一条像素流光。
82
- - **会话顶栏**:项目文件夹、终端、浏览器三个右侧栏入口;展开侧栏收进会话 ⋯ 菜单第一项。
83
- 标题左侧显示电脑图标,右侧下拉按参考提供 Open in、Rename、Fork、Transcript view、Output style、Archive、Delete;项目名以灰色标签显示,点击打开目录菜单。重命名、Fork、归档、对话/轨迹切换、宿主默认外部应用打开、复制目录路径/名称与打开终端接入真实操作。Show in Finder、Open repository on GitHub、Change folder、Output style 和 Delete 因 DSH 未提供相应公开接口或仓库信息,仅还原外观,点击显示具体限制说明;不会伪造删除或目录变更。
84
- - **右侧栏与 Files 页签**:Files、浏览器等视图各占一张卡,多个终端共用一张卡并通过标签页切换,加号新增真实终端;前两块上下排列,第三块开启右列;两列的上下分隔线独立可拖,关闭后同列补位,比例按会话保留。卡片可以放大到覆盖聊天区域(保留左导航)/还原,单视图标题为无交互文本,顶部按视频排列加号/搜索、⋮、展开与关闭,最后一块关闭时收起右侧栏。文件预览放在 Files 卡片内部,文件树与预览左右分栏;窄列无预览时优先显示完整文件树,放宽后显示空预览。支持拖动树宽、点击标题左侧蓝色清单按钮收起/展开文件树和切换已打开的文件;过滤框按名字收窄已加载的行,Esc 清除。
85
- 浏览器按参考提供 Servers/Files/Settings 分组菜单,以及单项 Save screenshot 菜单;桌面网页可保存 PNG,空页禁用。地球按钮右侧可直接输入服务地址并回车访问,dev 可聚焦地址框;启动服务器、本地文件直接浏览及三项配置暂时提供限制说明。独立窗口按钮暂时隐藏;浏览器元素选取保留按钮外观,点击说明 DSH 暂无接口;全目录搜索未接入,当前只过滤已加载文件。
86
- - **输入框与状态栏**:原生加号位于输入框内左侧,新会话的工作区选择行放在输入区与工具行下方。聚焦时加深输入边框;细线发送 / 停止按钮、模型、effort、权限与语音控件统一尺寸和间距,权限始终显示文字,上下文圆环位于行末。
87
- - **统一菜单**:工作区、会话、权限与模型等选单共用紧凑行高、圆角和悬停反馈,浅色与深色模式保持一致。
88
- - **顶栏入口**:子代理数量入口与智能体团队入口默认隐藏,可在「Claude 主题 → 视图」中分别开启;子代理运行、团队功能与侧栏子代理树保持可用。
89
- - **滚动条**:平时不画——滚动时出现、停下约一秒淡出,鼠标移到滚动条那条窄边上也会出现;五个页面级滚动面(会话页、转录列、侧栏树、文件树、智能体团队面板)改用一条封顶的深色浮层胶囊(长短不随内容变成整条高),轨道几何仍是宿主的(正文 5px、设置列 9px),宿主自己隐藏滚动条的几条横条保持原样。
90
- - **视图选项**:按参考图分成状态、分组与排序、空分组三段;「维度 + 当前值 + ›」的值行展开紧贴右侧的二级卡片。状态按活跃/已归档/全部命名,底部可一键清除筛选,并可开关空分组。分组方式新增「按状态」:需要输入/进行中/已结束,状态变化时平滑移动,进行中的会话下显示已加载的子任务;原有项目与单列表视图仍可选。
91
- - **主页字符水波纹**:固定的字符行上,多层不规则蓝色波带自主交错、增强并消退,安静时保留微弱纹理。点击主页空白处可触发同样不规则的扩散,连点只播放一次,结束后可再次触发;切入聊天、隐藏窗口或开启系统减少动态效果时停止。
92
- - **上下文分解面板**:点上下文圆环打开分段面板。收起态是标题行加一条 4px 分段条;点标题行展开成分类行(MCP 工具/系统工具/系统提示词/技能/记忆文件/对话消息/自动压缩余量/空闲空间)与可折叠的逐项分组(逐工具、逐指令文件、逐技能)。数字来自 DSH 的投影;每次打开时标题和各明细分组都默认收起,不显示估算差额,没有底部按钮。
93
- - **Markdown 排版**:链接、行内代码、表格与代码块按 CCD 风格重绘。
94
- - **像素小鲸鱼**:停在新会话页的输入卡旁,待机时眨眼与摆尾;点击随机喷一口水、轻弹眨眼或摆尾回应。
95
- - **主题跟随**:跟随 DSH 的浅色、深色和系统主题,支持自定义背景色与字体。
96
- - **用量统计卡片**:概览/模型视图、时间范围、贡献热力图与模型图表。
97
-
98
- ## 🐳 与小鲸鱼互动
75
+ ## 界面预览
76
+
77
+ 截图为 macOS、默认配色与 Geist 字体,统计卡片开启,状态栏统计读数保持默认关闭。小鲸鱼的点击回应与 Effort 拉到底的动效见下一节。
78
+
79
+ <!-- 截图占位 · 三行两列(浅色 / 深色),1600px WebP
80
+ 新会话页 assets/screenshots/new-session-light.webp assets/screenshots/new-session-dark.webp
81
+ 会话页 assets/screenshots/chat-light.webp assets/screenshots/chat-dark.webp
82
+ 插件设置 assets/screenshots/settings-light.webp assets/screenshots/settings-dark.webp
83
+ 替换本段注释为同名图片表格,行标题依次为:新会话页、会话页(含右侧栏)、插件设置 -->
84
+
85
+ <!-- 截图占位 · 补充两张单图
86
+ 上下文分解面板:assets/screenshots/context-panel-light.webp
87
+ 视图选项卡片: assets/screenshots/view-options-light.webp -->
88
+
89
+ ## 细节动效
99
90
 
100
91
  <div align="center">
101
92
 
@@ -119,102 +110,49 @@ dsh-claude-desktop-theme
119
110
  </tr>
120
111
  </table>
121
112
 
122
- </div>
123
-
124
- ## 🎚️ Effort 选单
125
-
126
- <div align="center">
127
-
128
113
  <table>
129
114
  <tr>
130
115
  <td width="50%" align="center">
131
116
  <img src="https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/effort/effort-light.gif" width="260" alt="浅色 Effort 面板:滑杆停在 Max,实心填充淡出,像素流光从右端扫入并在轨道上持续流动"><br/>
132
- <b>浅色</b>
117
+ <b>Effort 拉到底 · 浅色</b>
133
118
  </td>
134
119
  <td width="50%" align="center">
135
120
  <img src="https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/effort/effort-dark.gif" width="260" alt="深色 Effort 面板:同一条像素流光,亮紫像素落在深色轨道上"><br/>
136
- <b>深色</b>
121
+ <b>Effort 拉到底 · 深色</b>
137
122
  </td>
138
123
  </tr>
139
124
  </table>
140
125
 
141
126
  </div>
142
127
 
143
- ## 🖼️ 界面预览
144
-
145
- 截图为 macOS 版本,使用默认配色与 Geist 字体,统计卡片已开启,状态栏统计读数保持默认关闭。新会话页展示像素小鲸鱼与统计卡片,聊天页展示 Markdown 表格与代码高亮;插件设置两图分别展示模块开关,以及主题、背景色、视图与字体。小鲸鱼的三种点击回应与 Effort 拉到底的动效见上方。
146
-
147
- <div align="center">
148
-
149
- | | 浅色 | 深色 |
150
- | --- | --- | --- |
151
- | 新会话页 | ![新会话页浅色:工作区与模式选择、像素小鲸鱼和统计卡片](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/new-session-light.png) | ![新会话页深色:工作区与模式选择、像素小鲸鱼和统计卡片](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/new-session-dark.png) |
152
- | 聊天页 | ![聊天页浅色:Markdown 表格、对齐示例与 Python 代码高亮](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/chat-light.png) | ![聊天页深色:Markdown 表格、对齐示例与 Python 代码高亮](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/chat-dark.png) |
153
- | 插件设置 | ![插件设置浅色:启用 CCD 风格界面与模块开关](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/settings-light.png) | ![插件设置深色:上下文分解面板、主题、背景色、空分组与字体](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/settings-dark.png) |
154
-
155
- </div>
156
-
157
- ## ⚙️ 配置
128
+ ## 配置
158
129
 
159
- 打开「插件 → dsh-claude-desktop-theme」,调整总开关、模块、主题、颜色和字体。改动即时生效。
160
-
161
- <div align="center">
130
+ 打开「设置 → Claude 主题」,改动即时生效:
162
131
 
163
132
  | 分组 | 可调项 |
164
133
  | --- | --- |
165
134
  | 模块 | 窗口与分栏骨架、侧栏、新建页、聊天页、输入框小鲸鱼、统计卡片、状态栏统计读数、上下文分解面板 |
166
135
  | 外观 | 主题(浅色 / 深色 / 跟随系统)、会话背景色、侧栏背景色 |
167
- | 字体 | 界面字体、代码与等宽字体 |
168
-
169
- </div>
136
+ | 视图 | 顶栏子代理入口、顶栏团队入口(默认关闭)、显示空分组(默认关闭) |
137
+ | 字体 | 界面字体、代码与等宽字体;界面中文字体在设置页不列,需写进 profile 的 `cordis.patch.yml` |
170
138
 
171
139
  > [!NOTE]
172
140
  > 自定义背景色只作用于浅色模式,深色模式使用内置深色调色板。界面默认使用 Geist,未安装时回退系统字体;仓库的 `assets/fonts/` 提供本机安装用字体与 OFL 许可,字体不包含在 npm 包中。
173
141
 
174
- ## 🛠️ 环境要求
175
-
176
- <div align="center">
142
+ ## 已知限制
177
143
 
178
- | 项目 | 要求 |
179
- | --- | --- |
180
- | 宿主 | DSH `0.2.0-rc.2` |
181
- | 平台 | macOS(Apple 芯片)、Windows 10 及以上(64 位) |
182
- | 主题 | 浅色、深色与跟随系统 |
183
- | 开发环境 | Node.js ≥ 22.18.0 |
144
+ 插件只走宿主公开接口与样式层,不改宿主组件。少数条目还原了外观,但 DSH 尚未提供对应接口,点击时会说明限制,不会伪造状态:
184
145
 
185
- </div>
146
+ - 会话顶栏的 Show in Finder、Open repository on GitHub、Change folder、Output style 与 Delete。
147
+ - 浏览器面板的启动服务器、本地文件浏览、独立窗口与页面元素选取;Files 的全目录搜索。
186
148
 
187
- ## 🧑‍💻 开发
149
+ 完整清单见[已知限制](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/docs/limitations.md)。插件市场目录尚未收录,请通过插件页或终端安装。
188
150
 
189
- ```sh
190
- npm ci --cache .cache/npm
191
- npm run check
192
- npm run pack:local --cache .cache/npm
193
- ```
151
+ ## 环境要求
194
152
 
195
- `npm run check` 依次执行类型检查、模块边界与文档链接检查、测试、构建和包内容校验。本机有 Chrome 时,测试还会在真实浏览器中验证视图选项二级菜单的鼠标命中、跨菜单间隙与键盘操作,以及上下文分解面板的两态、锚定几何、分段间隙与浅深配色;没有 Chrome 时跳过这一项,可用 `CHROME` 指定浏览器路径。
153
+ DSH `0.2.0-rc.2`;macOS(Apple 芯片)或 Windows 10 及以上(64 位)。源码构建另需 Node.js ≥ 22.18.0。
196
154
 
197
- <details>
198
- <summary><b>全部脚本</b></summary>
199
-
200
- | 脚本 | 作用 |
201
- | --- | --- |
202
- | `npm run typecheck` | TypeScript 类型检查 |
203
- | `npm run check:architecture` | 模块边界、颜色归属与本地文档链接 |
204
- | `npm test` | 配置、生命周期、布局适配与统计行为测试 |
205
- | `npm run build` | 构建 Host 与 Client 产物 |
206
- | `npm run check:package` | 校验 npm 安装包内容 |
207
- | `npm run check` | 依次执行以上全部 |
208
- | `npm run dev` | 客户端增量构建 |
209
- | `npm run pack:local` | 生成用于本地安装的 tarball |
210
- | `npm run pet:gifs` | 重新渲染 README 里小鲸鱼的三个动图(需已安装 Chrome 与 ffmpeg) |
211
- | `npm run effort:gifs` | 重新渲染 README 里 Effort 拉到底的深浅两个动图(同上) |
212
-
213
- </details>
214
-
215
- 代码结构见 [ARCHITECTURE.md](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/ARCHITECTURE.md)。
216
-
217
- ## 📮 反馈与许可
155
+ ## 反馈与许可
218
156
 
219
157
  通过 [Issue](https://github.com/zkforge/dsh-claude-desktop-theme/issues) 反馈问题,附上 DSH 版本、窗口尺寸和复现步骤。
220
158