deepseek-harness/packages/client/ui-brand-official/README.md

description, kind

description	kind
Official DeepSeek Harness brand occupants for the sidebar and conversation hero, active only in official builds; for users and maintainers choosing or replacing brand presentation.	package-reference

@deepseek-ai/dsh-client-ui-brand-official

English | 中文

Summary

This package fills the browser brand slots — sidebar.brand.mark, sidebar.brand.name, and conversation.hero.brand.mark — with the official DeepSeek Harness mark and name. It registers these occupants only when the client bundle builds with the official profile; every other build loads the plugin but registers nothing, so the shell fallbacks stay visible. Choose it when the deployed identity is DeepSeek's own; a deployment with its own brand composes a different package into the same slots instead. It retains no runtime state and contributes nothing to model requests.

Table of Contents

• Use this package
• Understand the implementation
• Further Exploration
• Model Experience
• Known Limitations and Deferred Work
• Dev Note

---

Use this package

Mount this plugin in the browser roster of a deployment whose identity is DeepSeek's own, then build the client with the official profile so the occupants register.

Choosing the profile

DSH_CLIENT_BUILD_PROFILE selects which brand renders. An official build shows the official mark and name in the sidebar and the mark in the conversation hero; any other value leaves the shell fallbacks — the fish mark and the local-build label — in place. The plugin still loads and validates in both cases; only the registration is profile-gated.

Replacing the brand

A deployment with its own identity leaves this package out and composes another package that occupies the same three slots. Occupying a slot is the only composition route; there is no brand configuration surface here.

---

Understand the implementation

Implementation internals — click to expand

The three occupants install as one declaration-aware registration set: nested ctx.slots.inject() calls wait on the sidebar and conversation declarations, so the set works whether this row activates before or after the declarers, withdraws all three occupants when either declaration collapses, and leaves no partial brand mix during HMR. The browser half is src/client/index.ts; the node half is an empty Loader seat. The browser title is a build-environment concern (DSH_CLIENT_TITLE), outside the slot system.

---

Further Exploration

Read these pages when the brand surface is not enough. They move from the slots this package occupies to the shell that renders them.

• ui-sidebar — declares sidebar.brand.mark and sidebar.brand.name and renders their fallbacks.
• ui-conversation — declares conversation.hero.brand.mark in the hero.
• Web client architecture — how browser plugin rows load and register slots.

---

Model Experience

None, as the package contributes browser presentation only; nothing here reaches a model request.

KV Cache effect

None; this package neither assembles nor sends a provider request.

Known Limitations and Deferred Work

These limits define how brand presentation is supplied. They are current package constraints, not a brand-design comparison or a task backlog.

• One occupant set — alternative presentation belongs in another Cordis package occupying the same slots.
• The browser title is independent — DSH_CLIENT_TITLE selects title text at build time rather than through a UI slot.

Dev Note

Working context for maintainers — click to expand

None.