dsh-settings-hub
September 2, 2026 · View on GitHub
Highlights
- 统一入口 — 所有第三方插件的设置项自动归入「扩展设置项」分组，不再散落在侧边栏各处
- 动态发现 — 新安装的插件自动出现，无需手动配置或修改代码
- 分组归属 — 按父插件自动分组，每个插件的子设置项聚合在一起
- 拖拽排序 — 支持拖拽调整分组和子项顺序，顺序持久化到 localStorage
- 幽灵拖拽 — 拖拽时原位置保持不变，半透明幽灵跟随鼠标，视觉反馈清晰
- 零侵入 — 不修改 DSH 源码，通过官方 shadow 机制接管
sidebar.settings插槽
工作原理
┌─────────────────────────────────────────────┐
│ DeepSeek Harness │
│ ┌──────────────┐ ┌──────────────────────┐ │
│ │ 原生设置项 │ │ 扩展设置项 ▾ │ │
│ │ 通用设置 │ │ ┌─ 插件分组 A ─────┐ │ │
│ │ 模型 │ │ │ 子项 1 │ │ │
│ │ 插件 │ │ │ 子项 2 │ │ │
│ │ Agent 预设 │ │ ├─ 插件分组 B ─────┤ │ │
│ │ │ │ │ 子项 1 │ │ │
│ └──────────────┘ │ └──────────────────┘ │ │
│ └──────────────────────┘ │
└─────────────────────────────────────────────┘
原生设置项（通用设置/模型/插件/Agent 预设）保持原样，第三方插件的设置项自动折叠到「扩展设置项」下。
截图
| 折叠状态 | 展开状态 |
|---|---|
 |  |
快速开始
前置条件
- DeepSeek Harness 已安装
- Node.js 18+
安装
方式一：npm（推荐）
dsh plugin --profile web add dsh-settings-hub
pnpm 11 用户注意：pnpm 默认禁止安装发布 24 小时内的新版本。如果安装到旧版，在
~/.dsh/profiles/web/pnpm-workspace.yaml中添加：minimumReleaseAgeExclude: - dsh-settings-hub然后重新安装即可。
更新插件：
dsh plugin --profile web update dsh-settings-hub@latest
方式二：GitHub
dsh plugin --profile web add github:Amengclass/dsh-settings-hub
方式三：源码安装
git clone https://github.com/Amengclass/dsh-settings-hub.git
cd ~/.dsh/profiles/web
npm link /path/to/dsh-settings-hub
启动
dsh web
卸载
dsh plugin --profile web remove dsh-settings-hub
打开浏览器访问 http://127.0.0.1:3080，点击左下角「设置」即可看到效果。
配置
无需额外配置。安装后自动生效：
| 行为 | 说明 |
|---|---|
| 自动发现 | 扫描已安装插件，动态注册设置分组 |
| 拖拽排序 | 拖拽调整顺序，自动保存到 localStorage |
| 分组归属 | 根据 node_modules 依赖关系自动归属父插项 |
FAQ
安装后看不到效果？
- 确认插件已安装：
ls node_modules/dsh-settings-hub - 重启 DSH：
dsh web - 清除浏览器缓存后刷新
新安装的插件没有出现在设置里？
插件需要注册 settings.section 才会被发现。部分插件（如 dsh-vision-router）使用不同的设置注册机制，暂不支持。
拖拽排序不生效？
排序保存在浏览器 localStorage 中。清除浏览器数据后排序会重置为默认。
开发
# 克隆
git clone https://github.com/Amengclass/dsh-settings-hub.git
cd dsh-settings-hub
# 本地开发（链接到 DSH profile）
cd ~/.dsh/profiles/web
npm link /path/to/dsh-settings-hub
# 重启 DSH
dsh web
项目结构
dsh-settings-hub/
├── index.js # Node 端：HTTP API + 依赖扫描
├── lib/
│ └── client.js # 浏览器端：设置面板 UI + 拖拽
├── cordis.patch.yml # DSH bundle 层声明
├── package.json
└── README.md
贡献
欢迎提交 Issue 和 PR！
- Fork 本仓库
- 创建特性分支：
git checkout -b feature/my-feature - 提交更改：
git commit -m 'feat: add my feature' - 推送分支：
git push origin feature/my-feature - 创建 Pull Request