dsh-kimino-theme

一句话定位

把 DSH Web GUI 改造成新海诚《你的名字。》的电影感界面：壁纸垫底、毛玻璃拟态、彗星蓝主题色、电影 Logo 替换默认品牌；一条命令安装，卸载即完全还原。

核心能力

• 暴露壁纸与 Logo 静态资源：在 DSH Web 服务上挂载 /kimino-bg/current.jpg、/kimino-bg/logo-blue.svg、/kimino-bg/logo-letter.svg 三个路由，给浏览器半区提供素材
• 整体视觉改造：覆盖约 60 项 DSH 设计 token（背景层、边框、按钮、交互态、滚动条、状态色等），统一为深色玻璃 + 彗星蓝（#93C5FD）配色
• 替换默认品牌：首页大标题用电影 Logo 居中展示，侧边栏展开态换成电影 Logo，折叠态切成字母标记
• 重绘输入卡：藏蓝玻璃胶囊造型 + 主题化占位文案（中文「黄昏之时，我在这里等你。」、英文「黄昏の時、私はここにいるよ。」）
• 局部修复：消息列底部 40px 渐变蒙版淡出、修复「回到底部」按钮在某些会话中不出现的 bug、规范化输入卡与聊天区滚轮行为
• 全局统一滚动条：Chromium 内核下薄型蓝紫玻璃滚动条，亮/暗模式共用一套视觉

技术实现

• 语言: JavaScript（ESM，"type": "module"）
• 关键依赖: DSH 宿主 webServer（注册静态资源路由）、DSH 客户端 theme（overrideTokens 注入设计 token）、原生 node:fs/promises + node:path（读取资产）；浏览器侧通过 window.__ModuleLoader__ 注册
• 架构模式: 标准 DSH 双半区 bundle：宿主半区（bundle/host.js）注入 webServer 注册 3 个资源路由；浏览器半区（bundle/client.js）作为 ./client 导出由客户端模块系统加载；两半区都通过 ctx.effect 注册副作用，禁用/卸载即完全还原
• 入口文件: bundle/host.js（main 字段，宿主半区）+ bundle/client.js（exports['./client'] 字段，浏览器半区）；package.json#dsh.bundle.patch 指向 cordis.patch.yml，挂载插件行 kimino-theme

适用场景

喜欢《你的名字。》视觉风格、希望 DSH 聊天界面看起来更私人化、不想修改 DSH 源码只想换皮的普通用户。一条命令装上即可获得壁纸 + 毛玻璃 + 主题色 + Logo 替换效果，不喜欢时一行命令卸载即可彻底还原。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:niiang/dsh-kimino-theme

配置项

本插件无需额外配置。安装后重启 dsh web 即可生效；卸载后所有视觉变更（token、样式表、滚动监听、路由）会通过 fiber 的 effect 链自动注销，页面回到 DSH 默认主题。

常见问题

Q: 安装后必须重启 dsh web 吗？

A: 是。安装插件后须重启 dsh web 才会加载宿主半区（壁纸/Logo 路由）和浏览器半区（token 覆盖 + 样式表）。浏览器侧还需 Ctrl+F5 强刷跳过网页缓存。

Q: 装完重启后页面没变化怎么办？

A: 先确认安装命令带 --profile web（装到了正确的 profile）；再 Ctrl+F5 强刷一次；仍不行时查看 dsh web 启动日志有没有 [kimino-theme] host half active (3/3 asset routes registered) 字样，若没有或路由数少于 3，说明本次安装未生效。

Q: 能和别的皮肤主题插件一起用吗？

A: 不建议。token 覆盖是叠加式的，但视觉上会互相覆盖（玻璃底色、滚动条、按钮色都会冲撞）。同一时间只启用一个主题类插件效果最好。

Q: DSH 大版本升级后样式错乱怎么办？

A: 主题部分选择器依赖 DSH 前端构建期哈希类名（如 .Md3f7G_*、.wSkVaW_*、.hHd-Xa_*、.FjxK0a_*、.pXSMma_*、.uV2eYG_*），大版本升级后这些哈希可能变化。受影响的选择器需要对照新版类名更新，可到 issue 区反馈附截图。

Q: 在 Firefox 下能用吗？

A: 毛玻璃、滚动条与渐变蒙版按 Chromium 内核（Edge / Chrome）打磨。Firefox 下部分显示效果不兼容（滚动条、渐变蒙版可能打折），建议改用 Edge 或 Chrome。

Q: 壁纸和 Logo 能换成自己的吗？

A: 可以。需本地克隆仓库并改用 link: 安装，然后在 assets/current.jpg 替换壁纸、assets/logo/ 下替换两个 SVG。路由侧设了 1 小时缓存（Cache-Control: public, max-age=3600），替换后请浏览器强刷。

