dsh-opencode-palette 1.4.0

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 ADDED
@@ -0,0 +1,109 @@
1
+ # 🎨 dsh-opencode-palette
2
+
3
+ **🌐 [中文](../README.md) · [English](README.en.md)**
4
+
5
+ **The complete opencode palette for DeepSeek Harness — 34 official themes, one click.**
6
+
7
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](../LICENSE)
8
+ [![opencode](https://img.shields.io/badge/themes-opencode%20v1.18.12-orange)](https://github.com/anomalyco/opencode)
9
+ [![tests](https://img.shields.io/badge/tests-20%2F20-green)]()
10
+
11
+ ![hero](../assets/hero-en.svg)
12
+
13
+ ## Install in one command
14
+
15
+ Requires the **DSH CLI** (DeepSeek Harness command-line tool). If you don't have it yet:
16
+
17
+ ```bash
18
+ npm install -g @deepseek-ai/dsh
19
+ ```
20
+
21
+ Then install the plugin into your profile:
22
+
23
+ ```bash
24
+ dsh plugin --profile web add dsh-opencode-palette
25
+ ```
26
+
27
+ Register the entry (hot-reloaded, no restart): append to `~/.dsh/profiles/web/cordis.patch.yml`:
28
+
29
+ ```yaml
30
+ - insert:
31
+ - id: opencode-palette
32
+ name: 'dsh-opencode-palette'
33
+ ```
34
+
35
+ Refresh the browser page — the plugin is on, using the official `opencode` theme (deep black with orange / blue / violet).
36
+
37
+ ## What it does
38
+
39
+ DeepSeek Harness ships with one look. This plugin lets you dress the whole interface in any of the **34 official opencode themes** — `tokyonight`, `dracula`, `gruvbox`, `matrix`, `rose-pine`, `catppuccin ×3`, `solarized`, `synthwave84` …
40
+
41
+ - Every color comes from opencode's official theme JSON (v1.18.12) — what opencode ships is what you get.
42
+ - One click re-skins everything: backgrounds, buttons, borders, status colors, markdown, and code syntax highlighting.
43
+ - Your choice is remembered across restarts.
44
+ - The panel speaks your language — it follows the DSH interface language (中文 / English).
45
+
46
+ ## Get started in 30 seconds
47
+
48
+ **Settings → Plugins → Opencode Palette** (in Chinese: **设置 → 插件 → OpenCode 调色板**):
49
+
50
+ ![setup panel](../assets/setup-panel-en.svg)
51
+
52
+ Click any theme chip — the interface re-skins instantly:
53
+
54
+ ![theme switch](../assets/theme-switch-en.svg)
55
+
56
+ ## Features
57
+
58
+ ### 34 themes and the stories behind their names
59
+
60
+ Every name has a story:
61
+
62
+ ![theme stories](../assets/theme-stories-en.svg)
63
+
64
+ ### 34 official themes, faithfully ported
65
+
66
+ Each theme shows its 7 core colors at a glance — `background · text · primary · accent · error · warning · success`:
67
+
68
+ ![palette strips](../assets/palette-strips-en.svg)
69
+
70
+ All 34 at a glance:
71
+
72
+ ![palette matrix](../assets/palette-matrix-en.svg)
73
+
74
+ ### Typography, independent from the theme
75
+
76
+ - Body style: monospace (terminal) or regular (UI) — the opencode terminal look or a classic interface look.
77
+ - Font size: 11–18 px.
78
+ - Code font: 5 presets with live preview (JetBrains Mono, Cascadia Code, Fira Code, SF Mono, Consolas).
79
+
80
+ ### `system` — back to default in one click
81
+
82
+ Restores DSH's native appearance whenever you want, while keeping your typography settings.
83
+
84
+ ### Persisted per browser
85
+
86
+ Your theme and typography choices are stored locally and survive refresh and restart.
87
+
88
+ ### Bilingual panel
89
+
90
+ The panel follows your DSH interface language automatically — switch the language in DSH and the panel follows instantly.
91
+
92
+ ## Development
93
+
94
+ ```bash
95
+ npm run sync # fetch official theme JSONs from opencode (version-locked, checksummed)
96
+ npm test # 20 tests: engine audit of all 34 themes + panel render (zh/en)
97
+ npm run build # zero-dependency bundler -> package/ + dynamic client.js
98
+ npm run assets # regenerate the SVG images in this README
99
+ ```
100
+
101
+ Architecture: see [DESIGN.md](../DESIGN.md) — a data-driven three-stage pipeline, with `src/engine/map-dsh.mjs` as the single source of truth for the DSH mapping layer.
102
+
103
+ ## Contributing
104
+
105
+ Good starting points: new upstream themes (run `npm run sync`), mapping refinements, copy polish, or more locale translations. Keep the engine pure (no DOM) so the tests stay green.
106
+
107
+ ## License & credits
108
+
109
+ MIT © FeatherHunter. Theme definitions are vendored from [opencode](https://github.com/anomalyco/opencode) (MIT) and its upstream theme projects — see [THIRD_PARTY_NOTICES](../src/themes/THIRD_PARTY_NOTICES.md).