主题工坊 IRdotAI/dsh-studio

Studio for DeepSeek Harness

为 DeepSeek Harness（DSH）打造的主题与个性化插件：18 款主题；主题编辑器，能根据一种心情、一种颜色、任意词语或任意图片生成主题；每个工作区一套主题；社区主题与提示词包画廊；液态玻璃面板；壁纸（Bing 每日图、幻灯片和视频）；字体；按计划保存的外观，可跟随日出日落切换；Windows 强调色；布局控制与专注模式；AI 模式；任务完成提醒；用量与费用看板，带消费提醒；聊天导出为 Markdown 和 PDF；无障碍选项；更智能的已保存提示词；设置同步；Ctrl+K 快速切换器；19 种语言。

零 npm 依赖。除非你开启同步，否则设置只留在你的机器上。

Studio 使用 Liquid Glass 主题与磨砂玻璃面板

| 液态玻璃 + 个性化问候 | 快速切换器（实时预览） | 主题编辑器 |
| 壁纸上的磨砂玻璃输入框，问候语「Good night, RdotA」 | Ctrl+K 快速切换器预览 Tokyo Night | 主题编辑器：心情、单色、任意词语，Cyber 心情在整个应用中预览 |

| 社区画廊 | 用量与费用（示例数据） | 外观与计划，日语界面 |
| 画廊标签页，展示社区主题及其作者 | 用量标签页：总计、30 天图表和各模型价格 | 已保存外观与按时间段的计划，界面为日语 |

| 会先提问的提示词 | 已保存提示词 | 浅色模式（Synthwave） |
| 已保存提示词在插入前询问 Topic 和 Audience | 输入框旁的已保存提示词菜单 | 浅色模式下的 Studio 主题页面 |

安装

在应用内： 打开 DSH → 侧边栏 Plugins → Add plugin → 输入

github:IRdotAI/dsh-studio

在终端：

npx @deepseek-ai/dsh plugin --profile web add github:IRdotAI/dsh-studio

然后重启 dsh web。侧边栏会出现 Studio 入口。需要 DSH 0.2（已在 0.2.0-rc.2 上测试）、web 配置档和 Node 22.5+。安装插件时 pnpm 必须在你的 PATH 上（npm install -g pnpm）。

已经在 1.3 或更高版本？Studio 会自己提示更新（Studio → Updates）。

要卸载，在 Plugins 页面找到它的条目，点 Uninstall。

使用

- 侧边栏里的 Studio 包含全部功能，按标签页分类。在右上角选择语言（Automatic 跟随浏览器，如果 DSH 本身设为中文则跟随 DSH）。
- Ctrl+K（macOS 上是 Cmd+K）在任何地方都能打开快速切换器：主题（用方向键切换可实时预览，按 Esc 恢复你原来的主题）、你的外观、AI 模式、浅色/深色、文字大小、聊天宽度、专注模式、氛围、已保存的提示词、提醒、聊天导出、备份、更新，以及每个 Studio 页面。
- 在输入框里输入 /theme、/ai、/transcript、/prompts、/focus 或 /studio，或者点击输入框旁边的 ✦ 按钮，打开已保存的提示词。

功能

