Oh My DSH.文档GitHub ↗
文档导航

DOCUMENTATION OMD 0.2.1-alpha.1.omd.0.5.2

本页目录

Claude CLI · 全新终端布局#

在「设置 → 外观 → 皮肤」选择 Claude CLI · 全新终端布局。它的 ID 是 claude-cli-terminal。明暗跟随 DSH 的「明暗模式」设置。

这是一套从零实现的终端外观：暖黑/纸白底色、陶土橙强调、等宽文字、横线输入区、左对齐对话、紧凑工具记录、目录式会话导航和终端配置面板。覆盖宿主完整设置、Oh My DSH 六个子页、右侧工作台、菜单和窄屏导航。布局不改变 DSH 的模型、权限、工具执行或设置含义。

字体#

皮肤内嵌 JetBrains Mono Regular / SemiBold 两个 WOFF2 文件，导航、正文、输入、设置和代码使用同一字体族。加载皮肤后不访问字体 CDN，也不要求电脑预先安装字体。关闭代码连字，保留 =>、!= 等字符的原始形状，便于与终端输出对应。

中文依次回退到本机的 Noto Sans Mono CJK SC、Sarasa Mono SC、PingFang SC、Microsoft YaHei。中文字体不内嵌，具体字形取决于系统；不会把英文字体描述成包含中文字形。字号继续尊重 DSH 用户设置。

字体来自 JetBrains 官方仓库，采用 OFL-1.1。原许可及每个下载文件的来源和 SHA-256 保存在 src/client/skins/claude-cli-terminal/assets/。它是本皮肤为一致性选定的字体，不声称是 Claude Code 唯一的官方终端字体。

构建与导入#

运行 node scripts/build.mjs 时会从独立目录生成内置皮肤；运行 node scripts/pack-skin.mjs src/client/skins/claude-cli-terminal 可生成可导入的 .omd-skin.json。字体已经内嵌在 JSON 中，无需另拷贝素材。

完整布局由本插件内置的 claude-cli-terminal 适配器提供，因此应使用含该适配器的插件版本。旧版导入器不认识这个布局时会拒绝包，不保证自动降级。普通导入 CSS 仍不允许注入布局代码或 JavaScript。

600px 以下，展开会话导航时以整页导航呈现；选择会话或新建后自动返回对话。设置分类横向滚动，内容保持单栏。恢复默认或切换皮肤会移除本套样式，品牌插槽恢复原有呈现。

验证入口#

2026-09-21 已通过本套安装包 UI 验收，以及共用皮肤格式、导入恢复、原生控件、全部内置皮肤的设置与会话回归。实拍核对了终端对齐、桌面/窄屏设置、深浅色、工作台和代码。验证使用 macOS 上的 Chromium 与隔离 DSH 实例，模型响应由测试提供方返回。

  • test/claude-cli-terminal-ui.test.mjs：安装打包后的插件，使用真实 DSH 测试实例、隔离配置和模拟模型提供方；覆盖字体、各设置页面、深浅色、390px、工具调用、停止、设置保存、导入与恢复。
  • TRISOUL_UI_ARTIFACTS=1 node --test test/claude-cli-terminal-ui.test.mjs：保留各页面截图到 data/claude-cli-terminal-qa/，用于视觉复核。
  • 多会话同时构建时，共用 UI 回归可以设置 OMD_UI_PACKED=1，让测试安装包快照，避免另一个会话更新 lib/client.js 导致测试浏览器中途热重载。
  • 官方视觉与行为资料见 调研记录。