deepclear-ui
kun-nnn/deepclear-ui
DeepSeek Harness 的点阵外观插件:点阵欢迎页(人像与 deepseek/harness 字标共用一套网点)、点阵启动动画、输入框里用点阵印出的推理等级徽章(MAX 为鲸鱼蓝)、思考时旋转的点阵球与英文状态行、打字时的光标点阵拖尾,以及侧边栏按钮悬停点阵与鲸鱼蓝竖线。同时重绘了更安静的界面细节:磨砂输入框、灰色聚焦光环、鲸鱼蓝加粗文字、鲸鱼蓝 diff、阅读排版与低饱和代码配色。十五个偏好存在 profile 配置里,可逐项关闭。需要 DSH >=0.2.2-rc.3。
安装
dsh plugin --profile web add github:kun-nnn/deepclear-uiREADME
DeepClear UI

A dot-matrix welcome page, a dot-printed reasoning badge and quieter chrome for the DeepSeek Harness web UI. One bundle — a patch row, a client half and locale metadata. No dependencies, no host-side code.
Welcome page
- Right: the mascot portrait, sampled from an illustration into a halftone dot grid
- Left: the
deepseek/harnessdot-matrix wordmark
The portrait and the wordmark share one dot pitch, scale with the window, sit on the
composer, and disappear once the session starts. The stock headline, brand mark and
pixel-whale canvas are hidden while the page is showing, and a faint deepclear-ui
signature sits in the corner.
The lattice is the design. The background field, the wordmark and the portrait all sit on the same dot grid, phase-aligned to the artwork, so every dot in the scene lands on its own cell. Dots never move; only their brightness changes.
- Entrance: the wordmark fades in as a whole (
deepseekfirst,harnessafter, ~1.3 s), then the portrait grows downward as a soft wipe (~1.1 s) - A slow brightness wave travels across the lattice at the bottom of the page
- Moving the pointer over the bottom band sends light rings across the field
- Clicking anywhere sends a ripple across the wordmark
Startup splash
Every launch opens on a dark stage: a faint dot field surfaces, a ring travels outward from
the centre, then deepseek (white) and harness (whale blue) rise in, a light sheen crosses
the wordmark, and the app fades in. Driven entirely by transform / opacity so the
compositor keeps it smooth while the app is still booting.
Thinking
While a turn runs, the live status row is redrawn on our own overlay canvas:
- a small Fibonacci-sphere of dots spins in front of the label
- the label reads
Deep thinking for 12s. . .with a whale-blue highlight sweeping across it - the real elapsed seconds come from the host clock; the overlay is clipped above the composer, so nothing ever bleeds over the input box
Turning either switch off hands the corresponding part back to the host untouched.
Composer
- Welcome page: the card stays solid, so the dot sheet behind it never shows through
- Session: the card becomes translucent glass (
backdrop-filter) - Effort badge: whatever reasoning level is selected (except OFF) unfolds a dot field in the send row and prints the level name in dots — white for most levels, whale blue for MAX. While the model thinks, two vertical highlights travel outward from the middle. The badge is drawn above the composer content. Pure CSS: the plugin only stamps attributes on the composer card.
- Caret trail: typing leaves a fading column of dots behind the caret, filled to the full caret height and clipped to the card
A fresh conversation opens automatically after the splash on every launch.
Sidebar
- Hover dot field: every control in the sidebar lights a dot field around the pointer, clipped to that control, unlit when the pointer is elsewhere
- Settings sheet: a
DeepClear UIfooter button (nine-dot icon) opens a floating sheet with one switch per feature, applied instantly and remembered per profile
Accents
Whale blue is #7AAAFF:
- Bold prose in chat messages turns whale blue and stays bold
- Composer focus: a neutral light-grey ring fades in under the card's own hairline
- Diffs: added lines take whale blue, deleted lines deep blue, with the code text, gutter
and
+/-markers collapsed into the same blue family
The rules ride public markers ([data-slot="conversation.chat.flow"], [data-composer-card],
[data-diff-line], [data-chat-running], [data-composer-dock]) and ui-theme's own tokens.
Settings
The sidebar sheet carries:
- Welcome page: dot artwork, dot field, bottom wave, pointer ripples
- Thinking: dot sphere, English label
- Composer: frosted glass, effort badge
- Interface & reading: reading layout, code palette
- Accents: whale-blue bold, focus ring, re-inked diffs
Plus a single "Reset to defaults" action.
Install
npm i deepclear-ui
Or install it by name from the dsh Plugins panel.
Marketplace
The plugin is being added to the community catalog. Until that listing is live you can add this package's own index source so it shows up in Plugins -> Discover:
https://raw.githubusercontent.com/KUN-NNN/deepclear-ui/main/market/index.json
Add source, search deepclear, install.
Customize
Swapping the artwork, painting a mask, or editing the dot grid directly is documented in
scripts/README.md:
scripts\rebuild.cmd # sample artwork -> splice the hero block -> inject the grids
scripts\preview.cmd # render a preview strip of both themes
The dark theme prints the portrait from a line-art grid (girl-lines.txt) and the light
theme from the ink grid (girl-grid.txt).
Palette
| Token | Value |
|---|---|
| Whale blue | #7AAAFF |
| Dots, light theme | #666C78 at per-cell alpha |
| Dots, dark theme | #ECEEF2, weight inverted |
Tested against dsh 0.2.2-rc.3.
Plugin boundaries
The plugin only uses public surfaces: slot registrations (conversation.hero.frame,
shell.overlay, sidebar.footer.action), a stylesheet riding stable data attributes and
theme tokens, a Host patch row with a Schemastery config, and its own preferences through
the profile config form. It never takes over host components and never writes host DOM
trees.
Development
Design rules that new UI must follow live in docs/DESIGN.md — the toggle
spec, the hover dot field, the thinking row and the other conventions.
License
MIT. See LICENSE.