dsh-avatar-top
将侧边栏账户头像（设置启动器）移出底部条，并在 Plugins 页面提供设置卡片：位置（包括零高度内联模式）、行高、间距以及开关。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:kiefeng/dsh-avatar-top#1fe8738394c8ce28bb912643ff8c5f1865abf4e0Avatar Top 以 dsh-avatar-top 发布，当前版本为 0.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Moves the left sidebar's account avatar (which is also the Settings launcher) out of the bottom strip, so the session list gains the space back. Placement, height and spacing are adjustable from a card on the Plugins page; inline brand row costs zero vertical space.
Tested against DeepSeek Harness
0.2.1-rc.2(desktop, Windows).
DSH pins a footer at the bottom of the left sidebar: the account row (头像 + 账号名) sits next to
sidebar.footer.action, where plugins such as dsh-cost-meter mount their own widgets.
This plugin moves only the account row:
display: contents, so its two children join the sidebar's flex column; the
account row is then reordered while _footerActions keeps its default order and stays pinned at
the bottom. (Moving the whole footer would drag other plugins' widgets along — that was a real
bug in 0.2.1.)position: absolute at the free right end, zero vertical cost).Changes apply immediately — the browser half subscribes to the settings document and rewrites the
stylesheet. Settings persist in the profile's cordis.patch.yml.
| Setting | Values | Default |
|---|---|---|
| Enabled | on / off | on |
| Position | top / below brand / below New Session / inline brand row | top |
| Height | full 44 / compact 32 / avatar only 28 | full 44 |
| Spacing below | 0–24 px | 4 |
| Restore defaults | button | — |
dsh plugin add dsh-avatar-top
Restart DSH once after installing (the client bundle and package metadata are read at host start). Then open Plugins → dsh-avatar-top to configure it.
Git install works too, e.g. dsh plugin add git+https://github.com/<owner>/dsh-avatar-top.
Self-check: the plugin serves its current stylesheet at /dsh-avatar-top.css (public, read-only),
so a wrong layout can be diagnosed without a session:
http://127.0.0.1:<dsh-port>/dsh-avatar-top.css
The Host contributes one structured style row through webserver/index-inject:
ctx.on('webserver/index-inject', (table) => {
table.push({ kind: 'style', text: cssFor(readOptions(config)) })
})
Both shells render that row:
| Shell | Where the page comes from | How the row arrives |
|---|---|---|
Browser / dsh web | the SPA dist server answers the index over HTTP | renderIndex() renders the rows into the HTML |
| Desktop app | Electron serves dsh-web-frontend/dist/index.html itself over its dsh-app:// scheme | the Host's injection table is handed to the page over IPC after startup; the page-side interpreter appends style rows to <head> |
ctx.webServer.tapIndex() would only cover the HTTP shell; the desktop window never calls it.
The desktop snapshot is taken at Host start, so the browser half also applies the stylesheet live
(<style id="dsh-avatar-top-live">, appended after the boot row, so it wins) and the boot row only
prevents a flash on first paint.
The sidebar is a flex column; placement is pure order, and selectors key off the stable
CSS-module class-name suffixes (_root, _footArea, _settingsArea, _trigger, _label,
_avatar, _logoRow, _newSession, _panelList) rather than the per-build hash prefix.
html:not([data-platform='darwin']) [class*='_root']:not([class*='_collapsed']) > [class*='_footArea'] {
display: contents;
}
… > [class*='_footArea'] > [class*='_settingsArea'] {
order: -1;
margin-bottom: 4px;
}
:not([data-platform='darwin'])).display:none there anyway).inlineBrand lifts the button out of the flow (top: 8px; right: 12px; z-index: 3) and forces
the avatar-only shape. On non-Windows shells it falls back to top. While the update pill exists
(:has([class*='_indicator'])) the row returns to position: static; order: -3, i.e. a normal
28px row under the brand row.[class*='_trigger']:not([class*='_triggerRow']):not([class*='_triggerLabel']). A bare
[class*='_trigger'] also matches _triggerRow — the flex row holding the account button, the
connection indicator and the update pill — which collapsed the row to 28px and drew the pill
underneath the avatar (0.3.0 bug). The row itself only gets flex-wrap: wrap, so a pill that
cannot fit wraps instead of being pushed out of the sidebar.Config declares four volatile() fields (user settings, not deployment config), so the Host
serves the avatar-top namespace (the loader row id). The browser half binds it through
ctx.configForms.get('avatar-top'), writes through config.set() / config.unset() (which reach
remote.settings.mutate), and registers its card into the plugins.bundle.config keyed slot under
the package name.
sidebar.settings (instead of
sidebar.footer.action) would ride along; no shipped plugin does that today.inlineBrand needs the Windows titlebar (html[data-windows-titlebar]), where the collapse
toggle lives in the native titlebar. Elsewhere it falls back to the top placement.npm install # @deepseek-ai/schemastery, for the tests' host-side import
node --check lib/index.js
node --check lib/client.js
npm test
The smoke test covers the schema defaults and rejections, volatile-ref and plain-value inputs, the
full placement × height × spacing matrix, row de-duplication, the diagnostics route, a regression
assertion that _footerActions is never reordered (so cost meters and friends stay at the bottom),
and byte-equality of the two CSS generators across 120 option combinations.
lib/client.js is a hand-written bundle in the DSH client-module format
(window.__ModuleLoader__.load); it has no build step.
MIT