Skip to content

Latest commit

 

History

5 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dsh-modern-skin

DeepSeek Harness 现代皮肤插件 · 5 套可切换配色 · 归档会话管理 · 跨平台一键安装

参考 Codex / Claude Code 的现代 Agent 客户端视觉:暖灰画布 + 白色分层卡片、「墨水」按钮 + 品牌色强调、柔和阴影、胶囊滚动条、平滑主题过渡。适配 浅色 / 深色 / 跟随系统


功能

功能 说明 交付方式
🎨 现代皮肤 浅色/深色两套全新设计令牌(画布、卡片、边框、文字、阴影、滚动条) 纯客户端插件
🎛️ 5 套配色 深海蓝 / 翡翠绿 / 暮光紫 / 暖阳橙 / 玫瑰红,设置里一键切换、即时生效、持久保存 纯客户端插件
🗂️ 归档会话管理 侧边栏「已归档」分区:查看 / 恢复 / 删除(带确认,自动关闭空闲会话) 核心补丁(可选)

命令速查(安装 / 更新 / 卸载)

前提:已通过 dsh web 启动过 DeepSeek Harness(存在 $DSH_HOME/profiles/web)。

安装

平台 命令
任意平台(Node 通用) node scripts/cli.js
Windows(PowerShell) powershell -ExecutionPolicy Bypass -File scripts\install.ps1
macOS / Linux(bash) bash scripts/install.sh
任意平台(已发布 npm) npx dsh-modern-skin
任意平台(走 GitHub) npx github:gavinlee9051/dsh-modern-skin

只装皮肤、不打核心补丁,加 --skin-only(Node)或 -SkipArchivePatches(PowerShell):

node scripts/cli.js --skin-only

更新

场景 命令
GitHub 克隆方式 git pull 后重新运行安装命令(脚本幂等,覆盖更新、不重复注册)
Release zip 方式 重新下载 zip 解压后重跑安装命令
npm / npx 方式 npx dsh-modern-skin@latest(或 npm update -g dsh-modern-skin)
仅重跑安装(不拉新代码) node scripts/cli.js --skin-only 或对应平台安装脚本

卸载

平台 命令
任意平台(Node 通用) node scripts/cli.js uninstall
Windows(PowerShell) powershell -ExecutionPolicy Bypass -File scripts\uninstall.ps1
macOS / Linux(bash) bash scripts/uninstall.sh

皮肤插件可干净卸载;归档管理核心补丁修改了 dsh 核心包,需重装 dsh 才能还原(见下方说明)。

重启服务

平台 命令
任意平台(Node) node scripts/cli.js restart
Windows powershell -ExecutionPolicy Bypass -File scripts\restart.ps1
macOS / Linux bash scripts/restart.sh

快速开始(GitHub 克隆)

git clone https://github.com/gavinlee9051/dsh-modern-skin.git
cd dsh-modern-skin

node scripts/cli.js            # 皮肤 + 询问是否打归档核心补丁
# 或只装皮肤: node scripts/cli.js --skin-only

安装脚本自动完成:探测本机 DSH 安装位置 → 复制插件到 profile → 注册到 cordis.patch.yml → (可选)核心补丁 → 重启服务。

完成后刷新 http://127.0.0.1:3080(建议 Ctrl/Cmd+Shift+R),到 设置 → 外观 切换配色。

安装方式详解

方式一:GitHub 克隆(推荐,无需 npm)

见上方「快速开始」。

方式二:Release zip(不会 git 也能装)

  1. GitHub Releases 页下载 zip(或仓库页 Code → Download ZIP);
  2. 解压后进入 dsh-modern-skin/ 目录;
  3. 运行 node scripts/cli.js(最通用)或对应平台脚本。

方式三:npm / npx(发布 npm 后,一条命令)

# 作者首次发布(可选)
npm login && npm publish

# 用户安装
npx dsh-modern-skin              # 皮肤 + 询问归档核心补丁
npx dsh-modern-skin --skin-only  # 只装皮肤

方式四:直接走 GitHub 的 npx

npx github:gavinlee9051/dsh-modern-skin --skin-only

