Codex Rail & Integrated Deck

dsh-codex-rail

English  |  中文说明

English

Transforms DeepSeek Harness (DSH) into a sleek, immersive Codex-style dual-column workspace with an integrated Activity Bar, unified topbar, and smooth session history navigation.

[!NOTE]

Author Disclaimer: This project is for personal use by the author and is a product of vibecoding.

Crafted to bring a sleek, distraction-free, and immersive Codex dual-column workflow to DeepSeek Harness. Feature evolution and maintenance are primarily tailored to the author's daily workflow. Feedback, suggestions, and PRs are warmly welcomed!

✨ Key Features

• 🎨 Unified Titlebar & Activity Rail

Seamlessly fuses the native window titlebar with the 48px vertical Activity Rail, eliminating jarring borders, white gaps, and layout seams.

• 🗂️ Codex Dual-Column Layout & Adaptive Popover Alignment
• 48px Activity Rail: Consolidates plugins, web browser, terminal, workspace switchers, and upstream DSH 0.2.1-rc.3 More/Customization menus into a sleek vertical navigation column with millisecond-precision popover docking;
• Flexible Drawer Panel: History sessions and side drawers slide smoothly, maximizing your conversation and coding viewport;
• Rich Codex Iconography: Native dedicated SVG icons for Personalized Recommendations (Sparkle), More Menus (Triple Dot), Skill Explorer, and Taskboard.
• 👤 Quick Account Center & Avatar Access

A dedicated 30px circular crystal avatar entry is pinned at the bottom of the Activity Rail for instant one-click access to account, profile, and model settings.

• 🌈 Wallpaper Engine Seamless Transparency

Deeply integrates with Wallpaper Engine plugins, supporting liquid glass blur, acrylic frosted sidebar, and full transparent mode with zero visual clipping.

• ⚡ Session History Navigation (Forward / Back)

Built-in browser-like navigation buttons with native global shortcuts: Alt + ← (Back) and Alt + → (Forward) to effortlessly traverse multi-turn conversations.

• 🪄 10px Floating Card Workspace

The main chat and coding area is wrapped in a refined floating container with subtle inner shadows and rounded corners for maximum visual depth.

• 🚀 Buttery-Smooth Animations

Optimized CSS transform transitions and GPU repaint boundaries, completely eliminating frame drops during sidebar expand and collapse.

• ⚡ Idle & Debounced Sync Engine

120ms debounced synchronization combined with browser-native requestIdleCallback (with 300ms fallback timeout) and __dshHtml update fingerprinting, eliminating redundant DOM queries and innerHTML rewrites during high-frequency chat streaming.

⌨️ Keybindings

Shortcut · Description Alt + ← · Navigate back to previous session history Alt + → · Navigate forward to next session history Click Bottom Avatar · Open / focus Account Center & Profile Settings

📦 Installation

Method 1: DSH Plugin Market (Recommended)

1. Open DeepSeek Harness (DSH);
2. Go to Plugin Market;
3. Search for dsh-codex-rail and click Install;
4. Restart or refresh DSH to enjoy.

Method 2: Command Line

# In your DSH profile directory (e.g. ~/.dsh/profiles/desktop)
npm install dsh-codex-rail

And ensure it is enabled in your cordis.yml:

dsh-codex-rail: {}

Method 3: Local Symlink for Development

git clone https://github.com/ComlaiGonnann/dsh-codex-rail.git

# Create Junction on Windows:
mklink /J "%USERPROFILE%\.dsh\packages\dsh-codex-rail" "path\to\dsh-codex-rail"

⚙️ Compatibility

• Compatible with DSH: >= 0.1.1-rc.1 (Full native support for DSH 0.2.0 / 0.2.1-rc.1 / 0.2.1-rc.2 / 0.2.1-rc.3 Desktop & Web)
• Platforms: Windows / macOS / Linux

中文说明

将 DeepSeek Harness (DSH) 界面重构为极具现代质感的 Codex 式双列活动栏与全窗一体化工作区主题插件。

[!NOTE]

