Codex 风格侧栏MichengAI/dsh-codex-ui

DSH Codex UI

让 DSH Web 中的项目更好整理、会话更快找到、长对话更易回看

English · 更新日志 · Apache-2.0

许可证：Apache-2.0
npm package
npm 下载量
DSH Web Plugin
Node.js 22 or later

DSH Codex UI 是社区维护的 DeepSeek Harness（DSH）界面增强插件，并非 DeepSeek AI 官方产品。

在 DSH Web 中同时处理多个项目和会话时，DSH Codex UI 帮你整理左侧导航、快速找到任务，并在长对话中跳回之前的提问。它提供 Codex 风格的界面，支持浅色和深色主题。

宿主兼容性

当前工作区已声明支持 DSH 0.1.5-rc.1、0.1.5-rc.2 与 0.1.6-alpha.1。开发依赖钉在 0.1.6-alpha.1。@deepseek-ai/dsh-client-runtime 没有 0.1.6 包，继续使用已发布最高版 0.1.1-rc.2。隔离宿主检查覆盖 rc.2 与 0.1.6-alpha.1。

你可以用它做什么

- 整理项目与会话：展开或折叠项目、拖拽调整顺序、置顶常用项目，查看未读提醒和运行状态。
- 快速找到内容：通过顶部搜索查找会话、设置和快捷操作。
- 管理日常任务：在项目或会话菜单中重命名、归档、派生会话，或打开项目目录。
- 回看长对话：点击轮次导航，直接跳到对应提问。
- 复用之前的输入：输入框为空时，按上下方向键找回当前工作区中已提交的文本。
- 按需扩展功能：在「设置 → 关于」查看配套插件，安装或更新需要的功能。

界面预览

浅色主题：工作区会话树、新建会话建议与底部输入框。

浅色主题新建会话页

深色主题：定时任务总览与新建会话页。

深色主题新建会话页

常规设置：浅色主题下的独立设置页与分区导航。

浅色主题常规设置页

会话菜单：重命名、置顶、未读、归档、派生、复制和删除。

会话菜单

「设置 → 关于」列出配套插件及其安装状态。

关于页与配套插件

前置条件

- 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 dsh。
- 以下示例使用 web profile；请替换为实际目标 profile。
- 运行环境需满足 Node.js ^22.19.0 || >=24.0.0；从源码安装还需要 pnpm。

DSH 产品生态

想使用桌面工作台，可下载 DSH Codex Desktop；已有 DeepSeek Harness 环境，可按各项目 README 按需安装。以下列出 11 个自研插件；桌面端实际随附范围以对应版本的发行说明和内置清单为准。

| 插件 | 你可以用它做什么 |
| --- | --- |
| Codex UI | 整理项目与会话、搜索任务、跳转对话轮次 |
| Agency Agents | 按任务选择并召唤专业角色 |
| Skills Manager | 统一查找、启停、创建和导入本机技能 |
| Archive Manager | 搜索、恢复或清理已归档会话 |
| IM Connect | 从消息平台下任务、收回复 |
| Automation | 按计划执行任务，查看每次运行的结果 |
| BTW | 在当前上下文中临时旁问，不打断主任务 |
| Simplify | 用 /simplify 整理 Git 改动范围内的代码 |
| PUA | 引导 Agent 在失败时换方法、查原因，并在完成前验证结果 |
| Code Review | 用 /review 发起独立 Agent 代码审查，在当前会话接收报告 |
| Codex Pet | 通过桌面宠物查看会话提醒、处理工具审批和问题回答 |

安装

下面提供 Agent 代装和手动安装两种方式，使用同一条安装命令。示例指定最新版和官方 npm 源。

让 Agent 帮你安装（推荐）

把下面这段话发给任意能够执行本机终端命令的 Agent。将 web 替换为实际使用的 profile；安装完成后，在 DSH 中使用本插件。

请将 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，并告诉我如何重新加载 DSH 和开始使用。

手动安装

[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）。看到新的侧栏后即可开始使用；卸载插件会恢复默认侧栏。

使用

打开 DSH Web 后，左侧导航即由本插件渲染。

| 目标 | 操作 |
| --- | --- |
| 新建会话 | 点击「新建任务」，或使用项目中的「+」/「新建会话」。 |
| 查找会话或设置 | 使用顶栏搜索，选择会话、设置页或快捷操作。 |
| 折叠侧栏 | 使用顶栏面板按钮。折叠后展开入口保留在窄轨顶部。 |
| 置顶项目 | 拖到「置顶」区域，或在项目菜单中选择「置顶项目」。 |
| 管理会话 | 打开会话菜单，进行重命名、置顶、未读、归档、派生、复制或删除。 |
| 复用输入 | 输入框为空时按上下方向键，召回当前工作区中之前提交的文本。 |
| 跳转轮次 | 使用当前会话左侧的轮次刻度跳转到对应提问。 |
| 查看连接器 | 打开「设置 → 连接器」。不会展示地址、命令或凭证。 |
| 查看配套插件 | 打开「设置 → 关于」，安装或更新各个配套插件。 |

常见问题

置顶和未读状态会保留吗？

置顶项目保存在 DSH 配置中，重启后仍保留。未读标记仅保存在当前浏览器，不会跨浏览器同步。

为什么找不到以前的输入？

输入历史按工作区分别保存在当前浏览器，每个工作区最多保留 200 条。它从功能启用后的新输入开始记录，不会从已有会话补录；浏览器存储不可用时，仅在内存中临时保留。无需额外安装 BTW 插件。

移除项目会删除本地文件吗？

删除项目注册不会删除项目目录或会话记录。归档会话的永久删除功能由配套的 Archive Manager 插件提供。

安装后没有看到变化怎么办？

确认安装命令中的 profile 与正在运行的 DSH Web 一致，再重启 DSH Web 并硬刷新浏览器。可运行 dsh --profile web --dump-config 检查是否已挂载 codex-ui。

开发与贡献

从源码安装

适用于调试或使用未发布改动。克隆后的目录会直接作为插件安装路径：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
Set-Location D:\Repository\deepseek-harness-plugin
git clone https://github.com/MichengAI/dsh-codex-ui.git
Set-Location .\dsh-codex-ui
pnpm install --frozen-lockfile
pnpm build
dsh plugin --profile web add .
dsh --profile web --dump-config

完成后重启 DSH Web 并硬刷新浏览器。不要手工复制 lib；本地目录安装会同时读取包信息和 cordis.patch.yml。

- src\index.ts：Host 入口，以及不含敏感信息的连接器目录接口。
- src\client\index.ts：客户端入口，注册侧栏、工作区树、轮次导航和设置分区。
- src\client\CodexSidebar.tsx：侧栏壳、搜索面板和视觉样式。
- src\client\CodexWorkspaceBrowser.tsx：工作区和会话交互。
- tests\.assert.ts 与 tests\.spec.ts：交互、样式和运行时集成验证。

修改 src 后重新构建、测试，并以本地目录安装验证：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm build
pnpm test
dsh plugin --profile web add .

新增功能应复用已有 DSH 插槽和公开服务；不要依赖宿主私有 DOM 或写入会话数据。

许可证

本项目采用 Apache License 2.0。