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

  • 48px Activity Rail: Consolidates plugins, web browser, terminal, and workspace switchers into a sleek vertical navigation column;
  • Flexible Drawer Panel: History sessions and side drawers slide smoothly, maximizing your conversation and coding viewport.

• 👤 Quick Account Center & Avatar Access
  A dedicated 28px circular anime avatar entry is pinned at the bottom of the Activity Rail for instant one-click access to account, profile, and model settings.

• ⚡ 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.

⌨️ 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 (Fully supports 0.2.x Desktop / Web)
• Platforms: Windows / macOS / Linux

---

中文说明

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

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

✨ 核心特性

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

• 🗂️ Codex 级双列工作流

  • 48px 图标活动栏：将插件、终端、浏览器、工作区切换等功能归拢于左侧纵向 Rail，布局井然有序；
  • 弹性会话面板：侧边列表支持平滑收展，留出最大化的主对话与编码视野。

• 👤 快捷账号中心与头像入口
  在活动栏底部常驻 28px 精美圆形头像与个人中心入口，点击即可直接呼出或定位到账号与模型配置。

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

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

• 🚀 丝滑动画与高帧率过渡
  深度优化 CSS Transform 与浏览器重绘机制，彻底解决原生在侧边栏折叠与展开时的掉帧卡顿。

⌨️ 快捷键速查

快捷键	功能说明
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（完美兼容 0.2.x Desktop / Web）
• 适用平台：Windows / macOS / Linux

---

📄 开源许可 / License

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