| 模块 | 你能得到什么 |
| 18 款主题 | Liquid Glass、Midnight、Dracula、Nord、Tokyo Night、Catppuccin、Rosé Pine、Gruvbox、Solarized、Forest、Ocean、Synthwave、Sakura、Arc Reactor、Espresso、Paper、AMOLED 和 High Contrast，外加默认外观。每款都有浅色和深色两个版本，所以 DSH 的浅色 / 深色 / 跟随系统切换照常可用。 |
| 按工作区设置主题 | 给任意工作区单独指定主题或外观，一眼就能区分不同项目。切换工作区时主题跟着变，回到其他地方则恢复你常用的主题。 |
| 主题编辑器 | 按模式分别挑选背景色、文字色和强调色，还能再加一个可选的第二强调色用于渐变。Studio 用 OKLCH 从这些颜色推导出每个表面、边框、按钮和文字色阶，并设置对比度下限，保证次要文字始终可读。实时对比度徽标配一键 Fix、屏幕取色器 💧、任意 CSS 颜色（rgb(…)、hsl(…)、tomato）、撤销/重做（Ctrl+Z / Ctrl+Y）、Make Light from Dark（以及反向操作）、色盲预览、编辑时全应用预览、可分享的 dshs1: 代码和 .json 主题文件。 |
| 生成主题 | 十二种情绪（Calm、Cozy、Cyber、Sunset……，每次点击都有新变化）、一种颜色配一条色彩和谐规则（单色、类似色、互补色、分裂互补、三角色）、任意词语（同一个词总是生成同一款主题），或者 🎲 给我惊喜。用 锁定 🔒 留住你喜欢的颜色，生成器会保留它们。微调滑块能整体移动主题（色相、鲜艳度、暖度、背景），变体提供八种现成的变化。文字始终可读。 |
| 从图片生成主题 | 用你的桌面壁纸、Studio 壁纸或任意图片生成主题：Studio 对图片颜色做聚类，挑出背景色调和强调色，并调整它们以适配两种模式的对比度。 |
| 社区画廊 | Studio → Gallery 列出其他用户分享的主题和提示词包；点一下就能添加一款主题或一整套提示词。在主题编辑器里点 Submit to the gallery，或者在提示词文件夹上点，会打开 GitHub 并带上你准备好的文件。见 gallery/。 |
| 外观与定时切换 | 把主题、样式和壁纸一起保存成命名外观，然后一键切换整套配置，或者按计划切换：在指定时间，或者你所在地的日出和日落时（比如日出用浅色主题，日落用 Liquid Glass）。你自己手动改的设置会一直保留，直到下一次切换。 |
| Windows 颜色 | 使用我的 Windows 强调色 会把当前主题的高亮色换成你的 Windows 强调色，之后你改强调色它也跟着变；跟随 Windows 浅色/深色 则随系统切换。 |
| 液态玻璃 | 样式 → 材质会把侧边栏、输入框、卡片、对话框、消息气泡和菜单变成磨砂透明的面板：背景模糊、淡淡的霜感、顶部高光边缘和一道斜向光泽。DSH 自己的界面元素在运行时定位，所以 DSH 更新后依然可用。匹配我的桌面 一键套用整套外观。 |
| 布局 | 聊天宽度（从窄到全宽）、界面大小（75–140 %），以及 专注模式，会把侧边栏和侧面板收起来。 |
| 壁纸 | 上传图片或使用 URL；（在 Windows 上）使用你的桌面壁纸，会跟随壁纸变化；Bing 每日，每天换一张图；幻灯片，从图片文件夹轮播，间隔从几分钟到一天一次；或者一段静音循环的 视频，窗口隐藏时暂停。可见度和模糊可调。 |
| 样式 | 界面字体和代码字体（预设、任意已安装字体，或一个装满 .otf/.ttf/.woff2 文件的文件夹）、圆角样式、强调色染色的聊天气泡、强调色文本选中、表面色调。 |
| 氛围 | 极光辉光、暗角、胶片颗粒或 CRT 扫描线，带强度滑块。绝不挡住点击；遵循减少动态效果设置。 |
| 身份 | 在侧边栏重命名应用，更换 logo（emoji、字母组合或你自己的图片，一键移除），并把新聊天标题换成问候语，比如 Good {timeOfDay}, {name}，用你的语言。 |
| AI 偏好 | 可选的自定义指令：你的名字、关于你、回复风格（简洁、详尽、友好、导师、管家、激情）、回复语言和自由格式指令。默认关闭；该标签页会原样显示模型将收到什么。 |
| AI 模式 | 保存好的样式、语言和指令组合：起步有编程、写作、简单解释和头脑风暴，另外还有你自己保存的任意组合。在输入框用 /ai 切换，或按 Ctrl+K，或在 AI 标签页切换。 |
| 已保存提示词 | 六个起步模板；可以添加、编辑、排序，并把自己的提示词归入文件夹。插入时占位符会自动填充：{clipboard}、{date}、{time}、{day}，以及 {ask:Topic}，它会先问你。把所有提示词分享成一个 dshp1: 包代码，用代码或文件添加包，或把文件夹发送到画廊。 |
| 聊天导出 | /transcript（或 Ctrl+K → 导出此聊天）把打开的聊天保存为 Markdown 文件、PDF（用你主题的颜色，或白底黑字的朴素样式），或复制为 Markdown。 |
| 任务提醒 | 任务完成时发桌面通知并播放声音（四个内置音效，合成生成，音量可调），你也可以选择在智能体需要你批准或回答时提醒。只在你看向别处时提醒，而且如果你愿意，只提醒超过一定时长的任务。 |
| 用量与费用 | 每次模型调用的精确 token 数（输入、输出、缓存读取），今天、最近 7 天、最近 30 天和全部时间的总计，30 天图表，按模型分列的表，以及最近的调用记录。输入每百万 token 的价格，即可用八种货币查看花费。检查余额会向 DeepSeek 查询你的账户余额。 |
| 花费提醒 | 设置每日和/或每月预算。Studio 会显示已用掉多少，并在接近预算和达到预算时各提醒你一次（弹窗、声音和桌面通知）。 |
| 无障碍 | 高对比度主题、减少透明度（纯色面板，不显示壁纸；跟随 Windows 自身设置）、醒目的键盘焦点轮廓，以及字距更宽松的易读字体。 |
| 同步 | 把 Studio 设置备份到私有 GitHub Gist，在另一台电脑上恢复，可以手动，也可以在每次改动一分钟后自动进行。上传的图片留在本地，除非你选择一并包含。 |
| 19 种语言 | English、简体中文、繁體中文、日本語、한국어、Español、Français、Deutsch、Português (Brasil)、Italiano、Русский、Українська、Polski、Nederlands、Türkçe、Tiếng Việt、Bahasa Indonesia、हिन्दी 和 العربية（从右到左）。 |
| 高级 | 自定义 CSS（最后应用；使用 --dsw- 设计 token）、以 JSON 导出/导入设置、重置。 |
| 更新 | 有新版本时显示更新横幅和侧边栏圆点，可选自动更新，列出每个版本供更新、重装或降级，更新后自动重启 harness，让新版本自行接管。 |
| 致谢 | Studio 由谁打造、基于什么构建，以及每个改编主题配色的来源。 |

