Choi-Peng/dsh-footer-order ↗★ 1
@choi-p/dsh-footer-order
DSH web sidebar foot ordering: force the sidebar.footer.action slot into a vertical stack (display: contents → flex column), configure entry order (including the settings row under id `settings`), and manage layout, gap, align, and item order within settingsArea. 适合需要调整侧边栏底部布局、自定义图标间距和对齐方式的用户。
インストール
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Choi-Peng/dsh-footer-orderドキュメント
README 全文を読む ↗配置
插件设置遵循 dsh 官方双缝配置模型,均实时生效,无需重启 dsh web(核心功能兼容 dsh ≥ 0.1.1-rc.2;settingsArea 内部排列需 dsh ≥ 0.1.2-rc.1,见顶部兼容性提示):
| 层 | 来源 | 生效方式 |
|---|---|---|
| 默认值 | schema 内置 | — |
| base 层(部署方静态配置) | 插件 bundle 自带 cordis.patch.yml 行内 config(dsh.bundle.patch,安装即自动挂载) | dsh web 监听 patch 层(HMR),编辑后自动用新配置重启此 fiber |
| 用户层(运行时设置) | 设置 → 插件 → 侧边栏底部排序 的保存/重置,经 ctx.settings 持久化到 $DSH_HOME/settings.yaml;重置 = 清空用户层回落 base | settings 服务热发布,立即生效;本插件不再改写 cordis.patch.yml |
base 层 config(bundle 默认附带):
- insert:
- id: footer-order
name: '@choi-p/dsh-footer-order'
config:
layout: column # column = 纵向堆叠(默认)| row = 横向 | contents = 不干预
gap: 0 # 条目间距,px(>= 0)
align: stretch # stretch | start | center | end(纵向堆叠时的交叉轴对齐)
order: [settings] # 插件 id 列表;保留 id `settings` = 外壳的设置行(settingsArea)
settingsLayout: contents # contents = 不干预(默认)| row | column | row-reverse | column-reverse
settingsGap: 8 # 设置区条目间距,px(默认 8)
settingsAlign: center # center | stretch | start | end
settingsOrder: [] # 设置区内部组件顺序,如 [settings, connection]
order里的 id 是每个插件向sidebar.footer.action调用slots.register({ name, id, ... })时传入的id,不是包名。设置卡片会列出当前所有已注册 id,可用 ↑/↓ 重新排序。settings是一个保留 id,代表外壳的设置行(sidebar.settings槽位,渲染在div.settingsArea内)。把它写进order的任意位置即可 —— 例如['settings', 'deepseek-balance']让「设置」排在余额之上;不写它,设置行就保持外壳原本的位置:foot 区域底部、整组 footer 条目之下。(若真有 footer 条目注册了settings这个 id,则以该条目为准 —— 保留 id 只在没有条目占用它时生效。)
设置卡片采用与官方设置一致的按钮组和输入框风格,分别提供总体 footer 排列管理以及独立的 settingsArea 排列管理,并提供 保存 / 恢复默认值;保存采用 revision 乐观并发,若配置已在别处修改会提示并加载最新值。
使用
- 打开 dsh web —— 侧边栏底部的 footer 条目会上下排列。
- 设置 → 插件 → 侧边栏底部排序 卡片:调整 layout、gap、对齐方式、上下顺序,以及 settingsArea 内部排列方向与组件顺序,然后保存。所有修改实时生效,无需重启
dsh web。在 dsh 0.1.1-rc.2 上,settingsArea 相关分组不会生效,但其余调整照常工作。