前言¶
DeepSeek Harness (DSH) Web 提供了强大的智能体开发能力，但默认界面可能与特定参考风格（如 Codex）存在差异。codex-ui 插件通过重写 DSH Web 的界面元素，将窗口边缘、侧边栏分隔线、模型选择器、Composer 结构以及配色方案重建为 Codex 风格。
插件定位¶
codex-ui 是一个社区维护的界面插件，旨在为 DSH Web 提供统一的视觉体验。它不是 DeepSeek AI 的官方产品。
核心功能¶
插件通过接管和重绘界面组件，实现以下功能：
-
模型选择器
- 面部 B（默认开启）：自定义组件接管 Composer 的模型位置。提供按提供商分组的模型列表及描述。包含 Codex 推理能力滑块（24px 轨道、4px 刻度、28px 白色滑块，支持拖拽与快捷键）。支持乐观更新。
- 面部 A（默认关闭）：当面部 B 关闭时，显示原生主机菜单（圆角、行高、勾选列、加载中状态）。
-
界面布局与视觉
- Composer：头部清空，面板按钮保留官方图标。释放头部插槽，注册的条目（如子代理计数、预设徽章）重新渲染。Trajectory 视图增加“← Chat”返回胶囊。
- 卡片与控件：Composer 卡片采用特定圆角（20/25px）和阴影。底部控件（添加、模型、权限）在悬停时显示圆角芯片。右侧面板无边框，带图标和快捷键胶囊。对话窗口边缘包含 0.5px 线条和 24px 柔和阴影。
- 侧边栏：颜色匹配 Codex 浅色侧边栏。行状态根据主机语义映射（选中与悬停颜色区分）。
-
设置系统
- 插件管理页设置：支持主题、强调色、背景/前景色、UI/代码字体、半透明侧边栏、Codex 模型选择器、对比度调整。
- 全页设置模态框：分组侧边栏（含返回、搜索、分组标题）、内容页头部、白卡配细线、粘性保存栏。
安装与启用¶
使用 CLI 安装：
dsh plugin --profile web add link:<absolute repo path>
启动 Web 界面查看插件：
dsh web
卸载：
dsh plugin --profile web remove codex-ui
若需修改源码，修改文件后运行：
npm run build
典型用法¶
- 本地开发：克隆仓库，修改 CSS 或组件，运行
npm run build并刷新页面。 - 桌面端安装：在 DSH 桌面应用中打开“Plugins -> Add plugin”，输入仓库的绝对路径。
- 配置外观：在插件管理器的 codex-ui 捆绑页面调整主题、字体或开关模型选择器的面部 B。
注意事项¶
- 兼容性：插件针对 DSH 0.1.7-rc.1 和 0.1.7-rc.2 开发，并在
@deepseek-ai/dsh@0.1.7-rc.2上进行了完全验证。 - 依赖：
@deepseek-ai/schemastery为 peerDependencies，由宿主提供。 - 权限：插件以当前 DSH 进程权限运行，安装前请检查源码与许可证。
- 非官方：这是一个社区维护的插件，非 DeepSeek AI 官方产品。
总结¶
codex-ui 适合需要特定视觉风格或统一界面体验的开发者。它通过精细的界面重写，将 DSH Web 定制为 Codex 风格，并提供灵活的设置选项。
