dsh-codex-suite 使用指南

一键聚合 6 个 DSH Web 插件的安装包,把 Codex 侧栏、专家、技能、归档、IM 助理、定时任务锁定在同一套经过验证的版本上。

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

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

快速上手

— 源: plugin_wiki.wiki_content

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

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

— 源: plugins.install

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

— 源: plugin_wiki.readme_zh (fallback readme_raw)

这个聚合包和单独装 dsh-codex-ui 有什么区别?

单独装 dsh-codex-ui 只会得到 Codex 风格侧栏;装聚合包会一次性装好侧栏、专家、技能、归档、IM 助理、定时任务 6 个插件,且版本互相锁定。如果只需要侧栏功能,推荐独立安装。

已经单独装了 6 个插件里的某一个,可以直接再装聚合包吗?

不可以。聚合包和单独安装互斥。两套 patch 会冲突,需要先卸载已安装的 6 个子插件中的全部,再装聚合包。

安装时报"无法解析子包"或启动时报 patch 找不到,怎么办?

通常是 pnpm 严格隔离布局导致的。本聚合包的 patch 从 profile 顶层解析子插件,需要在 profile 的 pnpm-workspace.yaml 设置 nodeLinker: hoisted 后重新安装。

dshmarket(插件市场)在这个聚合包里吗?

不在。dshmarket 是可选功能,需要时单独安装即可。

装完后怎么验证 6 个插件都生效?

运行 dsh --profile web --dump-config,配置输出中应该同时包含 codex-ui、agency-agents、skills-manager、archive-manager、im-connect、dsh-automation,再重启 DSH Web 并硬刷新浏览器。

怎么升级子插件?

不要单独升级某个子插件。聚合包会把每个子插件锁到经过验证的精确版本,需要升级时等待并安装聚合包的新版本。

怎么完全卸载这个聚合包?

通过 dsh plugin --profile web remove @michengai/dsh-codex-suite 移除;它带的 6 个子插件会被一并移除,然后重启 DSH Web 即可恢复官方默认侧栏等界面。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

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

— 来源：通用规则