YrracOwl/dsh-theme-cutout-clash

dsh-theme-cutout-clash

英文

Cutout Clash 是面向 DeepSeek Harness Web 的可选择新粗野主义 / 波普艺术主题包。它让对话内容保持平静，同时为 Shell、Composer、Goal 和转场表面增添表现力。Client Store 兼容路径面向 DSH 0.1.2+，并为更早的 RC 宿主提供旧版 runtime 回退。

中文

Cutout Clash 是面向 DeepSeek Harness Web 的可选择新粗野主义 / 波普艺术主题包：保持会话内容安静易读，同时增强 Shell、Composer、Goal 和转场表面。优先使用 DSH 0.1.2+ 的 Client Store，并为旧版 RC 保留 runtime 回退。

Cutout Clash 0.5.10 是一个独立的、可选择 DSH Web 主题包，围绕原创的新粗野主义与波普艺术构图构建。它是 dsh-theme-acid-noir 的配套插件；两者互不替换、互不修补。

视觉系统

该主题遵循边缘张扬，中心平静：

- 侧边栏、选区、Composer、Goal 以及瞬时主题转场承载表现力几何。
- 对话文本、Markdown、终端、diff、代码指标、滚动几何以及流式内容保持平直、安静。
- 工具与 Think 表面使用狭窄的语义状态栏，而不是在每张卡片上加重阴影。
- 语义状态覆盖 Goal/Todo 文本、行内代码、区分工作区展开与活动会话状态、Subagent 弹窗悬停、任务管理悬停、Settings 导航、Composer 命令控件以及上下文对话框，且不依赖 CSS-module 哈希名。
- Settings 内容按钮保留其插件自有的语义前景色：主题绝不会把每个对话框按钮都压平成普通标签文本，因此主要的 Save/Upgrade 控件会保留与其填充 token 配对的前景色。
- 产出文件 chip 保留自己的控件，但其背后的行是透明的，因此交付物行不会读起来像另一个选中状态。
- 行内链接限定在对话正文平面内，并使用按变体区分的、显式带下划线的链接配色对：Night 上为亮青色/黄色，Pop 上为深蓝色/红色。必须显式设置装饰线，因为 DSH 的基础 Markdown 链接样式会将 text-decoration-line 重置为 none；仅设置装饰颜色和粗细不会渲染出高亮。导航、按钮、文件 chip 和插件外壳不会被重新着色为正文链接。
- DSH 官方 Markdown 渲染器会自动将完整值为绝对 HTTP(S) URL 的行内代码 token 转换为 ，包括在紧凑或宽松列表项内部。因此，该主题会将每个 code:not(pre code) a[href] 与代码 chip 前景色配对，而不假设其父级是段落。
- 当 DSH 的文件提及提供程序识别出行内代码路径时，同一渲染器会输出 。该主题针对这一稳定的语义结构——而非其 CSS-module 哈希——因此可点击的文件路径会继承代码 chip 前景色，并在正常与悬停状态下保留显式下划线。
- Composer 在悬停时从不接收 transform，因此其原生上下文对话框会保留 DSH 原有的包含块和定位。
- 不包含任何外部字体、图片、音频、网络资源、游戏标识或角色资源。

安装

dsh plugin --profile web add dsh-theme-cutout-clash

之后重启现有的 DSH Web 进程：Host 会在启动时扫描浏览器插件名册，因此这三个主题只会在重启后出现。然后打开 设置 → 通用 → Cutout Clash 主题。

本地开发时，从本检出目录的父目录执行：

dsh plugin --profile web add .\dsh-theme-cutout-clash

两种形式都会将该包记录到配置文件的 dsh.profile.bundles 中，客户端 bundle 正是由它提供。

可用选项：

- 默认外观 — 跟随 DSH 内置外观。
- Cutout Clash — 暖色纸张、青柠色操作、粉色事件、青色信号。
- Night Cutout — 墨蓝色 Voltage 调色板，配以黄色和青色层级；填充黄色控件使用深色前景，而深色选中导航使用浅色文字。
- Pop Signal — 暖色 Press 调色板，配以印刷蓝、红、黄。

动效与生命周期

- DSH 目前没有公开任何 app/ready、shell/ready 或 boot/ready Client 事件。shell.overlay 由 AppFrame 声明，因此在 AppFrame 首次渲染之前无法覆盖该框架。
- 已保存的 Cutout 主题会在 Client bundle 脚本执行时立即安装一个小的视口固定早期幕布。该幕布在 [data-dsh-frame] 挂载之前就已存在；在 Theme Runtime 恢复已保存的令牌并且官方 shell Slot 可用之后，它会显现并移除自身。
- 普通主题切换会保留一个附加的 shell.overlay 生命周期锚点，而视觉 Plate 直接挂载在 document.body 下。在正常的 z-index: 90 下，它会脱离 AppFrame 的层叠上下文并覆盖 shell 内容，但仍位于 DSH 的弹层带之下（菜单为 100，对话框为 1000，toast 为 1100），因此菜单、对话框、toast 和第三方覆盖层可以覆盖该过渡。
- 启动显现清理拥有自己的定时器通道，因此同时发生的 Theme Runtime 事件无法取消移除并在已恢复的应用程序上留下不透明幕布。Cordis 之前的幕布还拥有一个独立的 2.5 秒看门狗，如果任何 Client 插件加载失败导致 Cutout Fiber 无法应用，它会执行相同的显现和移除。
- 两个几何 Plate 和一个注册带执行一段短暂的非阻塞覆盖/显现序列。
- 覆盖层始终为 pointer-events: none。
- 单调递增的 generation 会在快速切换期间取消过期的定时器。
- 动效可在设置中选择：完整转场 / Full motion、跟随系统 / Follow system 或 关闭转场 / Motion off。现有 Cutout 用户默认使用 Full motion，这样浏览器级别的 reduced-motion 标志不会静默隐藏所请求的主题效果；用户可以随时选择 Follow system。
- 当选择“跟随系统”时，prefers-reduced-motion: reduce 会被遵循；完整动效是用户的显式覆盖，而动效关闭是同步的。
- 任何转录节点、代码行、终端输出、diff 或流式 token 都不会获得入场动效。
- 主题注册、Slot 条目、样式节点、定时器和 body 标记都属于插件生命周期，会在 stop/unload 时被移除。

偏好协调

Acid Noir 和 Cutout Clash 现在共享带版本的浏览器记录 dsh.theme.preference.v1。旧版键仅用于迁移读取。选中的主题会写入一条记录，而 Default 会清除它，因此 DSH 重启后只有一个明确的自定义主题所有者，而不是两个相互竞争的重启恢复器。

DSH 的内置外观作用域可以在任何 Settings 分区保存时重新发出其持久的 light / dark / system 偏好。如果该刷新短暂替换了当前激活的 Cutout 主题，插件会在下一个任务中恢复仍然选中的自定义偏好，而无需按 F5。此管理恢复路径是显式静默的：它会取消任何待处理的 Plate，并且从不播放 cover/reveal 动画。只有冷启动和有意的主题切换才会播放动画。显式点击内置外观选项或任一主题家族的 Default 按钮会先清除自定义记录，因此有意的切换永远不会被对抗。

动效选择单独存储为 dsh-theme-cutout-clash.motion。