dsh-codex-ui
michengai/dsh-codex-ui
Codex 스타일 레이아웃으로 DeepSeek Harness의 웹 사이드바, 워크스페이스 트리, 검색, 턴 내비게이션을 재구성합니다.
설치
dsh plugin --profile web add github:michengai/dsh-codex-uiREADME
DSH Codex UI v2.0
现代化 DeepSeek Harness 全方位界面增强套件:极速历史召回、全屏设置皮肤、原生物理毛玻璃换肤与模块化侧栏
简体中文 · English · 日本語 · Español · Français · Deutsch · Русский · Português
声明:DSH Codex UI 是社区维护的 DeepSeek Harness(DSH)现代化界面增强插件,并非 DeepSeek AI 官方产品。
为什么选择 Codex UI 2.0?
在日常使用 DeepSeek Harness 时,原生界面可能存在设置窗口狭小局促、主题配色单一、侧栏长插件列表不易整理、输入历史丢失等痛点。Codex UI 2.0 经历了从底层架构到视觉体系的全面重塑,以六大独立子插件与内置生态管理构建起一套高性能、低侵入、官方原生的现代化界面增强体系:
- 🚀 极速输入召回与智能预测:智能行内意图预测与续写(
Tab一键采纳,Alt+↓/↑切换候选项),终端风格输入框历史(↑/↓快捷召回),支持自适应宽度微调; - 🪟 全屏悬浮双岛设置:告别局促模态框,接入 Ambient Ground 漫反射画布与双岛卡片工作台;
- 🎨 物理级毛玻璃换肤:内置 14 款高品质主题配色(含 Codex、Claude、Dracula、Cyberpunk、Solarized、Gruvbox 与 Catppuccin 系列),支持原版平铺玻璃与云母悬浮双排版模态、三档材质预设与独立地面光斑;
- 🧭 模块化侧边栏:展开态支持原位平滑折叠抽屉与自由拖拽排序;收缩折叠态 100% 对齐宿主官方 56px 原生导轨,所有图标整齐排列、新会话常驻高对比度;
- 🧠 智能会话标题:首条消息语义解析,自动提炼精炼标题,完美适配推理大模型长上下文;
- 🌐 全量官方多语言国际化:深度支持 DSH 官方全部 8 门内置语言(中、英、日、西、法、德、俄、葡),界面文案、建议卡片、右键菜单与会话标题随宿主环境自适应无缝切换;
- 🖥️ 桌面原生窗口菜单:在官方桌面端系统标题栏无缝注入帮助菜单,提供原生视图刷新与跨端可靠的应用与 Host 重启能力;
- 📦 生态配套管理:官方与第三方生态插件集中看护、版本检测与一键批量升级。
为什么选择彻底重构?(历史演变与技术决策)
1. 早期 1.x 时代的无奈选择:“暴力覆盖组件”的技术负债
在 DeepSeek Harness(DSH)生态起步阶段,官方宿主的客户端扩展能力与基础设施尚不完善:不仅缺少细粒度的标准 Slots 插槽机制,亦未开放官方原语控件库,插件生命周期钩子也相对稀少。为了能在短时间内为开发者打造出接近 OpenAI / Codex 质感的沉浸式体验,早期 1.x 版本不得不采用了大量激进的“覆盖组件”策略:直接拦截并强行替换宿主 DOM 树、使用高权重 CSS 暴力覆盖原生视图、全量硬编码注入自定义 CSS 变量。
随之而来的维护困局:随着 DSH 官方宿主的快速迭代演进(先后引入 profile 多环境隔离体系、shortcuts 服务门控、标准 Slots 插槽注册契约以及官方原生原语库 @deepseek-ai/dsh-client-ui-primitives 等),早期“强行覆盖”的技术负债开始集中爆发,日常维护愈发举步维艰:
- 💥 版本兼容极度脆弱:宿主上游稍有 DOM 结构微调或 CSS 类名 hash 变动,就会导致覆盖式选择器失效甚至整页渲染崩溃,难以平滑跟进官方新特性;
- 🎨 样式污染与半降级顽疾:暴力注入的全局样式难以做到干净的生命周期销毁。当用户切换或关闭自定义主题时,残存的根属性与色彩变量导致原生暗色模式被严重污染,甚至出现“毛玻璃材质关闭了、但深色背景被卡死无法复原”的半降级尴尬;
- 🧩 状态脱节与“僵尸配置”:在插件或子特性被停用时,覆盖式组件无法干净退回到宿主原生外观,依然在设置面板中渲染无法生效的失效配置项,破坏了系统的整洁度与用户心智。
2. 2.0.0 的彻底重构决策:全面拥抱官方原生体系
面对维护困局,我们在 2.0.0 版本痛定思痛,彻底推翻了 1.x 的全部“组件覆盖”代码,确立了**“零侵入、微内核解耦、全面拥抱官方原生”**的全新技术路线:
- 🏛️ 严格复用官方原生原语与标准 Slots:坚决禁止用 CSS 自行手绘宿主已有控件,全面接入官方
Switch、SegmentedControl、Button原生原语库;侧栏收起时 100% 严丝合缝退回官方原生 56px 导轨规范,真正做到与宿主体系同生共荣; - 🧩 六大微内核子插件物理解耦与模块化管理:将臃肿的单体代码彻底拆解为 6 个高内聚、自闭环的独立子插件与内置模块,彼此边界分明、支持按需独立启停,极大提升了工程可维护性与审计透明度;
- 🛡️ 严格的 Fail-Closed 熔断与动态隐匿 UI:建立标准的高可用防御契约。一旦探测到子插件在当前 Profile 被停用或服务端不可达,底层不仅物理熔断 Token 注入并彻底清空根属性,前台设置面板更会直接整体隐匿对应卡片(0 DOM 节点),绝不残留任何置灰死项,瞬间 100% 干净回退至官方原生;
- 🔒 严格 Profile 隔离与无缝自愈机制:统一权威的 Profile 路径解析,彻底杜绝跨环境串读与配置污染;同时接入
focus窗口重获焦点自愈探活,兼顾极致安全与网络抖动下的高可用性; - 🎨 纯正 Codex 科技蓝黑美学:彻底清洗历史残留的绿色硬编码,精准还原官方
#339cff科技蓝、极简纸白与沉浸炭黑质感,辅以双排版模态与地面柔光反射光斑。
六大核心子插件与内置功能架构
| 子插件 ID | 模块名称 | 核心能力说明 |
|---|---|---|
composer | 输入框增强 | 智能输入预测与行内续写(Tab 采纳、Alt+↓/↑ 候选循环)、终端风格历史记录(↑/↓)快捷召回、会话/工作区可选隔离存储、自适应宽度拖拽手柄与快捷提示。 |
settings-skin | 原生设置皮肤 | 全屏设置工作台美化、悬浮双岛架构、Ambient Ground 自然光漫反射底板、分类导航与原生输入框搜索。 |
theme | 主题与界面换肤 | 内置 14 款主题配色(含 Appearance Cube 色彩方块)、原版平铺/云母悬浮双排版、三档材质预设与地面光斑开关。 |
sidebar | 模块化侧栏导航 | 模块化侧边栏导航、工作区分区管理(支持从任意分区标题栏直接「添加工作区」并自动归位,按宿主目录选择能力动态显隐)、手风琴原位平滑折叠抽屉、自由拖拽排序、会话右键「标记为未读 / 已读」;折叠态 100% 对齐宿主官方 56px 原生导轨。 |
session-title | 会话智能标题 | 基于首条消息语义提取并生成规范的会话标题,支持推理模型 4096 tokens 上下文,防止乱码截断。 |
desktop-menu | 桌面窗口菜单 | 官方桌面端系统原生标题栏菜单无缝增强,提供视图快速重载与跨端高可靠的应用与 Host 优雅重启。 |
dependencies | 配套生态管理(内置模块) | 深度集成 DSH 官方与第三方生态插件集中管理,实时显示 npm 下载量、安装状态与一键批量升级。 |
真机界面预览
以下界面均使用
ego-browser在真实的 DeepSeek Harness Web 运行环境中捕获。
1. 沉浸主界面与输入增强(深色模式)
沉浸炭黑(Codex Dark)配色,居中展示品牌标语与快捷动作引导卡片,底部输入框提供「↑↓ 翻历史」快捷召回与自适应宽度手柄。

