DSH Codex UI 是社区维护的 DeepSeek Harness（DSH）插件，并非 DeepSeek AI 官方产品。它只使用 DSH 公开插槽，不修改宿主源码或会话数据。

功能概览

• 通过官方 sidebar 插槽替换默认侧栏，并保留 sidebar.workspaces、sidebar.settings 和 sidebar.footer.action。
• 提供 Codex 风格顶栏：品牌标识、侧栏折叠和全局搜索。
• 工作区与会话支持展开折叠、拖拽排序、项目置顶、未读圆点和运行状态。
• 项目和会话菜单支持重命名、置顶、未读、归档、派生、打开目录、复制和删除。
• 调整会话列与输入卡片视觉，并为当前会话提供紧凑轮次导航。
• 在「设置 → 关于」展示配套插件状态，并可从 npm 安装缺失项。

界面预览

浅色主题：Codex 风格侧栏、工作区会话树和会话列。

深色主题：同一布局，使用 Codex 暗色令牌。

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

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

前置条件

• 已可正常运行 DeepSeek Harness Web，且可在 PowerShell 中使用 dsh。
• 以下示例使用 web profile；请替换为实际目标 profile。
• 从源码安装或二次开发需要 Node.js 22+ 与 pnpm；仅从 npm 安装无需在任意目录执行 pnpm install。

插件组合

@michengai/dsh-codex-suite-installer 是 @michengai/dsh-codex-suite 成员组合的轻量一键安装器，会把下面 6 个插件作为直接依赖装进同一个 profile：

插件	npm 包	作用
Codex UI	@michengai/dsh-codex-ui	Codex 风格侧栏、工作区会话树、搜索和轮次导航
专家管理	@michengai/dsh-agency-agents	从「专家」进入对应设置页
技能管理	@michengai/dsh-skills-manager	从「技能」进入对应设置页
归档管理	@michengai/dsh-archive-manager	提供永久删除和已归档会话管理
IM 助理	@michengai/dsh-im-connect	IM 设置页和「频道」页签
定时任务	@michengai/dsh-automation	定时任务设置页和「定时」页签

dshmarket 仍是可选项。已安装时，「插件」入口会优先进入市场。

直接依赖让「设置 → 关于」能够分别检测和升级每个插件。轻量安装器只携带版本清单，也会自动迁移旧版聚合 Suite，避免聚合 patch 与独立 patch 冲突。

DSH 产品生态

Codex UI 既可以独立安装，也可以随桌面端或 Web 套件一起使用。它们共享同一个 DSH 核心，但面向不同的使用方式：

产品	与 Codex UI 的关系
DeepSeek Harness	Codex UI 的运行宿主，提供模型、会话、工具和插件系统
DSH Codex Desktop	下载安装即用的桌面产品，已内置 Codex UI 和其他 5 个功能产品
DSH Codex Suite	面向已有 DSH Web 环境的一键套件，会安装 Codex UI 和其他 5 个功能产品
6 个功能产品	Codex UI · IM Connect · Automation · Skills Manager · Archive Manager · Agency Agents

安装

dsh plugin add 会转发到 profile 目录里的 pnpm add。不写版本、不指定官方源时，本机镜像和最短发布间隔可能让你停在旧版。

交给其他 Agent 一句话安装套件

把下面其中一句复制到 DSH、Codex 或 WorkBuddy，让它代你安装到本机 web profile。

从 npm 安装完整套件：

请用一键安装器把 DSH Codex Suite 的六个成员作为直接依赖装进本机 web profile，执行：npx --yes @michengai/dsh-codex-suite-installer@latest --profile web。确认安装器完成配置检查，并提醒我重启 DSH Web 后硬刷新浏览器。

只安装 Codex UI：

请把 DSH 插件 @michengai/dsh-codex-ui 最新版装进本机 web profile，使用官方 npm 源执行：dsh plugin --profile web add @michengai/dsh-codex-ui@latest --registry=https://registry.npmjs.org/。装完执行 dsh --profile web --dump-config，确认已挂载 codex-ui，并提醒我重启 DSH Web 后硬刷新浏览器。

产品	怎么用
DSH	把上面其中一句发给当前会话。
Codex	把上面其中一句发给 Codex，让它在本机执行安装。
WorkBuddy	把上面其中一句发给 WorkBuddy。

一键安装器需要能从 PATH 找到当前 DSH；也可以用 DSH_BIN 指定 dsh 可执行文件。

安装完整套件

这是一键组合安装。在任意 PowerShell 目录执行：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
npx --yes @michengai/dsh-codex-suite-installer@latest --profile web

安装器会读取自身锁定的精确成员版本，用一次 dsh plugin add 将六个成员写成 profile 的直接依赖，并在最后运行 dsh --profile web --dump-config。需要钉死一组版本时，把 @latest 换成具体安装器版本。

安装后重启 DSH Web 并硬刷新浏览器。已有成员会原地对齐版本；旧版 @michengai/dsh-codex-suite 聚合依赖会在六个成员提升完成后自动移除。

新建自定义 Web profile 也使用同一命令，只需改 profile 名：

npx --yes @michengai/dsh-codex-suite-installer@latest --profile codex

安装器会复用当前 DSH_HOME，并把 DSH 自带的 @deepseek-ai/dsh-web-app 放到成员 bundle 之前；不会创建独立 Home，也不会重新安装官方 Web 包。

只安装 Codex UI

[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

插件会通过 cordis.patch.yml 接管默认侧栏；卸载后默认侧栏会恢复。

从源码安装

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

[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 并硬刷新浏览器。不要手工复制 dist；本地目录安装会同时读取包信息和 cordis.patch.yml。

使用

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

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

删除项目注册不会删除项目目录或会话记录。置顶和未读状态只保存在当前浏览器。

持久化与安全边界

数据	存储位置	范围
置顶项目	Host Profile 文件，并使用 localStorage 缓存	DSH 重启及 Desktop 托盘重新加载后仍保留
置顶会话	localStorage 键 dsh.session-pins.v1	仅当前浏览器
未读会话	localStorage 键 dsh.session-unread.v1	仅当前浏览器
会话记录	DSH 宿主服务	本插件不改写

• 本插件只使用 DSH 公开插槽和服务。
• 不修改宿主源码或会话数据模型。
• 归档会话的永久删除由 @michengai/dsh-archive-manager 提供。
• 连接器目录不会展示地址、命令或凭证。

二次开发

• 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 或写入会话数据。

验证

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8
pnpm build
pnpm test

许可证

本项目采用 Apache License 2.0。会话管理工作流参考 Semidia/dsh-session-manager，但本插件独立通过 DSH 公开插槽和服务实现。