作者声明：此为作者自用且为 vibecoding 产物。

本插件旨在为 DeepSeek Harness 打造精致沉浸的 Codex 双列活动栏与顶栏一体化视觉体验。功能演变与日常维护主要依据作者个人实际工作流展开，欢迎交流体验与提交 PR！

✨ 核心特性

• 🎨 全窗顶栏一体化质感

无缝打通原生标题栏与 48px 活动栏（Activity Rail），彻底消除断层与多余留白，与原生明亮/暗黑主题深度贴合。

• 🗂️ Codex 级双列工作流与自适应 Popover 锚定
• 48px 图标活动栏：将插件、终端、浏览器、工作区切换以及 DSH 0.2.1-rc.3 原生「更多/创建插件」菜单归拢于左侧纵向 Rail，毫秒级浮层对齐，布局井然有序；
• 弹性会话面板：侧边列表支持平滑收展，留出最大化的主对话与编码视野；
• 全套 Codex 专属图标：深度适配个性化推荐（灵感火花 Sparkle）、更多菜单（三点水平排列）、技能探索与看板等专属矢量图形。
• 👤 快捷账号中心与水晶头像入口

在活动栏底部常驻 30px 精美圆形水晶微质感头像与个人中心入口，点击即可直接呼出或定位到账号与模型配置。

• 🌈 壁纸引擎无缝透光与毛玻璃兼容

深度适配 Wallpaper Engine 壁纸插件，无缝支持液态磨砂毛玻璃（Liquid Glass）、侧边栏亚克力与全透模式（Full Clear）。

• ⚡ 会话前进 / 后退历史导航

内置导航控制按键，并原生支持 Alt + ←（后退）和 Alt + →（前进）全局快捷键，顺畅穿梭于多轮历史会话。

• 🪄 工作区 10px 悬浮圆角卡片

主对话与代码编辑区域采用卡片化容器包裹，搭配轻量内衬阴影与圆角设计，层次分明，极具科技美感。

• 🚀 丝滑动画与高帧率过渡

深度优化 CSS Transform 与浏览器重绘机制，彻底解决原生在侧边栏折叠与展开时的掉帧卡顿。

• ⚡ 智能空闲调度与高频 DOM 防抖 (Idle & Debounced Sync Engine)

采用 120ms 动态防抖与浏览器原生 requestIdleCallback（300ms 超时保护），配合活动栏按钮 __dshHtml 缓存指纹，彻底消除高频对话流与侧边栏变动时的多余 DOM 重排与重绘开销。

⌨️ 快捷键速查

快捷键 · 功能说明 Alt + ← · 后退至上一个会话历史 Alt + → · 前进至下一个会话历史 点击活动栏底部头像 · 快速唤出 / 跳转个人账号中心

📦 安装与使用

方式一：DSH 插件市场安装（推荐）

1. 启动 DeepSeek Harness (DSH)；
2. 进入 插件市场 (Market)；
3. 搜索 dsh-codex-rail 并点击 安装；
4. 安装完成后重启或刷新 DSH 即可生效。

方式二：命令行安装

进入你的 DSH 用户 Profile 目录（如 ~/.dsh/profiles/desktop 或指定 workspace）：

npm install dsh-codex-rail

并在 cordis.yml 中确认启用：

dsh-codex-rail: {}

方式三：开发者本地软链接调试

# 克隆仓库
git clone https://github.com/ComlaiGonnann/dsh-codex-rail.git

# 在 DSH 的 packages 目录下建立软链接 (Windows 示例)
mklink /J "%USERPROFILE%\.dsh\packages\dsh-codex-rail" "你的本地仓库路径\dsh-codex-rail"

⚙️ 兼容性说明

• 兼容 DSH 版本：>= 0.1.1-rc.1（完美支持 DSH 0.2.0 / 0.2.1-rc.1 / 0.2.1-rc.2 / 0.2.1-rc.3 Desktop 与 Web）
• 适用平台：Windows / macOS / Linux

📄 开源许可 / License

本项目基于 MIT License 开源发布。