nai

Nai (奶蛙) mascot appearance layer for the DeepSeek Harness Web GUI — the original Nai photo, shipped inside the plugin, worn by the harness as its background, its brand mark, and its settings surface.

What it does

• Chat background — the shipped 16:9 artwork is mounted as a fixed, click-through layer behind the whole GUI. The shell's surface tokens (--dsw-alias-bg-base, --dsw-specific-sidebar-fill, --dsw-alias-bg-layer-1/2) are faded to the configured opacity so the wallpaper actually shows through instead of hiding behind an opaque shell, and the root background is cleared for it.
• Controls — opacity of the shell surfaces, wallpaper blur, a dark scrim for readability, and background-position, all applied live.
• Brand mark — the square Nai avatar replaces the logo in the sidebar and the conversation hero through the stock sidebar.brand.mark and conversation.hero.brand.mark slots.
• Settings section — a 「奶蛙美化 Nai」 page in Settings edits everything, with previews of both artworks, and applies on save.
• Tab icon — the browser tab favicon follows the same Nai avatar while the brand mark is on, and the stock icons come back when it is switched off.
• Host half — serves the artwork and the config from the local DSH web server (/api/nai/...), so the browser never reaches outside, and stamps the config into the HTML so the GUI comes up already dressed.

Install

DeepSeek Harness Desktop — install it from the application, not from a shell: open Plugins in the sidebar, choose Add plugin, enter

https://github.com/bauerelizabeth07139/nai

and switch the new nai bundle on. The Desktop application boots the reserved desktop profile, so the command below installs into a different profile that the Desktop app never reads.

dsh CLI (web profile) — install it into the profile you boot:

dsh plugin --profile web add bauerelizabeth07139/nai

No git on the machine? pnpm resolves a git shorthand with git ls-remote, so an owner/repo or github: spec fails with 'git' is not recognized when git is missing from PATH. Install the published tarball over plain HTTPS instead — that path never calls git:

dsh plugin --profile web add https://codeload.github.com/bauerelizabeth07139/nai/tar.gz/main

The same address works in the Desktop application's Plugins → Add plugin dialog. Pin the revision by replacing main with a commit SHA (/tar.gz/<sha>) when you want a fixed build.

Any spec the plugin manager accepts works — a GitHub shorthand, a full git URL, or a local checkout:

dsh plugin --profile web add https://github.com/bauerelizabeth07139/nai.git
dsh plugin --profile web add C:\path\to\nai

Then open Settings → 奶蛙美化 Nai. Uninstall with dsh plugin --profile web remove nai.

Configuration

The config lives at $DSH_HOME/nai.json (default ~/.dsh/nai.json) and is edited by the Settings section; it is also reachable over HTTP.

Field	Default	Meaning
wallpaper	true	Wear the Nai artwork as the GUI background
brand	true	Replace the sidebar and hero logos with the Nai avatar
surfaceOpacity	60	Shell surface opacity in % — lower shows more of the wallpaper, higher keeps the shell opaque (25–100)
blur	0	Gaussian blur applied to the wallpaper, in px (0–24)
scrim	35	Palette-matched wash over the wallpaper — black in the dark theme, white in the light theme — for a readable transcript, in % (0–90)
position	center	Wallpaper background-position: center, left, right, top, bottom

Route	Method	Purpose
/api/nai/config	GET / PUT	Read / write the config (writes are same-origin only)
/api/nai/wallpaper	GET	The 16:9 background artwork
/api/nai/mark	GET	The square avatar artwork
/api/nai/diag	GET / POST	Last browser-side diagnostic report (mount state, surface overrides, errors)

Every value is clamped server-side; unknown keys are dropped.

Artwork provenance

All three shipped images come from one original photo (nai.jpg, shipped byte for byte as given):

• assets/nai.jpg — the original file, unmodified.
• assets/nai-mark.jpg — a 160×160 crop of the character (head to hands) from that photo, resampled to 512×512.
• assets/nai-wallpaper.jpg — 1536×864, the character flood-filled off its white backdrop and composited onto a light 16:9 canvas with a soft ground shadow and faint bokeh.

No AI re-rendering: the character in every shipped asset is the one from the photo.

Development

No build step, no runtime dependencies (React and @deepseek-ai/cordis are peers supplied by the harness).

npm test   # node >= 22: host routes/config/stamp tests + client DOM-stub tests

• lib/index.js — the host half: config file, three routes, HTML boot stamp.
• lib/client.js — the browser half: wallpaper layer, surface fade, brand-mark slots, Settings section.
• cordis.patch.yml — the loader row that makes both halves load.

---

Plugin metadata

The manifest declares what the Harness and the plugin catalogs read without activating the plugin:

