DSH | DSH Codex UI | Codex-style navigation and workspace UI / Codex 风格导航与工作区界面

[MichengAI]

Unofficial project, independently developed and maintained by MichengAI. This project is not an official DeepSeek AI product.

非官方项目，由 MichengAI 独立开发和维护，并非 DeepSeek AI 官方产品。

Project / 项目地址： https://github.com/MichengAI/dsh-codex-ui
npm： https://www.npmjs.com/package/@michengai/dsh-codex-ui

DSH Codex UI

English

DSH Codex UI is a standalone Web client plugin for DeepSeek Harness. It rebuilds the default Web navigation and conversation surface into a focused Codex-style workspace: projects and conversations stay organized in the sidebar, while search, task state, session actions, and turn navigation are available where people actually work.

The project is for people who want to use the DSH runtime, models, tools, and plugin ecosystem while working in a denser desktop-oriented interface. It can be installed by itself into a web profile; it is not a fork or replacement of the DSH host.

Key capabilities

• Workspace-first navigation — workspace and conversation trees, independent expand/collapse state, pinned projects, drag reordering, unread markers, and running-state indicators.
• A practical session workflow — create, rename, pin, mark unread, archive, fork, copy, and delete conversations from contextual menus; open a workspace folder when the host exposes that action.
• Fast orientation — global search for conversations, workspaces, settings, and quick actions; a compact turn navigator for moving through the current conversation.
• Codex-style visual system — branded header, collapsible sidebar/rail, responsive light and dark themes, a restyled conversation column, and a compact composer card.
• Companion-plugin management — Settings → About shows compatible MichengAI companion plugins, their installed/update state, and provides installation/update entry points.

Screenshots

Light theme — sidebar, workspace tree, and conversation column

Dark theme — the same workspace and conversation workflow

Session actions — manage a conversation without leaving the workspace

Settings → About — inspect and manage companion plugins

DeepSeek Harness integration

DSH Codex UI is a DSH Web client plugin. It integrates through published DSH extension points only:

• It replaces the navigation through the official sidebar slot while preserving sidebar.workspaces, sidebar.settings, and sidebar.footer.action.
• It injects through the published client runtime, layout, locale, conversation, and settings-general integration points.
• It consumes the host’s existing workspace/session services instead of maintaining another conversation store.
• It does not modify DeepSeek Harness source code or conversation records. Uninstalling the plugin restores the default sidebar.

Install

Prerequisite: a working DeepSeek Harness Web installation with the dsh command available. The example uses the web profile; replace it with your target profile if needed.

dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/
dsh --profile web --dump-config

After installation, restart DSH Web and hard-refresh the browser. The configuration dump should show the Codex UI bundle mounted. Source installation, compatibility details, screenshots, and changelogs are in the repository.

---

中文介绍

DSH Codex UI 是一个面向 DeepSeek Harness 的独立 Web 客户端插件。它不改变 DSH 的运行时、模型、工具或会话存储，而是在官方扩展点之上，将默认 Web 导航和对话界面重构为更偏 Codex 工作台的布局：项目、会话、搜索、运行状态和常用操作集中在一套连续的工作流中。

它适合希望继续使用 DSH 生态和能力、但更偏好桌面开发工具式导航与会话管理体验的用户。插件可以独立安装到任意 DSH web profile；它不是 DSH Host 的 Fork，也不取代官方运行时。

主要能力

• 以工作区为中心的导航：项目与会话树、独立展开/折叠状态、置顶项目、拖拽排序、未读提示与运行状态提示。
• 完整的会话管理流程：在右键/上下文菜单中完成新建、重命名、置顶、标记未读、归档、Fork、复制和删除；当宿主提供能力时，也可直接打开工作区文件夹。
• 快速定位信息：全局搜索可查找会话、项目、设置页和快捷操作；当前会话带紧凑的轮次导航，便于回看长对话。
• Codex 风格界面：品牌化顶部栏、可折叠侧边栏与窄栏、亮/暗主题、自适应对话列和紧凑输入卡片。
• 配套插件管理：在 设置 → 关于 中查看兼容 MichengAI 配套插件的安装与更新状态，并提供安装/更新入口。

与 DeepSeek Harness 的集成方式

DSH Codex UI 是 DSH 的 Web 客户端插件，只通过公开的 DSH 扩展点集成：

• 使用官方 sidebar slot 替换导航，同时保留 sidebar.workspaces、sidebar.settings、sidebar.footer.action 等子插槽。
• 通过已发布的客户端 runtime、layout、locale、conversation、settings-general 集成点注入功能。
• 直接使用宿主已有的工作区和会话服务，不再建立第二套会话数据源。
• 不修改 DSH 宿主源码，也不写入或改造对话记录；卸载后即可恢复默认侧边栏。

安装

前提是已能运行 DeepSeek Harness Web，并且 PowerShell 中可以使用 dsh 命令。下面以 web profile 为例，其他 profile 可替换名称：

dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/
dsh --profile web --dump-config

安装完成后重启 DSH Web，并对浏览器执行硬刷新；可通过 --dump-config 确认 Codex UI bundle 已挂载。源码安装、兼容性说明、完整截图与更新日志请见项目仓库： https://github.com/MichengAI/dsh-codex-ui

欢迎使用、反馈问题或提交贡献。

[denial123789]

I turned the project description into an Agent-first integration runbook: https://github.com/sandbaseai/deepseek-harness-handbook/blob/main/docs/en/integrations/dsh-codex-ui-extension-boundary.md — it focuses on public extension points, Host-owned Sessions, acceptance probes, and profile-scoped rollback. Published in v0.5.374: https://github.com/sandbaseai/deepseek-harness-handbook/releases/tag/v0.5.374

[MichengAI]

Thank you for taking the time to create and share this detailed integration guide. We appreciate your careful work and the attention to the project’s integration boundaries and rollback considerations.