DeepSeek Harness 的 Web GUI 默认侧边栏包含了全局面板(如 Pull requests、Scheduled、Plugins)以及新建会话按钮。对于习惯 Codex 风格界面或追求极简的开发者来说,这些元素可能会显得冗余。
dsh-plugin-codex-ui 是一个 Web GUI 侧边栏皮肤插件。它将默认的浏览区域替换为 Projects 和 Recents 两个可折叠区域,并将新建会话的操作简化为无需选择项目即可启动的“新对话”行。同时,该插件隐藏了全局面板行,并调整了侧边栏的内边距。
核心功能¶
- 品牌名称替换:将侧边栏顶部的品牌名称替换为“DeepSeek Harness”。
- 侧边栏重构:用 Projects(项目)和 Recents(最近)浏览器替代原有的浏览区域。
- 隐藏全局面板:隐藏 Pull requests、Scheduled、Plugins 等全局面板行。
- 新建会话优化:隐藏默认的新建会话按钮,替换为“新对话”行。点击该行可直接创建会话,系统会自动分配工作目录,无需预先选择项目。
- 布局微调:将侧边栏内边距(
--dsh-sidebar-inline-padding)从 12px 调整为 10px。 - 交互优化:项目行点击可折叠/展开该项目的聊天记录;最近会话支持悬停查看存档操作。
安装与启用¶
该插件依赖 DeepSeek Harness 的 web profile,并且环境需要安装 Node.js 20 或更高版本,同时 pnpm 需要在 PATH 中可用。
- 执行以下命令安装插件:
dsh plugin --profile web add github:ice-ai-lab/dsh-plugin-codex-ui
- 安装完成后,必须重启
dsh web进程以加载客户端组件。仅刷新页面无法生效。
典型用法¶
无项目启动会话¶
安装并重启后,侧边栏会出现“新对话”行。点击该行会创建一个会话,系统会自动分配一个全新的工作目录,并将其注册为 Workspace。该会话属于“无项目”会话,会自动归类到 Recents 区域。
管理项目¶
侧边栏底部的“项目”区域列出了已注册的工作目录。点击项目行可以折叠或展开该项目的聊天列表。在项目行上点击“+”按钮可以在该项目内新建聊天。
管理最近会话¶
“最近”区域仅显示属于无项目会话的聊天记录。将鼠标悬停在最近会话行上,点击右侧出现的垃圾桶图标即可存档该会话。
注意事项¶
- 环境依赖:安装前请确保 Node.js 版本 >= 20,且系统中已配置
pnpm。 - 存档不可逆:最近会话的存档操作是不可逆的,存档后聊天记录将从列表中消失,但日志文件仍保留在磁盘上。
- 目录位置:无项目会话和最近会话的工作目录位于
$DSH_HOME/codex-workspaces/(默认~/.dsh/codex-workspaces/)。
总结¶
dsh-plugin-codex-ui 适合希望将 DeepSeek Harness Web 界面调整为 Codex 风格,并简化项目管理流程的用户。它通过移除默认的全局面板行和简化新建会话流程,提供了一个更聚焦于聊天记录和项目管理的侧边栏视图。