# apes--sidebar

WorkBuddy / Tutti 风格的右侧边栏增强插件（基于 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 的 `ctx.betterSidebar` 服务）。**显示名可配置**：默认 `apes--sidebar`，预设 `feyOS`，或任意自定义。

在 better-sidebar 的右侧工作台里新增 3 个**可配置** Tab：

| Tab | id | 对应参照 | 配置开关 |
|---|---|---|---|
| **Tasks**（任务导航） | `wb:tasks` | WorkBuddy 左侧任务列表：按工作区+时间分组、搜索、运行中徽标、一键打开/新建会话 | `enableTasks`（默认开） |
| **Agents**（Agent 总览） | `wb:agents` | Tutti multi-agent：子代理/后台 agent 列表、运行状态、一键跳转 | `enableAgents`（默认开） |
| **Profile**（底部用户区） | `wb:profile` | WorkBuddy 底部：显示名 + 模型信息 + 设置/帮助入口 | `enableProfile`（默认开） |

## 安装

前置：已装 `dsh-better-sidebar`（≥0.16）。

```bash
dsh plugin --profile desktop add apes--sidebar
```

装完**硬刷新**（Cmd/Ctrl+Shift+R）即可在侧边栏 + 菜单看到新 Tab。

## 配置（设置页「侧边卡片」→ apes--sidebar）

| 键 | 默认 | 说明 |
|---|---|---|
| `displayName` | `apes--sidebar` | 显示名：预设 `feyOS`，或自定义任意名字（Profile Tab 标题与卡片名跟随） |
| `enableTasks` | `true` | 显示 Tasks Tab |
| `enableAgents` | `true` | 显示 Agents Tab |
| `enableProfile` | `true` | 显示 Profile Tab |
| `showTime` / `showUngrouped` | — | Tasks 子设置 |

持久化在 `prefs.pluginSettings['apes--sidebar']`。

## 卸载

```bash
dsh plugin --profile desktop remove apes--sidebar
```

## 验证

```bash
dsh --profile desktop --dump-config | grep apes-sidebar   # host 挂载
# 唯一性（崩溃检查）：dump-config 的 id 不应有重复
```

## 兼容性注意

- **不要与 `dsh-background-agents` 0.7.1 同 profile**：它与基座 `@deepseek-ai/dsh-base` 的 `storage` loader 条目 id 冲突（`duplicate loader entry id "storage"`），会导致 desktop profile 启动崩溃。Agent 总览不依赖它，独立可用。
- Agents Tab 不依赖 `remote.commands`（该服务不存在）；团队房间能力暂不可用，界面显示说明。

## 结构

- `lib/index.js` — host 侧最小入口（Node）
- `lib/client.js` — client bundle（`__ModuleLoader__.load` 格式），注册 3 个可配置 Tab
- `cordis.patch.yml` — profile 组成树挂载（含双挂载守卫）

## 关联

- 前身：dsh-wb-sidebar（v0.2.0）→ 更名为本插件（v0.3.0）
- 聚合安装包：figmar/dsh-sidebar-boost（含基础侧边栏 + 多个增强插件）

## License

MIT