前言¶
DeepSeek Harness(DSH)的 Web 界面默认是一套通用外观。对长期跑在本地或内网的开发者来说,界面往往只是「能用」——配色、图标、对话状态反馈都停留在框架默认层,和你在用的工具链没有视觉上的关联。
社区里已有不少 DSH 插件扩展能力,但「换皮」类插件相对少见,且多数只是改几个 CSS 变量。下面介绍的是维护者 tpmoonchefryan 发布的 dsh-joi-channel-theme:一套基于 VirtuaReal 虚拟主播轴伊 Joi 官设制作的非官方粉丝主题,把两套完整衣装(Joi·Flowers / Joi·Library)搬进 Harness 的每个界面角落,并在对话状态变化时同步演出角色表情。
这是什么¶
dsh-joi-channel-theme 是 DSH 的 Web 客户端主题插件,插件 ID 为 dsh-joi-channel-theme,当前 npm 版本 0.1.10。它在 SkillHub 社区目录中归类为「趣味换装」,GitHub 仓库约 11 stars。
插件定位很明确:把 DeepSeek Harness 的界面换成轴伊 Joi 的两间「房间」——暖色舞台感的 Joi·Flowers 和冷色书房感的 Joi·Library。两套衣装各自拥有独立的底色、面板、气泡、代码高亮、底纹和角色演出,互不混用;明暗模式(浅色 / 深色 / 跟随系统)仍由 Harness 原生设置控制,换装只切换色相体系。
需要事先说明:这是非官方、非商业的粉丝作品,与轴伊 Joi、VirtuaReal、哔哩哔哩、DeepSeek 及相关权利方不存在隶属或授权关系。代码以 MIT 许可发布,角色与视觉资产以 CC BY-NC-SA 4.0 许可发布。
核心功能¶
双衣装完整主题¶
每套衣装覆盖 19 级中性色阶、44 条语义色映射和 9 项代码高亮(浅深各一套值)。侧栏 logo 换成轴伊与鲸鱼娘的双人合照,随衣装切换;标签页图标、列表记号等细节也一并替换。全部视觉素材以内联 WebP data URI 打包(10 件,约 2.4 MB),不依赖外链,对 CSP 友好。
对话状态演出¶
对话页输入框两侧各有一个 Q 版角色:左侧为粉丝形象「轴芯」,右侧为轴伊。它们共享同一套状态词表,在同一时刻切换表情:
| 状态 | 标识 | 表现 |
|---|---|---|
| 待机 | info |
默认姿态 |
| 执行中 | running |
工作中 |
| 成功 | success |
眯眼开心 |
| 失败 | error |
垂眼落泪,约五秒后回到待机 |
长对话中文字与角色重叠时,重叠行会自动加底色描边以保证可读性。
界面内换装与回退¶
安装后,在 设置 → 通用设置 → 换装 中可见三张卡片:Joi·Flowers、Joi·Library,以及「DeepSeek 原生」。选原生外观不会卸载插件,只是切回框架默认皮肤;再选任一套衣装即可恢复。明暗仍由下方的浅色 / 深色 / 跟随系统控制。
其他设计细节¶
- 上下文用量指示改为一颗会随用量变色的橘子,熟过头即警示。
- 子代理任务以小鲸鱼图标排队展示:排队闭眼、运行喷水、完成眯眼。
- 设计基线冻结在
baseline-4q.json,构建期生成常量;四套象限(两衣装 × 浅深)各有独立校色。
兼容要求:DeepSeek Harness Web 0.1.0-rc.5+。
安装与启用¶
DSH 插件目前只能通过命令行安装,装完后需重启 Harness 进程才会生效。安装前确认运行环境:
| 前提 | 检查命令 |
|---|---|
Node.js ^22.19 或 >=24 |
node -v |
pnpm(dsh plugin 依赖它管理 profile 依赖) |
pnpm -v |
没有 pnpm 时,任选一种方式安装:
npm install -g pnpm
或
corepack enable pnpm
用 npx 启动 Harness 的情况¶
若你平时用 npx @deepseek-ai/dsh web 启动,dsh 命令不在 PATH 上,需加同样的 npx 前缀:
npx @deepseek-ai/dsh plugin --profile web add dsh-joi-channel-theme
装完后照常启动:
npx @deepseek-ai/dsh web
profile 名必须是 web。只有 web 和 headless 带有出厂模板,其他名字不会加载网页界面。
全局安装 dsh 的情况¶
npm install -g @deepseek-ai/dsh
dsh plugin --profile web add dsh-joi-channel-theme && dsh web
浏览器打开终端打印的地址(默认 http://127.0.0.1:3080),硬刷新一次即可看到主题。若 Harness 已在运行,需先 Ctrl+C 停掉再重启,插件集变更不支持热加载。
卸载¶
npx @deepseek-ai/dsh plugin --profile web remove dsh-joi-channel-theme
卸载后界面会逐项回到原生外观,README 称经过实机逐项核对,token、图标、字标、代码高亮均无残留。
国内网络下若 npx 拉取失败,可临时指定官方源:
npx --registry=https://registry.npmjs.org/ @deepseek-ai/dsh plugin --profile web add dsh-joi-channel-theme
典型用法¶
经过上面的安装步骤,日常操作全部在界面内完成,无需再敲命令行。
- 启动 Harness 并打开 Web 界面。
- 进入 设置 → 通用设置。
- 在「换装」行选择 Joi·Flowers 或 Joi·Library;需要恢复默认时选「DeepSeek 原生」。
- 在同一页面的明暗设置中选择浅色、深色或跟随系统——明暗与衣装独立,可自由组合出四个象限。
对话过程中,观察输入框两侧角色的表情随任务状态(待机、执行中、成功、失败)自动切换,无需额外配置。
适用场景与注意¶
适合谁
- 已在本地或内网使用 DeepSeek Harness Web 界面的开发者,想给日常工具换一套有完整视觉体系的皮肤。
- 轴伊 Joi 或 VirtuaReal 粉丝,希望在开发环境里保留角色元素,同时不影响 Harness 本身的功能。
- 需要离线友好、零外链素材的主题——全部资源内联打包,不依赖 CDN。
使用前请注意
- 插件随当前 DSH 进程权限运行,安装前应阅读仓库源码与许可证(代码 MIT、资产 CC BY-NC-SA 4.0),确认非商业使用范围符合你的场景。
- 这是粉丝二创,不得用于商业用途,也不得暗示与官方或权利方有关联。
- 插件只改 Web 客户端外观,不修改模型调用、工具链或 agent 逻辑;若你用的是
headlessprofile,本插件的 Web 注入不会生效。 - 从 GitHub 直装不推荐:pnpm ≥10 会拦截
prepare构建脚本,首次安装可能失败;应通过 npm 官方包dsh-joi-channel-theme安装,包内已带构建产物。
结尾¶
dsh-joi-channel-theme 把轴伊 Joi 的两套官设衣装做成了 Harness 里可切换的完整房间:色板、角色、状态演出和细节彩蛋各自成体系,又能在设置里一键回到原生外观。对想把 DSH 界面个性化、又希望保持可逆和零残留的开发者来说,这是一条经过 npm 官方链路、文档齐全的换装路径。