DeepSeek Harness (DSH) 采用插件化架构，允许开发者扩展或替换界面组件。dsh-theme-aurum 是一个针对 DSH Web profile 的主题插件，旨在通过覆盖原生组件实现“金粉奢华”的视觉改造。该插件采用 loader 格式，零构建，所有能力运行在浏览器端。
核心功能¶
主题与布局¶
插件使用 oklch 色彩空间定义浅色与深色双色层。侧栏底部提供与官方 preference 同步的“深色/浅色主题”一键切换功能。侧栏采用圆角渐变卡片与柔影，折叠态为 56px 细条。
左侧会话栏¶
插件遮蔽了 sidebar.workspaces。目录头包含“工作区”标签、展开式搜索（金圈聚焦）及视图菜单。支持分组折叠，收合采用非线性动画与 stagger 入场。会话行包含状态槽（运行中/等待/完成）、金色调色板、悬停浮动菜单（重命名、分支、归档）及拖拽排序。品牌行保留官方鲸鱼图标与字标。
会话流¶
会话流采用右对齐金渐变用户气泡。正文使用衬线字体，上下文行包含 ◈ 符号。Reasoning 部分为可折叠的衬线斜体段落。支持 turn-tail、compress、retry、err 等尾部节点，并实现逐节点阶梯入场动画。
工具卡¶
插件全量接管 conversation.chat.node。针对 9 类工具进行特判，未知工具兜底使用官方图标。工具卡呈现药丸状态，运行时具备金扫光效果，tool-kids 子调用支持缩进显示。
输入坞¶
输入坞包含 todo 清单条（金→玫渐变进度）、实色输入卡、金渐变发送按钮。模式/模型菜单支持 mono 换皮。底部包含 ctx 圆环、构成面板及 c-stats 统计行。
全局浮层与响应式¶
主区 header 采用 sh-head 浮头方案，包含绝对定位的渐变纱与同轴标题。全局浮层（新会话居中态、命令/工作区菜单、设置弹窗）均进行金色化处理。响应式支持 ≤820、≤640、≤480 三档降密度布局，覆盖 360–1920 全档，确保零横向滚动。
兼容性与扩展¶
图标一律使用 DSH 官方原版。插件保留官方注册的全部槽位（priority:-1 遮蔽），停止运行即可还原官方 UI。插件提供 aurum.workspaces.menu-extra list 扩展槽，支持多插件共存。
安装与启用¶
在终端执行以下命令安装插件：
# GitHub 安装（推荐；建议固定到特定 commit）
dsh plugin --profile web add github:fengb3/dsh-theme-aurum#<commit-sha>
# 本地开发（Link 安装，编辑即生效）
dsh plugin --profile web add <本仓库路径>
安装后需重启 dsh web，所有页面将自动加载该主题。
开发与注意事项¶
插件基于 @deepseek-ai/dsh-client-ui-primitives 等官方依赖构建。
- Link 安装机制：使用本地路径安装时，部署副本为符号链接。修改代码后必须重装插件或重启
dsh web才能生效（hot-reload 仅限已加载插件）。 - 脚本警告：执行
sync-deploy.ps1时会报 LINKED，禁止使用 Copy-Item 进行拷贝。 - 文件修改：修改
package.json、cordis.patch.yml或index.js后，需要执行上述重装或重启操作。 - 兼容性：插件要求 DSH Web 版本 >= 0.1.0-rc.6。
结语¶
dsh-theme-aurum 提供了一套从侧栏、会话流到工具卡的全链路视觉接管方案，适合希望在 DSH Web 中统一视觉风格或进行界面定制的开发者。
