前言¶
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 風格，並提供靈活的設置選項。
