dsh-sidebar-organizer

简体中文 · English

给 DSH（DeepSeek Harness）里七处会重复出现的按钮/卡片加上自定义排序与收纳能力：左侧边栏、侧栏底部、对话标签、输入框工具条、会话头部工具条、右侧栏、设置导航。

最新版要点：桌面端窗口与浏览器里的 Web 界面共用同一份布局（配置页可关闭），七区域整理、收纳与配置导入/导出齐全。完整版本历史与各版本下载见 Releases。

现在能做什么

整理范围覆盖七处位置：

位置	内容	拖动方向
左侧边栏	插件、市场、技能管理、定时任务……	上下
侧栏底部	反馈、设置等底部入口	左右
对话标签	对话、轨迹等标签	左右
输入框工具条	统计、上下文、活动、用量等	左右
会话头部工具条	提醒、底部面板、上下文诊断、查找等图标	左右
右侧栏「开始」页	文件、浏览器、终端、「更多工具」	上下
设置导航	账户、通用、模型、插件……	上下

长按拖动排序：按住目标约 0.26 秒，行/卡片浮起（跟随指针的 ghost + 落点指示线），拖到目标位置松手。横向区域显示竖线，纵向区域显示横线。顺序即时生效并保存。
收进对应「更多」：把行拖到本区域的「更多」按钮上松手，即从原位消失，收进该区域「更多」菜单的「已收纳」分组。侧栏底部与左侧边栏共用左侧「更多」；对话标签与输入框工具条共用对话区「更多」；右侧栏使用自己的「更多工具」；会话头部工具条收进官方那个「更多操作」菜单（下载 Session 日志 / 反馈所在的那个），被收纳的图标直接排在该菜单原生两项上方；那个「...」按钮本身是宿主控件，不参与排序也不可收纳，同一条带里的分屏组合控件（文件资源管理器 / 更多打开方式）同样保持整体。设置导航的「更多」由本插件在出现收纳项时补上：第一项需在配置页收起，之后导航底部会出现「更多」，可继续把其他设置行拖进去，也可以点击其中条目直接打开对应设置。
从「更多」拖回来：打开对应菜单，长按被收纳项并拖回该区域的目标位置松手；拖动时源行会隐藏，只留下浮动预览，避免预览框与原行重叠。
菜单内排序：在「已收纳」分组里长按拖动，调整被收纳项之间的顺序。
把官方菜单项拖成按钮：会话头部工具条里，把「更多操作」菜单自带的「下载 Session 日志」「反馈」拖到条带上，会生成同名图标按钮，点击等同于点该菜单项；把按钮拖回「更多操作」即撤下。
键盘排序：聚焦某行后 Alt+↑ / Alt+↓（横向区域同样按顺序移动）。
配置页：DSH 设置 →「布局整理」，或本插件的详情页。七张位置卡片，可拖动整行、上移/下移、收起/恢复、恢复本组；每张卡片有独立的「拖动」开关，关闭后该区域不再响应长按拖动（布局和收纳保持不变）。本插件自己的设置入口可以拖动排序但不能收起；better-sidebar 的设置入口完全固定，既不能拖动也不能收起。
导入 / 导出配置：配置页标题栏的「导出配置」把七区域的排序、收纳状态和拖动开关写成 JSON 文件；「导入配置」读取同格式文件并整体替换当前配置。版本不兼容或文件损坏时整份拒绝，不会只应用一半。
跨窗口共用布局：桌面端窗口与浏览器打开的 Web 界面（http://127.0.0.1:<端口>）共用同一份顺序，重启 DSH、换端口都不受影响；配置页顶部的「跨窗口共用布局」开关可关闭，关掉后各窗口只用自己的本地布局。
按区域恢复：每处「更多」菜单的「恢复默认排序」只恢复该区域，恢复时已收纳的行会立即展开；「恢复默认排序」不会改动各区域的拖动开关。
刷新页面、重启 DSH 后布局保持。
拖动过程中，指针下方的行不会触发 :hover 或 tooltip（拖动期间临时 pointer-events: none，命中判定全部走几何矩形）。
没有右键菜单、悬浮启动器、快捷键、搜索或分组——这些不在本版本范围内。

