入口编排 xishuai-zero/dsh-entry-organizer

dsh-entry-organizer

English — 一个 DSH（DeepSeek Harness）插件：把左侧栏的插件条目拖成任意顺序，把会话视图顶部标签拖成任意顺序，还能把条目在两个区域之间搬移，搬过去就是真实标签。顺序与搬移结果保存在本机，重启后依然保留。零依赖、无构建步骤、MIT。

中文 — DSH（DeepSeek Harness）插件「入口编排」：拖拽左侧栏的插件条目自由排序、拖拽会话顶部标签自由排序，并能把条目在侧栏与标签区之间搬移（搬过去就是真实标签）。顺序与搬移状态保存在本机，重启后保留。零依赖、无构建步骤、MIT。

名称消歧：「entry」在本生态里也指入场动画（如 dsh-entry-transition）或代理 payload（如 dsh-entry-shaper）。本插件的 entry 指侧栏面板条目 / 会话视图。

功能

- 侧栏条目拖拽排序：按住左侧栏「全局面板」列表里的插件行拖动即可重排，顺序按 CSS order 生效，不改动官方 React 渲染结构。
- 顶部标签拖拽排序：会话顶部「对话 / 阅读 / 轨迹 / …」标签可左右拖动重排；「对话」固定首位，不参与拖拽。
- 跨区搬移：把侧栏行拖到顶部标签行，该行消失、顶部多出一个同名标签；点标签会用官方 layout.selectPanel() 打开对应面板，并出现左上角「← 返回对话」浮标。把标签拖回侧栏（或拖到侧栏空位）即还原成侧栏行，按落点决定插到上方还是下方。
- 溢出兜底：标签行宽度放不下时，官方会把标签截断进右侧「…」菜单，那里没有可拖的 DOM 节点；插件在同一个「…」菜单里注册了「把搬入的标签全部移回侧栏」，保证任何情况下都能一键恢复。
- 键盘 / 触屏可达：「设置 → 入口编排」把「侧栏顺序」「标签顺序」渲染成带 ↑/↓ 按钮的列表，不用拖拽也能逐项调整顺序（拖拽被截断、触屏或无鼠标时仍可操作）。
- 持久化：顺序与搬移状态存 localStorage 键 dsh.entry-organizer.v1（v2 结构），全局一份，重启后恢复；多个窗口之间通过 storage 事件实时同步。
- 设置页：「设置 → 入口编排」显示侧栏行数 / 可排序标签数 / 已搬入列表，可逐项「移回侧栏」或「恢复默认」。
- 中英双语：跟随宿主语言；界面文案带在 client.js 的 DICT 里。

安装

插件通过 dsh.bundle manifest 声明自己可安装（浏览器半身由 dsh.client 声明，宿主半身由根目录 cordis.patch.yml 的一行 insert 挂载）。

1) 从 npm（推荐，预构建、免 allowBuilds 构建授权）
dsh plugin --profile web add dsh-entry-organizer

2) 从 GitHub 源码（按 tag 固定版本）
dsh plugin --profile web add github:xishuai-zero/dsh-entry-organizer#v0.1.1

3) 从 GitHub Release 的预构建 tarball
dsh plugin --profile web add https://github.com/xishuai-zero/dsh-entry-organizer/releases/download/v0.1.1/dsh-entry-organizer-0.1.1.tgz

已发布：npm dsh-entry-organizer · GitHub Releases v0.1.1。

web 是市场里通用的 profile 名；桌面版等安装的 profile 名可能不同（本机桌面版为 desktop）。不确定时用 dsh plugin --help 或官方文档确认，把 --profile web 换成你的 profile 即可。

安装后重启 DSH（或等宿主热加载）。验证：左侧栏出现可拖拽行、设置页出现「入口编排」。卸载请用插件管理界面或参考官方文档从 profile 中移除该包。

从旧名升级：v0.1.0 之前的包名是 dsh-entry-arrange。升级到本包后，首次加载会读取旧键 dsh.entry-arrange.v1 并迁移到新键 dsh.entry-organizer.v1，已有的顺序与搬移不会丢；旧键保留不删。

升级到 0.1.1：存储结构从 v1 升级到 v2（排序键由「显示文案」改为稳定的 panel/view id），首次加载自动迁移并回写，不需要手动清 localStorage；旧结构里的顺序会被完整保留。

已知限制

都是宿主官方契约边界，不是实现偷懒：

1. 「…」菜单里的条目不能拖：官方标签行把 conversation.view 条目按 priority/order 排序，再按可用宽度切出前 N 个（visibleViewLimit = max(1, floor((width - 48) / 120))）；被截断的 View 根本不生成标签 DOM，第三方拿不到节点。因此只能提供菜单内的一键还原，不能提供“从菜单里拖出来”。
2. 标签重排只对可见标签生效，且可见集合是按 order 排序后切前 N 个：把 order 调小只能让条目更容易进入可见集，本插件不修改官方条目的排序，只调整自己启动器的 order。
3. 不重建别人的面板组件：跨区只做“启动器”——标签点击走官方 layout.selectPanel() 打开真正的 main 面板。直接手写渲染别的插件的面板 Component 会丢掉它们自己的 inject props（渲染器把注入封装在条目内部），所以不做。
4. 不接管官方 pin：侧栏行显隐仍由官方「更多 → 固定/取消」决定；本插件只负责顺序与搬移，两者互不覆盖。
5. 插件管理行可被拖动：没有硬编码排除 id === "plugins" 的行；若希望锁死它，可后续加开关（未在本版提供）。
6. 状态只在本机：顺序与搬移存浏览器 localStorage，不随账号同步、不跨设备；换浏览器或清站点数据会回到默认顺序。
7. 依赖宿主真实 DOM 契约：见下方「宿主 DOM 契约」一节；宿主大改侧栏/标签结构时需要同步适配（代码里已为多数选择器准备了兜底）。
8. 切换界面语言后，已搬入标签的文案要等重新登记才更新：排序与搬移按 panel id 存，不会丢；但启动器文案是搬移当时冻结的字符串，切语言后需要重新搬一次才换成新语言。