Field	Value
dsh.bundle.patch	./cordis.patch.yml — what makes this package an installable profile bundle
dsh.client	platform: web, so the browser half ships with the bundle
locale/en.json, locale/zh.json	card title and description (meta.title, meta.description)
icon	./assets/nai-mark.jpg — the card artwork (SVG/PNG/JPEG/WebP, at most 256 KiB)
exports	./package.json and ./locale/*.json, the two subpaths the readers resolve

Both locale files and the icon are resolved through the package specifier, so a package that keeps exports sealed without these subpaths shows up under its bare package name instead of its title.

Troubleshooting

The application does not start: ... is not valid JSON

The Harness Host reads each profile manifest as JSON before it loads any plugin, so one stray , before the opening { of a manifest makes the read throw and the application stop. The Desktop recovery action "Disable third-party plugins" cannot repair it: it re-reads the same broken manifest.

Find the damaged file — the Desktop application boots $DSH_HOME/profiles/desktop ($DSH_HOME defaults to ~/.dsh):

$home = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE '.dsh' }
Get-ChildItem (Join-Path $home 'profiles\*\package.json'), (Join-Path $home 'profiles\*\node_modules\*\package.json') -ErrorAction SilentlyContinue |
  ForEach-Object { try { $null = Get-Content $_ -Raw | ConvertFrom-Json; "OK   $_" } catch { "BAD  $_" } }

A BAD file whose first non-space character is a comma is otherwise intact: delete that one character. Deleting the whole file also works when it is the profile manifest — the next start re-creates it from the shipped template and only the bundle selection is lost, because installed packages stay in the profile's node_modules; switch nai back on from Plugins. While the manifest is broken, neither dsh plugin nor the Plugins page can run.

中文

DeepSeek Harness 网页端的奶蛙美化形象插件 —— 一张奶蛙原图随插件一起分发,由 Harness 当作背景、品牌标识与设置项穿在身上。

功能

• 聊天背景:内置 16:9 壁纸作为不可点击的全屏背景层;同时把界面的表面色令牌(--dsw-alias-bg-base、--dsw-specific-sidebar-fill、--dsw-alias-bg-layer-1/2)按设定透明度调淡,背景才能真正透出来,而不是被不透明的界面挡住。
• 可调参数:界面不透明度、背景模糊、暗色遮罩、壁纸位置,改动即时生效。
• 品牌标识:通过官方的 sidebar.brand.mark 与 conversation.hero.brand.mark 插槽,把侧栏与会话标题处的 logo 换成奶蛙方形头像。
• 设置页:Settings 里的「奶蛙美化 Nai」页面提供两张素材预览与全部开关,保存即生效。
• 标签页图标:品牌标识开启时,浏览器标签页小图标也换成同一张 Nai 头像;关闭后恢复官方图标。
• 宿主半:由本地 DSH Web 服务直接提供素材与配置接口(/api/nai/...),浏览器无需访问外部网络;配置同时被盖进 HTML,页面一打开就是美化后的样子。

安装

桌面版 DeepSeek Harness:请在应用内安装——侧栏 Plugins → Add plugin,填入

https://github.com/bauerelizabeth07139/nai

然后打开 nai 这个 bundle。桌面版启动的是保留 profile desktop,而下面的命令行会把插件装进另一个 profile,桌面版不会读取它。

dsh 命令行(web profile):装进你实际启动的 profile。

dsh plugin --profile web add bauerelizabeth07139/nai

机器上没有 git? pnpm 解析 git 形式的依赖时会调用 git ls-remote,owner/repo、github: 这类写法在 PATH 里找不到 git 时会直接报 'git' 不是内部或外部命令。改成用 HTTPS 直接下载 tarball 即可,这条路径完全不需要 git:

dsh plugin --profile web add https://codeload.github.com/bauerelizabeth07139/nai/tar.gz/main

同样的地址也能填进桌面版的 Plugins → Add plugin。想要固定版本,把 main 换成提交 SHA (/tar.gz/<sha>) 即可。

随后打开 Settings → 奶蛙美化 Nai。卸载:dsh plugin --profile web remove nai。

配置

配置文件为 $DSH_HOME/nai.json(默认 ~/.dsh/nai.json),字段与取值范围见上方英文表格;服务端会做钳制并丢弃未知字段。

素材来源

三张素材全部来自同一张原图(插件内的 nai.jpg 即原文件、逐字节一致):头像由原图裁切并重采样,壁纸则把原图中的角色从白底上抠出、贴到 16:9 浅色画布上并加柔和落影。全程没有 AI 重绘。

开发

npm test   # 需要 node >= 22,无任何运行时依赖

插件元数据

manifest 里声明了 Harness 与插件目录在不激活插件的情况下会读取的字段:

字段	值
dsh.bundle.patch	./cordis.patch.yml —— 让这个包成为可安装 profile bundle 的关键
dsh.client	platform: web,浏览器半随 bundle 一起分发
locale/en.json、locale/zh.json	卡片标题与描述(meta.title、meta.description)
icon	./assets/nai-mark.jpg —— 卡片配图(SVG/PNG/JPEG/WebP,上限 256 KiB)
exports	./package.json 与 ./locale/*.json,读取方解析的这两个子路径

两个语言文件与图标都是通过包名解析的:若 exports 没有开放这两个子路径,插件在列表里 只会显示裸包名,而不是这里的标题。

疑难解答

应用无法启动,报 ... is not valid JSON

Host 在加载任何插件之前会把每个 profile manifest 当作 JSON 读取;只要某个 manifest 开头的 { 之前多出一个 ,,这次读取就会抛错,应用随之停止。桌面版 的「禁用第三方插件」恢复按钮修不好它,因为它会重新读取同一个坏文件。

定位损坏的文件(桌面版启动的是 $DSH_HOME/profiles/desktop,$DSH_HOME 默认 为 ~/.dsh):

$home = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $env:USERPROFILE '.dsh' }
Get-ChildItem (Join-Path $home 'profiles\*\package.json'), (Join-Path $home 'profiles\*\node_modules\*\package.json') -ErrorAction SilentlyContinue |
  ForEach-Object { try { $null = Get-Content $_ -Raw | ConvertFrom-Json; "OK   $_" } catch { "BAD  $_" } }

报告为 BAD 且第一个非空白字符是逗号的文件,其余内容是完好的:删掉那一个逗号 即可。如果坏的是 profile manifest 本身,直接删除整个文件也可以——下次启动会按 内置模板重建,只会丢失 bundle 的勾选记录,已安装的包仍留在 profile 的 node_modules 里,在 Plugins 页面重新打开 nai 即可。manifest 损坏期间, dsh plugin 与 Plugins 页面同样无法工作。

License

MIT