dsh-kaze-tachinu-theme:为 DSH Web GUI 换上《起风了》天蓝玻璃主题

前言

DeepSeek Harness(DSH)的 Web 界面默认是功能向的纯色或渐变背景,长时间对着同一套视觉,对日常用 dsh web 调试智能体、跑会话的开发者来说缺少一点「留在界面里」的动机。社区里有人用插件只改配色,有人用皮肤中心试穿;若你希望在不改 DSH 源码的前提下,把整页换成电影感壁纸、毛玻璃表面和统一的天蓝交互色,dsh-kaze-tachinu-theme 就是面向 Web profile 的一条标准 bundle 安装路径。下面介绍它是什么、改动了哪些界面元素,以及如何安装、更新与卸载。

这是什么

dsh-kaze-tachinu-theme(仓库 suuuuunamei/dsh-kaze-tachinu-theme)是维护者 suuuuunamei 发布的 DSH 插件,分类为 趣味换装。它将宫崎骏动画《起风了》(風立ちぬ / The Wind Rises)的视觉语言映射到 DSH Web GUI:菜穗子在山坡写生的电影壁纸垫底,界面表面改为半透明毛玻璃,交互色统一为天蓝 #1C96B5,侧边栏与首页 hero 使用自绘红翼飞机矢量徽标,输入区重绘为云海蓝玻璃胶囊,占位文案按界面语言替换。

它是一个标准的 dsh 插件包:通过 dsh plugin --profile web add 装进 profile,随 DSH 启动常驻,不修改 DSH 源码;卸载后页面可完全还原。SkillHub 目录页:https://www.skillhub.cn/plugins/suuuuunamei/dsh-kaze-tachinu-theme。许可证为 MIT(见仓库 package.json 与 README 徽章)。

维度 原生 DSH Web 本主题
背景 纯色 / 纯色渐变 晴空电影壁纸 + 全局模糊遮罩
界面表面 不透明分层 半透明毛玻璃(backdrop-filter)
品牌标识 DSH 默认 自绘红翼飞机徽标(展开 + 折叠纸飞机)
交互色 默认 天蓝 #1C96B5
安装 — 一条 dsh plugin --profile web add
还原 — 卸载即还原

核心功能

天蓝玻璃拟态与 token 覆盖

主题通过官方 theme.overrideTokens API 叠加约 60 项 design token:背景层半透明以露出壁纸,边框为低饱和天蓝描边,悬停/激活/选中态统一为天蓝系,错误/成功/警告等状态色微调以适配深色玻璃。亮色与暗色模式共用同一套视觉。完整 token 清单见仓库 docs/theme-tokens.md。

壁纸、徽标与静态路由

壁纸由插件宿主半区以 /kaze-tachinu/current.jpg 提供(包内 assets/current.jpg),并叠加轻微深色渐变以保证文字可读。侧边栏展开态显示横向徽标(红翼飞机 + The Wind Rises 字标),折叠态显示纸飞机字母标记;首页 hero 标题替换为居中大尺寸徽标。SVG 与壁纸均为包内资产,由宿主路由按包内路径解析。

输入卡、占位文案与会话统计

输入卡重绘为云海蓝玻璃胶囊。占位文案按界面语言自动替换,并同步 Lexical 输入框的 data-placeholder、aria-label 与可见占位层;宿主重渲染后由 MutationObserver 补写。中文界面输入框统一为「風立ちぬ——让想法随风飘去」;英文输入框为「風立ちぬ。いざ生きめやも。」;若宿主提供独立的「新会话描述」输入框,英文为 Kaze Tachinu — let your thoughts ride the wind。

composer 区的会话统计行(如「20 轮 · 185 步 | LLM …」)重绘为居中轻玻璃胶囊。消息列底部增加 40px 渐变淡出蒙版:主题将滚动视口下沉到纯消息列,避免蒙版裁切输入框。全局滚动条统一为天蓝玻璃风格(Chromium 系为主,Firefox 有 scrollbar-color 兜底)。

抗哈希漂移(v2)