归档会话管理(核心补丁,可选)

该功能修改 dsh 核心包(workspace 注册表、会话持久化、API 网关、客户端运行时与界面),通过 patches/archive-core.mjs 应用。

# 安装(install 脚本会询问;或手动)
node patches/archive-core.mjs

# npm 重装后重新应用(锚点不匹配会明确报错,不会静默出错)
node patches/archive-core.mjs

# 卸载:皮肤插件可干净卸载;核心补丁需重装 dsh 还原
node scripts/cli.js uninstall

核心补丁提供:

  • 侧边栏「已归档」分区:查看 / 恢复 / 删除已归档会话;
  • 删除时自动关闭空闲的打开会话;仅对正在运行的会话返回清晰的 session-open 错误。

目录结构

dsh-modern-skin/
├── package.json            # 插件包元数据(dsh.client 声明 + bin)
├── lib/
│   ├── index.js            # 宿主端:注册 skin 设置命名空间
│   └── client.js           # 浏览器端:注入皮肤 CSS + 设置面板(build 生成)
├── styles/
│   ├── modern-skin.css     # 现代皮肤(浅/深色)
│   └── modern-schemes.css  # 4 套附加配色
├── patches/archive-core.mjs  # 归档管理核心补丁(自动探测 DSH 路径,跨平台)
├── scripts/
│   ├── cli.js              # ★ 跨平台统一入口:install / uninstall / restart
│   ├── install / uninstall / restart  .ps1(Windows)+ .sh(macOS/Linux)
├── build-client.mjs        # 改完 styles 后重新生成 lib/client.js
└── README.md

自定义

  1. 改配色:编辑 styles/modern-skin.css(浅色)与 styles/modern-schemes.css(各方案),然后 node build-client.mjs 重新生成 lib/client.js;
  2. 新增配色:在 modern-schemes.css 增加 body[data-ds-scheme="xxx"] 规则,并在 build-client.mjs 的 SCHEME_DEFS 与宿主 lib/index.js 的 THEME_SCHEMES 登记;
  3. 本地生效:改完后重跑安装脚本(覆盖更新)或复制 lib/、styles/ 到 profile 的插件目录后重启。

常见问题

1. 为什么不要用 npm exec @deepseek-ai/dsh web 重启?

npm exec 每次会重新安装 dsh 包,覆盖所有本地修改(皮肤、补丁都会丢失)。请用本项目 scripts/restart(或 node scripts/cli.js restart)重启——它直接调用 node /lib/bin.js,不触发 npm 重装。

2. 删除归档会话时报 session-open?

该会话正在运行(agent 忙碌)。等它完成或先中断,再删除。空闲的打开会话会被自动关闭后删除。

3. 核心补丁报 ANCHOR FAIL?

说明当前 dsh 包版本与补丁锚点不匹配(通常发生在 dsh 升级后)。脚本会明确列出失败的包,不会静默出错——等待补丁更新或回退 dsh 版本即可。

4. 支持哪些平台?

Windows / macOS / Linux 均支持。Node 版本(scripts/cli.js)是统一入口,只需本机有 Node(dsh 本身就依赖 Node);PowerShell / bash 脚本分别面向 Windows / Unix 用户。


许可

MIT

About

DeepSeek Harness 现代皮肤插件 · 5 套可切换配色 · 归档会话管理 · 跨平台一键安装 参考 Codex / Claude Code 的现代 Agent 客户端视觉:暖灰画布 + 白色分层卡片、墨水按钮 + 品牌色强调、柔和阴影与胶囊滚动条,适配浅色 / 深色 / 跟随系统三种模式。 - 🎨 **5 套配色**:深海蓝 / 翡翠绿 / 暮光紫 / 暖阳橙 / 玫瑰红(设置里一键切换,即时生效、持久保存) - 🗂️ **归档会话管理**:侧边栏查看 / 恢复 / 删除已归档会话(核心补丁,可选安装) - 🚀 **一键安装**:`git clone` 后一条命令,自动探测 DSH 安装位置,Windows / macOS / Linux 通用

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages