dsh-codex-ui 使用指南

把 DSH Web 默认侧栏替换成 Codex 风格侧栏,补齐工作区会话树、全局搜索和轮次导航。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add @michengai/dsh-codex-ui

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

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

— 源: plugin_wiki.readme_zh (fallback readme_raw)

安装后页面没变化怎么办?

必须先重启 DSH Web,然后硬刷新浏览器(Ctrl+Shift+R)才会生效,插件在启动期通过 cordis.patch.yml 接管默认侧栏。

Codex UI 和 @michengai/dsh-codex-suite 能同时装吗?

不能。两者在同一个 profile 里会重复 patch 侧栏并冲突,需要先卸掉其一再装另一个。

项目置顶状态会丢失吗?

置顶项目保存在宿主 Profile 文件并经 localStorage 缓存,DSH 重启或 Desktop 托盘重载后仍保留;但换浏览器或清空站点数据会丢。

删除项目/会话按钮会删除文件夹吗?

不会。删除项目注册只是把它从侧栏项目列表中移除,本地文件夹和会话记录都会保留;归档会话的永久删除由 archive-manager 插件提供。

连接器目录会泄露我的凭证吗?

不会。本插件提供的连接器目录只展示 MCP 服务名、工具名和说明,服务端主动过滤掉了地址、命令和凭证字段。

侧栏的"频道"和"定时"页签什么时候出现?

仅在安装了对应配套插件(分别由 @michengai/dsh-im-connect 和 @michengai/dsh-automation 注入 sidebar.channels 与 sidebar.schedule 插槽)时才出现,否则侧栏自动隐藏这两个页签。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则