npm.io
1.0.1 • Published 15h ago

dsh-theme-customizer

Licence
MIT
Version
1.0.1
Deps
0
Size
258 kB
Vulns
0
Weekly
0
SummaryDependencyVersions

dsh-theme-customizer

npm version license topic: dsh-plugin stars

中文 | English

DeepSeek Harness（DSH）Web 界面自定义主题插件：背景、文字、框线、细节全部可视化设置，刷新/重启不丢。 配置存 localStorage，预设可导出 .tczp 文件（含图片）分享到任意电脑。

界面预览

主界面效果 设置面板
示例预设 0 预设0主界面 预设0面板
示例预设 1 预设1主界面 预设1面板

功能一览

  • 界面板块（7 区域背景）：主界面 / 侧边栏 / 对话区 / 输入区 / 设置界面 / 浮窗面板 / Cordis 插件界面
    • 每区域：无 / 纯色 / 图片（选区裁剪）+ 透明度（数值越大越透明）+ 底色（独立层）
    • 主界面支持「包含侧边栏 / 不包含侧边栏」显示区域切换
    • 侧边栏图片用 mask 直接淡出，不盖顶部 UI、不挡设置面板
  • 框线板块：所有界面默认边框/分隔线颜色 + 透明度，主界面（含侧边栏）/ Cordis / 输入区 / 设置界面 / 浮窗 5 区域独立
  • 字体颜色板块：正文 / 过程 / 辅助 / 弱化 / 强调 5 类文字颜色（亮暗主题共用，可恢复官方默认）
  • 标志调色：左上角 DeepSeek Harness 标志颜色 + 透明度；「Harness」文字部分可单独调色
  • 对话区细节：用户发言气泡 / 行内代码 / 代码块背景 / 代码块滚动条 / 对话区滚动条 / 任务栏收起展开 / 「一键到底」按钮背景
  • 输入区：背景、输入框固定高度（1~10 行）、统计条接管渲染（9 项独立开关 + 完全展开）、命令按钮/菜单背景
  • 新会话按钮：无/纯色/图片样式 + 显示文本/图标开关 + 图标/文本颜色独立设置 + 底色
  • 布局调整：设置界面面板可拖动（拖 header 移动 + 位置持久化 + 一键复位）
  • 浮动主题面板：可拖动的迷你设置面板（勾选显示内容），顶层不遮挡
  • 预设：保存/应用/重命名/删除/导出/导入（.tczp 含图，最多 10 个）+ 拖拽排序
  • 全局恢复默认：一键重置所有设置（三级确认防误触）

安装

# 方式一：npm 安装（发布包）
npm install -g dsh-theme-customizer
dsh plugin --profile web add dsh-theme-customizer

# 方式二：本地目录安装（GitHub clone 后）
dsh plugin --profile web add <本仓库路径>

装完重启 dsh web 生效。验证：设置 → 主题 出现即可。

使用

  1. 打开 设置 → 主题，按板块调整；改动即时生效、自动保存（页面底部显示「最近保存」时间）
  2. 需要快速调整时可点右上「 打开浮窗」，浮窗可拖动
  3. 装完想验证对话区各选项效果，可用 对话区测试指令.md 里的测试文本

Cordis 按钮常驻（可选）

主题设置里「Cordis 按钮常驻」开关依赖官方 dsh-client-ui-cordis 补丁，未打补丁时开关不生效。一键安装：

node apply-patch.cjs           # 打补丁（自动备份）
node apply-patch.cjs --check   # 查看状态
node apply-patch.cjs --undo    # 撤销

DSH 升级会覆盖官方包，升级后需重跑 apply-patch.cjs。细节见 PATCH-CORDIS-BUTTON.md。

从源码构建（开发者）

# 1. 拼接源码片段（optimized/src/ → optimized/dist/，自动语法校验 + 行号映射/符号表）
node optimized\build.cjs

# 2. 生成静态 client bundle（dist/p3_2_client.js → lib/client.js）
node build_static.cjs optimized\dist\p3_2_client.js lib\client.js

# 3. 语法校验 + 安装测试
node --check lib\client.js
dsh plugin --profile web add <本仓库路径>

源码结构：optimized/src/ 16 个片段（00_*~`15_*+host.js）按文件名拼接为插件函数体，功能定位查 optimized/INDEX.md`。

预设文件（.tczp）

预设面板 → 「导入预设」选择 .tczp 文件即可恢复整套配置（含图片，无需原图）。导出同样在预设面板逐条「导出」。

卸载

dsh plugin --profile web remove dsh-theme-customizer

联系与反馈

  • 使用问题 / 功能建议 → Issues 发议题
  • 维护时间：每周日集中查看议题并回复
  • 哔哩哔哩：个人主页

AI 使用说明

本项目由 lxxz1918 主导设计与验收，代码在 AI 助手（DeepSeek）辅助下编写。所有功能需求、界面文案与最终效果均由作者本人确认。

License

MIT

Keywords

dshdeepseek-harnessthemecustomizerweb-ui