安装

从 GitHub Release 安装（推荐）

打开 Releases，在最新发布里复制 dsh-sidebar-organizer-<版本>.tgz 的链接，粘贴到 DSH 的「插件」页 →「添加插件」；也可以下载后选择本地文件。发布页同时提供 SHA256SUMS 便于校验。

每个 v* 标签由 GitHub Actions 自动构建并附加到 Release。

也可以直接粘贴 Git 地址（使用仓库里已构建好的 lib/，无需在本机构建）：

git+https://github.com/TLEWA/dsh-sidebar-organizer.git#v0.7.3

从 npm 安装

dsh plugin install dsh-sidebar-organizer

或在 DSH 的插件管理器里搜索 dsh-sidebar-organizer。

从源码安装

本仓库本身就是一个 DSH 插件包（bundle）。克隆后，用插件管理器指向仓库目录安装：

plugin_manager  action: install_bundle  target: <仓库的绝对路径>

安装后刷新 Web 界面（Ctrl+R）。以 link: 方式装进 profile 时，改 src/ 并执行 npm run build 后刷新页面即可生效，不必重装。

0.3.6 及更早版本名为 dsh-modmenu。改名后旧的布局存储键 dsh.modmenu.layout.v1 会自动迁移到 dsh.sidebar-organizer.layout.v1，控制台句柄 window.__dshModmenu 也保留为 window.__dshSidebarOrganizer 的别名。

安全设计

0.1.0 曾在每次插槽变更通知里重新注册整列面板，形成 注册 → 通知 → 再注册 的反馈环，把页面拖死。0.2.0 起彻底换掉机制：

被整理的插槽只读：不注册、不 shadow 任何 sidebar.panellist、sidebar.footer.action、 conversation.view、conversation.composer.dock、settings.section 条目；只用 entriesOfSlot 获取 id 与标签。设置导航是例外：本插件会注册自己的「布局整理」设置页，该行可以拖动排序，但不能收起。
排序 / 隐藏只写 DOM 内联样式：按区域给行写 style.order，横向容器与纵向容器都适用；收纳用 style.display:none + data-dso-hidden。
固定、幂等的插槽注册：三处「更多」菜单各注册一个静态行 panel-organizer； settings.section 与 plugins.detail.section 各注册一次设置页。全部只注册一次，不订阅、不重注册。
幂等 + 限流：每次布局 pass 都是「值不同才写」，并用 requestAnimationFrame 合并到每帧最多一次。
看门狗：3 秒内超过 90 次 pass 即判定异常并停止观察与监听。
只观察 childList：自身写入的 style / data-* 不会反过来触发观察器。

逃生开关（浏览器控制台）：

window.__dshSidebarOrganizer.reset();                    // 忘掉全部布局
window.__dshSidebarOrganizer.resetScope("footer");       // 只恢复某一区域
window.__dshSidebarOrganizer.hide("footer", "feedback"); // 手动收起
window.__dshSidebarOrganizer.reveal("footer", "feedback");// 手动恢复
window.__dshSidebarOrganizer.setDragEnabled("footer", false); // 关闭某区域拖动
window.__dshSidebarOrganizer.disable();                  // 置开关并停用，刷新后也不启动
window.__dshSidebarOrganizer.status();                   // 查看七区域状态

hide(id) / reveal(id) 只传一个参数时仍按旧版语义作用于 sidebar。 disable() 之后要恢复，执行 localStorage.removeItem("dsh.sidebar-organizer.disabled") 再刷新。

宿主侧同步只走本机：宿主半用 connection.fetch.register 注册一条 GET/POST /api/dsh-sidebar-organizer/layout 路由，只接受本机 owner 身份的请求（webServer 侧按会话 cookie 判定，非 owner 直接 403），不发出任何外部网络请求；数据只写 $DSH_HOME/storages/dsh-sidebar-organizer/layout.json 一个文件，写入用临时文件 + rename 原子替换，失败时客户端退回本地 localStorage。
就算本插件完全不工作，七处位置也只是保持 DSH 默认顺序，不会有其他副作用。

实现说明

