dsh-joi-channel-theme:为 DeepSeek Harness 换上轴伊 Joi 双衣装主题

前言

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。只有 webheadless 带有出厂模板,其他名字不会加载网页界面。

全局安装 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

典型用法

经过上面的安装步骤,日常操作全部在界面内完成,无需再敲命令行。

  1. 启动 Harness 并打开 Web 界面。
  2. 进入 设置 → 通用设置
  3. 在「换装」行选择 Joi·Flowers 或 Joi·Library;需要恢复默认时选「DeepSeek 原生」。
  4. 在同一页面的明暗设置中选择浅色、深色或跟随系统——明暗与衣装独立,可自由组合出四个象限。

对话过程中,观察输入框两侧角色的表情随任务状态(待机、执行中、成功、失败)自动切换,无需额外配置。

适用场景与注意

适合谁

  • 已在本地或内网使用 DeepSeek Harness Web 界面的开发者,想给日常工具换一套有完整视觉体系的皮肤。
  • 轴伊 Joi 或 VirtuaReal 粉丝,希望在开发环境里保留角色元素,同时不影响 Harness 本身的功能。
  • 需要离线友好、零外链素材的主题——全部资源内联打包,不依赖 CDN。

使用前请注意

  • 插件随当前 DSH 进程权限运行,安装前应阅读仓库源码与许可证(代码 MIT、资产 CC BY-NC-SA 4.0),确认非商业使用范围符合你的场景。
  • 这是粉丝二创,不得用于商业用途,也不得暗示与官方或权利方有关联。
  • 插件只改 Web 客户端外观,不修改模型调用、工具链或 agent 逻辑;若你用的是 headless profile,本插件的 Web 注入不会生效。
  • 从 GitHub 直装不推荐:pnpm ≥10 会拦截 prepare 构建脚本,首次安装可能失败;应通过 npm 官方包 dsh-joi-channel-theme 安装,包内已带构建产物。

结尾

dsh-joi-channel-theme 把轴伊 Joi 的两套官设衣装做成了 Harness 里可切换的完整房间:色板、角色、状态演出和细节彩蛋各自成体系,又能在设置里一键回到原生外观。对想把 DSH 界面个性化、又希望保持可逆和零残留的开发者来说,这是一条经过 npm 官方链路、文档齐全的换装路径。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