dsh-claude-desktop-theme 0.4.3 → 0.4.5

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.
Files changed (37) hide show
  1. package/README.md +95 -140
  2. package/lib/client.js +9036 -812
  3. package/lib/index.js +56 -19
  4. package/lib/types/client/compat/browser-header.d.ts +1 -2
  5. package/lib/types/client/compat/frame.d.ts +29 -0
  6. package/lib/types/client/compat/hero-greeting.d.ts +6 -0
  7. package/lib/types/client/compat/host-dom.d.ts +8 -0
  8. package/lib/types/client/compat/mutation-scope.d.ts +43 -0
  9. package/lib/types/client/compat/pane-chrome.d.ts +2 -0
  10. package/lib/types/client/compat/permission-confirmation.d.ts +5 -0
  11. package/lib/types/client/compat/permission-menu.d.ts +4 -1
  12. package/lib/types/client/compat/pet-anchor.d.ts +5 -1
  13. package/lib/types/client/compat/sidebar-search.d.ts +18 -0
  14. package/lib/types/client/compat/view-switch.d.ts +1 -1
  15. package/lib/types/client/contracts/ports.d.ts +2 -0
  16. package/lib/types/client/features/composer-pet/BlankPet.d.ts +4 -1
  17. package/lib/types/client/features/composer-pet/ClaudePet.d.ts +7 -0
  18. package/lib/types/client/features/composer-pet/claude-frames.d.ts +12 -0
  19. package/lib/types/client/features/composer-pet/claude-motion.d.ts +3 -0
  20. package/lib/types/client/features/conversation/header-actions/HeaderActionButton.d.ts +2 -2
  21. package/lib/types/client/features/conversation/header-actions/entries.d.ts +11 -15
  22. package/lib/types/client/features/conversation/view-switch-icons.d.ts +2 -2
  23. package/lib/types/client/features/model-controls/EffortPanel.d.ts +2 -1
  24. package/lib/types/client/features/model-controls/ModelControls.d.ts +11 -1
  25. package/lib/types/client/features/model-controls/model-icon-data.d.ts +31 -0
  26. package/lib/types/client/features/model-controls/model-icon-match.d.ts +20 -0
  27. package/lib/types/client/features/model-controls/model-icons.d.ts +13 -0
  28. package/lib/types/client/features/model-controls/popup.d.ts +20 -0
  29. package/lib/types/client/features/model-controls/selection.d.ts +2 -0
  30. package/lib/types/client/features/new-session/ripples.d.ts +2 -2
  31. package/lib/types/client/features/settings/ChoiceMenu.d.ts +15 -0
  32. package/lib/types/client/features/settings/fields.d.ts +18 -0
  33. package/lib/types/client/features/settings/locales.d.ts +16 -1
  34. package/lib/types/client/features/statistics/source.d.ts +2 -1
  35. package/lib/types/host/index.d.ts +30 -0
  36. package/lib/types/shared/config.d.ts +11 -2
  37. package/package.json +2 -1
package/README.md CHANGED
@@ -1,220 +1,175 @@
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-latest-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
- ---
17
-
18
- `dsh-claude-desktop-theme`是面向 macOS 与 Windows 的 **DSH Claude 风格主题 / 界面美化插件**。
19
-
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)
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)
21
15
 
22
16
  </div>
23
17
 
24
- ## 🚀 快速安装
18
+ <p align="center">
19
+ <img src="https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/fullscreen-light.webp" width="1200" alt="新会话页:浅色主题、Claude 像素宠物、用量统计与字符水波纹">
20
+ </p>
25
21
 
