奶蛙美化 bauerelizabeth07139/nai

nai

dsh.so risk

DeepSeek Harness Web GUI 的 Nai（奶蛙）吉祥物外观层 —— 插件内置 Nai 原图，由 harness 作为背景、品牌标识和设置界面来展示。

Nai original
Nai wallpaper

功能

- 聊天背景 —— 内置的 16:9 原图作为固定、可穿透点击的图层，挂在整个 GUI 后面。shell 的表面 token（--dsw-alias-bg-base、--dsw-specific-sidebar-fill、--dsw-alias-bg-layer-1/2）会按配置的不透明度淡化，让壁纸真正透出来，而不是被不透明的 shell 挡住，同时清空根背景。
- 控制项 —— shell 表面的不透明度、壁纸模糊、提升可读性的暗色蒙层，以及 background-position，全部实时生效。
- 品牌标识 —— 方形 Nai 头像通过内置的 sidebar.brand.mark 和 conversation.hero.brand.mark 插槽，替换侧边栏和对话主视觉区的 logo。
- 设置分区 —— 设置里新增「奶蛙美化 Nai」页面，可编辑所有内容，附带两张原图的预览，保存后生效。
- 标签页图标 —— 品牌标识开启时，浏览器标签页 favicon 同步换成 Nai 头像；关闭后恢复内置图标。
- 宿主端 —— 由本地 DSH web 服务器提供原图和配置（/api/nai/...），浏览器无需访问外部，并把配置写入 HTML，让 GUI 启动时就已经装扮好。

安装

DeepSeek Harness Desktop —— 从应用里安装，不要用 shell：打开侧边栏的 Plugins，选择 Add plugin，输入

https://github.com/bauerelizabeth07139/nai

然后打开新增的 nai bundle 开关。Desktop 应用启动的是保留的 desktop 配置档，所以下面的命令会装进另一个配置档，Desktop 应用根本不会读取。

dsh 命令行（web 配置档） —— 装进你启动时用的配置档：

dsh plugin --profile web add bauerelizabeth07139/nai

机器上没有 git？ pnpm 会用 git ls-remote 解析 git 简写，所以 PATH 里没有 git 时，owner/repo 或 github: 形式的 spec 会报 'git' is not recognized。改用纯 HTTPS 安装已发布的 tarball —— 这条路径不会调用 git：

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

同一个地址在 Desktop 应用的 Plugins → Add plugin 对话框里也能用。想要固定构建版本时，把 main 换成 commit SHA（/tar.gz/<sha>）即可锁定修订。

插件管理器接受的任何 spec 都可以 —— GitHub 简写、完整 git URL，或本地 checkout：

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

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

配置

配置放在 $DSH_HOME/nai.json（默认 ~/.dsh/nai.json），由「设置」区域编辑，也能通过 HTTP 访问。

| 字段 | 默认值 | 含义 |
| wallpaper | true | 把 Nai 插画用作 GUI 背景 |
| brand | true | 把侧边栏和主视觉 logo 换成 Nai 头像 |
| surfaceOpacity | 60 | 外壳表面不透明度，单位 % —— 数值越低，壁纸露出越多；数值越高，外壳越不透明（25–100） |
| blur | 0 | 施加到壁纸上的高斯模糊，单位 px（0–24） |
| scrim | 35 | 覆盖在壁纸上的配色蒙层 —— 深色主题下为黑色，浅色主题下为白色 —— 让对话记录更易读，单位 %（0–90） |
| position | center | 壁纸的 background-position：center、left、right、top、bottom |

| 路由 | 方法 | 用途 |
| /api/nai/config | GET / PUT | 读取 / 写入配置（写入仅限同源） |
| /api/nai/wallpaper | GET | 16:9 背景插画 |
| /api/nai/mark | GET | 方形头像插画 |
| /api/nai/diag | GET / POST | 最近一次浏览器端诊断报告（挂载状态、表面覆盖、错误） |

所有取值都会在服务端做范围钳制；未知键直接丢弃。

插画来源

随包发布的三张图都来自同一张原始照片（nai.jpg，按原样逐字节发布）：

- assets/nai.jpg —— 原始文件，未做修改。
- assets/nai-mark.jpg —— 从照片中裁出角色（头部到双手）的 160×160 区域，再重采样到 512×512。
- assets/nai-wallpaper.jpg —— 1536×864，把角色从白色背景中泛洪填充抠出，合成到浅色 16:9 画布上，并加上柔和的地面阴影和淡淡的散景。

没有 AI 重绘：每张随包资源里的角色都是照片里的那一个。

开发

没有构建步骤，没有运行时依赖（React 和 @deepseek-ai/cordis 是由 harness 提供的 peer 依赖）。

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

- lib/index.js —— 宿主端：配置文件、三条路由、HTML 启动标记。
- lib/client.js —— 浏览器端：壁纸层、表面淡出、品牌标记插槽、设置区域。
- cordis.patch.yml —— 让两端都加载起来的 loader 行。

插件元数据

manifest 声明了 Harness 和插件目录在不激活插件的情况下会读取的内容：

| 字段 | 值 |
| dsh.bundle.patch | ./cordis.patch.yml —— 让这个包成为可安装配置档 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，读取方解析的两个子路径 |

两个 locale 文件和图标都通过包说明符解析，所以 exports 未开放这些子路径的包，会以裸包名显示，而不是它的标题。

故障排查

应用无法启动：... is not valid JSON

Harness Host 在加载任何插件之前，会先把每个配置档清单当作 JSON 读取，所以清单开头 { 前多出一个 ,，读取就会抛错，应用随之停止。桌面版的恢复操作「Disable third-party plugins」修不好它：它会重新读取同一份损坏的清单。

找出损坏的文件——桌面版应用启动的是 $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 的文件，如果第一个非空白字符是逗号，其余部分其实完好：删掉那一个字符即可。如果它是配置档清单，整个删掉也行——下次启动会按随附模板重建，只会丢掉 bundle 选择，因为已安装的包仍留在配置档的 node_modules 里；再到 Plugins 里把 nai 重新打开即可。清单损坏期间，dsh plugin 和 Plugins 页面都跑不起来。

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 重绘。

开发

bash
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）： powershell $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