leonardoxr/dsh-plugins

DSH 插件

DeepSeek Harness 插件的主仓库。每个插件都保持为独立的 Git 仓库，并作为 Git 子模块包含在此处，因此插件的历史、分支、发布和 CI 都保持隔离。

插件

| 插件 | 仓库 | 用途 |
|---|---|---|
| dsh-auto-chat-titles | leonardoxr/dsh-auto-chat-titles | 语义化、可配置的聊天标题 |
| dsh-better-sidebar | leonardoxr/DSH-better-sidebar | 侧边栏工作台与扩展 API |
| dsh-claude-usage | leonardoxr/dsh-claude-usage | Claude 用量 UI |
| dsh-codex-usage | leonardoxr/dsh-codex-usage | Codex 用量 UI |
| dsh-coding-tools | leonardoxr/dsh-coding-tools | LSP、ast-grep 与版本化编辑工具 |
| dsh-status-bar-config | leonardoxr/dsh-status-bar-config | 对话统计行 |

dsh-all-in-one

本仓库还发布 dsh-all-in-one，这是一个聚合式 DSH 捆绑包，可一步安装该集合中的所有 Web 插件，并将它们挂载为单个捆绑层：

published channel
dsh plugin --profile  add dsh-all-in-one

or pinned straight from this repository's releases
dsh plugin --profile  add https://github.com/leonardoxr/dsh-plugins/releases/download/v/dsh-all-in-one-.tgz

特性：

- 每个插件一行，使用规范 ID。 每个聚合插件都保留其独立捆绑包所使用的相同 Cordis 行 ID，因此从独立插件迁移到 all-in-one 时，profile-patch 配置覆盖可继续正常工作。
- 二选一——绝不能同时使用。 该套件会取代独立捆绑包。同时挂载独立捆绑包和该套件会导致启动致命错误，这是加载器设计使然（“duplicate loader entry id”，即使其中一行被禁用也是如此）。在添加该套件之前，请移除独立安装。每次插入还带有 !!js 退避保护，以防止在较早时以不同 ID 挂载同一包；请最后安装 all-in-one（dsh plugin add 会自动这样做），以便保护机制能看到在它之前挂载的所有内容。
- 自动生成，绝不手动编辑。 aggregate.yml 是唯一事实来源；package.json 依赖和 cordis.patch.yml 由 scripts/aggregate.mjs 生成：

pnpm generate   # regenerate both outputs from aggregate.yml
pnpm verify     # fail when outputs drifted (runs on prepack too)

- 按插件选择退出在聚合后仍然有效。 用户仍可在其 profile patch 中禁用任意子集（- id:  + disabled: true）。
依赖固定版本在包已发布时使用精确的 npm 版本，否则使用
GitHub Release tarball URL；要将其切换为 npm，请在 aggregate.yml 中编辑其
channel/spec 并重新生成。
| dsh-harness-updater | leonardoxr/dsh-harness-updater | Claude Code / Codex CLI 更新检测与一键更新 |
| dsh-image-preview | leonardoxr/dsh-image-preview | 内联图片预览与剪贴板复制 |
| dsh-plugin-manager | leonardoxr/dsh-plugin-manager | Profile 插件管理 |
| dsh-companion | leonardoxr/dsh-companion | 只读工作区/会话 API 与通知 |
| dsh-native | leonardoxr/dsh-native | DSH Web 服务器的原生桌面与移动端外壳 |
| dsh-routed-subagent | leonardoxr/dsh-routed-subagent | 按复杂度路由的子代理委派 |
| dsh-workspace-git | leonardoxr/dsh-workspace-git | 工作区 Git 集成 |

仓库模型

- 本仓库协调插件集合；它不会合并它们的历史记录。
- 插件目录是独立的 Git 仓库。对插件进行操作时使用 git -C  ...。
- 使用 git -C  pull 后接 git add  来更新主仓库中固定的插件修订版本。
- 不要在此处或插件内部提交 DSH 源码更改。插件必须通过 DSH profile 和 cordis.patch.yml 机制挂载。
- 代码更改遵循每个插件的贡献规则；仅文档的集合更改可在此处进行。

DSH 插件行为

插件是 Cordis 模块，具有可选的宿主端和客户端部分。包清单声明 DSH bundle patch 和客户端注入元数据。宿主端代码必须使用公共 DSH 服务/路由；客户端代码必须使用注入的服务，并且必须能够干净地卸载。

关于 better-sidebar 集成，请参阅 dsh-better-sidebar/AGENTS.md。关键规则：使用 inject = ['betterSidebar']，通过 ctx.betterSidebar 注册标签页/查看器，将注册包装在 ctx.effect() 中以便 disposer 对 HMR 安全，使用带包前缀的 ID，并将 dsh-better-sidebar 保留为可选 peer 依赖。该服务仅存在于客户端侧。

本地开发

Clone this collection with plugin repositories
git clone --recurse-submodules  dsh-plugins

Initialize plugins after a normal clone
git submodule update --init --recursive

Work inside one plugin
cd dsh-better-sidebar
pnpm install
pnpm build
使用官方插件机制将本地插件安装到 DSH Web 配置文件中，然后刷新现有的 DSH UI。不要修改 DSH 检出内容。

文档参考

- DeepSeek Harness
- DSH 插件注册表
- better-sidebar 使用指南