Q: 占用 DSH 启动时间多吗？

A: 插件宿主半区在 DSH 启动时注册 3 个静态资源路由（壁纸/Logo），浏览器半区注册约 60 项 token 覆盖 + 一张样式表 + 几个滚动事件守卫。卸载/禁用后所有副作用（路由、样式、属性、监听器）都通过 fiber 的 effect 注销，页面完全还原。

Q: 如何彻底卸载？

A: 运行 dsh plugin --profile web remove dsh-kimino-theme 后重启 dsh web，主题的所有副作用（路由、token 覆盖、样式表、滚动事件监听）都会被清理，页面回到 DSH 默认。

上手难度

入门 — 一条命令安装、无需任何配置，重启后即可看到效果；遇到样式异常时按 README 常见问题排查即可。

已知问题与限制

• 部分选择器依赖 DSH 前端构建期哈希类名（Md3f7G_* / wSkVaW_* / hHd-Xa_* / FjxK0a_* / pXSMma_* / uV2eYG_*），DSH 大版本升级后这些哈希可能变化，需要跟随更新
• 毛玻璃、滚动条与渐变蒙版按 Chromium 内核（Edge / Chrome）打磨，Firefox 下部分显示效果不兼容（滚动条、渐变蒙版可能打折）
• 主题强制深色玻璃视觉，亮色模式不做单独适配（亮/暗模式共用同一套 token 与样式）
• 壁纸与 Logo 路由缓存 1 小时（Cache-Control: public, max-age=3600），替换素材后需浏览器强刷
• 主题内 token 覆盖与组件样式集中在 bundle/client.js，文件内存在大量 CSS 选择器（来源是 DSH 内置组件的内部类名），与 DSH 自身耦合较深，DSH 升级后样式需要适配

中文 | English

     

《你的名字。》(Kimi no Na wa) 主题，为 DeepSeek Harness (DSH) Web GUI 而作
彗星蓝玻璃拟态 · 电影壁纸 · Logo 替换 · 输入卡重绘 · 统一滚动条 · 一条命令安装

是什么

dsh-kimino-theme 把 DSH Web GUI 变成新海诚《你的名字。》的模样：一张电影壁纸垫底，全部界面表面换成半透明毛玻璃，交互色统一为彗星蓝（#93C5FD），侧边栏品牌与首页标题替换为电影 Logo，输入卡重绘为藏蓝玻璃胶囊，占位文案换成「黄昏之时，我在这里等你。」。

它是一个标准的 dsh 插件包：一条 dsh plugin 命令装进 profile，随 DSH 启动常驻，不修改任何 DSH 源码；卸载后页面完全还原。

主题细节

彗星蓝玻璃拟态

主题通过官方 theme.overrideTokens API 叠加一层约 60 项的 design token 覆盖：背景层全部半透明化（露出壁纸）、边框换成低饱和蓝描边、交互态（悬停/激活/选中）统一为彗星蓝系、状态色（错误/成功/警告）微调至与深色玻璃协调。亮色与暗色模式共用同一套视觉——壁纸底上的玻璃拟态本身不区分明暗。完整 token 清单见 docs/theme-tokens.md。

壁纸与 Logo

• 壁纸由插件宿主半区以 /kimino-bg/current.jpg 路由提供（包内 assets/current.jpg），叠加一层轻微的深色渐变保证文字可读性；
• 侧边栏展开态显示横向电影 Logo，折叠态显示字母标记（两个 SVG，同样由插件路由提供）；
• 首页（hero）标题替换为居中大尺寸 Logo。

输入卡与占位文案

输入卡重绘为藏蓝玻璃胶囊，占位文案按界面语言自动替换：

消息滚动与渐变蒙版

消息列底部 40px 平滑淡出，输入框零裁切；修复了「回到底部」按钮不出现的问题。

统一滚动条

全局滚动条统一为蓝紫玻璃风格，适配主流浏览器。

快速开始

浏览器建议：主题大量使用 backdrop-filter 毛玻璃、滚动条定制与 CSS 蒙版，推荐使用 Microsoft Edge 或 Google Chrome；Firefox 下部分显示效果不兼容（滚动条、渐变蒙版等可能打折）。

系统要求

• 已安装 DeepSeek Harness，dsh web 可正常启动；
• 机器上有 pnpm（dsh plugin 内部使用；Node.js 自带的 corepack 可提供）。

安装

dsh plugin --profile web add github:niiang/dsh-kimino-theme
dsh web   # 重启 DSH 生效

壁纸出现、侧边栏 Logo 变化，即安装成功。安装后随 DSH 启动常驻，无需每次重装。

更新

dsh plugin --profile web update dsh-kimino-theme
dsh web   # 重启生效