2. 极简纸白主界面(浅色模式)
极简纸白(Codex Light)配色,接入 Ambient Ground 自然光漫反射渐变底板,温润通透,视觉流平滑舒缓。

3. 全屏悬浮双岛设置中心(模块化卡片体系)
告别局促的弹窗,重塑为模块化卡片工作台(功能与内置子插件、界面外观与换肤、配套管理插件),层次严谨秩序井然,支持根据子组件启用状态动态自适应呈现。

4. 界面外观换肤与毛玻璃配置
内置 14 款高品质主题色盘与 1 款官方原生选项(涵盖 Codex、Claude、Dracula、Cyberpunk、Solarized、Gruvbox 与 Catppuccin 系列),支持原版平铺玻璃与云母悬浮双排版模态,提供清透/标准/磨砂三档材质直选与地面反射光斑开关。所有主题基于 Design Token 动态注入与无残留纯净销毁,绝无全局样式污染。
内置主题与配色方案一览
| 主题系列 | 主题名称 | ID | 模式 | 视觉风格 | 核心配色方案 (强调色 / 底板色 / 文本色) |
|---|---|---|---|---|---|
| 官方原生 | 官方默认 | stock | 自动 | 跟随系统 原生界面 | Accent: #3b82f6 (保持宿主原生深浅模式,不注入自定义配色变量) |
| Codex | Codex 暗色 | codex-dark | 深色 | 沉浸炭黑 极客质感 | Accent: #339cff · BG: #09090b · Text: #fafafa |
| Codex 亮色 | codex-light | 浅色 | 极简纸白 纯净阅读 | Accent: #0169cc · BG: #ffffff · Text: #18181b | |
| Claude | Claude 暗色 | claude-dark | 深色 | 暖炭夜色 陶橙点缀 | Accent: #d97757 · BG: #141414 · Text: #fdfdfd |
| Claude 暖白 | claude-light | 浅色 | 暖米纸感 陶橙点缀 | Accent: #d97757 · BG: #faf9f5 · Text: #1f1e1d | |
| Dracula | Dracula (德古拉) | dracula | 深色 | 吸血鬼粉 潮酷荧光 | Accent: #ff79c6 · BG: #191a21 · Text: #f8f8f2 |
| Cyberpunk | Cyberpunk (赛博朋克) | cyberpunk | 深色 | 黑底霓虹绿 矩阵终端 | Accent: #00ff41 · BG: #000a00 · Text: #00ff41 |
| Solarized | Solarized 暗色 | solarized-dark | 深色 | 深海墨绿 碧玉青蓝 | Accent: #2aa198 · BG: #002b36 · Text: #93a1a1 |
| Solarized 亮色 | solarized-light | 浅色 | 古籍羊皮 日光清蓝 | Accent: #268bd2 · BG: #fdf6e3 · Text: #586e75 | |
| Gruvbox | Gruvbox 暗色 | gruvbox-dark | 深色 | 泥炭深棕 暖金复古 | Accent: #fabd2f · BG: #282828 · Text: #fbf1c7 |
| Gruvbox 亮色 | gruvbox-light | 浅色 | 牛皮纸黄 复古工装 | Accent: #b57614 · BG: #fbf1c7 · Text: #282828 | |
| Catppuccin | Mocha (摩卡) | catppuccin-mocha | 深色 | 摩卡暗色 舒适护眼 | Accent: #cba6f7 · BG: #11111b · Text: #cdd6f4 |
| Macchiato (玛奇朵) | catppuccin-macchiato | 深色 | 玛奇朵暗色 典雅柔和 | Accent: #c6a0f6 · BG: #181926 · Text: #cad3f5 | |
| Frappé (冰吸) | catppuccin-frappe | 深色 | 冰吸暗色 雾感通透 | Accent: #ca9ee6 · BG: #232634 · Text: #c6d0f5 | |
| Latte (拿铁) | catppuccin-latte | 浅色 | 拿铁暖白 温润明快 | Accent: #8839ef · BG: #eff1f5 · Text: #4c4f69 |
5. 模块化侧边栏导航(展开态)
支持插件、技能、常用工具(IM 助理、定时任务、归档会话、代码审查等)自由拖拽排序与「更多」手风琴平滑折叠收纳。