更新

Studio 从本仓库的 releases 自行更新：

- 有新版本时，Studio 顶部的横幅（以及侧边栏图标上的圆点）会提供 立即更新、开启自动更新 和 更新内容。
- Studio → 更新 列出每个版本。可以 更新 到更新的版本、重装 当前版本，或者在新版本带来麻烦时 降级 到旧版本。
- 开启 自动更新 后，Studio 每 6 小时检查一次 GitHub，并自行安装新版本。
- 安装走 DeepSeek Harness 自己的插件管理器（与 插件 → 添加插件 相同）。新版本只在全新的 harness 中运行，所以 Studio 随后会自行重启 DeepSeek Harness：你主动发起的更新立即重启，自动更新则在没有任务运行时重启。已打开的窗口会自行采用新版本。重启会复用启动 harness 时的原命令，在同一个终端或日志中，因此 Ctrl+C（或启动它的应用）仍能将其停止。可在 Studio → 更新 → 更新后自行重启 DeepSeek Harness 下关闭。用 dsh 命令以外的方式启动的 harness 需要手动重启，更新页面会说明这一点。
- 每次安装前都会备份你的设置（~/.dsh/studio/studio.backup-.json，保留最新五份）。
- 降级会自动关掉自动更新，这样 Studio 不会立刻又跳回去。
- 1.3.0 之前的版本没有 Updates 页面；要从这类版本回来，走 Plugins → Add plugin → github:IRdotAI/dsh-studio 再装一次。

一键更新要求 Studio 是从 GitHub 安装的。如果是从本地文件夹链接过来的副本（开发者安装），Updates 页面会说明这一点，并从那个文件夹更新。

隐私

- 设置存放在 ~/.dsh/studio/studio.json（或 $DSH_HOME/studio/studio.json），上传的图片也在里面。使用记录放在旁边的 usage.json，从不离开你的机器。
- Sync 在你添加 GitHub token 之前是关闭的。token 保存在 ~/.dsh/studio/github-token（只有你能读），从不发给浏览器，只用来和 GitHub 通信。备份会存到你账号下的私有 gist。
- Check balance 会把你已有的 DeepSeek API key 发给 DeepSeek 自己的余额接口，而且只在你按下按钮时才发。
- Gallery 标签页从 GitHub 上的这个仓库下载主题和提示词包列表。
- AI 偏好（以及模式）只在你开启它们时，才会加进模型的系统提示词。
- 用 URL 设置的壁纸由你的浏览器从那个 URL 拉取。上传的图片、幻灯片文件夹、视频文件和桌面壁纸从不离开你的机器。
- Bing daily 每天从 bing.com 下载当日图片一次，最近三张保存在 ~/.dsh/studio/bing/。
- Sunrise and sunset 使用你输入或授权一次的位置；位置会取整到约 10 km，只存在你的设置里。时间在你的机器上算出。
- Chat export 在浏览器里完成；不上传任何东西。

工作原理

DSH 插件有宿主端（Node）和浏览器端（React）两半。Studio 的宿主端负责存储设置，通过带鉴权的 /api/studio/ 路由提供这些设置，在每次页面加载时注入样式表（所以你的主题从第一帧就在），提供桌面壁纸和字体文件，读取 Windows 强调色，从 llm/stream 瀑布流记录 token 用量，执行 gist 同步，并贡献可选的系统提示词段落。浏览器端渲染 UI，并实时更新样式表。

主题化的做法是重新推导 DSH 的三套静态色阶（--dsw-static-neutral-bluish-、--dsw-static-neutral-、--dsw-static-deepseek-）。所有别名 token 都指向它们，所以整个界面会跟着变，同时保留原来的对比度阶梯。