宿主 DOM 契约

本插件不移动、不重建官方节点，只按下面这些可观察标记工作；宿主改版导致某条失效时，插件会安静跳过对应部分（记录到设置页诊断），而不是抛错：

| 用途 | 依赖的标记 | 兜底 |
| 找到侧栏面板行 | [data-slot="sidebar.panellist"] 的 closest('button') | 扫 nav 直系、有 aria-label 且无 aria-haspopup 的按钮 |
| 行身份 / 文案 | 行的 aria-label，没有时用 textContent | 空标签行整行跳过（不会让后续行错位） |
| 「更多」排序 | 侧栏 nav 直系子节点里的 button[aria-haspopup]，或包着它的容器 | 找不到就不改它的 order |
| 排序生效 | 侧栏 nav 与标签容器的 flex order | 只写 style.order |
| 标签行 | [data-conversation-tabs] 里的 button[role="tab"]，文案取 textContent | 找不到标签行时只做侧栏部分 |
| 当前打开的面板 | 行上的 aria-current="page" | 视为停在对话视图 |
| 浮标位置 | [data-slot="sidebar"] 的盒宽（该 outlet 为 display:contents，实测宽度 0），其次 grid-template-columns 首列 | 固定 16px |

兼容性

| 项 | 值 |
| 宿主 DSH | >=0.2.1-rc.5（engines.dsh；所有契约均在 0.2.1-rc.5 上实测） |
| Node.js | >=22.19.0（engines.node） |
| 运行依赖 | 无（dependencies 为空；React 由宿主 shell 注入） |
| 宿主声明 | dsh.bundle.patch: ./cordis.patch.yml + dsh.client.platform: web |

engines.dsh 是市场与安装器读取的兼容性声明：不满足时安装器会给出不兼容提示，而不是装完才炸。

开发与测试

npm run check # node --check index.js && node --check client.js
npm test # node --test：10 个纯函数/存储用例 + 28 个 mini-DOM 集成与组件用例
node test/arrange.test.mjs # 若环境禁止子进程（spawn EPERM）时直接执行测试文件
node test/dom.test.mjs

没有引入 jsdom：test/harness.mjs 自带最小 DOM（选择器、事件捕获/冒泡、getBoundingClientRect、内存 localStorage、MutationObserver 空实现、可派发的 window 事件），用 vm 真正执行 client.js，并提供 renderTree() 递归展开函数组件，用来测试设置页与浮标渲染。

结构

| 文件 | 作用 |
| client.js | 浏览器半身：DOM 同步、拖拽、启动器注册、浮标、设置页 |
| index.js | 宿主半身（空壳，只声明 name / apply；本插件无服务端状态） |
| cordis.patch.yml | 一行 insert，把包挂进 profile 组合 |
| package.json | dsh.bundle.patch + dsh.client 声明、engines.dsh 兼容范围 |
| test/harness.mjs | mini-DOM + 假 ctx + __ModuleLoader__ 装载器 |
| test/arrange.test.mjs | 纯函数回归（含旧键迁移） |
| test/dom.test.mjs | 集成回归（横向拖拽、跨区搬移、「…」菜单还原） |
| docs/submission/ | 投稿 awesome-dsh-plugin 的条目 YAML |
| docs/PUBLISHING.md | 维护者发布流程（GitHub / npm / awesome） |

实现要点

- 排序只写行/标签的 style.order（侧栏 nav 与标签容器都是 flex），不移动、不重建官方节点；空标签行逐行跳过，避免下标错配。
- 身份用稳定 id：侧栏排序键 p:<panel id>、标签键 v:<view id>；拿不到 id 时（宿主还没注册该条目）退回 ~，之后自动升级。存储结构 v2 = { v: 2, sidebarOrder: [...], moved: [{ id, label }], tabOrder: [...] }，v1 数据自动迁移。
- 搬移时通过 ctx.slots.register({ name: 'conversation.view', id: 'ea-<hash>', label, locale }, Launcher) 动态注册一个真实 View（注销即卸载），启动器组件只做“回对话 + 打开面板”；每次同步都会清理注册表里已消失的搬移项。
- 顺序变化在同步阶段立即写 localStorage；storage 事件让其他窗口实时重载。
- MutationObserver 只对影响侧栏/标签行的变更触发同步，拖拽标记精确清理（不再每个 dragover 全文档扫描）。
- 浮标注册在 shell.overlay（list slot），仅当“被搬走的面板当前可见”时显示；首次若发现热加载残留的旧占位框会接管并去重。

数据与隐私

不联网、不收集数据、不读文件。只写浏览器 localStorage 的 dsh.entry-organizer.v1 一个键（JSON：{ v: 2, sidebarOrder, moved: [{ id, label }], tabOrder }，排序键形如 p:<panel id> / v:<view id>）；迁移时只读旧键 dsh.entry-arrange.v1，不删除。

License

MIT © 2026 xishuai-zero