前言¶
DeepSeek Harness(DSH)把对话、工具调用和子代理委派都收进同一客户端。默认界面能完成工作,但运行指标往往藏在弹窗里,子代理拓扑随步骤折叠而难追踪,侧栏工作区与置顶项也容易混在一列表里。若你希望在不改宿主布局骨架的前提下,换一套克制的视觉体系并把这些信息固定到可见位置,社区插件 潮汐主题(npm 包名 dsh-tide-theme,仓库 zdt3476/dsh-tide-theme)是一套可选方案。维护者为 zdt3476;包在 npm 发布,README 标注 dsh-market verified,当前 GitHub 星标为 1,许可证为 MIT(package.json 版本 0.6.1)。
这是什么¶
潮汐主题(Tide Theme)面向 DSH 桌面 Web 客户端:提供「深海潮汐蓝」明暗两套表面体系、清晰字阶与较低信息密度,并保留宿主对话、导航与分屏结构。除 Token 覆盖外,插件还附带底栏性能 HUD、用量看板、Agent Graph 子代理拓扑、侧栏置顶小节与筛选、输入区模型/权限控件等增强。插件原名 dsh-simplify-theme,升级到新包需先卸载旧包;本地配置存储键随包名变更,需重新设置。
设计基线与材质开关¶
主题按固定设计契约实现(仓库内 docs/ui-design-contract.md),而非零散改色:6-3-1 配色、单一强调色、禁用纯黑与霓虹辉光,正文对比度按 WCAG AA,核心读数按 AAA;度量数字使用等宽字体栈与 tabular-nums,避免刷新抖动。
底栏 HUD、用量看板、委派图三个自绘组件统一受 潮汐主题材质 开关控制(设置 → 插件 → 潮汐主题 → 潮汐主题材质)。默认开启时套用潮汐 Surface;关闭时回落 DSH 原生 token(如 --dsw-specific-menu、--dsw-alias-bg-layer-*),与宿主外观一致。改动写入 localStorage,实时生效,无需重启。
核心功能¶
底栏性能 HUD 与用量看板¶
单行常驻 HUD(约 36px 高,对齐宿主 TodoPanel 形制)展示会话规模、上下文容量、端到端 TPS、缓存命中率、模型累计耗时;窄屏在 760px / 640px 断点收窄布局。数据未就绪时显示同尺寸骨架条,避免布局跳动。
TPS 口径与原生不同:插件把网络往返与推理思考(含 TTFT)计入,避免仅按解码时间出现的虚高读数。上下文容量按 ≤50%、50–75%、>75% 三档语义色;压缩后通过 projectedTokens 与 contextBreakdown 即时刷新。点击 HUD 展开用量看板:容量分段、性能 KPI、Token 构成与会话耗时;浮层相对 HUD 居中贴合,空间不足时翻转或内部滚动。
Agent Graph 子代理拓扑¶
子代理派发记录独立展示:SVG 弧形连线、横向 Agent 卡片(标题、模型、状态、步骤数)。卡片汇总宿主四个用量桶的 token,并在能匹配 OpenRouter 公开模型目录 单价时显示预估金额(仅供参考,未处理分时定价)。无法可靠匹配工具行与子会话时不占位显示节点。点击卡片进入子会话;运行中卡片可单独停止且不跳转。
侧栏与工作区¶
置顶与普通工作区分列为「置顶 (N)」与「工作区 (M)」小节;支持未归档/归档标签、实时筛选,以及置顶与普通项各自的折叠数量上限(置顶上限为 0 表示不限)。
输入区与插件设置¶
输入框下方提供按供应商分组的模型面板与 Reasoning Effort 滑块;右下方可切换权限预设。每轮回复操作栏显示该轮端到端耗时。动画尊重 prefers-reduced-motion。
安装与启用¶
DSH 生态主张「一切皆插件」;SkillHub 插件目录 为社区站点,与 DeepSeek / 幻方无官方从属关系。安装前建议浏览源码与 LICENSE,并记住插件随当前 DSH 进程权限运行。
方式 1(推荐):在 DSH 插件市场搜索 dsh-tide-theme(显示名「潮汐主题」),安装后重启客户端。
方式 2:命令行(摘自仓库 README,--profile desktop 以你实际 profile 为准):
# npm
dsh plugin --profile desktop add dsh-tide-theme
# GitHub 源码
dsh plugin --profile desktop add git+https://github.com/zdt3476/dsh-tide-theme.git
# GitHub Release 预构建包(示例为 v0.6.1)
dsh plugin --profile desktop add https://github.com/zdt3476/dsh-tide-theme/releases/download/v0.6.1/dsh-tide-theme-0.6.1.tgz
安装后在 设置 → 插件 中启用,并按 README 说明使用 Cmd/Ctrl + R 重载客户端。package.json 要求 dsh >= 0.2.0,Node ^22.19.0 || >=24.0.0。
典型用法¶
- 安装并启用插件,重载客户端。
- 打开 设置 → 插件 → 潮汐主题,按需调整 潮汐主题材质 及侧栏折叠上限等项;配置即时保存。
- 日常会话中观察底栏 HUD;需要明细时点击展开用量看板。
- 使用子代理或
spawn_teammate时,在 Agent Graph 区域查看拓扑与 token;若只需原生皮肤,关闭材质开关即可保留功能、仅换表面 token。
从旧包 dsh-simplify-theme 迁移时,先卸载旧包再安装 dsh-tide-theme,并重新配置本地项。
适用场景与注意¶
适合长期开 DSH 做智能体开发、需要常驻性能读数与子代理可见性的用户。README 说明功能截图部分由插件组件在隔离浏览器中用演示数据渲染,用于展示样式;完整宿主布局另由结构契约测试验证。
OpenRouter 预估金额为保守参考,不可作计费依据。委派图在无法确定映射时会缺省节点,这是刻意设计而非故障。
结尾¶
潮汐主题把 DSH 的视觉与工作流信息层收成一套可开关的增强:真实 TPS、上下文语义色、子代理拓扑与侧栏分层,均可从插件设置页调节。进一步了解可访问目录页 SkillHub · dsh-tide-theme 与 GitHub 仓库。