iMocking/dsh-theme-triptych

Name: iMocking/dsh-theme-triptych
Author: iMocking

插件Plugin 原生Native ⭐ 2 MIT cat_label.deepseek-harnesscat_label.deepseek-harness cat_label.dshcat_label.dsh cat_label.themecat_label.theme

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-theme-triptych 是 DSH 外观主题插件，将 keyshub.top 的 NEXUS、COMIKET、IRONCORE 三套主题及壁纸带入 Web GUI。通过标准 theme.register 注册，支持毛玻璃效果与两处切换入口。适合定制 DSH 界面时使用。注意壁纸版权归原作者所有。

dsh-theme-triptych is a DSH appearance plugin bringing three themes (NEXUS, COMIKET, IRONCORE) with wallpapers from keyshub.top to the Web GUI. It registers themes via standard APIs, adds translucent wallpaper effects, and provides two switching entry points. Use it to customize DSH's look. Note: wallpaper copyright belongs to the original authors.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-theme-triptych】【https://github.com/iMocking/dsh-theme-triptych】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:iMocking/dsh-theme-triptych

把 iMocking/dsh-theme-triptych 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

6.9 KB · 缓存于 2026-08-27 05:42:28 · 6.9 KB

dsh-theme-triptych

DeepSeek Harness（DSH）外观主题插件包 —— 把 keyshub.top 的三种主题色调与壁纸带进 DSH Web GUI。

三套主题逐字取自参考工程 isolo-news/web/src/config/themes.ts，三张壁纸与线上 Hero 背景图（image_0/2/4_yi19x4.jpg）SHA-256 完全一致。

主题	氛围	主色 / 次色	色系
NEXUS	赛博霓虹（暗色）	`#00f0ff` 青 / `#ff2d95` 品红	深蓝底 + 荧光点缀
COMIKET	温暖纸感（亮色）	`#ff6b2b` 橙 / `#3b9eff` 蓝	暖纸白底
IRONCORE	机械工业（暗色）	`#f0a030` 琥珀 / `#4ecdc4` 青绿	铁灰底 + 警示橙

特性

三套主题通过标准 theme.register 注册，与 DSH 内置 Light / Dark / System 完全互通（theme.setTheme）。
每套主题自带壁纸：自定义 token --dsw-theme-wallpaper 由主题 presenter 自动写入 <body> 内联变量，表面色（bg-base / layer-1 / layer-2 / overlay / sidebar-fill）改为半透明同色系，壁纸从底层透出，形成毛玻璃观感。
两处零侵入切换入口（均为 additive 槽位，replaceRisk: none）：
- 设置 → 通用 → “外观主题 / Theme”（order 11，紧跟系统 Appearance 行）：三张壁纸预览卡片 + “默认 System”；
- 侧边栏底部 “主题外观” 调色板按钮（order 10）：弹出四选项菜单，窄栏（rail）下自动收成纯图标。
卸载即还原：插件停用/更新时主题、样式、槽位全部自动清理。

工作原理（DSH 客户端插件格式）

这是一个标准 DSH 双面 dsh.client 包：

