# dsh-sidebar-buttons

简体中文 · [English](./README.md)

一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件。
接管左下侧栏的按钮：拖动调整顺序，给每个按钮设置三种显示状态之一，并统一按钮高度。

## 兼容性

在 **DSH 0.2.0-rc.2**（web profile）上实测通过，0.1.5-rc.1 与 0.1.2-rc.1 上也能正常运行。
这些版本就是 `package.json` 里 `dsh.engines.dsh` 声明的范围，宿主和插件管理器
不必解析这份文档就能读到同样的信息。

这里**故意不声明** `@deepseek-ai/*` 的 `peerDependencies`：预发布范围会排除掉更新的
DSH 版本，导致宿主的兼容门禁直接跳过本插件。

所有逻辑都在浏览器侧。插件只通过公开的 list 槽位 `sidebar.footer.action`（以及外壳
自己的 `settings.launcher` 座位）工作，不碰 DSH 本体，也不改别的插件的文件，所以卸载
后侧栏就回到原样。

## 安装

1. 安装插件 —— 从 npm：

   ```bash
   dsh plugin --profile web add dsh-sidebar-buttons
   ```

   或直接从 GitHub：

   ```bash
   dsh plugin --profile web add github:lywusichen/dsh-sidebar-buttons
   ```

2. 重启 DSH。

3. 打开 **设置 → 侧栏按钮设置**。

## 功能

- 列出当前注册在侧栏底部的全部按钮。拖动行即可调整顺序，松手后侧栏立即生效。
- 每个按钮有三种显示状态：
  - **显示** —— 照常固定在侧栏里。
  - **折叠到更多** —— 收进"设置"上方的"更多"按钮。只有当存在折叠项时"更多"按钮
    才会出现，折叠进去的按钮在菜单里功能完整。
  - **完全隐藏** —— 侧栏和"更多"菜单里都没有，只有设置页能恢复。
- 不同插件的按钮高度不一样。可以统一成一个高度，也可以保持各自原样，或直接填
  自定义像素值。

## 截图

![更多按钮位置](assets/sidebar-more.png)

![更多菜单](assets/more-menu.png)

![设置导航位置](assets/settings-nav.png)

![设置页面](assets/settings-page.png)

## 实现方式

侧栏底部是一个 list 槽位，同一个 id 允许注册多个条目，渲染时按 `priority` 排序。
本插件把每个已有条目用 `priority: -1` 重新注册一份，让它排到原条目前面，再包一层
自己的组件去渲染原来那个。顺序、显隐、尺寸都由包装组件读取的共享 store 决定
（CSS `order` 加上 `--dsh-sbf-size` 变量）。整个过程不注销任何东西，所以关掉插件
就立刻交还给原条目。

有一类按钮不吃这套：槽位条目只是挂载锚点，真正的按钮由插件自己渲染到侧栏别处
（例如 `dsh-mneme` 的记忆入口，它把自己挂在工作区列表上方）。这类按钮**不搬任何节点，
只在原地控制**：状态没有可见座位时把它的外层容器隐藏；折叠到"更多"时，弹窗里放一个
代理行，点击时把事件转给真按钮。改成搬节点会坏两次——拥有它的插件会用自家的
MutationObserver 把容器插回原位；而节点一旦离开 React 渲染的子树，就再也收不到让按钮
可用的合成事件。

外壳的"设置"座位（`settings.launcher`）同样处理。它是 `single` 槽位、无法镜像，所以只能
原地隐藏或折叠，并且被固定在所有受管按钮之后，始终沉在侧栏最底部。

## 已知限制

- 锚点型按钮靠 `data-plugin-entry` 标记或内置声明表来识别（记忆入口与设置座位都已
  声明）。两者都没有就认不出来，管不到。
- "设置"座位只提供**显示**与**折叠到更多**：把它完全隐藏会让设置面板再也打不开，
  而本插件自己的设置页就在里面。它也不参与拖拽排序。
- 顺序调整和"更多"菜单依赖 `slots.entries` 与 `slots.subscribe`，插件靠它们跟上
  自己加载之后才发生的注册。如果将来 DSH 改了 list 槽位的契约，本插件需要跟着更新。
- 三种状态按按钮 id 存储。两个插件注册同一个 id 时会共用一份状态。

## 构建

```bash
npm install   # esbuild
npm run build # 生成 lib/client.js
```

请把 `lib/client.js` 提交进仓库。git 方式安装直接消费构建产物。

## 许可

[MIT](LICENSE)