DSH 前端组件类名带构建期哈希,升级后类名会变。自 v2 起,消息滚动、底部渐隐与统计栏胶囊不再在 CSS 里硬绑这些哈希类,而由浏览器半区运行时引擎用稳定属性(如 [data-conversation-scroll]、[data-slot="conversation.session]")与类名后缀定位 DOM,成功后打上 data-kaze-scroll、data-kaze-scroll-inner、data-kaze-stats 等标记;定位失败则不动手,保留原生滚动与默认外观。纯装饰区域(hero、侧边栏品牌、输入卡内 hint)仍可能因哈希漂移局部降级,但不影响对话可用性。

安装与启用

系统要求

  1. 已安装 DeepSeek Harness,且 dsh web 能正常启动。
  2. 机器上有 pnpm(dsh plugin 内部使用;可用 Node.js 的 corepack 启用)。
  3. DSH Desktop 用户:profile 位于 %APPDATA%/dsh-desktop/harness/profiles/;命令行环境需将 DSH_HOME 指向对应 harness 目录。

README 建议主题大量使用 backdrop-filter 与滚动条定制,优先使用 Microsoft Edge 或 Google Chrome;Firefox 下滚动条、渐变蒙版等效果可能不完整。

发布版安装

先执行安装命令,再重启 Web 界面:

dsh plugin --profile web add dsh-kaze-tachinu-theme
dsh web

也可从 GitHub 安装:

dsh plugin --profile web add github:suuuuunamei/dsh-kaze-tachinu-theme
dsh web

壁纸出现、侧边栏徽标替换生效,即表示安装成功。插件随 DSH 启动常驻,无需每次重装。

更新与卸载

更新:

dsh plugin --profile web update dsh-kaze-tachinu-theme
dsh web

卸载:

dsh plugin --profile web remove dsh-kaze-tachinu-theme
dsh web

暂时关闭(不卸载):编辑 profile 的 package.json,从 dsh.profile.bundles 数组中删除 "dsh-kaze-tachinu-theme" 一行后重启;加回该行再重启即可恢复。

典型用法与可选通道

验证运行时标记

在任一会话的「对话」页签打开后,于浏览器 Console 运行 README 中的探测脚本,预期输出为 kaze-scroll根=1 | 内层=1 | 统计栏=1 | conv-scroll=2(或 README 所述的 1 / 1 / 1 / 2 含义一致):

console.log('kaze-scroll根=', document.querySelectorAll('[data-kaze-scroll]').length,
  '| 内层=', document.querySelectorAll('[data-kaze-scroll-inner]').length,
  '| 统计栏=', document.querySelectorAll('[data-kaze-stats]').length,
  '| conv-scroll=', document.querySelectorAll('[data-conversation-scroll]').length);

若滚动相关标记全为 0,需对照 README「常见问题」排查是否加载了旧版 client 或引擎未生效。

皮肤中心(与插件二选一)

若使用 dsh-web-ui 的皮肤中心,可将仓库 skin/kaze-tachinu/ 整目录复制到 ~/.dsh/skins/kaze-tachinu/(DSH Desktop 为 %APPDATA%/dsh-desktop/harness/skins/kaze-tachinu/),刷新后在「设置 → 皮肤中心」试穿或切换。说明:手工投放的皮肤不带经市场溯源的 hooks.mjs 行为增强(滚动下沉、占位文案、统计栏标记等);壁纸、配色、徽标、玻璃样式仍可用。经 dsh plugin 安装为功能全量。两条通道共享 v2 抗漂移引擎代码,择一即可。

本地开发与自定义

未发布到 npm 时,可用本地路径安装(改代码后需按 README 刷新快照或改用 link:):

dsh plugin --profile web add file:/绝对路径/dsh-kaze-tachinu-theme
# 或
dsh plugin --profile web add link:/绝对路径/dsh-kaze-tachinu-theme

换壁纸:替换包内 assets/current.jpg 后浏览器强刷(Ctrl+F5)。换徽标:替换 assets/logo/ 下 SVG。换占位文案或调色:修改 bundle/client.js、skin/kaze-tachinu/hooks.mjs 或 token 表(见 docs/theme-tokens.md)后重启并强刷。

适用场景与注意

适合谁: 长期在浏览器里使用 DSH Web、希望界面有统一电影壁纸与玻璃拟态、又愿意接受插件随 DSH 进程加载的开发者。不适合必须在 Firefox 下获得与 Chrome 完全一致滚动条与蒙版效果的环境。

安全与信任: 插件以当前 dsh 进程的权限运行,会向 Web 页面注入 client 半区脚本、在宿主侧注册 /kaze-tachinu/* 静态路由。安装前应阅读仓库源码与 MIT 许可证,并确认维护者与来源(GitHub suuuuunamei/dsh-kaze-tachinu-theme)。SkillHub 等为社区目录站点,与 DeepSeek / 幻方无官方从属关系;星标等元数据以目录与仓库页面为准(当前线索为 GitHub 1 stars)。

已知限制(摘要): 装饰性 CSS 仍依赖少量哈希类名,DSH 大版本升级后可能出现局部视觉降级;Firefox 部分效果打折。装完无变化时,确认命令含 --profile web、强刷浏览器,并查看 dsh web 日志是否出现 [kaze-tachinu-theme] host half active。

结尾

经过上面的步骤,dsh-kaze-tachinu-theme 把 DSH Web GUI 从默认分层界面换成《起风了》主题的天蓝玻璃与电影壁纸,并通过 v2 运行时标记降低前端哈希漂移对对话滚动的影响。需要一键装进 profile 时用 dsh plugin --profile web add;只想试视觉、走皮肤中心时按 README 复制 skin/kaze-tachinu/ 即可。

  • 目录页:https://www.skillhub.cn/plugins/suuuuunamei/dsh-kaze-tachinu-theme
  • GitHub:https://github.com/suuuuunamei/dsh-kaze-tachinu-theme
羽毛球分组比赛记分
小程序二维码

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

Xiaoye