dsh-theme-customizer 1.0.0 → 1.0.1

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 (4) hide show
  1. package/README.en.md +106 -89
  2. package/README.md +22 -5
  3. package/lib/client.js +3108 -3102
  4. package/package.json +50 -50
package/README.en.md CHANGED
@@ -1,89 +1,106 @@
1
- # dsh-theme-customizer
2
-
3
- [![npm version](https://img.shields.io/npm/v/dsh-theme-customizer?style=flat-square)](https://www.npmjs.com/package/dsh-theme-customizer)
4
- [![license](https://img.shields.io/github/license/lxxz1918/dsh-theme-customizer?style=flat-square)](LICENSE)
5
- [![topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-0969da?style=flat-square)](https://github.com/topics/dsh-plugin)
6
- [![stars](https://img.shields.io/github/stars/lxxz1918/dsh-theme-customizer?style=flat-square)](https://github.com/lxxz1918/dsh-theme-customizer/stargazers)
7
-
8
- **English** | [中文](README.md)
9
-
10
- > A theme customizer plugin for the DeepSeek Harness (DSH) web UI. Backgrounds, text colors, borders and details — all adjustable visually, persisted across restarts.
11
- > Config is stored in localStorage; presets can be exported as `.tczp` files (images included) and shared with any machine.
12
-
13
- ## Features
14
-
15
- - **Interface module (7 background areas)**: Main / Sidebar / Conversation / Composer / Settings panel / Floating panel / Cordis panel
16
- - Each area: None / Solid color / Image (with crop & selection) + opacity (**larger value = more transparent**) + base color (independent layer)
17
- - Main background supports "include sidebar / exclude sidebar" display area toggle
18
- - Sidebar image fades out directly via mask — never covers the top UI or the settings panel
19
- - **Borders module**: color + opacity for all default UI borders/dividers, independently for 5 areas (Main incl. sidebar / Cordis / Composer / Settings / Floating panel)
20
- - **Text colors module**: 5 categories (Body / Process / Auxiliary / Faded / Accent), shared across light & dark themes, restorable to official defaults
21
- - **Brand color**: color + opacity for the top-left DeepSeek Harness logo; the "Harness" wordmark can be tinted separately
22
- - **Conversation details**: user bubble / inline code / code block background / code block scrollbar / conversation scrollbar / todo panel collapsed & expanded / "scroll to bottom" button background
23
- - **Composer**: background, fixed input height (1–10 rows), stats line takeover (9 independent toggles + full expand), command button & menu backgrounds
24
- - **New session button**: None/Solid/Image style + show text/icon toggles + independent icon/text colors + base color
25
- - **Layout**: draggable settings panel (drag its header; position persisted; one-click reset)
26
- - **Floating panel**: a draggable mini settings panel (choose which modules to show), always on top
27
- - **Presets**: save/apply/rename/delete/export/import (`.tczp`, images included, up to 10) + drag-to-reorder
28
- - **Global reset**: one click to restore all defaults (3-step confirm to prevent accidents)
29
-
30
- ## Installation
31
-
32
- ```bash
33
- # Option 1: npm (published package)
34
- npm install -g dsh-theme-customizer
35
- dsh plugin --profile web add dsh-theme-customizer
36
-
37
- # Option 2: local directory (after cloning this repo)
38
- dsh plugin --profile web add <path-to-this-repo>
39
- ```
40
-
41
- Then **restart dsh web** for it to take effect. Verify: Settings → Theme should appear.
42
-
43
- ## Usage
44
-
45
- 1. Open **Settings Theme** and adjust by module; changes apply instantly and save automatically (the bottom of the page shows "last saved" time)
46
- 2. For quick tweaks, click "↗ Open float panel" at the top right — the panel is draggable
47
- 3. To verify the conversation-area options, use the test text in [对话区测试指令.md](对话区测试指令.md)
48
-
49
- ## Persistent Cordis button (optional)
50
-
51
- The "Cordis button always visible" toggle in Theme settings **requires a patch to the official dsh-client-ui-cordis package**; without the patch the toggle has no effect. One-click install:
52
-
53
- ```bash
54
- node apply-patch.cjs # apply patch (auto backup)
55
- node apply-patch.cjs --check # check status
56
- node apply-patch.cjs --undo # revert
57
- ```
58
-
59
- ⚠️ **DSH upgrades overwrite the official package** — re-run `apply-patch.cjs` after upgrading. Details in [PATCH-CORDIS-BUTTON.md](PATCH-CORDIS-BUTTON.md).
60
-
61
- ## Build from source (developers)
62
-
63
- ```bash
64
- # 1. Concatenate source fragments (optimized/src/ → optimized/dist/, with syntax check + line map/symbols)
65
- node optimized\build.cjs
66
-
67
- # 2. Generate the static client bundle (dist/p3_2_client.js → lib/client.js)
68
- node build_static.cjs optimized\dist\p3_2_client.js lib\client.js
69
-
70
- # 3. Syntax check + install for testing
71
- node --check lib\client.js
72
- dsh plugin --profile web add <path-to-this-repo>
73
- ```
74
-
75
- Source layout: `optimized/src/` contains 16 fragments (`00_*`~`15_*` + `host.js`) concatenated in filename order into the plugin function body. Look up features in `optimized/INDEX.md`.
76
-
77
- ## Preset files (.tczp)
78
-
79
- Presets panel "📥 Import preset" and pick a `.tczp` file to restore a whole config (images included — no original files needed). Export each preset via "📤 Export" in the same panel.
80
-
81
- ## Uninstall
82
-
83
- ```bash
84
- dsh plugin --profile web remove dsh-theme-customizer
85
- ```
86
-
87
- ## License
88
-
89
- [MIT](LICENSE)
1
+ # dsh-theme-customizer
2
+
3
+ [![npm version](https://img.shields.io/npm/v/dsh-theme-customizer?style=flat-square&v=1)](https://www.npmjs.com/package/dsh-theme-customizer)
4
+ [![license](https://img.shields.io/github/license/lxxz1918/dsh-theme-customizer?style=flat-square&v=1)](LICENSE)
5
+ [![topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-0969da?style=flat-square&v=1)](https://github.com/topics/dsh-plugin)
6
+ [![stars](https://img.shields.io/github/stars/lxxz1918/dsh-theme-customizer?style=flat-square&v=1)](https://github.com/lxxz1918/dsh-theme-customizer/stargazers)
7
+
8
+ **English** | [中文](README.md)
9
+
10
+ > A theme customizer plugin for the DeepSeek Harness (DSH) web UI. Backgrounds, text colors, borders and details — all adjustable visually, persisted across restarts.
11
+ > Config is stored in localStorage; presets can be exported as `.tczp` files (images included) and shared with any machine.
12
+
13
+ ## Screenshots
14
+
15
+ | | Main UI | Settings panel |
16
+ |:---:|:---:|:---:|
17
+ | **Preset 0** | ![Preset 0 main UI](https://github.com/lxxz1918/dsh-theme-customizer/raw/main/docs/screenshots/theme-effect.png) | ![Preset 0 panel](https://github.com/lxxz1918/dsh-theme-customizer/raw/main/docs/screenshots/settings-panel.png) |
18
+ | **Preset 1** | ![Preset 1 main UI](https://github.com/lxxz1918/dsh-theme-customizer/raw/main/docs/screenshots/preset-1-main.png) | ![Preset 1 panel](https://github.com/lxxz1918/dsh-theme-customizer/raw/main/docs/screenshots/preset-1-panel.png) |
19
+
20
+ ## Features
21
+
22
+ - **Interface module (7 background areas)**: Main / Sidebar / Conversation / Composer / Settings panel / Floating panel / Cordis panel
23
+ - Each area: None / Solid color / Image (with crop & selection) + opacity (**larger value = more transparent**) + base color (independent layer)
24
+ - Main background supports "include sidebar / exclude sidebar" display area toggle
25
+ - Sidebar image fades out directly via mask never covers the top UI or the settings panel
26
+ - **Borders module**: color + opacity for all default UI borders/dividers, independently for 5 areas (Main incl. sidebar / Cordis / Composer / Settings / Floating panel)
27
+ - **Text colors module**: 5 categories (Body / Process / Auxiliary / Faded / Accent), shared across light & dark themes, restorable to official defaults
28
+ - **Brand color**: color + opacity for the top-left DeepSeek Harness logo; the "Harness" wordmark can be tinted separately
29
+ - **Conversation details**: user bubble / inline code / code block background / code block scrollbar / conversation scrollbar / todo panel collapsed & expanded / "scroll to bottom" button background
30
+ - **Composer**: background, fixed input height (1–10 rows), stats line takeover (9 independent toggles + full expand), command button & menu backgrounds
31
+ - **New session button**: None/Solid/Image style + show text/icon toggles + independent icon/text colors + base color
32
+ - **Layout**: draggable settings panel (drag its header; position persisted; one-click reset)
33
+ - **Floating panel**: a draggable mini settings panel (choose which modules to show), always on top
34
+ - **Presets**: save/apply/rename/delete/export/import (`.tczp`, images included, up to 10) + drag-to-reorder
35
+ - **Global reset**: one click to restore all defaults (3-step confirm to prevent accidents)
36
+
37
+ ## Installation
38
+
39
+ ```bash
40
+ # Option 1: npm (published package)
41
+ npm install -g dsh-theme-customizer
42
+ dsh plugin --profile web add dsh-theme-customizer
43
+
44
+ # Option 2: local directory (after cloning this repo)
45
+ dsh plugin --profile web add <path-to-this-repo>
46
+ ```
47
+
48
+ Then **restart dsh web** for it to take effect. Verify: Settings → Theme should appear.
49
+
50
+ ## Usage
51
+
52
+ 1. Open **Settings → Theme** and adjust by module; changes apply instantly and save automatically (the bottom of the page shows "last saved" time)
53
+ 2. For quick tweaks, click "↗ Open float panel" at the top right — the panel is draggable
54
+ 3. To verify the conversation-area options, use the test text in [对话区测试指令.md](对话区测试指令.md)
55
+
56
+ ## Persistent Cordis button (optional)
57
+
58
+ The "Cordis button always visible" toggle in Theme settings **requires a patch to the official dsh-client-ui-cordis package**; without the patch the toggle has no effect. One-click install:
59
+
60
+ ```bash
61
+ node apply-patch.cjs # apply patch (auto backup)
62
+ node apply-patch.cjs --check # check status
63
+ node apply-patch.cjs --undo # revert
64
+ ```
65
+
66
+ ⚠️ **DSH upgrades overwrite the official package** — re-run `apply-patch.cjs` after upgrading. Details in [PATCH-CORDIS-BUTTON.md](PATCH-CORDIS-BUTTON.md).
67
+
68
+ ## Build from source (developers)
69
+
70
+ ```bash
71
+ # 1. Concatenate source fragments (optimized/src/ → optimized/dist/, with syntax check + line map/symbols)
72
+ node optimized\build.cjs
73
+
74
+ # 2. Generate the static client bundle (dist/p3_2_client.js → lib/client.js)
75
+ node build_static.cjs optimized\dist\p3_2_client.js lib\client.js
76
+
77
+ # 3. Syntax check + install for testing
78
+ node --check lib\client.js
79
+ dsh plugin --profile web add <path-to-this-repo>
80
+ ```
81
+
82
+ Source layout: `optimized/src/` contains 16 fragments (`00_*`~`15_*` + `host.js`) concatenated in filename order into the plugin function body. Look up features in `optimized/INDEX.md`.
83
+
84
+ ## Preset files (.tczp)
85
+
86
+ Presets panel → "Import preset" and pick a `.tczp` file to restore a whole config (images included — no original files needed). Export each preset via "Export" in the same panel.
87
+
88
+ ## Uninstall
89
+
90
+ ```bash
91
+ dsh plugin --profile web remove dsh-theme-customizer
92
+ ```
93
+
94
+ ## Contact & Feedback
95
+
96
+ - Bugs / feature requests → open an [issue](https://github.com/lxxz1918/dsh-theme-customizer/issues)
97
+ - Maintenance: issues are reviewed and replied to **every Sunday**
98
+ - Bilibili: [homepage](https://space.bilibili.com/38175333)
99
+
100
+ ## AI Usage
101
+
102
+ This project is designed and reviewed by [lxxz1918](https://github.com/lxxz1918); the code is written with the assistance of an AI assistant (DeepSeek). All feature requirements, UI copy and final results are confirmed by the author.
103
+
104
+ ## License
105
+
106
+ [MIT](LICENSE)
package/README.md CHANGED
@@ -1,15 +1,22 @@
1
1
  # dsh-theme-customizer
2
2
 
3
- [![npm version](https://img.shields.io/npm/v/dsh-theme-customizer?style=flat-square)](https://www.npmjs.com/package/dsh-theme-customizer)
4
- [![license](https://img.shields.io/github/license/lxxz1918/dsh-theme-customizer?style=flat-square)](LICENSE)
5
- [![topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-0969da?style=flat-square)](https://github.com/topics/dsh-plugin)
6
- [![stars](https://img.shields.io/github/stars/lxxz1918/dsh-theme-customizer?style=flat-square)](https://github.com/lxxz1918/dsh-theme-customizer/stargazers)
3
+ [![npm version](https://img.shields.io/npm/v/dsh-theme-customizer?style=flat-square&v=1)](https://www.npmjs.com/package/dsh-theme-customizer)
4
+ [![license](https://img.shields.io/github/license/lxxz1918/dsh-theme-customizer?style=flat-square&v=1)](LICENSE)
5
+ [![topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-0969da?style=flat-square&v=1)](https://github.com/topics/dsh-plugin)
6
+ [![stars](https://img.shields.io/github/stars/lxxz1918/dsh-theme-customizer?style=flat-square&v=1)](https://github.com/lxxz1918/dsh-theme-customizer/stargazers)
7
7
 
8
8
  **中文** | [English](README.en.md)
9
9
 
10
10
  > DeepSeek Harness(DSH)Web 界面自定义主题插件:背景、文字、框线、细节全部可视化设置,刷新/重启不丢。
11
11
  > 配置存 localStorage,预设可导出 `.tczp` 文件(含图片)分享到任意电脑。
12
12
 
13
+ ## 界面预览
14
+
15
+ | | 主界面效果 | 设置面板 |
16
+ |:---:|:---:|:---:|
17
+ | **示例预设 0** | ![预设0主界面](https://github.com/lxxz1918/dsh-theme-customizer/raw/main/docs/screenshots/theme-effect.png) | ![预设0面板](https://github.com/lxxz1918/dsh-theme-customizer/raw/main/docs/screenshots/settings-panel.png) |
18
+ | **示例预设 1** | ![预设1主界面](https://github.com/lxxz1918/dsh-theme-customizer/raw/main/docs/screenshots/preset-1-main.png) | ![预设1面板](https://github.com/lxxz1918/dsh-theme-customizer/raw/main/docs/screenshots/preset-1-panel.png) |
19
+
13
20
  ## 功能一览
14
21
 
15
22
  - **界面板块(7 区域背景)**:主界面 / 侧边栏 / 对话区 / 输入区 / 设置界面 / 浮窗面板 / Cordis 插件界面
@@ -76,7 +83,7 @@ dsh plugin --profile web add <本仓库路径>
76
83
 
77
84
  ## 预设文件(.tczp)
78
85
 
79
- 预设面板 → 「📥 导入预设」选择 `.tczp` 文件即可恢复整套配置(含图片,无需原图)。导出同样在预设面板逐条「📤 导出」。
86
+ 预设面板 → 「导入预设」选择 `.tczp` 文件即可恢复整套配置(含图片,无需原图)。导出同样在预设面板逐条「导出」。
80
87
 
81
88
  ## 卸载
82
89
 
@@ -84,6 +91,16 @@ dsh plugin --profile web add <本仓库路径>
84
91
  dsh plugin --profile web remove dsh-theme-customizer
85
92
  ```
86
93
 
94
+ ## 联系与反馈
95
+
96
+ - 使用问题 / 功能建议 → [Issues](https://github.com/lxxz1918/dsh-theme-customizer/issues) 发议题
97
+ - 维护时间:**每周日**集中查看议题并回复
98
+ - 哔哩哔哩:[个人主页](https://space.bilibili.com/38175333)
99
+
100
+ ## AI 使用说明
101
+
102
+ 本项目由 [lxxz1918](https://github.com/lxxz1918) 主导设计与验收,代码在 AI 助手(DeepSeek)辅助下编写。所有功能需求、界面文案与最终效果均由作者本人确认。
103
+
87
104
  ## License
88
105
 
89
106
  [MIT](LICENSE)