暂时关闭（不卸载）

编辑 ~/.dsh/profiles/web/package.json，删掉 dsh.profile.bundles 数组中的 "dsh-kimino-theme" 一行，重启 dsh web 即关闭；加回该行再重启即恢复。长期不用请直接卸载。

卸载

dsh plugin --profile web remove dsh-kimino-theme
dsh web   # 重启后页面完全还原

自定义

需本地克隆并改用 link: 安装：

git clone https://github.com/niiang/dsh-kimino-theme <你的目录>
dsh plugin --profile web add link:<你的目录的绝对路径>
dsh web

换壁纸

替换克隆目录中的 assets/current.jpg（保持文件名不变），浏览器强刷（Ctrl+F5）即可。

换 Logo

替换 assets/logo/ 下的两个 SVG，强刷生效。

调色

颜色集中在 bundle/client.js：token 覆盖与组件样式两处，改完重启 dsh web 并强刷。速查表见 docs/theme-tokens.md。

架构

主题是一个标准的 dsh 插件包（bundle）：package.json 声明 dsh.bundle 与 dsh.client，dsh plugin add 装进 profile 并挂上插件行——不修改 DSH 源码。

bundle/host.js       # 插件宿主半区（Node）：3 个资产路由 /kimino-bg/*（路径相对包内解析，装哪都能用）
bundle/client.js     # 插件浏览器半区：token 覆盖 + 组件样式 + DOM 补丁
cordis.patch.yml     # 插件行清单：dsh plugin add 挂载的入口
assets/              # 壁纸与 Logo
plugin/              # 会话内动态注入用的同源闭包源码（高级用法，一般无需关心）

所有副作用（token 层、样式标签、事件监听、DOM 属性、路由）都注册在插件 fiber 上，禁用/卸载即完全还原。

常见问题

装完重启了，页面没变化？

A: 确认命令里带 --profile web（装进了正确的 profile）；浏览器 Ctrl+F5 强刷一次；仍不行时看 dsh web 启动日志有没有 [kimino-theme] host half active 与安装时的警告信息。

安装时警告 declares no dsh.bundle？

A: 说明装到的版本不含静态安装声明（v65 之前的旧 tag）。确认仓库地址为 github:niiang/dsh-kimino-theme（不带 #版本号 时默认装最新 main），按「安装」小节的命令重装。

背景图 / Logo 404？

A: 静态安装的资产路径相对包内解析，正常不会发生。多为 profile 的 node_modules 被手动清理或链接损坏所致：重新执行一次安装命令即可修复。

DSH 升级后样式错乱 / 某些部分没生效？

A: 主题依赖少量构建期哈希类名（如 .Md3f7G_*、.wSkVaW_*、.hHd-Xa_*，涉及消息滚动、侧边栏品牌、输入卡高亮），DSH 前端升级后哈希可能变化。token 层与大多数样式（基于稳定 data 属性）不受影响；受影响的选择器需对照新版类名更新。欢迎提 issue 附截图。

亮色模式下文字看不清？

A: 主题按「壁纸上的深色玻璃」设计，亮/暗模式共用同一套视觉。若在亮色模式下觉得整体偏暗，属预期行为；可自行调亮 token 中的玻璃底色（见「自定义 - 调色」）。

和其他皮肤/主题插件能共存吗？

A: token 层是叠加式的，但视觉上会互相覆盖。建议同一时间只启用一个主题类插件。

已知限制

• 主题的毛玻璃、滚动条与渐变蒙版按 Chromium 内核（Edge / Chrome）打磨，Firefox 下部分显示效果不兼容，推荐使用 Edge 或 Chrome。
• 消息滚动重构、侧边栏 Logo 替换、输入卡高亮等处的选择器依赖 DSH 前端构建期哈希类名，DSH 大版本升级后可能需要跟随更新（见常见问题）。
• 主题强制深色玻璃视觉，亮色模式不做单独适配（见常见问题）。
• 壁纸与 Logo 路由缓存 1 小时，替换素材后需强刷浏览器。

许可证与素材版权

代码以 MIT 授权。

assets/ 中的壁纸与 Logo 素材源自电影《你的名字。》（君の名は。, Kimi no Na wa, 2016）的宣传物料，版权归 CoMix Wave Films、东宝等原权利方所有。本仓库仅作个人桌面美化之用，不主张任何素材版权，也不从中获利；如权利方提出异议，将立即移除相关素材。

参与贡献

• 提交信息遵循 Conventional Commits（如 feat(client): 修复 xxx），代码、文档与提交信息不使用 emoji；
• 用户可见的变更请在 PR 中附截图或验证证据；
• 改动主题 token 时同步更新 docs/theme-tokens.md。