dsh-avatar-chat
为 DeepSeek Harness 聊天记录提供用户和助手双头像，并提供头像设置页面。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:suwodhcbbc/dsh-avatar-chat#f3cf310727627a65c1db13ea639c59a6cda3713bAvatar Chat 以 dsh-avatar-chat 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
Dual avatars for the DeepSeek Harness chat transcript — a user avatar on the right of every user turn, an assistant avatar on the left of every answer — plus an Avatars page in Settings to switch each side on or off, set a picture, and pick the size.
A DSH Web Client plugin: a Cordis bundle that registers one settings.section seat and decorates the transcript with a page-level stylesheet.
Transcript — the user's picture beside the request on the right, the assistant's beside the reply on the left, both at 50 px:
Avatars in the chat transcript
Settings — the Avatars page this plugin adds, with a picture chosen on each side:
Both come from the author's own desktop build (Chinese locale, custom wallpaper); the pictures, the size, and the toggles are exactly the controls the page exposes.
https://… address. The address is probed once before it is adopted.0.2.1-alpha.4 (Web / Desktop). The plugin uses only the shipped theme tokens and the settings.section slot.react, react/jsx-runtime, @deepseek-ai/dsh-client-store, @deepseek-ai/dsh-client-ui-primitives — are all part of the shell's frozen module table, so nothing extra needs installing next to this package.A profile-local plugin joins a profile as a bundle. The profile's own cordis.patch.yml is id-targeted — it can only override or disable entries that a bundle layer already declared — so adding a row there does nothing.
Works for the desktop app, whose profile is managed exclusively by the application and therefore cannot be edited through the dsh CLI.
Copy this repository into the profile's node_modules under the package name:
<profile>/node_modules/dsh-avatar-chat/
<profile> is e.g. ~/.dsh/profiles/desktop. Ship package.json, cordis.patch.yml and lib/.
Add the package name to the profile's package.json under dsh.profile.bundles:
"dsh": {
"profile": {
"bundles": [
"…",
"dsh-avatar-chat"
]
}
}
Being listed here is what composes the plugin into the tree; it does not also have to appear in dependencies.
Restart the application. The bundle stack is recomposed at boot.
For a profile the dsh CLI is allowed to manage:
dsh plugin --profile <profile> add link:<absolute path to this repository>
After the restart, this should name the package and a real directory:
cordis_inspect → host / Config / listConfigs { "entry": "include:ui-avatar-chat" }
Open Settings → Avatars.
https://… URL and apply it.Nothing else to do: the transcript picks the settings up on the next paint.
Preferences live in the browser's localStorage under the single key dsh.avatar-chat.v1, as JSON:
{ "schemaVersion": 1, "size": 28,
"user": { "visible": true, "image": "data:image/webp;base64,…" },
"assistant": { "visible": true, "image": null } }
schemaVersion, an out-of-range size, or a malformed side is repaired in place and reported as damaged.DSH has no slot that adds leading or trailing chrome to an individual chat message row: conversation.chat.node's keyed seats are already fully occupied by the shipped renderers (user, steering, assistant-step, …) and a third-party package cannot import or wrap them. Every class name inside the chat subtree is also a CSS-Modules hash, so it is not addressable from another package.
What is stable is the row element itself, which carries data-chat-flow-kind (equal to the chat node kind), data-chat-turn, and data-chat-group-part. So the plugin ships a page-level stylesheet that selects on those attributes, and drives it entirely from root-element state:
data-dsh-avatar-chat, -user, -user-image, -assistant, -assistant-image--dsh-avatar-chat-size and the two picture variablesThe avatar is painted by an absolutely-positioned ::before inside padding the stylesheet reserves on the decorated row; the row keeps its shipped display, so host layout is untouched.
The stylesheet is a plain .css side-effect import, which the DSH client bundler turns into a tagged <style data-plugin-css> element — deduplicated by tag id, so re-running the plugin never double-injects it. Every root write is absolute, so applying twice is idempotent.
data-chat-flow-kind, which is not a published contract. If the chat row markup changes, avatars disappear silently until the selector is updated.user, steering and assistant-step rows are decorated. Tool calls, commands, system prompts and turn-process rows have no avatar.position: relative, so it is the containing block for its own absolutely-positioned descendants.--dsw-alias-brand-primary, which is near-black in light mode and near-white in dark mode — an inverse monochrome accent, not a brand blue.Verified against DeepSeek Harness 0.2.1-alpha.4 on Windows with the shipped Web client, in both unit tests and a real headless-Chromium run against an assembled profile.
The lib/ directory in this repository is the built artifact and is what the loader consumes. Rebuilding it requires a DeepSeek Harness source checkout: this package is compiled by the repository's shared client bundler preset (packages/client/tsdown.client.ts), which owns the window.__ModuleLoader__.load({ id, factory }) wrapper, the platform externals, and the CSS inlining.
To rebuild: place src/ at packages/client/ui-avatar-chat/src in the checkout, then
pnpm --filter @deepseek-ai/dsh-client-ui-avatar-chat bundle
Keep the package name in sync — the module id baked into lib/client.js comes from package.json, and the loader matches the bundle row to that id.
MIT