| 文件 | 作用 |
| lib/shared.js | 纯核心：颜色计算、预设、调色板提取、样式表构建、设置校验、日程与日出日落时间、提示词占位符、用量总计与预算、人设文本与模式、聊天导出。两半共用。 |
| lib/index.js | 宿主端：设置文件、API 路由、首屏样式表、壁纸（桌面、Bing、幻灯片、视频）与字体服务、图库与余额查询、聊天导出、系统提示词区块。 |
| lib/updater.js | 在 GitHub 上查找发行版，并通过 harness 插件管理器安装更新或降级。 |
| lib/restart.js | 安装完成后重启 harness：先优雅关闭，再在同一进程树中重新执行同一条 dsh web 命令。 |
| lib/usage.js | 用量记录器：包装 llm/stream，保存每次调用的 token 数量。 |
| lib/windows.js | 读取 Windows 主题色。 |
| lib/sync.js | 私有 gist 备份与恢复。 |
| src/client/.js | 浏览器端源码，每个区域一个文件（store、styles、各个标签页、快速切换器、composer 按钮、斜杠命令、入口）。 |
| locales/.json | 界面文案，每种语言一个文件。英文已内置进 bundle，其他语言按需加载。 |
| lib/client.js | 生成产物，浏览器 bundle。修改 src/client/、locales/en.json 或 lib/shared.js 后，运行 node scripts/build.mjs。 |
| gallery/ | 社区主题与提示词包，以及生成的 index.json，供 Gallery 标签页读取。 |

API

所有路由都在 DSH 自带的浏览器认证之后。

- GET /api/studio/state：设置，以及这台机器能提供什么（桌面壁纸、已服务的字体、Windows 主题色）
- POST /api/studio/patch：局部更新（对象合并，数组替换）
- POST /api/studio/replace：整份设置导入
- POST /api/studio/reset，带 {"confirm":"reset-studio"}
- GET /api/studio/desktop-wallpaper：当前 Windows 壁纸
- GET /api/studio/bing-wallpaper：今天的 Bing 图片（每天下载一次）
- GET /api/studio/wallpaper-file?i=<n>：幻灯片文件夹中的一张图片
- GET /api/studio/video-wallpaper：视频壁纸文件（支持 Range）
- GET /api/studio/export?session=<id>：某个会话的消息，用于导出
- GET /api/studio/font?f=<file>：配置的字体文件夹中的一个文件（只服务该文件夹内的文件）
- GET /api/studio/updates：版本、发行版与更新状态；POST 时传 {"action":"check"}、{"action":"install","version":"x.y.z"} 或 {"action":"restart"}
- GET /api/studio/usage：用量总计与最近调用；POST 时传 {"action":"clear"} 或 {"action":"balance"}
- GET /api/studio/sync：同步状态；POST 时传 {"action":"set-token","token":"…"}、clear-token、push 或 pull
- GET /api/studio/gallery：社区图库（缓存一小时）；POST 可刷新
- GET /api/studio/locale?lang=：某种语言的界面文案

开发

git clone https://github.com/IRdotAI/dsh-studio
cd dsh-studio
node scripts/build.mjs # rebuild lib/client.js
node test/selftest.mjs # 41 checks
node scripts/check-locales.mjs # every language has every string
node scripts/build-gallery.mjs # validate gallery themes and prompt packs, rebuild gallery/index.json
npx @deepseek-ai/dsh plugin --profile web add "$PWD" # install your local copy

改动 lib/ 下任何内容后都要重启 dsh web（宿主模块有缓存）。

添加语言： 在 lib/shared.js 的 LANGUAGES 里加上它，把 locales/en.json 复制成 locales/.json，翻译其中的值（保留每个 {placeholder}），然后运行 node scripts/check-locales.mjs。

DSH 插件里值得知道的坑：

- connection.fetch.register 的路径必须是以 /api/ 开头的完整路径，否则会抛 "invalid exact Fetch route"。
- 精确路由只按路径做键，所以同一个路径上的 GET 和 POST 必须写成一条路由，用 methods: ["GET", "POST"]。
- requestBody: "streaming" 的路由不能处理 GET（桥接层总会附带 body）。读取类请求保持 buffered。
- 宿主注入的 如果用 html:root body 选择器，优先级会高过 DSH 的 token 表，而且还能覆盖首屏绘制。
- DSH 会把菜单传送到 <body>，再按屏幕上的矩形定位，所以缩放应用要用 #root 上的 zoom，绝不要用 。
- 插件斜杠命令如果和宿主命令同名（/export、/plan、/goal……），整个 / 菜单都会失效。宿主行还排在前面，所以名字只要是宿主命令的开头（/mode 对 /model），就永远没法用 Enter 选中。Studio 在提供自己的每条命令之前，都会先检查宿主的命令。

致谢

由 RdotA 制作。主题配色改编自 Dracula、Nord、Catppuccin、Gruvbox、Solarized、Tokyo Night 和 Rosé Pine。完整致谢与链接见 CREDITS.md，应用内也在 Studio → Credits 里。

许可

MIT