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 +78 -140
- package/lib/client.js +1931 -400
- package/lib/index.js +38 -17
- package/lib/types/client/compat/conversation-process.d.ts +8 -0
- package/lib/types/client/compat/frame.d.ts +29 -0
- package/lib/types/client/compat/hero-chips.d.ts +9 -0
- package/lib/types/client/compat/host-dom.d.ts +6 -0
- package/lib/types/client/compat/mutation-scope.d.ts +43 -0
- package/lib/types/client/compat/pane-chrome.d.ts +2 -0
- package/lib/types/client/compat/reply-signature.d.ts +6 -0
- package/lib/types/client/compat/view-switch.d.ts +1 -1
- package/lib/types/client/contracts/ports.d.ts +2 -0
- package/lib/types/client/features/conversation/header-actions/HeaderActionButton.d.ts +2 -2
- package/lib/types/client/features/conversation/header-actions/entries.d.ts +11 -15
- package/lib/types/client/features/conversation/view-switch-icons.d.ts +2 -2
- package/lib/types/client/features/model-controls/popup.d.ts +20 -0
- package/lib/types/client/features/new-session/ripples.d.ts +2 -2
- package/lib/types/client/features/statistics/source.d.ts +2 -1
- package/package.json +1 -2
package/README.md
CHANGED
|
@@ -1,101 +1,92 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
# DSH Claude Desktop Theme
|
|
3
|
+
# DSH Claude Desktop Theme
|
|
4
4
|
|
|
5
|
-
|
|
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
|
|
9
|
-
<img src="https://img.shields.io/
|
|
10
|
-
<img src="https://img.shields.io/badge/
|
|
11
|
-
<img src="https://img.shields.io/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
|
-
|
|
16
|
+
</div>
|
|
19
17
|
|
|
20
|
-
|
|
18
|
+
<!-- 截图占位 · hero
|
|
19
|
+
新会话页,浅色,1600px WebP:assets/screenshots/new-session-light.webp
|
|
20
|
+
替换本段注释为一行居中 img,宽 1200,alt「新会话页」 -->
|
|
21
21
|
|
|
22
|
-
|
|
22
|
+
## 快速安装
|
|
23
23
|
|
|
24
|
-
|
|
24
|
+
[npm 包](https://www.npmjs.com/package/dsh-claude-desktop-theme)已发布,两种入口任选其一:
|
|
25
25
|
|
|
26
|
-
|
|
26
|
+
- **插件页**:「插件 → 添加插件」,输入 `dsh-claude-desktop-theme`
|
|
27
|
+
- **终端**:`dsh plugin --profile desktop add dsh-claude-desktop-theme`
|
|
27
28
|
|
|
28
|
-
|
|
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
|
-
|
|
33
|
+
### 侧栏
|
|
37
34
|
|
|
38
|
-
|
|
35
|
+
- 新建会话 / 插件 / 例程三枚入口与工作区、会话列表、账号菜单共用紧凑行高,当前入口常驻底色。
|
|
36
|
+
- 会话条目尾部只有一枚 ⋮,菜单里是置顶、重命名、分叉与归档。
|
|
37
|
+
- 视图选项分状态、分组与排序、空分组三段。「按状态」把会话分为需要输入 / 进行中 / 已结束,状态变化时平滑移动,进行中的会话下显示子任务;项目分组与单列表仍然可选。
|
|
38
|
+
- 「对话 / 轨迹」切换器停在侧栏窗口控制行,以图标表示。
|
|
39
39
|
|
|
40
|
-
|
|
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
|
-
|
|
47
|
-
dsh-claude-desktop-theme
|
|
48
|
-
```
|
|
48
|
+
### 输入框
|
|
49
49
|
|
|
50
|
-
|
|
50
|
+
- 加号位于输入面内左侧;工作区与模式两枚 chip 同长,工作区名过长时省略,模式标签始终完整。
|
|
51
|
+
- 模型选择器支持搜索;effort 用滑杆,停在最后一档时实心填充换成一条像素流光。两者都可用键盘操作。
|
|
52
|
+
- 发送 / 停止是细线按钮,权限常显文字,上下文圆环在行末;输入面聚焦时边框加深。
|
|
53
|
+
- 上下文圆环点开分段面板:MCP 工具、系统工具、系统提示词、技能、记忆文件、对话消息、自动压缩余量与空闲空间,可逐项展开。
|
|
51
54
|
|
|
52
|
-
|
|
55
|
+
### 右侧栏
|
|
53
56
|
|
|
54
|
-
|
|
57
|
+
- Files 与浏览器各占一张浮动卡片,多个终端共用一张并用标签切换;第三块开启右列,两列分隔线各自可拖,比例按会话保留。
|
|
58
|
+
- 卡片可放大到覆盖聊天区(保留左导航)/还原;最后一块关闭时收起右栏。
|
|
59
|
+
- Files 的文件树与预览左右分栏、树宽可拖;标题左侧蓝色清单按钮收起 / 展开文件树;过滤框按名字收窄已加载的行,Esc 清除。
|
|
60
|
+
- 浏览器带 Servers / Files / Settings 分组菜单与 Save screenshot;标题栏可直接输入服务地址并回车访问。
|
|
55
61
|
|
|
56
|
-
|
|
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
|
-
|
|
64
|
+
- 工作区、会话、权限与模型等菜单共用紧凑行高、圆角与悬停反馈,浅色与深色一致。
|
|
65
|
+
- 滚动条平时不画:滚动时出现、停下约一秒淡出;五个页面级滚动面(会话页、转录列、侧栏树、文件树、智能体团队面板)用一条封顶的深色浮层胶囊。
|
|
66
|
+
|
|
67
|
+
### 主题与细节
|
|
68
|
+
|
|
69
|
+
- 跟随 DSH 的浅色、深色与系统主题。
|
|
70
|
+
- 可自定义会话与侧栏背景色(仅浅色模式),以及界面、界面中文与代码字体。
|
|
71
|
+
- 主页字符水波纹持续流动,点击空白处触发同款扩散。
|
|
72
|
+
- 像素小鲸鱼停在输入卡旁:待机时眨眼摆尾,点击随机喷水、弹跳或摆尾。
|
|
73
|
+
- 用量统计卡片:概览 / 模型视图、时间范围、贡献热力图与模型图表。
|
|
78
74
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
-
|
|
85
|
-
|
|
86
|
-
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
-
|
|
91
|
-
-
|
|
92
|
-
|
|
93
|
-
|
|
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
|
|
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
|
|
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
|
-
| 新会话页 |  |  |
|
|
152
|
-
| 聊天页 |  |  |
|
|
153
|
-
| 插件设置 |  |  |
|
|
154
|
-
|
|
155
|
-
</div>
|
|
156
|
-
|
|
157
|
-
## ⚙️ 配置
|
|
128
|
+
## 配置
|
|
158
129
|
|
|
159
|
-
|
|
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
|
-
|
|
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
|
-
|
|
190
|
-
npm ci --cache .cache/npm
|
|
191
|
-
npm run check
|
|
192
|
-
npm run pack:local --cache .cache/npm
|
|
193
|
-
```
|
|
151
|
+
## 环境要求
|
|
194
152
|
|
|
195
|
-
`
|
|
153
|
+
DSH `0.2.0-rc.2`;macOS(Apple 芯片)或 Windows 10 及以上(64 位)。源码构建另需 Node.js ≥ 22.18.0。
|
|
196
154
|
|
|
197
|
-
|
|
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
|
|