七个区域的定义、行/卡片发现与 id 映射都在 src/scopes.js：
- 左侧边栏按 button[aria-label] 与 sidebar.panellist 投影标签配对；
- 侧栏底部、输入框工具条读取 [data-slot="…"] 的直接子元素；
- 对话标签读取 [data-conversation-tabs] 的直接 tab，并识别旁边的「更多」；
- 右侧栏读取 [data-sidebar-right-guide] 的直接卡片，按 data-sidebar-right-guide-entry 区分；
- 设置导航读取 [data-shortcut-modal="settings"] nav 中按钮最多的容器。
找不到对应容器或行时该区域直接跳过，不影响其他区域。
保存的布局（v3）：
```
{
  "version": 3,
  "scopes": {
    "sidebar": { "order": ["plugins", "…"], "hidden": ["tasks"] },
    "footer": { "order": ["feedback"], "hidden": [] }
  }
}
```
v2 的 {version:2, order, hidden} 与更早的 dsh.modmenu.layout.v1 会自动迁移到 sidebar 区域；其余区域首次使用时按 DOM 默认顺序登记。宿主或新插件后来插入的行会按它当前的 DOM 邻居插入，不会一律追加到末尾。
各区域的拖动开关保存在单独的 dsh.sidebar-organizer.drag.v1 （{ "sidebar": true, "footer": false, … }），与布局互不影响。
导出文件是 { format, version, exportedAt, scopes, drag } 的快照；导入只接受 version === 3 且含 scopes 对象的文件，写入前会走与本地存储相同的规范化，并为七个区域标记一次性修复已完成，避免旧版尾行修复改写导入的顺序。
跨窗口同步（0.7.2 起）：src/sync.js 把布局推给宿主半的路由 POST/GET api/dsh-sidebar-organizer/layout，宿主存在 $DSH_HOME/storages/dsh-sidebar-organizer/layout.json。合并按时间戳新者优先：本地写完后 350ms 去抖上传，窗口重新可见 / 获得焦点时拉取；拉取到的布局会立即应用到当前页面并标记各区域已修复，但不会再回传一次。宿主没有存档时，新窗口保留本地顺序，避免空布局覆盖已有配置；localStorage 仍是本地缓存与降级路径。上传只由用户操作触发：启动时的默认顺序登记与投影 pass 写回都只留在本地， dsh.sidebar-organizer.customized.v1 记录「这个 origin 真正被调整过」；升级前就在本地、且与宿主注册顺序不同的布局会被认作手工配置，首次启动时接管宿主存档。
关掉共用：设置页顶部有「跨窗口共用布局」开关（dsh.sidebar-organizer.cross-window.v1，默认开）。关掉后本窗口不再上传或拉取宿主存档，只用自己的 localStorage，等同于 0.7.1 的行为；重新打开会立即拉取宿主那份，宿主没有存档时保留本地布局。
拖拽层：document 捕获阶段 pointerdown → 260ms 长按计时（指针移动超过 8px 取消）→ 激活后克隆行做 ghost、按区域轴向插入落点指示线；落点按其余行的中点判定；拖到本区域「更多」按钮矩形内即收纳；松手后 500ms 内吞掉紧随的 click，避免误触打开。
配置页用原生 HTML5 拖拽（draggable + dragstart/dragover/drop），不引入额外交互库；按钮只做上移/下移/收起/恢复，避免和页面长按手势冲突。

目录结构

src/                 源码（模块化，按依赖顺序拼接）
  constants.js       常量、文案、共享句柄
  styles.js          注入的样式表（拖动 + 配置页）
  storage.js         localStorage 布局持久化与 v2/v3 迁移
  sync.js            宿主侧同步：拉取 / 去抖上传 / 采纳远端布局
  icons.js           图标 SVG 序列化与 id 前缀处理
  slot.js            只读访问插槽投影
  scopes.js          七区域发现、id 映射、轴向
  runtime.js         DOM 运行时：应用顺序、收纳、拖拽手势、菜单数据
  menu.js            三处「更多」菜单里的收纳行
  settings.js        设置页 / 插件详情页配置界面
  plugin.js          插件入口 apply()