6. 官方原生 56px 折叠导轨(收缩态)
侧栏收起后自动对齐官方原生紧凑 56px 导轨规范,无缝完整显示全部功能图标,新会话常驻高亮显示,无需鼠标悬停试探。

7. 增强会话菜单
支持在会话项上快速执行置顶、重命名、未读标记、归档、派生新会话与安全清理。

宿主兼容性
- 支持范围:DeepSeek Harness
0.2.x全系列(>=0.2.0-rc.1 <0.3.0-0); - 实测验证:支持矩阵为全部
0.2.xRC(0.2.0-rc.1、0.2.0-rc.2、0.2.1-rc.1~0.2.1-rc.5、0.2.2-rc.1~0.2.2-rc.3);中间版本阿尔法不在支持范围内; - 环境要求:Node.js
^22.19.0 || >=24.0.0,pnpm^11.0.0。
⚠️ 互斥提示:请勿同时启用 Codex UI 与
ds-bot。两者均重塑侧栏与主会话插槽,功能重叠。启用前请先停用或卸载另一个。
安装与快速上手
方式 A:让 Agent 帮您安装(推荐)
复制以下指令发送给任意具备终端执行权限的 Agent(将 web 替换为您实际使用的 profile 名称):
请将 DSH 插件 @michengai/dsh-codex-ui 安装到本机 web profile,执行:
dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/
安装后执行 dsh --profile web --dump-config 确认包含 codex-ui,并提示我刷新浏览器。
方式 B:终端手动安装
在终端(Windows PowerShell 或 MSYS Bash)中执行:
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/
dsh --profile web --dump-config
安装完成后,重启 DSH Web 实例并硬刷新浏览器页面(Ctrl + Shift + R 或 Cmd + Shift + R)即可进入全新 2.0 体验!
常用操作速查
| 场景 | 操作方式 |
|---|---|
| 采纳输入预测续写 | 打字停顿弹出高亮候选项时,按 Tab 键一键采纳补全;按 Alt + ↓ / Alt + ↑ 循环切换多条候选,按 Esc 退出。 |
| 切换输入预测模式 | 打开「设置 → Codex UI」,在「输入框增强」卡片选择「智能输入预测」模式(关闭 / 仅续写 / 推测+续写);支持在 Profile 的 cordis.patch.yml 中配置 config.prediction: false 实现站点级统一锁定。 |
| 找回历史输入 | 输入框为空时按键盘 ↑ / ↓ 方向键,即时召回当前会话(或同一工作区,可在设置中切换)提交过的历史文本(每个作用域最多 200 条)。 |
| 切换历史召回范围 | 在「设置 → Codex UI → 输入框增强」卡片选择「历史召回范围」:默认「当前会话」只召回本会话输入;切到「当前工作区」后与同一 cwd 的所有会话共享,在未被最近 100 个作用域的容量上限淘汰前,旧的工作区历史也会重新可见。 |
| 调节输入框宽度 | 悬停至输入框左右边缘,拖拽蓝色手柄即可自定义最舒适的编写宽度。 |
| 切换主题与质感 | 打开「设置 → Codex UI」,在「界面外观与换肤」卡片单选 14 款主题,直选原版/云母模式与材质预设。 |
| 调整侧栏图标顺序 | 鼠标按住展开侧栏中的任意插件条目拖拽上下移动,蓝线指示放置位置,支持拖入/拖出「更多」手风琴。 |
| 从分区直接添加工作区 | 悬停或键盘聚焦到任意侧栏分区(「置顶」、「项目」或自定义分区)标题,点击右侧 ··· 旁的「添加工作区」图标(随宿主目录选择能力显隐),新建的工作区会自动归入该分区并展开。 |
| 折叠/收起侧边栏 | 点击侧栏顶部折叠按钮;收缩后自动切换为 56px 原生导轨,单手盲点所有功能图标。 |
| 生态插件批量更新 | 在「设置 → Codex UI」底部「配套管理插件」卡片,点击「全部更新」自动安装最新配套依赖。 |
DSH 现代化生态矩阵
如需搭配完整的开发运维闭环,可按需在配套管理卡片中一键启用以下生态插件:
| 插件名称 | 核心用途 |
|---|---|
| Codex UI | 界面总控:极速输入召回、全屏设置皮肤、毛玻璃换肤与模块化侧栏 |
| Agency Agents | 专家调度:任务精准画像,一键召唤行业专家角色矩阵 |
| Skills Manager | 技能枢纽:本地技能统一发现、导入、启停与智能配置 |
| Archive Manager | 归档管理:历史会话深度检索、恢复与安全物理归档清理 |
| IM Connect | 消息串联:连接微信、钉钉、飞书、QQBot 双向派发与接收任务 |
| Automation | 定时管家:Cron 定时流水线看护与运行证据追踪 |
| Code Review | 代码审查:/review 独立审查子代理并直接向当前会话投递严谨评审报告 |
| Simplify | 代码精简:/simplify 4-agent 并发精简与坏味道消除 |
| PUA | 韧性强化:失败自动归因重试,完工证据多维校验守门员 |
| BTW | 临时旁问:长任务进行中轻量旁问,不破坏主线程上下文 |
| Codex Pet | 桌面宠物:任务状态动态浮窗交互、工具审批与拟人化提醒 |
许可证
本项目基于 Apache License 2.0 开源协议分发与维护。