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. 适合需要调整侧边栏底部布局、自定义图标间距和对齐方式的用户。

Package
@choi-p/dsh-footer-order
Compatibility
Unverified
Harness peer range
>=0.1.0-rc.7 <0.2.0
Cordis peer range
>=4.0.1 <5
Version
0.4.1
License
MIT
Last updated
Sep 7, 2026

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Choi-Peng/dsh-footer-order

配置

插件设置遵循 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;重置 = 清空用户层回落 basesettings 服务热发布,立即生效;本插件不再改写 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 乐观并发,若配置已在别处修改会提示并加载最新值。

使用

  1. 打开 dsh web —— 侧边栏底部的 footer 条目会上下排列。
  2. 设置 → 插件 → 侧边栏底部排序 卡片:调整 layout、gap、对齐方式、上下顺序,以及 settingsArea 内部排列方向与组件顺序,然后保存。所有修改实时生效,无需重启 dsh web。在 dsh 0.1.1-rc.2 上,settingsArea 相关分组不会生效,但其余调整照常工作。