scripts/build.mjs    把 src/ 拼成 lib/client.js
lib/client.js        构建产物（DSH 实际加载的客户端半）
lib/index.js         宿主半（GET/POST 布局路由 + $DSH_HOME/storages 下的 JSON 存档）
cordis.patch.yml     bundle 补丁（安装时插入 profile）
test/harness.html    离线夹具：伪造七区域 DOM 与插槽数据，浏览器打开即回归

DSH 的客户端插件是以经典脚本方式通过 window.__ModuleLoader__.load({ id, factory }) 加载的，不是 ES 模块，因此运行时无法 import；源码模块化 + 构建期拼接是这个约束下的折中。

开发

npm run build   # src/ → lib/client.js
npm run check   # 语法检查

回归测试不碰真实 UI：用浏览器打开 test/harness.html，页面会自检并打印七区域发现、顺序、持久化、v2→v3 迁移、resetScope()、收纳 / 恢复、区域菜单清单、设置页固定项、菜单内拖动、拖动途中 DOM 替换与滚动、配置导出 / 导入与版本拒绝、dispose() 还原的结果。

兼容性

DSH >= 0.2.1-rc.3（在 0.2.1-rc.5 上开发）。
客户端只 require("react")；@deepseek-ai/dsh-client-ui-primitives 的 MenuItemButton 存在时优先使用，缺失时降级为内置按钮样式。
插槽/属性选择器缺失时对应区域自动降级为空，不影响 DSH 启动。
跨窗口同步需要宿主半能在 connection.fetch.register 上注册路由（0.2.1-rc.5 具备）；该服务缺失时客户端只跑本地 localStorage，不会报错。

路线图

0.2.0 — 只读 + DOM order 的最小可行版本
0.3.0 — 「更多」收纳、键盘排序、拖动期抑制 :hover
0.4.0 — 源码模块化与构建脚本、多语言文档、AI 使用与代码来源声明
0.4.3 — 悬停反馈改为按钮整体缩放（图标与文字一起）
0.5.0 — 六区域可拖动/收纳；设置页与插件详情页配置界面；v3 存储与迁移
0.5.1 — 修正六区域拖拽落点按视觉顺序计算、拖影净化、「更多」高亮贴合圆角
0.5.2 — 按区域恢复并展开收纳项、footer/composer 行识别、composer/右侧栏宿主 chrome 隔离、better-sidebar 设置入口固定
0.5.3 — 收纳动画回滚到 0.4.x、More 虚线框贴合圆角、横向插入线居中
0.5.4 — 菜单拖动隐藏源行、六区域独立拖动开关、右侧栏新入口保持宿主位置
0.5.5 — 修复旧布局中右侧栏新入口仍被追加到末尾、横向插入线贴住最后一项、短按缩放
0.5.6 — 修复右侧栏起始页指南针与第一张卡之间的空白（宿主 ::after 占位被 order 挤到前面）
0.5.7 — 修复窄宽度下已收纳视图泄漏、设置导航可拖动与「更多」入口、拖入「更多」误点击
0.6.0 — 首个正式版：六区域整理、设置页、配置导入/导出、刷新后自定义顺序保持
0.6.1 — 修复已收纳条目的拖影丢失圆角
0.7.0 — 新增会话头部工具条：图标排序、收进官方「更多操作」菜单与拖回；修正陈旧布局条目导致的落点偏移与拖影白边
0.7.1 — 修复「更多操作」菜单内排序不生效与重排后菜单关闭、纯图标行拖影黑底
0.7.2 — 布局改为宿主侧存档：桌面窗口与浏览器 Web 界面（任意端口）共用同一份顺序；配置页可关闭共用

声明与引用

第三方代码与商标说明：NOTICE.md
AI 参与方式、代码来源与引用方式：见 NOTICE.md 的「AI 使用与代码来源声明」一节
引用本项目的 BibTeX：CITATION.cff

许可

MIT

dsh-sidebar-organizer

Install

Source

Tags

Creators

Readme

dsh-sidebar-organizer

现在能做什么

安装

从 GitHub Release 安装（推荐）

从 npm 安装

从源码安装

安全设计

实现说明

目录结构

开发

兼容性

路线图

声明与引用

许可