package.json 声明 dsh.client: { platform: "web" } 与 exports["./client"]；
Node 半部（lib/index.js）：作为组合中的一个 loader 行挂载，用 webServer 注册三条精确路由（/dsh-theme-triptych/*.jpg），从包内 assets/ 提供壁纸；
浏览器半部（lib/client.js）：__ModuleLoader__.load 工厂包，注册主题、注入壁纸样式、挂载两个切换入口；
宿主扫描到该行后自动把客户端包编入 window.__DSH_BOOT__，浏览器按需加载 —— 无需重新构建 DSH Web 产物。

安装（任选其一）

要求：本机已安装 DSH（dsh CLI 可用），并能访问 npm registry。

方式 A：官方安装脚本（推荐）

# Linux / macOS / Git Bash on Windows
bash install/install.sh            # 默认 profile: web；可传参: bash install/install.sh <profile>
# 或 PowerShell
powershell -ExecutionPolicy Bypass -File install/install.ps1   # 可传 -Profile <name>

脚本会：① 在 $DSH_HOME/profiles/<profile> 中 pnpm add dsh-theme-triptych（无 pnpm 则用 npm）；② 向 cordis.patch.yml 追加 loader 插入项；③ 提示重启。

方式 B：手动三步

# 1) 安装包（在 DSH 部署的 profile 目录下）
cd "$DSH_HOME/profiles/web"          # Windows: %USERPROFILE%\.dsh\profiles\web
pnpm add dsh-theme-triptych           # 或 npm install dsh-theme-triptych

# 2) 在 cordis.patch.yml 末尾追加（若文件内容是 []，整体替换为下面块）

- insert:
    - id: dsh-theme-triptych
      name: dsh-theme-triptych

# 3) 重启 DSH
dsh --profile web

验证

# 壁纸路由（应返回 200 与 image/jpeg）
curl -I http://127.0.0.1:3080/dsh-theme-triptych/nexus.jpg
# 打开 Web GUI：侧边栏底部出现调色板按钮；设置 → 通用 出现“外观主题 / Theme”

卸载

cd "$DSH_HOME/profiles/web"
pnpm remove dsh-theme-triptych
# 并从 cordis.patch.yml 删除 installer 追加的 insert 块

从源码构建与测试

node scripts/build.mjs   # 生成 lib/client.js（__ModuleLoader__ 工厂包装）与 lib/index.js
node test/smoke.mjs      # 无 DSH 运行时依赖的冒烟测试（bundle 契约 + 壁纸路由）

发布（维护者）

DSH 插件没有独立的“提交审核”市场 —— 官方分发渠道就是 npm（见 deepseek-ai 官方文档 docs/user/develop/basic/publish.zh.md），“能被搜到”取决于 npm 元数据与 GitHub 主题：

发布到 npm（官方渠道，npm search / pnpm add 可发现）：
- 本地：node scripts/build.mjs 后 npm publish --access public（需 npm 账号）。
- 自动：打 tag 触发 .github/workflows/release.yml（需在仓库 Secrets 配置 NPM_TOKEN）：
```
git tag v0.1.0 && git push origin v0.1.0
```
优化 npm 可搜索性：description 含 “DeepSeek Harness”，keywords 含 deepseek-harness / dsh / dsh-plugin（本包已配置）；补全 repository / homepage 字段让 npm 页面展示 GitHub 链接。
让社区插件市场收录（非官方，但覆盖面最广）：多数社区市场（如 DSH-Plugins-Marketplace、AwesomeHou/dsh-plugin-marketplace）实时同步 GitHub dsh-plugin topic 下的仓库，或索引 npm 上 dsh-plugin-* 名称的包。在 GitHub 仓库页 About → Topics 添加 dsh-plugin（以及 deepseek-harness、dsh、theme），无需额外申请即可被这些市场自动收录。
可选：向社区维护的 awesome 列表提交 PR（如 awesome-dsh-plugin）。

未经安装的试用（动态插件方式）

若只想在当前 DSH 会话里临时体验（无需改动部署），可在 GUI 会话中把 src/index.js / src/client/index.js 作为 cordis_define 的 code.host / code.client 声明一个动态插件并运行（需在 Run 卡片中允许）。重启后失效。

许可

MIT。壁纸图片来自 keyshub.top 项目（isolo-news/web/public/images），版权归原作者所有。

English

dsh-theme-triptych brings the three appearance themes of keyshub.top — NEXUS (neon cyan/pink, dark), COMIKET (warm paper, light) and IRONCORE (industrial amber/teal, dark) — to the DeepSeek Harness Web GUI, wallpapers included.

It is a standard DSH dual-face dsh.client package: the node half serves the three wallpapers over webServer routes (/dsh-theme-triptych/*.jpg), the browser half registers the themes (translucent surfaces over a wallpaper via the --dsw-theme-wallpaper token), and both a Settings → General → 外观主题 row and a sidebar-footer palette button switch themes. No web rebuild is required — the host serves the client bundle from disk (/plugins/<id>/client.js).

Install: bash install/install.sh (or manual: pnpm add dsh-theme-triptych inside $DSH_HOME/profiles/<profile>, append the - insert: block for dsh-theme-triptych to cordis.patch.yml, restart dsh --profile web).

渲染基于仓库 iMocking/dsh-theme-triptych 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install