26
- [npm 包](https://www.npmjs.com/package/dsh-claude-desktop-theme)已发布,可通过官方插件页或终端安装。
22
+ ## 快速安装
27
23
 
28
- <div align="center">
24
+ [npm 包](https://www.npmjs.com/package/dsh-claude-desktop-theme)已发布,两种入口任选其一:
29
25
 
30
- | 入口 | 安装方式 |
31
- | --- | --- |
32
- | 官方插件页 | 「插件 → 添加插件」输入 `dsh-claude-desktop-theme` |
33
- | 终端 | `dsh plugin --profile desktop add dsh-claude-desktop-theme` |
34
- | 插件市场 | 待目录收录后可搜索安装;当前请使用上面两个入口 |
26
+ - **插件页**:「插件 → 添加插件」,输入 `dsh-claude-desktop-theme`
27
+ - **终端**:`dsh plugin --profile desktop add dsh-claude-desktop-theme`
35
28
 
36
- </div>
29
+ 源码安装见[安装指南](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/install.md)。
37
30
 
38
- **终端**(需先注册 `dsh`)
39
31
 
40
- ```sh
41
- dsh plugin --profile desktop add dsh-claude-desktop-theme
42
- ```
32
+ ## 界面预览
43
33
 
44
- **插件页**:打开「插件 → 添加插件」,粘贴
34
+ 截图为 macOS、默认配色与 Geist 字体,统计卡片开启,状态栏统计读数保持默认关闭。两种宠物的点击回应与 Effort 拉到底的动效见下一节。
45
35
 
46
- ```text
47
- dsh-claude-desktop-theme
48
- ```
36
+ | 界面 | 浅色 | 深色 |
37
+ | --- | --- | --- |
38
+ | 新会话页 | ![新会话页 · 浅色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/new-session-light.webp) | ![新会话页 · 深色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/new-session-dark.webp) |
39
+ | 会话页 | ![会话页 · 浅色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/chat-light.webp) | ![会话页 · 深色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/chat-dark.webp) |
40
+ | 插件设置 | ![插件设置 · 浅色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/settings-light.webp) | ![插件设置 · 深色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/settings-dark.webp) |
49
41
 
50
- 首次安装后插件自动开启,升级沿用已保存的配置。应用内添加插件无需注册 CLI;安装后重载 DSH,具体步骤、应用内置 CLI 路径与源码安装见 [安装指南](https://github.com/zkforge/dsh-claude-desktop-theme/blob/main/install.md)。
42
+ ### 完整窗口展示
51
43
 
52
- ## 🌟 核心特性
44
+ 以下为 macOS 完整窗口截图,使用 Claude 像素宠物与首页问候样式,开启主页水波纹,保留统计卡片。
53
45
 
54
- <div align="center">
46
+ | 界面 | 浅色 | 深色 |
47
+ | --- | --- | --- |
48
+ | 新会话页 · 完整窗口 | ![新会话页完整窗口 · 浅色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/fullscreen-light.webp) | ![新会话页完整窗口 · 深色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/fullscreen-dark.webp) |
49
+ | 模型选单展开 · 完整窗口 | ![模型选单完整窗口 · 浅色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/model-menu-fullscreen-light.webp) | ![模型选单完整窗口 · 深色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/model-menu-fullscreen-dark.webp) |
55
50
 
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>
51
+ ### 组件特写
76
52
 
77
- </div>
53
+ | 组件 | 浅色 | 深色 |
54
+ | --- | --- | --- |
55
+ | 模型选择器 | ![模型选择器 · 浅色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/model-picker-light.webp) | ![模型选择器 · 深色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/model-picker-dark.webp) |
56
+ | 上下文圆环与分解面板 | ![上下文圆环与分解面板 · 浅色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/context-panel-light.webp) | ![上下文圆环与分解面板 · 深色](https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/screenshots/context-panel-dark.webp) |
78
57
 
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
- - **输入框与状态栏**:原生加号位于输入框内左侧,新会话的工作区选择行放在输入区与工具行下方,行里两枚 chip(工作区与模式)同长:模式标签完整,工作区名过长时接省略号。聚焦时加深输入边框;细线发送 / 停止按钮、模型、effort、权限与语音控件统一尺寸和间距,权限始终显示文字,上下文圆环位于行末。
87
- - **统一菜单**:工作区、会话、权限与模型等选单共用紧凑行高、圆角和悬停反馈,浅色与深色模式保持一致。
88
- - **顶栏入口**:子代理数量入口与智能体团队入口默认隐藏,可在「Claude 主题 → 视图」中分别开启;子代理运行、团队功能与侧栏子代理树保持可用。
89
- - **滚动条**:平时不画——滚动时出现、停下约一秒淡出,鼠标移到滚动条那条窄边上也会出现;五个页面级滚动面(会话页、转录列、侧栏树、文件树、智能体团队面板)改用一条封顶的深色浮层胶囊(长短不随内容变成整条高),轨道几何仍是宿主的(正文 5px、设置列 9px),宿主自己隐藏滚动条的几条横条保持原样。
90
- - **视图选项**:按参考图分成状态、分组与排序、空分组三段;「维度 + 当前值 + ›」的值行展开紧贴右侧的二级卡片。状态按活跃/已归档/全部命名,底部可一键清除筛选,并可开关空分组。分组方式新增「按状态」:需要输入/进行中/已结束,状态变化时平滑移动,进行中的会话下显示已加载的子任务;原有项目与单列表视图仍可选。
91
- - **主页字符水波纹**:固定的字符行上,多层不规则蓝色波带持续流动交错,亮度轻微起伏,深浅主题使用相同的明亮蓝色。点击主页空白处可触发同样不规则的扩散,连点只播放一次,结束后可再次触发;切入聊天、隐藏窗口或开启系统减少动态效果时停止。
92
- - **上下文分解面板**:点上下文圆环打开分段面板。收起态是标题行加一条 4px 分段条;点标题行展开成分类行(MCP 工具/系统工具/系统提示词/技能/记忆文件/对话消息/自动压缩余量/空闲空间)与可折叠的逐项分组(逐工具、逐指令文件、逐技能)。数字来自 DSH 的投影;每次打开时标题和各明细分组都默认收起,不显示估算差额,没有底部按钮。
93
- - **Markdown 排版**:链接、行内代码、表格与代码块按 CCD 风格重绘。
94
- - **像素小鲸鱼**:停在新会话页的输入卡旁,待机时眨眼与摆尾;点击随机喷一口水、轻弹眨眼或摆尾回应。
95
- - **主题跟随**:跟随 DSH 的浅色、深色和系统主题,支持自定义背景色与字体。
96
- - **用量统计卡片**:概览/模型视图、时间范围、贡献热力图与模型图表。
97
-
98
- ## 🐳 与小鲸鱼互动
58
+ 模型选择器与上下文分解面板均为组件局部截图,使用演示数据。模型选择器展示供应商分组、模型图标与当前选中项,可选模型和 Effort 档位以 DSH 实际提供的目录为准;上下文面板展示分类占比与展开的 MCP 工具明细,右下角保留用量圆环入口。
59
+
60
+ ## 细节动效
99
61
 
100
62
  <div align="center">
101
63
 
102
64
  <table>
103
65
  <tr>
104
- <td width="33%" align="center">
66
+ <td width="25%" align="center">
105
67
  <img src="https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/pet/pet-spout.gif" width="150" alt="喷一口水:身体轻晃、闭眼,从头顶喷出水柱,水滴向两侧散开落下"><br/>
106
68
  <b>喷一口水</b><br/>
107
69
  身体轻晃、闭眼,从头顶喷出水柱,水滴向两侧散开落下
108
70
  </td>
109
- <td width="33%" align="center">
71
+ <td width="25%" align="center">
110
72
  <img src="https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/pet/pet-hop.gif" width="150" alt="轻弹眨眼:蓄力、向上轻跳、落地回弹并眨眼"><br/>
111
73
  <b>轻弹眨眼</b><br/>
112
74
  蓄力、向上轻跳、落地回弹并眨眼
113
75
  </td>
114
- <td width="33%" align="center">
76
+ <td width="25%" align="center">
115
77
  <img src="https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/pet/pet-wag.gif" width="150" alt="摆尾回应:身体左右轻晃,尾巴与胸鳍摆动并眨眼"><br/>
116
78
  <b>摆尾回应</b><br/>
117
79
  身体左右轻晃,尾巴与胸鳍摆动并眨眼
118
80
  </td>
81
+ <td width="25%" align="center">
82
+ <img src="https://raw.githubusercontent.com/zkforge/dsh-claude-desktop-theme/main/assets/pet/pet-claude.gif" width="150" alt="Claude 像素宠物:取出笔记本电脑、敲键盘,再收起电脑恢复站姿"><br/>
83
+ <b>Claude 像素宠物</b><br/>
84
+ 取出笔记本电脑、敲键盘,再恢复站姿
85
+ </td>
119
86
  </tr>
120
87
  </table>
121
88
 
122
- </div>
123
-
124
- ## 🎚️ Effort 选单
125
-
126
- <div align="center">
89
+ <p>在「设置 → Claude 主题 → 个性化 → 宠物样式」中切换小鲸鱼或 Claude 像素宠物,点击宠物即可播放动作。</p>
127
90
 
128
91
  <table>
129
92
  <tr>
130
93
  <td width="50%" align="center">
131
94
  <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>
95
+ <b>Effort 拉到底 · 浅色</b>
133
96
  </td>
134
97
  <td width="50%" align="center">
135
98
  <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>
99
+ <b>Effort 拉到底 · 深色</b>
137
100
  </td>
138
101
  </tr>
139
102
  </table>
140
103
 
141
104
  </div>
142
105
 
143
- ## 🖼️ 界面预览
106
+ ## 功能
144
107
 
145
- 截图为 macOS 版本,使用默认配色与 Geist 字体,统计卡片已开启,状态栏统计读数保持默认关闭。新会话页展示像素小鲸鱼与统计卡片,聊天页展示 Markdown 表格与代码高亮;插件设置两图分别展示模块开关,以及主题、背景色、视图与字体。小鲸鱼的三种点击回应与 Effort 拉到底的动效见上方。
108
+ ### 侧栏
146
109
 
147
- <div align="center">
110
+ - DeepSeek Harness 品牌条目默认隐藏,可在「设置 → Claude 主题 → 视图」开启显示。
111
+ - 新建 / 插件 / 例程三枚入口与工作区、会话列表、账号菜单共用紧凑行高,当前入口常驻底色。
112
+ - 会话搜索框与导航行同宽同高,位于「新建」上方;原位置改为左侧「最近会话」标题和右侧筛选视图按钮。
113
+ - 会话条目尾部只有一枚 ⋮,菜单里是置顶、重命名、分叉与归档。
114
+ - 视图选项分状态、分组与排序、空分组三段。「按状态」把会话分为需要输入 / 进行中 / 已结束,状态变化时平滑移动,进行中的会话下显示子任务;项目分组与单列表仍然可选。
115
+ - 「对话 / 轨迹」切换器停在侧栏窗口控制行,以图标表示。
148
116
 
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) |
117
+ ### 会话页
154
118
 
155
- </div>
119
+ - 新会话页、输入卡片与聊天页共用一套布局,正文边缘随滚动渐隐。
120
+ - 顶栏左侧是电脑图标与标题下拉(Open in、Rename、Fork、Transcript view、Output style、Archive、Delete);项目名以灰色标签显示,点击打开目录菜单。有宿主接口的动作接真实操作,其余点击说明限制。
121
+ - 顶栏右侧是项目文件夹、终端、浏览器三个右栏入口;展开右栏的动作在会话 ⋯ 菜单第一项。
122
+ - 整轮过程默认展开,「已完成,用时…」与步骤分组标题不再显示。
123
+ - Markdown 的链接、行内代码、表格与代码块按 CCD 风格重绘。
156
124
 
157
- ## ⚙️ 配置
125
+ ### 输入框
158
126
 
159
- 打开「插件 → dsh-claude-desktop-theme」,调整总开关、模块、主题、颜色和字体。改动即时生效。
127
+ - 加号位于输入面内左侧;工作区与模式两枚 chip 同长,工作区名过长时省略,模式标签始终完整。
128
+ - 模型选单名称前的图标可在「Claude 主题 → 视图 → 显示模型图标」中开关,默认开启。
129
+ - 模型选择器支持搜索;effort 用滑杆,停在最后一档时实心填充换成一条像素流光。两者都可用键盘操作。
130
+ - 发送 / 停止是细线按钮,权限常显文字,上下文圆环在行末;输入面聚焦时边框加深。
131
+ - 上下文圆环点开分段面板:MCP 工具、系统工具、系统提示词、技能、记忆文件、对话消息、自动压缩余量与空闲空间,可逐项展开。
160
132
 
161
- <div align="center">
133
+ ### 右侧栏
162
134
 
163
- | 分组 | 可调项 |
164
- | --- | --- |
165
- | 模块 | 窗口与分栏骨架、侧栏、新建页、聊天页、输入框小鲸鱼、统计卡片、状态栏统计读数、上下文分解面板 |
166
- | 外观 | 主题(浅色 / 深色 / 跟随系统)、会话背景色、侧栏背景色 |
167
- | 字体 | 界面字体、代码与等宽字体 |
135
+ - Files 与浏览器各占一张浮动卡片,多个终端共用一张并用标签切换;第三块开启右列,两列分隔线各自可拖,比例按会话保留。
136
+ - 卡片可放大到覆盖聊天区(保留左导航)/还原;最后一块关闭时收起右栏。
137
+ - Files 的文件树与预览左右分栏、树宽可拖;标题左侧蓝色清单按钮收起 / 展开文件树;过滤框按名字收窄已加载的行,Esc 清除。
138
+ - 浏览器带 Servers / Files / Settings 分组菜单与 Save screenshot;标题栏可直接输入服务地址并回车访问。
168
139
 
169
- </div>
140
+ ### 菜单与滚动条
170
141
 
171
- > [!NOTE]
172
- > 自定义背景色只作用于浅色模式,深色模式使用内置深色调色板。界面默认使用 Geist,未安装时回退系统字体;仓库的 `assets/fonts/` 提供本机安装用字体与 OFL 许可,字体不包含在 npm 包中。
142
+ - 工作区、会话、权限与模型等菜单共用紧凑行高、圆角与悬停反馈,浅色与深色一致。
143
+ - 滚动条平时不画:滚动时出现、停下约一秒淡出;五个页面级滚动面(会话页、转录列、侧栏树、文件树、智能体团队面板)用一条封顶的深色浮层胶囊。
173
144
 
174
- ## 🛠️ 环境要求
145
+ ### 主题与细节
175
146
 
176
- <div align="center">
147
+ - 跟随 DSH 的浅色、深色与系统主题。
148
+ - 可自定义会话与侧栏背景色(仅浅色模式),以及界面、界面中文与代码字体。
149
+ - 主页字符水波纹持续流动,点击空白处触发同款扩散。
150
+ - 输入卡旁的宠物可在小鲸鱼与 Claude 像素宠物之间切换:小鲸鱼点击随机喷水、弹跳或摆尾;Claude 宠物点击后取出笔记本电脑、敲键盘,再恢复站姿。
151
+ - 「Claude 主题 → 个性化」可独立选择宠物样式、首页问候与图标;首页保留「探索未知之境」,也可切换为橙色星芒图标与 “What’s up next?”,问候语跟随界面语言,不显示姓名。默认保持原样式。
152
+ - 用量统计卡片:概览 / 模型视图、时间范围、贡献热力图与模型图表。
177
153
 
178
- | 项目 | 要求 |
179
- | --- | --- |
180
- | 宿主 | DSH `0.2.0-rc.2` |
181
- | 平台 | macOS(Apple 芯片)、Windows 10 及以上(64 位) |
182
- | 主题 | 浅色、深色与跟随系统 |
183
- | 开发环境 | Node.js ≥ 22.18.0 |
154
+ ## 配置
184
155
 
185
- </div>
156
+ 打开「设置 → Claude 主题」,改动即时生效:
186
157
 
187
- ## 🧑‍💻 开发
158
+ | 分组 | 可调项 |
159
+ | --- | --- |
160
+ | 模块 | 窗口与分栏骨架、侧栏、新建页、主页字符水波纹(默认开启)、聊天页、输入框小鲸鱼、统计卡片、状态栏统计读数、上下文分解面板 |
161
+ | 外观 | 主题(浅色 / 深色 / 跟随系统)、会话背景色、侧栏背景色 |
162
+ | 视图 | 顶栏子代理入口、顶栏团队入口(默认关闭)、显示空分组(默认关闭) |
163
+ | 字体 | 界面字体、代码与等宽字体;界面中文字体在设置页不列,需写进 profile 的 `cordis.patch.yml` |
188
164
 
189
- ```sh
190
- npm ci --cache .cache/npm
191
- npm run check
192
- npm run pack:local --cache .cache/npm
193
- ```
165
+ > [!NOTE]
166
+ > 自定义背景色只作用于浅色模式,深色模式使用内置深色调色板。界面默认使用 Geist,未安装时回退系统字体;仓库的 `assets/fonts/` 提供本机安装用字体与 OFL 许可,字体不包含在 npm 包中。
194
167
 
195
- `npm run check` 依次执行类型检查、模块边界与文档链接检查、测试、构建和包内容校验。本机有 Chrome 时,测试还会在真实浏览器中验证视图选项二级菜单的鼠标命中、跨菜单间隙与键盘操作,以及上下文分解面板的两态、锚定几何、分段间隙与浅深配色;没有 Chrome 时跳过这一项,可用 `CHROME` 指定浏览器路径。
168
+ ## 环境要求
196
169
 
197
- <details>
198
- <summary><b>全部脚本</b></summary>
170
+ 支持最新版 DSH Desktop,兼容 `0.2.0-rc.2`;macOS(Apple 芯片)或 Windows 10 及以上(64 位)。源码构建另需 Node.js ≥ 22.18.0。
199
171
 
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
- ## 📮 反馈与许可
172
+ ## 反馈与许可
218
173
 
219
174
  通过 [Issue](https://github.com/zkforge/dsh-claude-desktop-theme/issues) 反馈问题,附上 DSH 版本、窗口尺寸和复现步骤。
220
175